Administering the CICS-WebSphere MQ adapter
You can use the control functions of the CICS-WebSphere MQ adapter to initiate, manage, and view the connection between CICS® and WebSphere® MQ. You can access the control functions using the CKQC transaction, EXEC CICS SPI and CEMT commands, CICSPlex® SM, or the CICS Explorer®.
- You can use the CKQC transaction through the CICS-WebSphere MQ adapter control panels, or from the command line, or from an application program.
- You can use the CEMT transaction to issue commands in the CICS environment, or use the EXEC CICS system programming interface (SPI) commands in an application program.
- If your CICS region is managed by CICSPlex SM, you can use the available views and actions to control the connection.
- The CICS Explorer includes SM Operations and SM Administration views for the CICS-WebSphere MQ connection. For information about working with CICS resources using the CICS Explorer, see the Help information that is provided with the CICS Explorer.
Before you can operate the CICS-WebSphere MQ adapter, you must configure your CICS region appropriately and install an MQCONN resource definition. Setting up the CICS-WebSphere MQ adapter tells you how to do this.
The following table summarizes the operator actions that you can perform for the CICS-WebSphere MQ connection, and whether you can perform these actions using EXEC CICS and CEMT commands, the CKQC transaction, the CICS Explorer, or CICSPlex SM.
Operator action | EXEC CICS, CEMT | CKQC | CICS Explorer or CICSPlex SM |
---|---|---|---|
Start CICS-WebSphere MQ connection | Yes, using SET MQCONN, but you cannot specify the default initiation queue name | Yes | Yes |
Stop CICS-WebSphere MQ connection | Yes, using SET MQCONN | Yes | Yes |
Display connection status and settings | Yes, using INQUIRE MQCONN | Yes | Yes |
Display connect and disconnect time | Yes, using CICS statistics commands | No | Yes |
Display and reset detailed connection statistics including call types | Yes, using CICS statistics commands (resets all statistics) | Yes (resets CICS-WebSphere MQ connection statistics only) | No |
Display tasks that are using the CICS-WebSphere MQ connection | Yes, but only the number of tasks, using INQUIRE MQCONN | Yes, full listing of tasks | No |
Purge individual tasks that are using the CICS-WebSphere MQ connection | Yes, using SET TASK FORCEPURGE | No | No |
Enable or disable CICS-WebSphere MQ API-crossing exit | No | Yes | No |
Start instances of CKTI (CICS-WebSphere MQ trigger monitor or task initiator) | No | Yes | No |