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
- 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).
- Install the MQMONITOR resource.