Skip to content
Art2link ESB v2.02 LTS HomeDocumentationBlogContact
Core concepts/Adapters/MQ Series adapter
Adapter

MQ Series adapter Enterprise

Bidirectional integration with IBM MQ. Acts as a Listener when bound to a receive port and a Caller when bound to a send port. The familiar Queue Manager / Channel / Queue model carries over directly.

Enterprise edition only. MQ Series is part of the Enterprise adapter set and is not available in Starter. See the Edition comparison for what each edition includes.
ADAPTER · RECEIVE · SEND MQ Series IBM MQ, Listener (consume) and Caller (put) on a queue Beta DIRECTION ↓ ↑ Receive & Send MODES One-way · Two-way AUTHENTICATION MQ Authentication EDITION Enterprise Beta

MQ Series is the longest-running enterprise message broker in production. The Art2link ESB adapter binds to a single queue and lets you treat that queue as either an inbound source or an outbound destination, without writing any MQ client code.

Connection model

The MQ client connection that the adapter opens follows the classic three-part addressing IBM MQ users will recognise.

QUEUE MANAGER QMGR1 CHANNEL SYSTEM.DEF.SVRCONN QUEUE APP.IN.ORDERS a single queue per adapter binding
Listener side, consume from a queue

Bound to a receive port, the adapter opens a long-lived connection to the queue manager and waits for messages on the configured queue. Each message is acknowledged transactionally: the get is committed only after the bus has accepted the publish, so an exception inside the receive port leaves the message on the queue for the next attempt.

QUEUE messages waiting get MQ LISTENER transactional get commit on bus publish publish Bus downstream picks up
Caller side, put to a queue

Bound to a send port, the adapter puts the message body onto the queue and returns. In one-way mode the put is the end of the flow. Two-way mode uses MQ's request/reply pattern: a reply queue and a correlation id are configured on the send port, and the adapter waits for the matching reply message and republishes it to the bus, making MQ one of the adapters that can return a real payload to a two-way send port.

Authentication

The MQ Series adapter pairs with an MQ Authentication. The Authentication carries the queue manager address (host + port), the channel name, the user identity, and either a password or a TLS client certificate. The same Authentication object is reused across Listener and Caller bindings into the same queue manager.

What you configure on the MQ Series adapter

Placeholder field set, verify against the running product. Beta details may change before GA.

Queue Name, required; the queue the adapter binds to.
Get Wait Interval, required on Listener; how long the adapter blocks waiting for a message before checking shutdown signals.
Reply Queue, required on two-way Caller; the queue replies are expected on.
Correlation Strategy, required on two-way Caller; one of MsgId => CorrelId (default), Generated CorrelId, or Custom expression.
Reply Timeout, required on two-way Caller; how long to wait for the reply before failing.
Persistence, optional on Caller; one of Persistent, Non-persistent, Queue default.
Priority, optional on Caller; 0–9 or queue default.
Expiry, optional on Caller; message lifetime in tenths of a second, or unlimited.
Character Set / CCSID, optional; defaults to the queue manager's CCSID.
Authentication, required; picker filtered to MQ Authentication objects in the same Application.

That is the MQ Series adapter

Bidirectional IBM MQ integration. Transactional get on the Listener, request/reply on the Caller. Beta until GA. Enterprise edition only. Back to Adapters.