MQCONN resources

An MQCONN resource defines the attributes of the connection between CICS® and IBM® MQ. You can install or discard an MQCONN resource only when CICS is not connected to IBM MQ.

Only one MQCONN resource can be installed at a time in a CICS region. When you define an MQCONN resource, CICS checks to ensure that there is only one MQCONN resource defined in the group or list. If more than one is found, even one with a different name, a warning message is issued. If you do install a second MQCONN resource, CICS implicitly discards the existing MQCONN resource before proceeding with the installation, unless you are reinstalling an MQCONN resource with the same name.

When you have installed the MQCONN resource, you can use the CEMT SET MQCONN or EXEC CICS SET MQCONN command, CICSPlex® SM, or the CICS Explorer® to start the connection between CICS and IBM MQ.

MQCONN and MQMONITOR resources

When you install an MQCONN resource that specifies a value in the INITQNAME attribute, CICS also dynamically creates and installs an MQMONITOR resource with the reserved name of DFHMQINI representing the default initiation queue.

DFHMQINI has the following attributes:

QNAME

Specifies the initiation queue name.

TRANSACTION

CKTI (by default)

MONUSERID

This attribute is obtained as follows:

From the PLTPIUSR system initialization parameter, if available
Otherwise, from the CICS region user ID

USERID

The value is the CICS default user ID.

DFHMQINI is automatically started when the MQ connection is established, and the user ID associated with the CKTI transaction is obtained from MONUSERID if security checking is active, or from the user ID of the transaction that set the state of the MQMONITOR resource to started if security checking is disabled.

You can use the EXEC CICS INQUIRE MQMONITOR or CEMT INQUIRE MQMONITOR command to inquire on the QNAME attribute of the dynamically created MQMONITOR resource. If you want to change this QNAME value, you must first change the INITQNAME attribute of the MQCONN resource and then reinstall the MQCONN resource. When you discard an MQCONN resource that includes a setting for the INITQNAME attribute, the dynamically created MQMONITOR resource and any user-defined MQMONITOR resources are also discarded.