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.

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.

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.

INQUIRE MQMONITOR

Read syntax diagramSkip visual syntax diagram INQUIRE MQMONITOR ( data-value ) AUTOSTART( cvda)ENABLESTATUS( cvda)MONSTATUS( cvda)TASKID( data-area)TRANSACTION( data-area)QNAME( data-area)MONDATA( data-area)MONUSERID( data-area)USERID( data-area)INSTALLTIME( date time)INSTALLUSRID( value)INSTALLAGENT( value)DEFINESOURCE( value)DEFINETIME( date time)CHANGETIME( date time)CHANGEUSRID( value)

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)
Bytes 19 - 218 contains MONDATA as entered by the user.

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.