Starting a CICS-WebSphere MQ connection
If the CICS®-WebSphere® MQ connection is not started at CICS initialization, you can start the connection in several ways.
Before you begin
About this task
To set the CICS-WebSphere MQ connection to start at CICS initialization in the future, specify the CICS system initialization parameter MQCONN=YES, or include the DFHMQCOD program or your own equivalent program in your CICS PLTPI list. For instructions to do this, see Setting up the CICS-WebSphere MQ adapter.
Procedure
- Using the CICS-WebSphere MQ adapter control panels
You can run the CICS-MQ Adapter control transaction, CKQC, and then start the CICS-WebSphere MQ connection from the CICS-WebSphere MQ adapter control panel.
- Issuing CKQC START from the CICS command line
You can start the CICS-WebSphere MQ connection by issuing the CKQC START command from a command line.
- Using a CICS
application program that issues EXEC CICS SET MQCONN
You can start the connection to WebSphere MQ by issuing an EXEC CICS SET MQCONN command in a CICS application program.
- Using a CICS application
program with linking to DFHMQQCN
You can start a connection to WebSphere MQ by linking to the CICS-WebSphere MQ adapter connect program, DFHMQQCN (or CSQCQCON, which is a previous name for the program), from a CICS application program. Although this method of starting the connection is maintained for compatibility, using the EXEC CICS SET MQCONN command is the preferred method of starting the connection from a CICS application program.
- Using the CICS
CEMT transaction
You can start the connection to WebSphere MQ by issuing the SET MQCONN command in the CICS CEMT transaction.
- Using the CICSPlex®
SM web user interface
You can start the connection to WebSphere MQ from the WebSphere MQ Connection view in the CICSPlex SM web user interface (WUI).
Using the CICS Explorer®
You can start the CICS-WebSphere MQ connection from the CICS Explorer. The CICS Explorer provides a functional equivalent to the CICSPlex SM web user interface and the CEMT transaction.
Results
When the connection between CICS and MQ has
been established, CICS will start MQ monitors that have been installed with attributes
AUTOSTART(YES) and STATUS(ENABLED) if the user ID associated with the task that set the MQCONN
resource to CONNECTED has sufficient authority to start the associated transactions.