Terminal control statistics

There are a number of ways in which terminal statistics are important for performance analysis. From them, you can get the number of inputs and outputs, that is, the loading of the system by end users. Line-transmission faults and transaction faults are shown (these both have a negative influence on performance behavior).

This section contains the following statistics:

Terminal control: Resource statistics

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

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

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

Table 143. Terminal control: Resource statistics
DFHSTUP name Field name Description
Term Id A06TETI is the identifier of each terminal, which may have been statically defined using CEDA or the TCT, 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 the CICS Application Programming Reference. .

Reset characteristic: not reset

 

Acc Meth A06EAMIB Start of changeis the terminal access method as defined in the TCT. This may be "SNA1", "MRO", "GAM", "TCAM", "SNA2", "BSAM", or "VTAM". For more information about access methods and their codes, see the DFHTCTTE DSECT in the CICS Data Areas guide.

Reset characteristic: not reset

 

End of change
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

 

Notes:
  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.

Terminal control: Summary resource statistics

Summary statistics are not available online.

Table 144. Terminal control: Summary resource statistics
DFHSTUP name Description
Term Id is the identifier of each terminal, which may have been statically defined using CEDA or the TCT, autoinstalled, or generated from the SESSIONS definition for a connection.

 

LUname is the terminal LU name.

 

Terminal Type is the terminal type as defined in the TCT. For information about terminal types and their codes, see the CICS Application Programming Reference.

 

Acc Meth Start of changeis the terminal access method as defined in the TCT. This may be "SNA1", "MRO", "GAM", "TCAM", "SNA2", "BSAM", or "VTAM". For more information about access methods and their codes, see the DFHTCTTE DSECT in the CICS Data Areas guide.

 

End of change
Conn ID is the last value found for the owning connection name for this terminal/session.

 

No. of Xactions 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.

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

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 is the number of storage violations that have occurred on this terminal.

 

Input Messages See note.

 

Output Messages See note.

 

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

 

Pipeline Message: Avg TIOA Storage is the average TIOA storage used by this terminal.

 

Pipeline Message: Avg logged on time is the average logged on time for an autoinstalled terminal/session. This field is blank if the terminal/session is not autoinstalled.

 

Note:
Input messages and output messages 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.

Related reference
Back to full list of statistics and DFHSTUP reports
Appendix A. CICS statistics tables
Interpreting these statistics
Interpreting terminal statistics
DFH0STAT reports for these statistics
not available
[[ Contents Previous Page | Next Page Index ]]