CKQC - CICS-MQ adapter control transaction
Use the CKQC transaction as one of the ways to control the CICS®-MQ adapter. You can use the CKQC transaction through the CICS-MQ adapter control panels, or from the command line, or from an application program.
For details of all the available options for controlling the CICS-MQ adapter, see Administering the CICS-MQ adapter.
CKQC commands
The CKQC transaction commands are as follows:
- CKQC START
- Starts the connection to IBM® MQ. For the syntax of this command and examples, see Starting a CICS-MQ connection from the CICS command line.
- CKQC STOP
- Stops the connection to IBM MQ. For the syntax of this command and examples, see Stopping a CICS-MQ connection from the CICS command line.
- CKQC DISPLAY
- Returns essential information about the connection to IBM MQ, in the form of a CICS message. This command has no options. For an example, see Displaying CICS-MQ connection status and settings.
- CKQC STARTCKTI initiation queue name
- Starts an instance of the CICS-MQ trigger monitor, CKTI that serves the default initiation queue or an initiation queue that you specify. If you issue a CKQC STARTCKTI command without specifying an initiation queue, this command is interpreted as referring to the default initiation queue for the CICS region, regionAPPLID.initiation.queue. To start an instance of CKTI to serve a
specified initiation queue, specify the queue name; for example:
CKQC STARTCKTI CICS01.INITIATION.QUEUE2CAUTION:You can use CKQC to start instances of CKTI. However, if the CICS region has installed MQMONITOR resources and has multiple instances of CKTI running, using CKQC to stop CKTI could cause unpredictable results. It is recommended to use MQMONITOR to control CKTI. - CKQC STOPCKTI
- Stops an instance of CKTI. CAUTION:You can use CKQC to start instances of CKTI. However, if the CICS region has installed MQMONITOR resources and has multiple instances of CKTI running, using CKQC to stop CKTI could cause unpredictable results. It is recommended to use MQMONITOR to control CKTI.
- CKQC MODIFY
- Resets CICS-MQ connection statistics,
and enables or disables the CICS-MQ
API-crossing exit. For examples of this command, see Enabling the CICS-WebSphere MQ API-crossing exit, Disabling the CICS-WebSphere MQ API-crossing exit,
and Resetting CICS-MQ connection statistics. The full syntax of the command is as follows:
CKQC MODIFY Y|N E|Dwhere:- Y|N
- Specify one of:
- Y
- Reset connection statistics.
- N
- Do not reset connection statistics.
- E|D
- Specify one of:
- E
- Enable the CICS-MQ API-crossing exit.
- D
- Disable the CICS-MQ API-crossing exit.