Transaction class (TCLASS) statistics

This section contains the following statistics:

Transaction class: Resource statistics

These statistics can be accessed online using the EXEC CICS® COLLECT STATISTICS TRANCLASS command, and are mapped by the DFHXMCDS DSECT. For programming information about the EXEC CICS COLLECT STATISTICS command, see the CICS System Programming Reference manual.

Table 145. Transaction class: Resource statistics
DFHSTUP name Field name Description
Tclass Name XMCTCL is the 8-character name of the transaction class.

Reset characteristic: not reset

 

Number Trandfs XMCITD is 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 tclasses.

Reset characteristic: not reset

 

Max Act XMCMXT is the maximum number of transactions in the named transaction class that may be active concurrently.

Reset characteristic: not reset

 

Purge Thresh XMCTH is 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 is the total number of attach requests made for transactions in this transaction class.

Reset characteristic: reset to zero

 

-AcptImm XMCAI is 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 is 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 is the total number of transaction that have queued for this transaction class.

Reset characteristic: reset to zero

 

NOT IN THE DFHSTUP REPORT XMCAAQ is the number of transactions that have become active in this transaction class but queued first.

Reset characteristic: reset to zero

 

-PrgQ'd XMCPWQ is the number of transactions that have been purged whilst 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 is 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 is the highest number of active transactions reached in the transaction class.

Reset characteristic: reset to current value

 

Peak Queued XMCPQT is the highest number of transactions queued waiting for admittance to the transaction class.

Reset characteristic: reset to current value

 

Times MaxAct XMCTAMA is 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 tclass is zero and there are no active transactions in the tclass.

Reset characteristic: reset to zero or one if transaction class is currently at its maxactive limit.

 

Times PrgThr XMCTAPT is 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 is the current number of transactions currently active in this transaction class.

Reset characteristic: not reset

 

-Queued XMCCQT is the number of transactions that are currently queuing in this transaction class.

Reset characteristic: not reset

 

-Queue Time XMCCQTME is the total time in STCK units spent waiting by those transactions that are currently queuing in this transaction class.

Reset characteristic: not reset

 

Figure 56 illustrates the transaction class statistics.

Figure 56. The transaction class statistics
 The transactions attempting to be accepted into each transaction class can have several different experiences, such as being purged, queued, or accepted. The total attaches for the transaction class are in statistics field XMCTAT, which represents all the transactions that attempt to be accepted. Once attached, they might be purged immediately -- the number of transactions that have this experience is in statistics field XMCPI. To find the number of transactions that continue to attempt to be accepted, subtract the number in XMCPI from the number in XMCTAT (total attaches). Next, the transactions continuing their attempt might be accepted immediately -- the number of transactions that have this experience is in statistics field XMCAI. To find the number of transactions that are queued instead of being accepted immediately, subtract the number in XMCAI from the number of transactions that continued to attempt to be accepted. Next, the queued transactions might be purged whilst queuing -- the number of transactions that have this experience is in statistics field XMCPWQ. Finally, the number of transactions that survive the queue and are accepted after queuing is in statistics field XMCAAQ.

Transaction class: Summary resource statistics

Summary statistics are not available online.

Table 146. Transaction class: Summary resource statistics
DFHSTUP name Description
Tclass Name is the 8 character name of the transaction class.

 

Max Act The maximum number of transactions in the named tclass that may be active concurrently.

 

Purge Thresh The queue limit at which transactions in the named tclass will be purged instead of being added to the queue of transactions that are waiting for membership of the transaction class.

 

Total
-Attaches is the total number of attach requests made for transactions in this transaction class.

 

-AccptImm The total number of transactions that did not have to queue to become active in this transaction class.

 

-PurgdImm The total number of transactions that were purged immediately because they made the queue reach the purge threshold for this transaction class.

 

-Queued The total number of transactions that have been made to queue in this transaction class.

 

-PurgQ'd The total number of transactions that have been purged whilst queuing for acceptance into the transaction class. This includes those transactions purged explicitly via Master Terminal, or implicitly via the purge threshold of the transaction class being lowered.

 

-Queuing-Time The total time spent waiting by those transactions that were queued. Note this time only includes the time spent by those have finished queuing. In order to calculate the average queuing time, current queue must be subtracted from the 'queued' count.

 

Peak Act The highest number of active transactions reached in the transaction class.

 

Peak Queued The highest number of transactions queued waiting for admittance to the transaction class.

 

Times Max Act The total number of separate times that the number of active transactions in the transaction class was equal to the maximum value.

 

Times PurgeThr The total number of separate times that the purge threshold has been reached.

 

Average Queuing-Time The average time spent waiting by those transactions that were queued.

 

Related reference
Back to full list of statistics and DFHSTUP reports
Appendix A. CICS statistics tables
Interpreting these statistics
Interpreting transaction class (TRANCLASS) statistics
DFH0STAT reports for these statistics
Transaction Classes Report
[[ Contents Previous Page | Next Page Index ]]