Task initiator or trigger monitor (CKTI)

CKTI starts a CICS® transaction when an MQ trigger message is read; for example, when a message is put onto a specific queue.

When a message is put onto an application message queue, a trigger is generated if the trigger conditions are met. The queue manager then writes a message, containing user-defined data, known as a trigger message, to the initiation queue that has been specified for that message queue. In a CICS environment, you can set up an instance of CKTI to monitor an initiation queue and to retrieve the trigger messages from it as they arrive. CKTI starts another CICS transaction, specified using the DEFINE PROCESS command, which typically reads the message from the application message queue and then processes it. The process must be named on the application queue definition, not the initiation queue.

Each copy of CKTI services a single initiation queue. Start of changeYou can have more than one instance of CKTI monitoring an MQ initiation queue.End of change

How to set up CKTI

An instance of CKTI can be set up in any of the following methods:

Start of changeUsing MQCONN and MQMONITOR resourcesEnd of change
Start of changeYou can specify the name of the default initiation queue in the MQCONN resource definition for the CICS region. When you install the MQCONN resource definition, CICS dynamically creates and installs an MQMONITOR resource with the reserved name of DFHMQINI representing the default initiation queue. You can install more MQMONITOR resources to monitor other initiation queues.

An MQMONITOR resource allows the associated transaction that services an MQ queue to restart automatically when the connection to the MQ queue manager is established. You can use CEMT or CICS APIs to manually start or stop an MQMONITOR.

You can change the name of the default initiation queue by changing and reinstalling the MQCONN resource definition to create a new MQMONITOR resource definition. You can also name an alternative default initiation queue if you start the CICS-WebSphere MQ connection manually.

End of change
Using a terminal from the CKQC transaction or a user-written program that links to DFHMQSSQ
The CKQC transaction gives you access to the control functions of the CICS-MQ adapter to initiate, manage, and view the connection between CICS® and MQ. To start or stop an instance of CKTI, you can use the CKQC STARTCKTI or CKQC STOPCKTI command. You can start CKTI from a terminal from the CKQC transaction or from a CICS program that links to the adapter task initiation program, DFHMQSSQ.

To start or stop a copy of CKTI, you must supply the name of the queue that this CKTI is to serve or is now serving.

If you issue CKQC STARTCKTI or CKQC STOPCKTI commands without specifying an initiation queue, these commands are automatically interpreted as referring to the default initiation queue for the CICS region, regionAPPLID.initiation.queue.

Start of changeCKQC does not control MQMONITOR resources.End of change

CAUTION:
Start of changeUsing the CKQC transaction and MQMONITORs at the same time to manage instances of the CKTI transaction can lead to confusing statistics because CKQC is not aware of MQMONITORs.End of change
Note: Start of changeWhen CKQC STOPCKTI is issued, all transactions monitoring the initiation queue are stopped, including those associated with MQMONITORs.End of change


zc12120_.html | Timestamp icon Last updated: Sunday, 4 June 2017