Creating JMS Target Activity
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 feature is available in:
Enterprise | Premier | Professional | Express |
---|---|---|---|
√ | √ | √ |
|
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:
Connection Type | Queue |
Transfer Type | Secure |
Queue Name | ReceiveMessage |
User Name | MyUserName |
Password | Mypassword |
Delivery Mode | Delivery Mode |
Correlation ID | EmpDetails |
Prerequisites
JMS Provider activity must be created before creating JMS Target activity
Steps to create a JMS Target Activity
- On the Adeptia Suite homepage, click the Develop tab.
Go to Services > Target and then click JMS. The Manage JMS Target screen is displayed.
- Click the Create New link. The Create JMS Target screen is displayed.
- 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 JMS Provider.
- Select the connection type as either queue or topic from the drop-down list Connection Type.
- Enter the name of queue or topic as configured in the JMS Server in the textbox Queue Or Topic Name.
- 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 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:
Name
Type
Default Value
EmpId
Plain Text
101
EmpSalary
PlainText
$$var$$
You can also add and delete rows in the Message Properties table as per your requirements.
To learn about Advanced Properties refer to Changing Advanced Properties section.
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.