Use the TCPIP Details attributes to display performance and identifying information for a specific connection.
APPLDATA The result of a SIOCSAPPLDATA ioctl query. APPLDATA enables 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.
Note: This attribute is available only on systems running z/OS v1.9 or later. On systems before z/OS v1.9, this attribute will display as blank.
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.
Application Name and Port The Application Name and Local Port are combined in this attribute, separated by a colon. The format is a string up to 15 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 number.
AT-TLS Policy Status The current Application Transparent Transport Layer Security (AT-TLS) policy status for the connection. The value returned defines the current runtime status of the AT-TLS policy for the connection. This value is stored and displayed as a string. Valid values for this integer are:
AT-TLS Status The current Application Transparent Transport Layer Security (AT-TLS) status for the connection. This value indicates whether the SSL handshake has completed successfully for the connection. This value has dependency on the value of AT-TLS Policy Status attribute. This value is stored and displayed as a string. Valid values for this integer are:
Byte Rate The number of bytes sent or received per minute during the most recent time interval. The format is an integer.
Bytes Received The number of bytes received during the most recent time interval. The format is an integer.
Bytes Sent The number of bytes sent during the most recent time interval. The format is an integer.
Bytes Sent or Received The number of sent or received bytes during the most recent time interval. The format is an 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
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:
Congestion Window Size The congestion window size for this connection. Congestion window size is the maximum amount of data that is sent without waiting for an acknowledgment from the remote socket. The format is an unsigned integer.
The value that is used when congestion is detected in the network to limit the amount of data that is sent by the local stack.
Connection Duration The amount of time, in seconds, since this connection was created. The format is an integer.
Connection Start Time The time and date when this connection was created. This time is displayed in the following format:
mm/dd/yy hh:mm:ss
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 State The state of the connection. The following are valid values:
DVIPA Identifies when the Local IP Address is a Dynamic Virtual IP Addressing (DVIPA) address. This value is stored as an integer and displayed as a string. The following are valid values:
: This information is available only on z/OS V1.9 or higher.
Duplicate ACKs The number of duplicate ACKs (TCP acknowledgements) received for this connection. The format is an unsigned integer.
Hex Connection Number The hexadecimal representation of the connection number. The format is an 8-digit hexadecimal string.
Inbound Bytes Buffered The number of incoming bytes buffered by this connection. The format is an unsigned integer.
Inbound Interface Name The link name of the receiving interface for this connection. The format is a string up to 16 characters in length.
Notes:
Inbound Queued Data Time Stamp The time stamp of the oldest inbound data that was queued. This time is displayed in the following format:
mm/dd/yy hh:mm:ss
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:
Note: This attribute is available only on systems running z/OS v1.10 or later. On systems before z/OS v1.10 or if no inbound data has been queued, this attribute will display as blank.
Local IP Address The local IP address for this connection. The format is a string up to 45 characters in length.
Local Port The local port for this connection. The format is an integer.
Local Port String The local port for this connection as a string. The format is a string up to five characters in length.
Local Window Size Frequency The number of times the local window size was set to zero during the most recent time interval. The format is an integer.
Maximum Segment Size The maximum segment size the connection can send. The largest amount of data the local socket can send in a single packet. The format is an unsigned integer.
Maximum Send Window Size The maximum send window size for the connection. The format is an unsigned integer.
Negotiated Cipher The negotiated cipher that is in use by the secure connection. This value is used for the data encryption or decryption. See the description of the TTLSCipherParms statement in the "Policy Agent and Policy Applications" chapter of the IBM z/OS Communications Server: IP Configuration Reference v1.12 book for a list of possible cipher values. This value is applicable only if the value for AT-TLS Status is Secure. This value is stored and displayed as a string. Valid values for this integer are:
Negotiated SSL Protocol The negotiated SSL protocol in use by the connection. This value is applicable only when the value for AT-TLS Status is Secure. This value is stored and displayed as a string. Valid values for this integer are:
Open Type The type of open performed for this connection. This value is stored and displayed as a string. Valid values for this integer are:
Origin Node The unique identifier for the TCP/IP stack being displayed. The format is an alphanumeric string no longer than 32 characters.
Out of Order Segments The number of out-of-order segments received during the most recent time interval. The format is an integer.
Outbound Bytes Buffered The number of outgoing bytes buffered by this connection. The format is an unsigned integer.
Outbound Interface Name The name of the interface used to send the most recent segment. The format is a string up to 16 characters in length.
Outbound Queued Data Time Stamp The time and date of the oldest queued data waiting to be sent. This time is displayed in the following format:
mm/dd/yy hh:mm:ss
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:
Note: This attribute is available only on systems running z/OS v1.10 or later. On systems before z/OS v1.10 or if no inbound data has been queued, this attribute will display as blank.
Partner User ID The user ID associated with the partner's certificate. This value is applicable only if the value for AT-TLS Status is Secure. The format is a string of up to 8 characters.
Percent Out of Order Segments The percentage of segments received that was out of order during the most recent time interval. The range for this value is from 0% to 100%.
Percent Segments Retransmitted The percentage of TCP segments that required retransmission over this connection. The range for this value is from 0% to 100%.
Receive Buffer Size The receive buffer size for the connection. The format is an unsigned integer.
Receive Byte Rate The number of bytes received, per minute, during the most recent time interval. The format is an integer.
Receive Segment Rate The number of segments received, per minute, during the most recent time interval. The format is an integer.
Registered Ancillary Inbound Queue An indicator of whether the TCP connection is registered with a TCP bulk data ancillary inbound queue. Valid values for this integer are:
Note: The attribute is available in a z/OS v1.12 and later environment only.
Remote IP Address The remote IP address for this connection. The format is an alphanumeric string up to 45 characters in length.
Remote Port The remote port for this connection. The format is an integer.
Remote Port String The remote port for this connection as a string. The format is a string up to five characters in length.
Remote Window Size Frequency The number of times the remote window size was set to zero during the most recent time interval. The format is an integer.
Response Time The elapsed time (in tenths of a second) from when the segment was sent to when the acknowledgment was received. The format is an integer.
Response Time Variance The statistical variation of round trip times since the connection was established. The format is an integer.
Retransmission Rate The number of segments retransmitted, per minute, during the most recent time interval. The format is an integer.
Segment Rate The number of segments sent or received, per minute, during the most recent time interval. The format is an integer.
Segments Received The number of segments received during the most recent time interval. The format is an integer.
Segments Retransmitted The number of segments retransmitted over this connection during most recent time interval. The format is an integer.
Segments Sent The number of segments sent during the most recent time interval. The format is an integer.
Segments Sent or Received The number of segments sent and received during the most recent time interval. The format is an integer.
Send Buffer Size The send buffer size for the connection. The format is an unsigned integer.
Send Window Size The send window size for the connection. The format is an unsigned integer.
Server Resource ID The numeric identification of the server (that is, the listener connection) associated with this client connection. This value applies only to load-balancing servers that have bound to a port number for which SHAREPORT was specified on the PORT/PORTRANGE profile statement. This value is zero (0) for client connections to servers that are not load-balancing servers. The format is an unsigned integer displayed as an 8-character hexadecimal string.
Slow Start Threshold The slow-start threshold for this connection. The format is an unsigned integer.
The slow-start threshold is used to determine whether the connection is recovering from congestion. If the congestion window is smaller than the slow-start threshold, the connection takes actions to more quickly recover from congestion.
SSL Session Type The type of System SSL secure session defined in AT-TLS policy in use by the connection. These values are specified in AT-TLS policy configuration with the HandshakeRole and ClientAuthType parameters. This value is applicable only when the value for AT-TLS Policy Status is Enabled or ApplicationControlled; otherwise, this value is SSL_Not_Applicable. This value is stored and displayed as a string. Valid values for this integer are:
Sysplex Cluster Connection Type The sysplex cluster connection types for this connection. This value is stored and displayed as a string. Valid values for this integer are:
System ID The SMF system ID. The format is an alphanumeric string no longer than 4 characters.
TCPIP STC Name The TCP/IP job name. The format is an alphanumeric string no longer than 8 characters.
Telnet Appl Name The VTAM application name that Telnet uses. The format is a string no longer than 8 characters.
Telnet Session Type The type of open performed for this connection. This value is stored and displayed as a string. Valid values for this integer are:
Telnet LU Name The VTAM logical unit name that Telnet uses to communicate with a VTAM application on this host. The format is a string no longer than 8 characters.
Time Since Last Activity The time, in seconds, since the most recent activity on this connection. The format is an integer.
TN3270 Client User ID The client user ID if the TCP connection is for a TN3270 or TN3270E session with an application whose access is restricted by a TN3270 profile RESTRICTAPPL parameter. This attribute is available only if the TN3270 client is in session with an application listed in a RESTRICTAPPL statement on the TN3270 server’s profile. For more information about this parameter, see the IBM z/OS Communications Server IP Configuration Reference. The format is a string up to 8 characters in length.
TN3270 Logmode Name The VTAM Logmode if the TCP connection is for a TN3270 or TN3270E session. The format is a string up to 8 characters in length.
Total Bytes The total number of bytes sent and received since the connection started. The format is a long long integer.
Total Bytes (deprecated) The total number of bytes sent and received since the connection started. When the value in the Total Bytes field exceeds 1,073,741,823, the number is divided by 1,073,741,824. The quotient is stored in the Total Bytes (in GB) field and the remainder is stored in the Total Bytes field. The format is an integer.
Total Bytes (in GB) (deprecated) The total number of bytes sent and received since the connection started, divided by 1,073,741,824. When the value in the Total Bytes field exceeds 1,073,741,823 (1 GB), the number is divided by 1,073,741,824. The quotient is stored in the Total Bytes (in GB) field and the remainder is stored in the Total Bytes field. The format is an integer.
Total Bytes Received The total number of bytes received since the connection started. The format is a along long integer.
Total Bytes Received (deprecated) The total number of bytes received since the connection started. When the value in the Total Bytes Received field exceeds 1,073,741,823 (1 GB), the number is divided by 1,073,741,824. The quotient is stored in the Total Bytes Received (in GB) field and the remainder is stored in the Total Bytes Received field. The format is an integer.
Total Bytes Received (in GB) (deprecated) The total number of bytes received since the connection started, divided by 1,073,741,824. When the value in the Total Bytes Received field exceeds 1,073,741,823 (1 GB), the number is divided by 1,073,741,824. The quotient is stored in the Total Bytes Received (in GB) field and the remainder is stored in the Total Bytes Received field. The format is an integer.
Total Bytes Sent The total number of bytes sent since the connection started. The format is a long long integer.
Total Bytes Sent (deprecated) The total number of bytes sent since the connection started. When the value in the Total Bytes Sent field exceeds 1,073,741,823 (1 GB), the number is divided by 1,073,741,824. The quotient is stored in the Total Bytes Sent (in GB) field and the remainder is stored in the Total Bytes Sent field. The format is an integer.
Total Bytes Sent (in GB) (deprecated) The total number of bytes sent since the connection started, divided by 1,073,741,824. When the value in the Total Bytes Sent field exceeds 1,073,741,823 (1 GB), the number is divided by 1,073,741,824. The quotient is stored in the Total Bytes Sent (in GB) field and the remainder is stored in the Total Bytes Sent field. The format is an integer.
Total Out of Order Segments The total number of out-of-order segments received since the connection started. The format is an integer.
Total Segments The total number of segments sent or received since the connection started. The format is an integer.
Total Segments Received The total number of segments received since the connection started. The format is an integer.
Total Segments Retransmitted The total number of segments retransmitted over this connection since the connection started. The format is an integer.
Total Segments Sent The total number of segments sent since the connection started. The format is an integer.
Transmit Byte Rate The number of bytes transmitted, per minute, during the most recent time interval. The format is an integer.
Transmit Segment Rate The number of segments transmitted, per minute, during the most recent time interval. The format is an integer.