A JMS Target activity enables you to send messages to JMS server, such as Apache MQ Server, Oracle AQ Server and Oracle WebLogic using JMS provider. JMS target is used to post the target data in a topic or to post the data in the queue of a JMS Server.
This section describes how to create a JMS Target activity using the following details of a message to be sent to JMS server, as an example:
JMS Provider activity must be created before creating JMS Target activity
Steps to create a JMS Target Activity
- Click Configure > TARGETS > JMS Target.
- Click CREATE JMS Target.
- On Create JMS Target screen, enter the name and description of the new JMS Target in the textboxes Name and Description respectively.
- Select the JMS Provider activity from the drop-down list of JMS Provider.
- Select the connection type as either QUEUE or TOPIC from the drop-down list of Connection Type.
- Enter the name of queue or topic as configured in the JMS Server in the textbox of Queue Or Topic Name.
- Select the message type as either TEXT or BYTE from the drop-down list of Message Type.
- Select the Create Dynamically checkbox, if queue or topic specified above, doesn't already exist on the JMS Server. If you enable create dynamically checkbox, it will create the queue or topic specified above on the JMS Server.
- Enter the username and password required to connect to JMS Server in the textboxes UserName and Password respectively. Then, re-enter the password in the textbox Confirm Password.
- Select the delivery mode from the drop-down list of Delivery Mode. This list has the following options:
- Persistent: Persistent messages are stored in the persistent storage to be delivered at a later date if a client is unavailable. Persistent Message is retained, even if the JMS Server is restarted.
Non-Persistent: Non-Persistent messages are not stored in persistent storage. The non-persistent messages are lost, in case the JMS Server is restarted.
The default delivery mode is persistent.
- Enter the Correlation ID in the textbox Correlation ID. Correlation ID is used to link one message with another.
- Enter the priority level of the message in the textbox Message Priority. For example, if you want to send the message with priority 2, type 2 in the textbox Message Priority.
- Enter the address at which you want to send the reply in the Reply To field.
- Enter the time to live for the message in milliseconds in the textbox Time to Live.You can set "TimeToLive" header value in JMS Target activity based on the value of "JMSExpiration" header value received in input JMS message. These parameters have the following relation:
JMSExpiration = currenttime + timeToLive.
You can override the following JMS Target Message Properties at runtime:
- Delivery Mode
- Correlation iD
- Message Priority
- Reply To
- Time to Live
- Message Properties
To know more on how to override these properties, refer to the Overriding JMS Target Message Properties section.
Enter the name, type, and default value for JMS message parameters in the Message Properties table.For example, enter the following values:
$$var$$You can also add and delete rows in the Message Properties table as per your requirements.
Expand Advanced Properties and select the project of the activity from the drop-down list of Project.
Click the Save button.You can verify the JMS target activity at design time. For this, click Test. This verifies the values given in the JMS Provider and Connection Type fields.