CEMT INQUIRE MQMONITOR
Inquire on the status of an installed MQ monitor and return the current attributes of the MQMONITOR resource.
In the CICS Explorer, the MQ Monitors view provides a functional equivalent to this command.
Description
The INQUIRE MQMONITOR command inquires on the status of an installed MQ monitor and returns the current attributes of the MQMONITOR resource.
When you install an MQCONN resource definition in the CICS® region with the INITQNAME attribute specified, an MQMONITOR resource with the reserved name of DFHMQINI is also installed. It represents the default initiation queue.
The resource signature
You can use this command to display the resource signature fields. You can use these fields to manage resources by capturing details of when the resource was defined, installed, and last changed. For more information, see Auditing resources. The resource signature fields are CHANGEAGENT, CHANGEAGREL, CHANGETIME, CHANGEUSRID, DEFINESOURCE, DEFINETIME, INSTALLAGENT, INSTALLTIME, and INSTALLUSRID. See Summary of the resource signature field values for detailed information about the content of the resource signature fields.
Input
Press the Clear key to clear the screen, and type CEMT INQUIRE MQMONITOR
(or
suitable abbreviations for the keywords). The resulting display lists the status. You can tab to the
highlighted or blank fields and overtype them with the required values.
Displayed fields
- AUTOSTART(cvda)
- Returns a CVDA value that indicates whether the MQ monitor is started automatically when the connection to the WebSphere® MQ queue manager is established. The possible values are as follows:
- AUTOSTART
- The MQ monitor is started automatically when the connection to the WebSphere MQ queue manager is established.
- NOAUTOSTART
- The MQ monitor is not started automatically.
- CHANGEAGENT(value)
- Displays a value that identifies the agent that made the last change to the resource definition.
You cannot use CEMT to filter on some of these values because they are duplicated. The possible
values are as follows:
- AUTOINSTALL
- The resource was autoinstalled as a result of specifying an initiation queue name on a CKQC START command, and the previously installed MQCONN definition did not specify a value for INITQNAME.
- DYNAMIC
- The resource was defined as a result of an MQCONN resource definition with INITQNAME specified.
- CHANGETIME(date time)
- Displays the date and time when the resource definition was last changed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
- CHANGEUSRID(value)
- Displays the 8-character user ID that ran the change agent.
- DEFINESOURCE(value)
- Displays the source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT option. For details, see Summary of the resource signature field values.
- DEFINETIME(date time)
- Displays the date and time when the resource was created. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
- ENABLESTATUS(cvda)
- Returns a CVDA value that indicates the status of the MQMONITOR resource. The possible values
are as follows:
- ENABLED
- The MQMONITOR resource is enabled for use.
- ENABLING
- The MQMONITOR resource is enabling.
- DISABLED
- The MQMONITOR resource is disabled.
- DISABLING
- The MQMONITOR resource is disabling.
- DISCARDING
- The MQMONITOR resource is being discarded.
- INSTALLAGENT(value)
- Displays a value that identifies the agent that installed the resource. The possible values are
as follows:
- AUTOINSTALL
- The resource was autoinstalled as a result of specifying an initiation queue name on a CKQC START command, and the previously installed MQCONN definition did not specify a value for INITQNAME.
- DYNAMIC
- The resource was installed as a result of the installation of an MQCONN with INITQNAME specified.
- CREATESPI
- The resource was installed by an EXEC CICS CREATE command.
- CSDAPI
- The resource was installed by a CEDA transaction or the programmable interface to DFHEDAP.
- GRPLIST
- The resource was installed by GRPLIST INSTALL.
- INSTALLTIME(date time)
- Displays the date and time when the resource was installed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
- INSTALLUSRID(value)
- Displays the 8-character user ID that installed the resource.
- MONDATA(data-area)
- Returns the data that is passed to the transaction monitoring the MQ queue.Note:When displayed and retrieved by the monitoring task, the MONDATA data is prepended with the following 18 bytes:
- Byte 1: < (left chevron)
- Bytes 2 - 9: MQMONITOR resource name
- Bytes 10 - 17: USERID
- Byte 18: > (right chevron)
Therefore, user-written programs must allow for a maximum length of 218 bytes to retrieve MONDATA, and use the MQMONITOR name as specified in bytes 2 - 9 from the retrieved MONDATA for setting the MONSTATUS attribute of the MQ monitor, thereby indicating its current status. Also note that when security checking is active, CICS performs security checks on the user ID associated with the transaction that attempts to set the MQ monitor state to started. For more information, see the security considerations described in MQMONITOR resources.
- MONSTATUS(cvda)
- Returns a CVDA value that indicates the status of the MQ monitor. The possible values are as follows:
- STARTED
- The MQ monitor is started.
- STARTING
- The MQ monitor is starting.
- STOPPED
- The MQ monitor is stopped.
- STOPPING
- The MQ monitor is stopping.
Note: Before this command completes, CICS verifies that the task identified by the TASKNUMBER attribute is actually executing in the region and that the TRANID of the task matches the TRANSACTION value of the MQMONITOR. If either verification fails, CICS considers the MQMONITOR as stopped. - MONUSERID(data-area)
- Returns the userid that is 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). CICS verifies 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 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(data-area)
- Returns the name of the MQ queue that is being monitored by the MQ monitor.
- TASKNUMBER(data-area)
- Returns the number of the task that is currently monitoring the MQ queue.
- TRANSACTION(data-area)
- Returns the 4-character ID of the CICS transaction that is used by the task monitoring the MQ queue.
- USERID(data-area)
- Returns the 8-character user ID to be used by default for issuing the start request for the application transaction if a suitable user ID is not available from any other source.