The CICS-MQ trigger monitor

CKTI is the CICS®-supplied trigger monitor (or task initiator) transaction, used in a CICS environment to start a transaction when the trigger conditions on any of its associated queues are met. The CICS-MQ trigger monitor CKTI provides the ability to track transactions initiated by the MQ trigger monitor. The benefit of this feature provides administrators with the ability to visualize and track work, therefore offering further value.

To a queue manager, a trigger monitor is like any other application that serves a queue. However, a trigger monitor serves initiation queues.

A trigger monitor is usually a continuously running program. When a trigger message arrives on an initiation queue, the trigger monitor retrieves that message. It uses information in the message to issue a command to start the application that is to process the messages on the application queue.

The trigger monitor must pass sufficient information to the program that it is starting so that the program can perform the right actions on the right application queue.

CKTI

Start of changeYou can start multiple instances of CKTI for each initiation queue.End of change CKTI passes the MQTM structure of the trigger message to the program that it starts by EXEC CICS START TRANSID. The started program obtains this information by using the EXEC CICS RETRIEVE command. For more information about the MQTM structure, see MQTM trigger message.

A program can use the EXEC CICS RETRIEVE command with the RTRANSID option to determine how the program was started; if the value returned is CKTI, the program was started by the CICS-MQ trigger monitor.

For an example of how to use CKTI, see the source code supplied for module CSQ4CVB2 in the Credit Check sample application that is supplied with IBM MQ for z/OS®. For more information about this sample, see Credit check sample.

Start of change

Using MQMONITOR to manage CKTI

Using the MQMONITOR resource is the recommended method of controlling instances of CKTI. The benefits are as follows:
  • You can set up multiple instances of CKTI to monitor an MQ initiation queue.
  • CKTI can be started automatically when the connection to the MQ queue manager is established.
  • MQMONITOR allows the CKTI or a message consuming transaction to run under a preset user ID.
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
Important: If you want to use your own MQ trigger monitors to serve MQ queues in your CICS environment, instead of using the CICS-supplied trigger monitor, ensure that you follow the instructions in Developing and using user-written MQ trigger monitors when designing and implementing your user-written MQ trigger monitor program.
End of change


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