Starting a CICS MQ monitor through the CICS CEMT transaction

You can start an MQ monitor by issuing the SET MQMONITOR command in the CICS® CEMT transaction.

Before you begin

  • The MQMONITOR resource must be installed and enabled for use in the CICS region. For details, see Setting up the CICS-MQ adapter.
  • If the MQMONITOR to be started is used to control the CICS-MQ bridge, ensure that the attributes needed by the CICS-MQ bridge are specified in the MONDATA attribute of the MQMONITOR.
  • If security checking is active (that is, the SEC system initialization parameter is set to YES), ensure that the user ID associated with the transaction that attempts to set the MQ monitor state to started is a surrogate of the user ID defined in MONUSERID and is authorized to start transactions associated with the MONUSERID. In the case of setting the MQ monitor state through a CICSPlex® SM API interface such as the CICS Explorer®, the user ID to be associated with the MQ monitor transaction is either the region user ID or the PLTPIUSR user ID (if specified).
  • If the z/OS® Workload Manager (WLM) health service is active (see WLMHEALTH), with every increment in the z/OS WLM HEALTH value of the CICS region from zero to 100%, an attempt is made to start all stopped MQ monitors that have been defined with AUTOSTART(YES). If you want to control when a stopped MQ monitor starts, you must set AUTOSTART(NO) for this MQMONITOR resource. For more information, see Effect of z/OS Workload Manager Health service on MQMONITORs and Alert monitor (CKAM).

About this task

For details of how to start and use the CEMT transaction, see CEMT - main terminal.

Procedure

  1. On the CICS command line, enter the following command: 
    CEMT SET MQMONITOR (name)

    where name is the name of the MQMONITOR resource that you want to start.

    The AUTOSTART, ENABLESTATUS, and MONSTATUS values of the specified MQMONITOR resource definition are displayed.
  2. If the MQMONITOR resource definition is disabled, overtype the value DISABLED in the ENABLESTATUS field with the value ENABLED to enable the resource for use in the CICS region.
  3. Overtype the value STOPPED in the MONSTATUS field with the value STARTED to start the MQ monitor.
  4. If AUTOSTART is not enabled, you can enable AUTOSTART for the MQMONITOR by overtyping the value NOAUTOSTART in the AUTOSTART field with the value AUTOSTART.