MQCONN

The MQCONN system initialization parameter specifies whether you want CICS® to start a connection to IBM® MQ automatically during initialization.

Defining MQCONN

You can define the MQCONN system initialization parameter in the following ways:
  • On the PARM parameter of the EXEC PGM=DFHSIP statement
  • In the SYSIN data set of the CICS start up job stream
  • Through the system console
  • In the DFHSIT macro

Values for MQCONN

Valid values for the MQCONN system initialization parameter are as follows:

MQCONN={NO|YES}
NO
NO is the default value for MQCONN2. NO is the default value for MQCONN. Do not automatically call DFHMQCOD, the CICS-MQ adapter program, during initialization.
YES

Call the CICS-MQ adapter program, DFHMQCOD, automatically during CICS initialization. The MQCONN parameter always uses program DFHMQCOD to start the CICS-MQ connection. It cannot be customized to use a user-supplied attach program of a different name.

When you specify MQCONN=YES, the information that CICS needs to start the connection to IBM MQ, such as the name of an IBM MQ queue manager or queue-sharing group, is taken from the MQCONN resource definition for the CICS region.

An MQCONN resource definition must be installed before CICS can start the connection to IBM MQ. When you start the connection automatically at CICS initialization, for an initial or cold start, the MQCONN resource definition must be present in one of the groups named in the list or lists named by the GRPLIST system initialization parameter. For a warm or emergency start of CICS, the MQCONN resource definition must have been installed by the end of the previous CICS run.

When you specify MQCONN=YES, you do not need to define the CICS-MQ adapter program in the CICS post initialization program list table (PLT).

For more information about starting and customizing a connection to IBM MQ, see How it works: The CICS-MQ adapter.