JMS message transformation

The JMSInput and JMSOutput nodes expect JMS messages, and therefore expect a native JMS message tree representation.

You can use the following nodes to transform messages between a WebSphere® MQ JMS message tree and a JMS message tree:

These nodes do not have any configurable properties. The JMSMQTransform node transforms a native JMS message tree to a WebSphere MQ JMS message tree, and the MQJMSTransform node performs the transformation in the opposite direction.

The following diagram provides an overview of the mapping scheme that is used:

Diagram showing transform between a native JMS message tree and a WebSphere MQ JMS message tree

This mapping diagram uses the same scheme as the WebSphere MQ JMS provider to convert between a JMS message and an MQMD or MQRFH2 message.

When transforming between a WebSphere MQ message tree and a native JMS message tree, the transformation nodes copy elements from different parts of a message tree:

Example message flow scenario: JMSInput node to MQOutput node

Diagram showing the message flow from the JMSInput node to the MQOutput node through the JMSMQTransform node
  1. A JMSInput node is configured to subscribe to topic ABC.
  2. An application that is connected to the JMS server publishes on topic ABC.
  3. A publication is received at the JMSInput node.
  4. The node extracts data from the JMS message.
  5. The JMS message is passed to the JMSMQTransform node where the message is converted to a WebSphere MQ message.
  6. The MQOutput node receives the WebSphere MQ message, and publishes the message on a WebSphere MQ queue.

The final destination is a WebSphere MQ queue, therefore the message must pass through a JMSMQTransform node to convert the message tree to a WebSphere MQ JMS format before it reaches the MQOutput node.

Example message flow scenario: MQInput node to JMSOutput node

Diagram showing the message flow from the MQInput node to the JMSOutput node through the MQJMSTransform node
  1. An MQInput node receives a message from a WebSphere MQ queue.
  2. The MQInput node creates a WebSphere MQ message.
  3. The MQ message is passed to the MQJMSTransform node where the message tree is converted to a JMS format.
  4. The JMSOutput node receives the JMS message and publishes the JMS message on topic XYZ.

Additional examples

These examples show some of the solutions that you can achieve when you use the JMS Transport. Other solutions are possible; for example, the message can be passed to a Compute node or a JavaCompute node and the contents can be modified as required.

Look at the following sample for examples of the JMS nodes being used in message flows: You can view samples only when you use the information center that is integrated with the Message Brokers Toolkit.
Related concepts
JMS parsers and domains
Related reference
JMS message selector
JMSInput node
JMSOutput node
JMS message as input
JMS message for output
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Last updated : 2009-01-07 15:20:33

ac24872_