Transaction manager: Global statistics
You can retrieve transaction manager global statistics by using the EXEC CICS EXTRACT STATISTICS TRANSACTION system command. They are mapped by the DFHXMGDS DSECT.
| DFHSTUP name | Field name | Description |
|---|---|---|
| Total number of transactions (user + system) | XMGNUM | is the number of transactions (user + system) that have run in the system.
Reset characteristic: reset to zero |
| Current MAXTASKS limit | XMGMXT | is the latest MXT value (expressed as a number of tasks) specified in the SIT,
or as an override, or changed dynamically using CEMT SET SYSTEM MAXTASKS(value) or EXEC CICS® SET SYSTEM
MAXTASKS(fullword binary data-value) commands. Reset characteristic: not reset |
| Time MAXTASKS last changed | XMGLSMXT | is the date and time when the maximum number of user transactions (MXT) was
last set or changed dynamically. The DFHSTUP report expresses this time as day/month/year hours:minutes:seconds:decimals; however, the DSECT field contains the time as a store clock (STCK) value in local time. Reset characteristic: not reset. |
| Current number of active user transactions | XMGCAT | is the current number of active user transactions in the system. Reset characteristic: not reset |
| Time last transaction attached | XMGLTAT | is the date and time when the last user transaction was attached. The DFHSTUP report expresses this time as day/month/year hours:minutes:seconds:decimals; however, the DSECT field contains the time as a store clock (STCK) value in local time. If the DFHSTUP report shows the date and time as --/--/---- --:--:--:---- then that indicates that a user transaction has not been attached since the statistics were last reset. Reset characteristic: reset to zero. |
| Current number of MAXTASK queued user transactions | XMGCQT | is the current number of queued user transactions in the system. Note that this
does not include transactions queueing for transaction class membership. Note that the current
queueing time for these transactions is in field XMGCQTME. Reset characteristic: not reset |
| Times the MAXTASKS limit reached | XMGTAMXT | is the number of times the MXT limit has been reached Reset characteristic: reset to zero (or one if at MXT) |
| Time the MAXTASKS limit last reached | XMGLAMXT | is the date and time when the number of active user transactions last equalled
the specified maximum number of user transactions (MXT). The DFHSTUP report expresses this time as day/month/year hours:minutes:seconds:decimals; however, the DSECT field contains the time as a store clock (STCK) value in local time. Reset characteristic: not reset. |
| Currently at MAXTASKS limit | XMGATMXT | Indicates whether the CICS region is currently at the maximum number of user
transactions (MXT). Reset characteristic: not reset. |
| Peak number of MAXTASK queued user transactions | XMGPQT | is the peak number of MAXTASK queued user transactions reached in the system.
Reset characteristic: reset to current value (XMGCQT) |
| Peak number of active user transactions | XMGPAT | is the number of user transactions that have become active. Reset characteristic: reset to current value (XMGCAT) |
| Total number of active user transactions | XMGTAT | is the total number of user transactions that have become active. Reset characteristic: reset to zero |
| Total number of MAXTASK delayed user transactions | XMGTDT | is the number of user transactions that had to queue for MXT reasons. This value
does not include those transactions that are currently queueing for MXT (see XMGCQT). Note that the
queueing time for these transactions is in field XMGTQTME. Reset characteristic: reset to zero |
| Total MAXTASK queuing time | XMGTQTME | is the total time spent waiting by those user transactions that had to queue for
MXT reasons. This value does not include the time spent by those transactions that are currently
queueing for MXT (see XMGCQTME). Reset characteristic: reset to zero |
| Total MAXTASK queuing time of currently queued user transactions | XMGCQTME | is the total time spent waiting so far by those user transactions currently
queuing for MXT reasons. Reset characteristic: not reset |