Starting a CICS-MQ monitor

If set up properly, a CICS®-MQ monitor can automatically start when the MQ connection is established. You can also manually start a CICS-MQ monitor in several ways.

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).

• To automatically start a CICS MQ monitor when the MQ connection is established, you should define the MQMONITOR resource with attributes AUTOSTART(YES) and STATUS(ENABLED).
  When the connection between CICS and MQ has been established, CICS will start MQ monitors that have been installed with attributes AUTOSTART(YES) and STATUS(ENABLED) if the user ID associated with the task that set the MQCONN resource to CONNECTED has sufficient authority to start the associated transactions.
• To manually start a CICS-MQ monitor, you can use any of the following methods:
  • Using a CICS application program that issues EXEC CICS SET MQMONITOR

    You can start a CICS-MQ monitor by issuing an EXEC CICS SET MQMONITOR command in a CICS application program.

  • Using a CICSPlex SM application program that issues EXEC CPSM PERFORM SET OBJECT(MQMON) ACTION(START)

    You can start a CICS-MQ monitor by issuing an EXEC CPSM PERFORM SET OBJECT(MQMON) ACTION(START) command in a CICSPlex SM application program.

  • Using the CICS CEMT transaction

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

  • Using the CICSPlex SM web user interface

    You can start a CICS-MQ monitor from the WebSphere MQ monitor view in the CICSPlex SM web user interface (WUI).

  • Using the CICS Explorer

    You can start a CICS-MQ monitor from the CICS Explorer. The CICS Explorer provides a functional equivalent to the CICSPlex SM web user interface and the CEMT transaction.