Terminal control: Resource statistics

You can retrieve terminal control: resource statistics by using the EXEC CICS COLLECT STATISTICS TERMINAL system command. They are mapped by the DFHA06DS DSECT.

These statistics are gathered for each terminal, including ISC and IRC (MRO) sessions.

In addition to this, this DSECT should be used to map the terminal totals record.

Table 1. Terminal control: Resource statistics
DFHSTUP name Field name Description
Term Id A06TETI is the identifier of each terminal, which may have been statically defined, autoinstalled, or generated from the SESSIONS definition for a connection.

Reset characteristic: not reset

LUname A06LUNAM is the terminal LU name.

Reset characteristic: not reset

Terminal Type A06TETT is the terminal type as defined in the TCT. For information about terminal types and their codes, see ASSIGN TERMCODE.

Reset characteristic: not reset

Acc Meth A06EAMIB is the terminal access method as defined in the TCT. This may be “SNA1”, “MRO”, “GAM”, “SNA2”, “BSAM”, or “VTAM” (now the z/OS® Communications Server). For more information about access methods and their codes, see the DFHTCTTE DSECT.

Reset characteristic: not reset

Conn ID A06SYSID is the owning connection name of this terminal/session.

Reset characteristic: not reset

No. of Xactions A06TEOT is the number of transactions, both conversational and pseudoconversational, that were started at this terminal. The transaction count is less than input messages if conversational transactions are being used.

Reset characteristic: reset to zero

When the operator signs off, the transaction count is not reset. At this time, message DFHSN1200 is issued containing the transaction count for that operator.

Xaction Errors A06TEOE is the number of transactions associated with this particular terminal that could not be started. This could mean that a transaction identifier has not been defined in the CSD data set, or that the operator does not have the proper security to enter the transaction, or that the transaction has been disabled.

Reset characteristic: reset to zero

When the operator signs off, the transaction error count is not reset. At this time, message DFHSN1200 is issued containing the transaction error count for that operator.

Storage Viols A06CSVC is the number of storage violations that have occurred on this terminal.

Reset characteristic: reset to zero

Input Messages

For more information see1

A06TENI See note.

Reset characteristic: reset to zero

Output Messages

For more information see 1

A06TENO See note.

Reset characteristic: reset to zero

Xmission Errors A06TETE is the number of errors for this terminal, or the number of disconnects for this session.

Reset characteristic: reset to zero

Pipeline Message: NOT IN THE DFHSTUP REPORT A06TCNT is the total throwaway count.

Reset characteristic: reset to zero

Pipeline Message: NOT IN THE DFHSTUP REPORT A06SCNT is the number of consecutive throwaways.

Reset characteristic: reset to zero

Pipeline Message: NOT IN THE DFHSTUP REPORT A06MCNT is the maximum throwaway count.

Reset characteristic: reset to zero

Pipeline Message: NOT IN THE DFHSTUP REPORT A06PRTY is the terminal priority

Reset characteristic: not reset

Pipeline Message: TIOA Storage A06STG is the TIOA storage allowed at this terminal.

Reset characteristic: reset to zero

Autoinstall Time: Logon A06ONTM is time at which this terminal/session was autoinstalled. This time is expressed as hours:minutes:seconds.decimals. The DSECT field contains the value as a store clock (STCK) value in local time.

Reset characteristic: not reset

Autoinstall Time: Logoff A06OFFTM is the time at which this terminal/session was logged off. This time is expressed as hours:minutes:seconds.decimals. The DSECT field contains the value as a store clock (STCK) value in local time.

Note that this field is only set on an Unsolicited Statistics (USS) record.

Reset characteristic: not reset

Autoinstall Time: NOT IN THE DFHSTUP REPORT A06GONTM is the time at which this terminal/session was autoinstalled. The DSECT field contains the value as a store clock (STCK) value in GMT.

Reset characteristic: not reset

Autoinstall Time: NOT IN THE DFHSTUP REPORT A06GOFTM is the time at which this terminal/session was logged off. The DSECT field contains the value as a store clock (STCK) value in GMT.

Note that this field is only set on an Unsolicited Statistics (USS) record.

Reset characteristic: not reset

Note:
  1. Input messages (A06TENI) and output messages (A06TENO) are the amount of message activity per terminal. Input and output messages should represent the message traffic between CICS® and the terminal. Input traffic should be the result of operator initiated input: that is, initial transaction input or input as a result of a conversational read to the terminal. Output messages should be output written by the application program or messages sent by CICS.

    Input and output messages can vary because of differences in the application program being used on different terminals. ATI-initiated transactions would typically not have terminal input but could result in one or many output messages. A batch oriented terminal could initiate a single transaction that did multiple reads to the terminal resulting in multiple input messages. The differences between the remote and local terminal counts may be a result of different applications that run on them. Otherwise, they should be similar.