MQJMSTransform node

Use the MQJMSTransform node to receive messages that have a WebSphere® MQ JMS provider message tree format, and transform them into a format that is compatible with messages that are to be sent to JMS destinations.

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

The MQJMSTransform 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

Use the MQJMSTransform node to send messages to existing message flows and to interoperate with WebSphere MQ JMS and IBM Integration Bus publish/subscribe.

The JMSMQTransform node handles messages in all supported message domains.

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

MQJMSTransform node icon

Terminals and properties

When you have put an instance of the MQJMSTransform 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 MQJMSTransform 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 WebSphere MQ queue.
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 MQJMSTransform node Description properties are described in the following table.
Property M C Default Description
Node name No No The node type, MQJMSTransform 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.