IBM MQ Connection statistics

You can retrieve IBM® MQ Connection statistics by using the EXEC CICS EXTRACT STATISTICS MQCONN system command. They are mapped by the DFHMQGDS DSECT.

Table 1. IBM MQConnection: Global statistics
DFHSTUP name	Field name	Description
MQCONN name	MQG_MQCONN_NAME	The name of the installed MQCONN definition for the CICS® region, which defines the attributes of the connection between CICS and IBM MQ. Reset characteristic: not reset
IBM MQ Connect Date / Time	MQG_CONNECT_TIME_LOCAL	The date and time when the most recent connection between CICS and IBM MQ was started. In the summary statistics, this field is not present; instead, a field Total IBM MQ Connection Time shows the total time for which CICS was connected to IBM MQ. Reset characteristic: not reset
IBM MQ Connection Status	MQG_CONNECTION_STATUS	The status of the connection between CICS and IBM MQ: C Connected N Not connected Reset characteristic: not reset In the summary statistics, this field is not present.
IBM MQ Disconnect Date / Time	MQG_ DISCONNECT_TIME_LOCAL	The date and time when the most recent connection between CICS and IBM MQ ended. If CICS is currently connected to IBM MQ, this field is blank. In the summary statistics, this field is not present. Reset characteristic: not reset
Mqname	MQG_MQNAME	The name of the IBM MQ queue manager or queue-sharing group that is specified in the MQNAME attribute of the installed MQCONN definition for the CICS region. CICS uses this as the default for the connection. Reset characteristic: not reset
IBM MQ Queue Manager name	MQG_QMGR_NAME	The name of the IBM MQ queue manager to which CICS is currently connected. If CICS is not connected to IBM MQ, this field is blank. Reset characteristic: not reset
Resync Group member	MQG_RESYNCMEMBER	Shows whether the MQCONN definition for the CICS region specifies resynchronization if there are indoubt units of work when CICS reconnects to IBM MQ: YES CICS connects to the same queue manager, waiting, if necessary, until the queue manager becomes active. NO CICS makes one attempt to connect to the same queue manager. If that attempt fails, CICS connects to any member of the queue-sharing group. GROUPRESYNC CICS connects to any member of the queue-sharing group. The queue manager is chosen by IBM MQ and it asks CICS to resolve indoubt units of work on behalf of all eligible queue managers in the queue-sharing group. This function is called group unit of recovery. Reset characteristic: not reset
IBM MQ Release	MQG_MQ_RELEASE	The release of IBM MQ that is connected to CICS.
Initiation Queue name	MQG_INITIATION_QUEUE	The name of the default initiation queue for the connection between CICS and IBM MQ. Reset characteristic: not reset
Number of current tasks	MQG_TTasks	The number of current tasks that have issued an MQI call. In the summary statistics, this field is not present. Reset characteristic: not reset
Number of futile attempts	MQG_TFutilAtt	A count of the number of MQI calls made while the connection status is not connected. This is reset to zero when the connection is established. Reset characteristic: reset to zero
Total number of API calls	MQG_TApi	The total number of MQI calls since the connection was made. Reset characteristic: reset to zero
Number of API calls completed OK	MQG_TApiOk	The total number of calls that have completed successfully. Reset characteristic: reset to zero
Number of OPEN requests	MQG_TOPEN	The number of MQOPEN calls issued. Reset characteristic: reset to zero
Number of CLOSE requests	MQG_TCLOSE	The number of MQCLOSE calls issued. Reset characteristic: reset to zero
Number of GET requests	MQG_TGET	The number of MQGET calls issued. Reset characteristic: reset to zero
Number of GETWAIT requests	MQG_TGETWAIT	The number of MQGET calls issued with the MQGMO_WAIT option. Reset characteristic: reset to zero
Number of GETWAITs that waited	MQG_TWaitMsg	The number of MQGET calls issued with the MQGMO_WAIT option that waited for a message. Reset characteristic: reset to zero
Number of PUT requests	MQG_TPUT	The number of MQPUT calls issued. Reset characteristic: reset to zero
Number of PUT1 requests	MQG_TPUT1	The number of MQPUT1 calls issued. Reset characteristic: reset to zero
Number of INQ requests	MQG_TINQ	The number of MQINQ calls issued. Reset characteristic: reset to zero
Number of SET requests	MQG_TSET	The number of MQSET calls issued. Reset characteristic: reset to zero
Number of internal MQ calls	MQG_TCall	The total number of flows to IBM MQ on the connection. Reset characteristic: reset to zero
Number that completed synchronously	MQG_TCallSyncComp	The total number of calls completed synchronously. Reset characteristic: reset to zero
Number that needed I/O	MQG_TCallIO	The total number of calls that needed I/O. Reset characteristic: reset to zero
Number of calls with TCB switch	MQG_TSubtasked	The number of API calls with a TCB switch. Reset characteristic: reset to zero
Number of indoubt units of work	MQG_IndoubtUOW	The number of indoubt UOWs at adapter startup. Reset characteristic: reset to zero
Number of unresolved units of work	MQG_UnResolvedUOW	The number of UOWs that were in doubt at adapter startup, and that have not been resolved because of a CICS cold start. Reset characteristic: reset to zero
Number of resolved committed UOWs	MQG_ResolveComm	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 resolved backout UOWs	MQG_ResolveBack	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 Backout UOWs	MQG_TBackUOW	The total number of backed out UOWs. Reset characteristic: reset to zero
Number of Committed UOWs	MQG_TCommUOW	The total number of committed UOWs. Reset characteristic: reset to zero
Number of tasks	MQG_TTaskend	The total number of tasks. Reset characteristic: reset to zero
Number of Single Phase Commits	MQG_TSPComm	The total number of single-phase commits. Reset characteristic: reset to zero
Number of Two Phase Commits	MQG_T2PComm	The total number of two-phase commits. Reset characteristic: reset to zero
Number of CB requests	MQG_TCB	The number of MQCB calls issued. Reset characteristic: reset to zero
Number of msgs consumed	MQG_TCONSUME	The number of messages passed to callback routines. Reset characteristic: reset to zero
Number of CTL requests	MQG_TCTL	The number of MQCTL calls issued. Reset characteristic: reset to zero
Number of SUB requests	MQG_TSUB	The number of MQSUB calls issued. Reset characteristic: reset to zero
Number of SUBRQ requests	MQG_TSUBRQ	The number of MQSUBRQ calls issued. Reset characteristic: reset to zero
Number of STAT requests	MQG_TSTAT	The number of MQSTAT calls issued. Reset characteristic: reset to zero
Number of CRTMH requests	MQG_TCRTMH	The number of MQCRTMH calls issued. Reset characteristic: reset to zero
Number of DLTMH requests	MQG_TDLTMH	The number of MQDLTMH calls issued. Reset characteristic: reset to zero
Number of SETMP requests	MQG_TSETMP	The number of MQSETMP calls issued. Reset characteristic: reset to zero
Number of INQMP requests	MQG_TINQMP	The number of MQINQMP calls issued. Reset characteristic: reset to zero
Number of DLTMP requests	MQG_TDLTMP	The number of MQDLTMP calls issued. Reset characteristic: reset to zero
Number of MHBUF requests	MQG_TMHBUF	The number of MQMHBUF calls issued. Reset characteristic: reset to zero
Number of BUFMH requests	MQG_TBUFMH	The number of MQBUFMH calls issued. Reset characteristic: reset to zero
Not in DFHSTUP report	MQG_Connect_time_gmt	The Greenwich mean time (GMT) when CICS connected to IBM MQ. 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	MQG_Disconnect_time_gmt	The Greenwich mean time (GMT) when CICS disconnected to IBM MQ. 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	MQG_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	MQG_CHANGE_TIME	The time stamp (STCK) in local time of CSD record change. Reset characteristic: not reset
Not in DFHSTUP report	MQG_CHANGE_USERID	The user ID that ran the change agent. Reset characteristic: not reset
Not in DFHSTUP report	MQG_CHANGE_AGENT	The agent that made the last change. Reset characteristic: not reset
Not in DFHSTUP report	MQG_INSTALL_AGENT	The agent that installed the resource. Reset characteristic: not reset
Not in DFHSTUP report	MQG_INSTALL_TIME	The time stamp (STCK) in local time when the resource was installed. Reset characteristic: not reset
Not in DFHSTUP report	MQG_INSTALL_USERID	The user ID 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.