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 IBM® MQ JMS provider.

The JMSMQTransform node requires access to IBM MQ, so you must install it in addition to IBM App Connect Enterprise if you require the capabilities provided by this node. For more information about using IBM MQ with IBM App Connect Enterprise, see Installing IBM 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 App Connect Enterprise 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 App Connect Enterprise Toolkit by the following 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. You can enable and disable events that are shown here by selecting or clearing the Enabled check box.