Processing WebSphere MQ messages

IBM® Integration Bus provides a number of nodes for handling messages that are received from or sent to WebSphere® MQ applications.

About this task

If you intend to use IBM Integration Bus to process MQ messages, you must install WebSphere MQ in addition to installing IBM Integration Bus. On distributed systems, if you want to connect to a remote queue manager to process MQ messages, you must install either an MQ Client or MQ Server on the same machine as IBM Integration Bus, in addition to installing MQ server on the machine that is running your queue manager. On z/OS®, you use only local connections to queue managers. WebSphere MQ is available as a separate installation package, and your IBM Integration Bus license entitles you to install and use WebSphere MQ with IBM Integration Bus. For more information, see Enhanced flexibility in interactions with WebSphere MQ and Installing WebSphere MQ.

The following nodes are provided for working with WebSphere MQ messages:
MQInput node
Use an MQInput node if the messages arrive at the integration node on a WebSphere MQ queue, and the node is to be at the start of a message flow.
MQOutput node
Use an MQOutput node if the target application expects to receive messages on a WebSphere MQ queue, or on the WebSphere MQ reply-to queue that is specified in the input message MD.
MQGet node
Use an MQGet node to retrieve a message from a WebSphere MQ queue, if you want to get the message later in the message flow.
MQReply node
Use an MQReply node if the target application expects to receive messages on the WebSphere MQ reply-to queue that is specified in the input message MD.
MQHeader node
Use the MQHeader nodes to manipulate WebSphere MQ transport headers and their properties without writing compute nodes. Use the MQHeader node to add, modify, or delete Message Descriptor (MD) and Dead Letter Header (DLH) headers.
JMSMQTransform node
Use the JMSMQTransform node to transform a message with a JMS message tree into a message that has a tree structure that is compatible with the format of messages that are produced by the WebSphere MQ JMS provider.

The JMSMQTransform node can be used to send messages to existing message flows and to interoperate with WebSphere MQ JMS and WebSphere MQ Publish/Subscribe.

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.

You can use the MQJMSTransform node to send messages to existing message flows and to interoperate with WebSphere MQ JMS and WebSphere MQ Publish/Subscribe.

The following topics contain information that you need to understand before you can use the WebSphere MQ support in IBM Integration Bus:

For step-by-step information about how to use MQ nodes to perform a set of typical tasks, see Working with WebSphere MQ.

See the following topics for more information about configuring your message flows, and about related resources for handling messages that are received from or sent to WebSphere MQ applications: