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
|