MQCONN resources

An MQCONN resource defines the attributes of the connection between CICS® and WebSphere MQ. You can install or discard an MQCONN resource only when CICS is not connected to WebSphere 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 or EXEC CICS SET MQCONN command, CICSPlex SM, or the CICS Explorer to start the connection between CICS and WebSphere MQ.

When you install an MQCONN resource that includes a setting for the INITQNAME attribute, CICS also dynamically creates and installs an MQINI resource. The MQINI resource represents the default initiation queue that is specified by the INITQNAME attribute of the MQCONN resource. The name of the MQINI resource is DFHMQINI, and its attribute INITQNAME specifies the initiation queue name.

You can use the EXEC CICS or CEMT INQUIRE MQINI command to inquire on the INITQNAME attribute of the dynamically created MQINI resource. If you want to change it, you must reinstall the MQCONN resource with an appropriate INITQNAME attribute. The MQINI resource is discarded when the MQCONN resource is discarded.

When you discard an MQCONN resource that includes a setting for the INITQNAME attribute, the dynamically created MQINI resource that represents the default initiation queue specified by the INITQNAME attribute is also discarded.