Control the IMS trigger monitor

We can use the CSQQTRMN transaction to stop, and start the IMS trigger monitor.

The IMS trigger monitor (the CSQQTRMN transaction) is described in the Set up the IMS trigger monitor.

• Starting CSQQTRMN
• Stopping CSQQTRMN

Starting CSQQTRMN

1. Start a batch-oriented BMP that runs the program CSQQTRMN for each initiation queue we want to monitor.
2. Modify your batch JCL to add a DDname of CSQQUT1 that points to a data set containing the following information:

   QMGRNAME=q_manager_name    Comment: queue manager name
   INITQUEUENAME=init_q_name   Comment: initiation queue name
   LTERM=lterm          Comment: LTERM to remove error messages
   CONSOLEMESSAGES=YES      Comment: Send error messages to console
   

   where:

   q_manager_name	The name of the queue manager (if this is blank, the default nominated in CSQQDEFV is assumed)
   init_q_name	The name of the initiation queue to be monitored
   lterm	The IMS LTERM name for the destination of error messages (if this is blank, the default value is MASTER).
   CONSOLEMESSAGES=YES	Requests that messages sent to the nominated IMS LTERM are also sent to the z/OS console. If this parameter is omitted or misspelled, the default is NOT to send messages to the console.

3. Add a DD name of CSQQUT2 if we want a printed report of the processing of CSQQUT1 input.

Note:

1. The data set CSQQUT1 is defined with LRECL=80. Other DCB information is taken from the data set. The DCB for data set CSQQUT2 is RECFM=VBA and LRECL=125.
2. We can put only one keyword on each record. The keyword value is delimited by the first blank following the keyword; this means that we can include comments. An asterisk in column 1 means that the whole input record is a comment.
3. If you misspell either of the QMGRNAME or LTERM keywords, CSQQTRMN uses the default for that keyword.
4. Ensure that the subsystem is started in IMS (by the /START SUBSYS command) before submitting the trigger monitor BMP job. If it is not started, your trigger monitor job terminates with abend code U3042.

Stopping CSQQTRMN

• the queue manager ending
• IMS ending

or a z/OS STOP jobname command is entered. Parent topic: Operate the IMS adapter