JMSMQTransform node

Use the JMSMQTransform node to transform a message with a JMS message tree into a message that has a message tree structure that is compatible with the format of messages that are produced by the WebSphere® MQ JMS provider.

The JMSMQTransform node is available in the following operation modes:
  • Developer
  • Application Integration Suite
  • Standard
  • Advanced
  • Express
  • Scale
For more information, see Operation modes.

The JMSMQTransform node requires access to WebSphere MQ, so you must install it in addition to IBM® Integration Bus if you require the capabilities provided by this node. For more information about using WebSphere MQ with IBM Integration Bus, see Installing WebSphere MQ.

This topic contains the following sections:

Purpose

You can use the JMSMQTransform node to send messages to existing message flows and to work with WebSphere MQ JMS and IBM Integration Bus publish/subscribe.

The JMSMQTransform node handles messages in all supported message domains.

The JMSMQTransform node is contained in the JMS drawer of the palette, and is represented in the IBM Integration Toolkit by the following icon:

JMSMQTransform node icon

Terminals and properties

When you have put an instance of the JMSMQTransform node into a message flow, you can configure it; see Configuring a message flow node. The properties of the node are displayed in the Properties view.

The terminals of the JMSMQTransform node are described in the following table.
Terminal Description
Failure The output terminal to which the message is routed if an error occurs. Even if the Validation property is set, messages that are propagated to this terminal are not validated.
Out The output terminal to which the message is routed if it is successfully retrieved from the JMS destination.
In The input terminal that accepts a message for processing by the node.

The following table describes the node properties. The column headed M indicates whether the property is mandatory (marked with an asterisk if you must enter a value when no default is defined); the column headed C indicates whether the property is configurable (you can change the value when you add the message flow to the BAR file to deploy it).

The JMSMQTransform node Description properties are described in the following table.
Property M C Default Description
Node name No No The node type, JMSMQTransform The name of the node.
Short Description No No   A brief description of the node.
Long Description No No   Text that describes the purpose of the node in the message flow.
The Monitoring properties of the node are described in the following table.
Property M C Default Description
Events No No None Events that you have defined for the node are displayed on this tab. By default, no monitoring events are defined on any node in a message flow. Use Add, Edit, and Delete to create, change or delete monitoring events for the node; see Configuring monitoring event sources by using monitoring properties for details.

You can enable and disable events that are shown here by selecting or clearing the Enabled check box.