WebSphere MQ shared queues

Support for WebSphere® MQ queue-sharing group attach is provided in CICS® TS 4.1 and later versions. Before this, it was necessary to specify the name of a specific WebSphere MQ subsystem.

In a Parallel Sysplex®, you can configure multiple WebSphere MQ queue managers as a queue sharing group (QSG). Queue managers in a QSG support two types of local queue: a shared queue and a private queue. The queue managers in a QSG cooperate to maintain and access shared queues in one or more z/OS® coupling facilities. In this way, all the queue managers own a shared queue. Different queue managers in a QSG can run in the same LPAR or in separate LPARs. An application that is running in any CICS region that connects to any queue manager in the QSG can put to and get from a shared queue that the QSG owns.

You specify a WebSphere MQ queue-sharing group name for the CICS-WebSphere MQ connection, so that CICS uses any eligible queue manager in the group when it reconnects to WebSphere MQ, rather than waiting for a specific queue manager. Queue-sharing groups increase reliability when you reconnect to WebSphere MQ, and help you standardize this aspect of CICS setup across CICS regions and z/OS images.

Instead of defining default settings for the CICS-WebSphere MQ connection in the DFHMQPRM operand of an INITPARM system initialization parameter, you use the MQCONN resource definition. You can use the MQCONN resource definition to specify a queue-sharing group name or the name of a specific queue manager.

If you specify a queue-sharing group name for the connection, you can select appropriate resynchronization actions for CICS by using the RESYNCMEMBER attribute of the MQCONN resource definition. Resynchronization works in the same way as it does for the group-attach function for DB2®. Resynchronization takes place when the connection to WebSphere MQ is lost and CICS is holding outstanding units of work for the last queue manager. You can choose whether CICS waits to reconnect to the same queue manager, or whether CICS makes one attempt to reconnect to the same queue manager, but if that attempt fails, connects to a different eligible queue manager in the group. A queue manager is eligible for connection to a CICS region if it is active on the same LPAR as the CICS region.

You can use EXEC CICS and CEMT commands or CICSPlex® SM to start and stop the CICS-WebSphere MQ connection and change all the attributes of the connection. Alternatively, you can continue to use previous methods of operating the CICS-WebSphere MQ adapter to initiate and manage connections between CICS and WebSphere MQ.

You can use the CKQC transaction from the CICS-WebSphere MQ adapter control panels, or call it from the CICS command line or from a CICS application.

For more information about the CICS-WebSphere MQ adapter, see About the CICS-WebSphere MQ adapter. For more information about setting up an MQCONN resource, see Setting up an MQCONN resource.



cics_mq_shared_queues.html | Timestamp icon Last updated: Sunday, 4 June 2017