IBM MQ Monitor statistics

You can retrieve IBM® MQ monitor statistics by using the EXEC CICS EXTRACT STATISTICS MQMONITOR system command. They are mapped by DFHMQRDS/DFHMQRPS/DFHMQRKS.

A record is produced for each MQMONITOR resource installed in the CICS region.

Table 1. IBM MQ Monitor statistics
DFHSTUP name	Field name	Description
MQMONITOR name	MQR_NAME	The name of an installed MQMONITOR definition in the CICS® region. Reset characteristic: not reset
MQMONITOR Start Date / Time	MQR_START_TIME_LOCAL	The local date and time when the most recent instance of the MQ monitor was started. Reset characteristic: not reset
MQMONITOR Stop Date / Time	MQR_STOP_TIME_LOCAL	The local date and time when the most recent instance of the MQ monitor was stopped. If the MQ monitor is running, this field is blank. Reset characteristic: not reset
Queue Name	MQR_QNAME	The name of the MQ queue monitored by the MQ monitor. Reset characteristic: none
Monitor Status	MQR_MONSTATUS	The status of the MQ monitor: STARTED The MQ monitor is started. STARTING The MQ monitor is starting. STOPPED The MQ monitor is stopped. STOPPING The MQ monitor is stopping. Reset characteristic: not reset
Monuserid	MQR_MONUSERID	The user ID used by the transaction monitoring the MQ queue. Reset characteristic: not reset
Task number	MQR_TASKNUM	Task number of the transaction monitoring the MQ queue. Reset characteristic: none
Tranid	MQR_TRANID	The ID of the CICS transaction used by the MQ monitor. Reset characteristic: not reset
Userid	MQR_USERID	The user ID to be used by the MQMONITOR transaction when issuing the start request for the application transaction if a suitable user ID is not available. Reset characteristic: not reset
Number of OPEN requests	MQR_TOPEN	The number of MQOPEN calls issued. Reset characteristic: reset to zero
Number of CLOSE requests	MQR_TCLOSE	The number of MQCLOSE calls issued. Reset characteristic: reset to zero
Number of GET requests	MQR_TGET	The number of MQGET calls issued. Reset characteristic: reset to zero
Number of GETWAIT requests	MQR_TGETWAIT	The number of MQGET calls issued with the MQGMO_WAIT option. Reset characteristic: reset to zero
Number of PUT requests	MQR_TPUT	The number of MQPUT calls issued. Reset characteristic: reset to zero
Number of PUT1 requests	MQR_TPUT1	The number of MQPUT1 calls issued. Reset characteristic: reset to zero
Number of INQ requests	MQR_TINQ	The number of MQINQ calls issued. Reset characteristic: reset to zero
Number of INQL requests	MQR_TINQL	The number of MQINQL calls issued. Reset characteristic: reset to zero
Number of SET requests	MQR_TSET	The number of MQSET calls issued. Reset characteristic: reset to zero
Number of COMMITOUW requests	MQR_TCOMMUOW	The number of UOWs that were in doubt at adapter startup that have now been resolved by committing. Reset characteristic: reset to zero
Number of BACKUOW requests	MQR_TBACKUOW	The number of UOWs that were in doubt at adapter startup that have now been resolved by backing out. Reset characteristic: reset to zero
Number of OTHER requests	MQR_TOTHER	The number of other calls. Reset characteristic: reset to zero
Not in DFHSTUP report	MQR_START_TIME_GMT	The Greenwich mean time (GMT) when the MQ monitor was started. The DFHSTUP report expresses this time as `hh:mm:ss`; however, the DSECT field contains the time as a GMT store clock (STCK) value. Reset characteristic: not reset
Not in DFHSTUP report	MQR_STOP_TIME_GMT	The Greenwich mean time (GMT) when the MQ monitor was stopped. The DFHSTUP report expresses this time as `hh:mm:ss`; however, the DSECT field contains the time as a GMT store clock (STCK) value. Reset characteristic: not reset
Not in DFHSTUP report	MQR_MQMON_DEFINE_SOURCE	The source of the resource definition. Its value depends on the change agent. For more information, see Summary of the resource signature field values. Reset characteristic: not reset
Not in DFHSTUP report	MQR_MQMON_CHANGE_TIME	The time stamp (STCK) in local time of CSD record change. Reset characteristic: not reset
Not in DFHSTUP report	MQR_MQMON_CHANGE_USERID	The ID of the user that ran the change agent. Reset characteristic: not reset
Not in DFHSTUP report	MQR_MQMON_CHANGE_AGENT	The agent that made the last change. Reset characteristic: not reset
Not in DFHSTUP report	MQR_MQMON_INSTALL_AGENT	The agent that installed the resource. Reset characteristic: not reset
Not in DFHSTUP report	MQR_MQMON_INSTALL_TIME	The time stamp (STCK) in local time when the resource was installed. Reset characteristic: not reset
Not in DFHSTUP report	MQR_MQMON_INSTALL_USERID	The ID of the user that installed the resource. Reset characteristic: not reset

The resource statistics fields for the resource signature

The resource signature captures details about when the resource is defined, installed, and last changed. The resource statistics field names for the resource signature end in CHANGE_AGENT, CHANGE_TIME, CHANGE_USERID, DEFINE_SOURCE, INSTALL_AGENT, INSTALL_TIME, and INSTALL_USERID. For detailed information about the content of the resource signature fields, see Summary of the resource signature field values.