JMS

Use the IBM® App Connect Enterprise Toolkit to configure message flow nodes that are converted from the IBM App Connect Professional JMS activities.

About this task

When you import an orchestration that contains JMS activities, the conversion utility creates a message flow with the JMSInput, JMSOutput, and JMSReceive nodes. See Table 1, for information on which nodes are used for each of the activities.

Table 1. IBM App Connect Professional JMS activities and the corresponding IBM App Connect Enterprise message flow nodes
IBM App Connect Professional activity	IBM App Connect Enterprise node
Poll message	JMSInput node
Send message	JMSOutput node
Get message	JMSReceive node
Subscribe message	JMSInput node
Publish message	JMSOutput node

Steps to connect JMS:

Procedure

Select the JMS node (JMSInput node/JMSReceive node/JMSOutput node).
Navigate to JMS connection tab.
1. Provide JMS provider name as Apache ActiveMQ(Default is Websphere MQ).
2. Provide Initial context factory, Location JNDI bindings and Connection factory name. The connection factory name must be the same as SecurityIdentity.

Steps to Create the SecurityIdentity (Connection factory name) for JMS Connection in IBM App Connect Enterprise:

Procedure

Navigate to the server or workstation where IBM App Connect Enterprise is installed and running.
Open the IBM App Connect Enterprise console on the server where the instance is running.
Run the mqsisetdbparms command to create a security identity for your JMS connection in the Console.
The syntax is as follows:
```
 mqsisetdbparms --work-dir <workDir> -n jms::<securityId> -u <userName> -p <password>
```
For example:
```
 mqsisetdbparms --work-dir C:\ACE12NODEWS\JMS_SERVER -n jms::ConnectionFactory -u <JMS_Username> -p <JMS_Password>
```
Replace:

<workDir> with the working directory of your integration server.

Example: C:\ACE12NODEWS\JMS_SERVER.

<securityId> with connection factory name you are using.

Example: ConnectionFactory.

<JMS_Username> with the JMS username.

<JMS_Password> with the JMS password.
Note:
After running the command successfully, restart your integration server in IBM App Connect Enterprise to apply the changes. Right-click on the integration server (for example JMS_SERVER) in the toolkit and select Restart.

Adding activemq jar:

Add activemq jar in the path: C:\Program Files\IBM\ACE\12.0.12.4\server\classes

JMSInput node for Poll Message activities

About this task

In IBM App Connect Enterprise, Poll Message can be achieved through JMSInput node. It immediately processes a message as soon as it arrives in the queue.

Procedure

Specify the source queue name from which the node will receive messages.
Configure the JMS connection as detailed in Steps to connect JMS.
In the message domain parsing property, select message domain from drop down, to specify how the file content should be interpreted. For example, JSON: For JavaScript Object Notation message.
- Specify the Message Selectors to filter messages, if needed. For more details, refer to the link: https://www.ibm.com/docs/en/app-connect/13.0?topic=enterprise-jms-message-selector.

JMSOutput node for Send Message activities

About this task

In IBM App Connect Enterprise, Send Message can be achieved through JMSOutput node.

Procedure

Specify the destination queue to which the node publishes outgoing messages.
Configure the JMS connection as detailed in Steps to connect JMS.
Specify the message type in the Advanced tab, if needed. The default message type will be "Determine output message from the JMS Message Tree<default>"

Example

Example message node:

JMSInput node > JMSOutput node

JMSReceive node for Get Message activities

About this task

In IBM App Connect Enterprise, Get Message can be achieved through JMSReceive node.

Procedure

Specify the source queue name from which the node will receive messages.
Configure the JMS connection as detailed in Steps to connect JMS.
In the message domain parsing property, select message domain from drop down, to specify how the file content should be interpreted. For example JSON : For JavaScript Object Notation messages.
Specify the message selectors to filter messages if needed. For more details, refer to the link: https://www.ibm.com/docs/en/app-connect/13.0?topic=enterprise-jms-message-selector

JMSInput node for Subscribe Message activities

About this task

In IBM App Connect Enterprise, Subscribe Message can be achieved through JMSInput node.

Procedure

Specify the topic to which the node is subscribed.
Configure the JMS connection as detailed in Steps to connect JMS.
In the message domain parsing property, select message domain from drop down, to specify how the file content should be interpreted. For example, JSON: For JavaScript Object Notation message
Specify the Message Selectors to filter messages, if needed. For more details, refer to the link: https://www.ibm.com/docs/en/app-connect/13.0?topic=enterprise-jms-message-selector.

JMSOutput node for Publish Message activities

About this task

In IBM App Connect Enterprise, Publish Message can be achieved through JMSOutput node.

Procedure

Specify the topic to which the node publishes the messages.
Specify the Reply to destination to which the receiving application must send a reply message.
Configure the JMS connection as detailed in Steps to connect JMS.
Specify the Message type under Advanced tab if needed. The default message type will be "Determine output message from the JMS Message Tree<default>".

Example

Example message node:JMSInput node > JMSOutput node >JMSReceive