Using the messaging adapter

When you use the IBM® MQ adapter as a source, by default messages are served from the queue in a first-in-first-out (FIFO) manner unless you specify a particular message by using a message identifier, correlation identifier, or group identifier. When you use the adapter as a target, messages are placed on the queue that you specify.

When you use the IBM MQ adapter in a Launcher environment, the user account that starts the Launcher service must be registered in the MQM group.

If more than one thread or process updates the watched queue with new messages, specify the -REFRESH and -EQN adapter commands on the command line of an input card. The -REFRESH command enables the IBM MQ adapter listener to process all messages on the queue, particularly when the messages are inserted and committed at different time intervals by multiple threads. The -EQN adapter command identifies a queue to which messages are copied when an error occurs.

By default, the IBM MQ adapter listener enables cooperative browsing. Cooperative browsing enables multiple IBM MQ adapter watches to monitor the same queue. When you deploy additional IBM MQ adapter listeners to watch the same queue from different Launchers, message handling is automatically coordinated and load-balanced with fail-over support.

Cooperative browsing requires no additional command line settings. To disable cooperative browsing, set the WTX_ADAPTER_MQS_DISABLE_COOP environment variable to any value before you start the Launcher.

Cooperative browsing is designed to process physical messages. The IBM MQ adapter listener automatically disables cooperative browsing when the command line of the watched input card specifies any of these commands:
  • -CMSG
  • -GRP2