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 Main 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.
