Transaction class: resource statistics
You can retrieve transaction class resource statistics by using the EXEC CICS EXTRACT STATISTICS TRANCLASS system command. They are mapped by the DFHXMCDS DSECT.
| DFHSTUP name | Field name | Description |
|---|---|---|
| Tclass Name | XMCTCL | The 8-character name of
the transaction class. Reset characteristic: not reset
|
| Number Trandfs | XMCITD | The number of installed
transaction definitions that are defined to belong to this transaction
class. Note: This will be a reference count from the latest version
of the transaction definition table. This statistic is useful to identify
redundant transaction classes.
Reset characteristic: not reset
|
| Max Act | XMCMXT | The maximum number of transactions
in the named transaction class that may be active concurrently. Reset characteristic: not reset
|
| Purge Thresh | XMCTH | The queue limit of the purge
threshold at which transactions in the named transaction class is
purged instead of being added to the queue of transactions that are
waiting for membership of the transaction class. Reset characteristic: not reset
|
| TOTAL | ||
| –Attaches | XMCTAT | The total number of attach
requests made for transactions in this transaction class. Reset characteristic: reset to zero
|
| –AcptImm | XMCAI | The number of transactions
that did not have to queue to become active in this transaction class.
They are accepted immediately. Reset characteristic: reset to zero
|
| –PrgImm | XMCPI | The number of transactions
that were purged immediately because the queue reached the purge threshold
for this transaction class. Reset characteristic: reset to zero
|
| –Queued | XMCTQ | The total number of transaction
that have queued for this transaction class. Reset characteristic: reset to zero
|
| NOT IN THE DFHSTUP REPORT | XMCAAQ | The number of transactions
that have become active in this transaction class but queued first.
Reset characteristic: reset to zero
|
| –PrgQ'd | XMCPWQ | The number of transactions
that have been purged while queuing for acceptance into the transaction
class. This includes those transactions purged explicitly through
Master Terminal, or implicitly through the purge threshold of the
transaction class being lowered. Reset characteristic: reset to zero
|
| –Q-Time | XMCTQTME | The total time in STCK units
spent waiting by those transactions that were queued in the transaction
class. Note: This time only includes the time spent by those that
have finished queuing. In order to calculate the average queuing time,
current queue must be subtracted from the 'queued' count.
Reset characteristic: reset to zero
|
| Peak Act | XMCPAT | The highest number of active
transactions reached in the transaction class. Reset characteristic: reset to current value
|
| Peak Queued | XMCPQT | The highest number of transactions
queued waiting for admittance to the transaction class. Reset characteristic: reset to current value
|
| Times MaxAct | XMCTAMA | The number of separate times
that the number of active transactions in the transaction class was
equal to the maximum value (XMCMXT). Also registers times when maxactive
setting of the transaction class is zero and there are no active transactions
in the transaction class. Reset characteristic: reset to zero or one if transaction class is currently at its maxactive limit.
|
| Times PrgThr | XMCTAPT | The number of separate times
that the purge threshold of the transaction class has been reached
(times at purge threshold). Reset characteristic: reset to zero or one if transaction class is currently at its purge threshold limit.
|
| CURRENT | ||
| –Act | XMCCAT | The current number of transactions
currently active in this transaction class. Reset characteristic: not reset
|
| –Queued | XMCCQT | The number of transactions
that are currently queuing in this transaction class. Reset characteristic: not reset
|
| –Queue Time | XMCCQTME | The total time in STCK units
spent waiting by those transactions that are currently queuing in
this transaction class. Reset characteristic: not reset
|
| Not in DFHSTUP report | XMC_TCLASS_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 | XMC_TCLASS_CHANGE_TIME | The time stamp (STCK)
in local time of the CSD record change. Reset characteristic: not reset
|
| Not in DFHSTUP report | XMC_TCLASS_CHANGE_USERID | The user ID that ran the
CHANGE_AGENT. Reset characteristic: not reset
|
| Not in DFHSTUP report | XMC_TCLASS_CHANGE_AGENT | The agent that was used
to make the last change. Reset characteristic: not reset
|
| Not in DFHSTUP report | XMC_TCLASS_INSTALL_AGENT | The agent that installed
the resource. Reset characteristic: not reset
|
| Not in DFHSTUP report | XMC_TCLASS_INSTALL_TIME | The time stamp (STCK)
in local time when the resource was installed. Reset characteristic: not reset
|
| Not in DFHSTUP report | XMC_TCLASS_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.
