Start of change

Setting up MQMONITOR resources

You can choose to install MQMONITOR resources to monitor MQ queues, including initiation queues. You can have more than one MQMONITOR resource monitoring an MQ queue. Using MQMONITOR resources is the recommended method of controlling instances of the CICS®-WebSphere® MQ trigger monitor, CKTI.

About this task

When you install an MQCONN resource that specifies a value in the INITQNAME attribute, CICS also dynamically creates and installs an MQMONITOR resource with the reserved name of DFHMQINI representing the default initiation queue.

DFHMQINI has the following attributes:
QNAME
Specifies the initiation queue name.
TRANSACTION
CKTI (by default)
MONUSERID
This attribute is obtained as follows:
  • From the PLTPIUSR system initialization parameter, if available
  • Otherwise, from the CICS region user ID
USERID
The value is the CICS default user ID.

You can install more MQMONITOR resources to monitor other MQ queues, including initiation queues.

Procedure

  1. Define an MQMONITOR resource. You can use the CREATE MQMONITOR command to define an MQMONITOR resource. Table 1 list shows important attributes for creating an MQMONITOR resource.
    Table 1. Important MQMONITOR attributes
    Attribute Required / Optional Default Description
    AUTOSTART Optional YES This attribute controls auto-restart of the MQ monitor.
    AUTOSTART(YES)
    Enables the transaction as specified in the TRANSACTION attribute to restart automatically when the connection to the MQ queue manager is established.
    AUTOSTART(NO)
    The MQ monitor is not started automatically. After the connection to the MQ queue manager is established, you have to manually start the MQ monitor.
    MONUSERID Required - Specifies the user ID to be associated with the transaction monitoring the MQ queue. This attribute is only effective when security checking is active (that is, the SEC system initialization parameter is set to YES). If security checking is disabled (that is, SEC is set to NO), the user ID to be associated with the MQ monitor transaction is the user ID of the transaction that set the state of the MQMONITOR resource to started.
    QNAME Optional

    If QNAME is omitted, the value is set to &APPLID..INITIATION.QUEUE by default when the resource is installed.

    Specifies the name of the MQ queue to be monitored.
    STATUS Optional ENABLED This attribute makes the resource available for use in the region.
    TRANSACTION Optional CKTI Specifies the 4-character ID of the CICS transaction monitoring the MQ queue.

    If you are defining an MQMONITOR for monitoring an MQ initiation queue, specify CKTI or leave blank.

    In order for CICS to attempt to automatically start the transaction that is associated with the MQMONITOR, ensure that the MQMONITOR resource has attributes AUTOSTART(YES) and STATUS(ENABLED).

  2. Install the MQMONITOR resource.


mqmonitor-setup.html | Timestamp icon Last updated: Sunday, 4 June 2017
End of change