TCP Listener Attributes

Use the TCP Listener attributes to display performance and identifying information for a specific listener connection.

Accepted Connections The number of connections accepted by this listener during the most recent time interval. The format is an integer.

Active Connections The number of current connections. The format is an integer.

Active Connection High Water Mark The high-water mark, which is the highest value recorded in the active connections field, for this listener. The format is an integer.

APPLDATA The result of an SIOCSAPPLDATA ioctl query. Use the APPLDATA attribute to enable applications to associate 40 bytes of application-specific information with TCP sockets that they own. This information can assist problem determination, capacity planning, and accounting applications. The format is a string of up to 40 bytes.

For additional information, see the application data appendix in the IBM z/OS Communications Sever: IP Configuration Reference.

Application Name The job name associated with the application address space that opened and bound the socket. The format is a string up to 8 characters in length.

ASID The z/OS address space ID of the address space that opened the socket. This value is displayed as a 4-digit hexadecimal value.

Backlog Connections Rejected The number of connections rejected during the most recent time interval because the backlog limit was exceeded before the listener was able to accept the waiting connections. z/OS Communications Server rejects a new connection when the number of connections waiting to be accepted exceeds the backlog limit for a listener. The format is an integer.

Backlog Connections Rejected Time Stamp The date and time that a connection was most recently rejected because the backlog limit was exceeded. The format of date and time is determined by the date and time formats specified in User Preferences. The time stamp reflects the time zone specified in User Preferences. This time is displayed in the following format:

mm/dd/yy hh:mm:ss (Tivoli Enterprise Portal) or yy/mm/dd hh:mm:ss (3270)

Where:

This value is stored as a string no longer than 16 characters in the format CYYMMDDHHMMSSmmm (as in 1020315064501000 for 03/15/02 06:45:01) where:

When no connections have been rejected, this value is stored as a character string of zeros and displayed as blank.

Backlog Limit The maximum number of connections allowed in backlog at one time. The format is an integer.

Bytes Received The number of bytes received on all connections for this listener that existed at the end of the most recent time interval. The format is a long long integer.

Bytes Sent The number of bytes sent on all connections for this listener that existed at the end of the most recent time interval. The format is a long long integer.

Bytes Sent or Received The number of bytes received or sent on all connections for this listener that existed at the end of the most recent time interval. The format is a long long integer.

Collection Time The time and date of the data sampling. This time is displayed in the following format:

mm/dd/yy hh:mm:ss (Tivoli Enterprise Portal) or yy/mm/dd hh:mm:ss (3270)

Where:

The stored format is a string no longer than 16 characters in the format CYYMMDDHHMMSSmmm (as in 1020315064501000 for 03/15/02 06:45:01) where:

Connection Flood Indicates if this server is under a potential connection flood attack. Valid values are:

Connection Rate The average number of accepted connections, per minute, during the most recent time interval. The format is an integer.

Connections in Backlog The current number of connections in backlog. The format is an integer.

Current Non-SMC Connections Number of active connections to this server that are not using SMC. The format is an integer

DVIPA Whether the listener socket supports Dynamic Virtual IP Addressing (DVIPA). This value is stored as an integer and displayed as a string. The following values are valid:

DVIPA Quiesced Whether or not Dynamic Virtual IP Addressing (DVIPA) associated with the listener socket has quiesced. This value is stored as an integer and displayed as a string. The following are valid:

Established Connections in Backlog The number of Connections in Backlog that are established. The format is an unsigned integer.

FRCA Connections in Backlog The number of Connections in Backlog that are established Fast Response Cache Accelerator (FRCA) connections not presented to be accepted by the application. The format is an unsigned integer.

Hex Connection Number The hexadecimal representation of the connection number. The format is an 8-digit hexadecimal string.

Idle Time Since Last Accept The amount of time, in hours, that the server has been idle since the most recent connection was accepted. This value is stored in hundreds of an hour (for example, one hour is stored as 100) and displayed as a real number.

Listener Type Indicates whether this listener is for a TN3270 server. A value of x’01’ indicates that the listener is for a TN3270 Server. The format is an unsigned integer. The following are valid values:

Local IP Address The local IP address for this connection. This IP address is 0 (zero) when the application accepts connections to any local IP address. The format is a string up to 45 characters in length.

Local Port The local port for this connection. The format is a four-byte integer.

Local Port (deprecated) The local port for this connection, as a two-byte integer.

LPAR Name The LPAR name. The format is a string of no more than 8 characters.

Non-Secure Connections The current number of TCP connections for this listener that have an AT-TLS status other than Secure.

Origin Node The unique identifier for the TCP/IP stack being displayed. The format is a string up to 32 characters in length.

Percent Active Connections The number of active connections in this collection interval as a percentage of the active connections high-water mark. The format is an integer.

Percent Non-Secure Connections The percentage of current TCP connections for this listener that have an AT-TLS status other than Secure. The format is an integer.

Percent SMC-D Connections The percentage of current connections that are using SMC-D compared to Active Connections. The format is an integer.

Percent SMC-R Connections The percentage of current connections that are using SMC-R compared to Active Connections. The format is an integer.

Percent Secure Connections The percentage of current TCP connections for this listener that have an AT-TLS status of Secure. The format is an integer.

Secure Connections The current number of TCP connections for this listener that have an AT-TLS status of Secure. The format is an integer.

Server Up Time The amount of time, in hours, that the listener has been active. The format is a real number.

SMC Auto Configured Indicates whether or not the AutoSMC function is active (GLOBALCONFIG SMCGLOBAL AUTOSMC statement in the current TCP/IP profile). The following values are valid:

SMC Auto Percent Percentage of connections requesting SMC whose workload pattern matched SMC criteria during the last AutoSMC function interval. A value of -1, displayed as 'N/A', indicates that there were not enough connections to analyze in the last AutoSMC funnction interval. This field is only meaningful if the SMC Port Configured attribute has a value of No.

SMC-D Configured Indicates whether or not SMC-D is currently configured on this stack or has been configured since the TCP/IP stack was started. The following values are valid:

SMC-D Connections The number of connections that this server has accepted during the most recent time interval that are using SMC-D. The format is an integer.

SMC-D Conn Rate The number of connections that this server has accepted per minute during the most recent time interval that are using SMC-D. The format is an integer.

SMC-D Current Connections Number of active connections to this server that are using SMC-D. The format is an integer.

SMC-D Total Connections The total number of connections that this server has accepted that are using SMC-R. The format is an integer.

SMC Port Configured If Yes, the setting of the Use SMC attribute is due to the specification of the NOSMC or SMC parameters on the PORT or PORTRANGE profile statement for the server's port. If No, then the setting of the Use SMC flag is the result of the AutoSMC function (GLOBALCONFIG SMCCGLOBAL AUTOSMC). This flag is only valid when Auto SMC is Yes. The following values are valid:

SMC-R Configured Indicates if the TCP/IP stack is configured with SMC-R and at least one PFID. The following values are valid:

SMC-R Connections The number of connections that this server has accepted. The format is an integer.

SMC-R Conn Rate The number of connections that this server has accepted per minute during the most recent time interval that are using SMC-R. The format is an integer.

SMC-R Current Connections Number of active connections to this server that are using SMC-R. The format is an integer.

SMC-R Total Connections The total number of connections that this server has accepted that are using SMC-R. The format is an integer.

Sysplex Name The name of the sysplex that the monitored system is part of. The format is a string of up to 8 characters.

System ID The SMF system ID. The format is a string up to 4 characters in length.

TCPIP STC Name The TCP/IP job name. The format is a string up to 8 characters in length.

Time Stamp for Active Connections High Water Mark The date and time when the highest value was recorded for the active connections. This time is displayed on the interface in the following format:

mm/dd/yy hh:mm:ss (Tivoli Enterprise Portal) or yy/mm/dd hh:mm:ss (3270)

Where:

The stored format is a string no longer than 16 characters in the format CYYMMDDHHMMSSmmm (as in 1020315064501000 for 03/15/02 06:45:01) where:

Total Backlog Connections Rejected The total number of connections rejected because the backlog limit was exceeded before the listener was able to accept the waiting connections. z/OS Communications Server rejects a new connection when the number of connections waiting to be accepted exceeds the backlog limit for a listener. The format is an unsigned integer.

Total Bytes The total number of bytes received or sent on all connections for this listener that existed at the end of the most recent time interval. The format is a long long integer.

Total Bytes Received The total number of bytes received on all connections for this listener that existed at the end of the most recent time interval. The format is a long long integer.

Total Bytes Sent The total number of bytes sent on all connections for this listener that existed at the end of the most recent time interval. The format is a long long integer.

Total Conn Accepted The total number of connections accepted by this listener since the listener started. The format is an integer.

Total Non-SMC Connections The total number of connections that this server has accepted that are not using SMC. The format is an integer.

Use SMC Indicates if the server connection workload favors SMC or TCP when this TCP Listener accepts new connections. This flag is only valid when Auto SMC is Yes. The following values are valid: