TCPIP Connection Data Attributes
Use these attributes to view TCP/IP connections.
Address Space ID The MVS address space ID of the address space that opened the socket. This is a 4-digit hexadecimal number.
AT-TLS Cipher The negotiated cipher that is used by the secure connection. This value, which is shown as a hexadecimal code, applies only if AT-TLS Connection Status has a value of Secure. For valid values, see information about the TTLSCipherParms statement in the z/OS Communications Server: IP Configuration Reference.
AT-TLS Connection Status The current application transparent transport layer security (AT-TLS) policy status for the connection. The following values are valid:
- Not_Secure (1): The SSL handshake has not completed successfully. A connection can have this status for several reasons, and AT-TLS Policy Status should be examined. If AT-TLS Policy Status is No_TTLS, No_Policy, or Not_Enabled, the handshake does not occur. If AT-TLS Policy Status is Enabled, Appl_Cntl, or Not_Known, the SSL handshake might occur.
- In_Progress (2): The SSL handshake for the connection is in progress.
- Secure (3): The connection is secure. The SSL handshake completed successfully.
AT-TLS Partner Userid The user ID associated with the certificate of the partner. This value is applicable only if AT-TLS Connection Status has a value of Secure and a user ID is associated with the certificate of the partner.
AT-TLS Policy Status The AT-TLS status for the connection. The following values are valid:
- Not_Known (0): The TCP/IP stack has not examined the AT-TLS configuration for the connection because the connection has not progressed to a state where the stack is ready to process this information.
- No_TTLS (1): NOTTLS was specified or was the default in the TCP/IP configuration profile when the AT-TLS configuration was examined for the connection. AT-TLS processing is not performed for the connection.
- No_ Policy (2): No AT-TLS policy is defined for the connection. AT-TLS processing is not performed for the connection.
- Not_Enabled (3): An AT-TLS policy is configured for this connection, but the TTLSEnabled parameter is set to OFF. AT-TLS processing is not performed for this connection.
- Enabled (4): An AT-TLS policy is configured for this connection, and the TTLSEnabled parameter is set to ON. AT-TLS processing is performed for this connection.
- Appl_Cntrl (5): An AT-TLS policy is configured for the connection, and the ApplicationControlled parameter is set to ON. The application that owns the connection is to tell the TCP/IP stack when to perform the secure handshake.
AT-TLS Security Type The type of system SSL secure session defined in the AT-TLS policy that is used by the connection. The following values are valid:
- N/A (0): Not applicable because AT-TLS Policy Status has a value other than Enabled or Appl Cntrl.
- Client (1): The SSL handshake is performed as a client.
- Server (2): The SSL handshake is performed as a server.
- SRVCAPASS (3): The SSL handshake is performed as a server requiring client authentication, but the client certificate validation is bypassed.
- SRVCAFULL (4): The SSL handshake is performed as a server requiring client authentication, and, if the client presents a certificate, client certificate validation is performed.
- SRVCAREQD (5): The SSL handshake is performed as a server requiring client authentication, and the client must present a certificate so that client certificate validation can be performed.
- SRVCASAFCHK (6): The SSL handshake is performed as a server requiring client authentication; the client must present a certificate so that client certificate validation can be performed, and the client certificate must have an associated user ID defined to the security product.
AT-TLS SSL Protocol The negotiated SSL protocol in use by the connection. The following values are valid:
- SSL_V2: SSL Version 2
- SSL_V3: SSL Version 3
- TLS_V1: TLS Version 1
- N/A: Not applicable
Byte Rate The number of bytes that were sent or received per minute during the most recent time interval.
Bytes Received The number of bytes that were received during the most recent time interval.
Bytes Received String The number of bytes that were received during the most recent time interval, formatted as a string.
Bytes Sent The number of bytes that were sent during the most recent time interval.
Bytes Sent or Received The number of bytes that were sent or received during the most recent time interval.
Bytes Sent or Received String The number of bytes that were sent or received during the most recent time interval, formatted as a string.
Bytes Sent String The number of bytes that were sent during the most recent time interval, formatted as a string.
Collection Time The date and time of the data sampling. By default, this value is displayed as MM/DD/YY hh:mm:ss, where MM is the month, DD is the day, YY is the year, hh is the hour, mm is the minute, and ss is the second.
Connection ID The hexadecimal representation of the connection number.
Connection Start Time The date and time that the connection started. By default, this value is displayed as MM/DD/YY hh:mm:ss, where MM is the month, DD is the day, YY is the year, hh is the hour, mm is the minute, and ss is the second.
Connection State The state of the connection. The following values are valid:
- CLOSED (1): The connection has ended and no longer exists.
- LISTENING (2): The connection is waiting for a connection request from any remote TCP and port.
- SYN_SENT (3): The connection is waiting for a matching connection request after sending a connection request. If a connection is in this state for two successive sample intervals, an exception is generated.
- SYN_RECEIVED (4): The connection is waiting for a confirming connection request acknowledgment after receiving and sending a connection request.
- ESTABLISHED (5): The connection is established.
- FIN_WAIT_1 (6): The connection is waiting for a connection stop request from the remote TCP or an acknowledgment of the connection stop request.
- FIN_WAIT_2 (7): The connection is waiting for a connection stop request from the remote TCP.
- CLOSE_WAIT (8): The connection is waiting for a connection stop request from the local port.
- LAST_ACK (9): The connection is waiting for an acknowledgment of the connection stop request that it sent to the remote TCP.
- CLOSING (10): The connection is waiting for a connection stop request acknowledgment from the remote TCP.
- TIME_WAIT (11): The host is waiting to ensure that a remote TCP has received a connection stop request. When the wait time is over, the socket pair that defines the connection is available for reuse.
- DELETE_TCB (12): The TCP connection has closed, and the resources that represent the connection are waiting to be cleaned up.
Current Send Window Size The current size of the send window.
Interface Name The name of the interface.
Last Activity Remote Timestamp The most recent time stamp value, in milliseconds, received from the remote side of the connection. If the TCP time stamp header option is not used, the value of this field is zero. If the TCP time stamp header option is used, this field contains bits 10 - 41 of a related time stamp that is provided by z/OS® Communications Server. The related time stamp is in store clock (STCK) format, which approximately indicates units of seconds. To convert this field into a STCK value and then into a date and time, follow these steps:
- Determine the current STCK value by using the following NetView® command:PIPE EDIT IFRAUGMT C2X|CONS
- Prefix bits 0 - 9 of the current STCK value to the field; if that conversion yields a time in the future, then subtract 1 from bits 0 - 9 of the current STCK value and prefix that value to the field instead.
- To convert the resulting STCK value (the field with the prefix added) to a date and time, run the following NetView command:PIPE EDIT 'resulting_STCK_value'X ZDT 1|CONS
Last Activity Timestamp The date and time of the last activity on this connection. By default, this value is displayed as MM/DD/YY hh:mm:ss, where MM is the month, DD is the day, YY is the year, hh is the hour, mm is the minute, and ss is the second.
Last Timestamp Age The time, in milliseconds, when the most recent time stamp from the partner was updated. If the TCP time stamp header option is not used, the value of this field is zero. If the TCP time stamp header option is used, this field contains bits 10 - 41 of a related time stamp that is provided by z/OS Communications Server. The related time stamp is in store clock (STCK) format, which approximately indicates units of seconds. To convert this field into a STCK value and then into a date and time, follow these steps:
- Determine the current STCK value by using the following NetView command:PIPE EDIT IFRAUGMT C2X|CONS
- Prefix bits 0 - 9 of the current STCK value to the field; if that conversion yields a time in the future, then subtract 1 from bits 0 - 9 of the current STCK value and prefix that value to the field instead.
- To convert the resulting STCK value (the field with the prefix added) to a date and time, run the following NetView command:PIPE EDIT 'resulting_STCK_value'X ZDT 1|CONS
Local IP Address The local IP address for this TCP connection. IPv4 and IPv6 addresses can be displayed.
Local Port The local port for this TCP connection.
Local Port String The local port for this TCP connection, formatted as a string.
Max Send Window Size The maximum size of the send window.
Number of Duplicate ACKS The number of duplicate acknowledgments that are received by this connection.
Origin Node The parent node of the workspace.
Passive or Active Open The type of open performed. The following values are valid:
- 0: Passive open; the remote end initiated the connection.
- 1: Active open; the local end initiated the connection.
Percent Segments Retransmitted The percent of TCP segments that were retransmitted over this connection since the connection started.
Remote IP Address The remote IP address for this TCP connection. IPv4 and IPv6 addresses can be displayed.
Remote Port The remote port for this TCP connection.
Remote Port String The remote port for this TCP connection, formatted as a string.
Resource Name The text identification of the resource. This value represents the user who opened the socket. It is updated during bind processing.
Segments Received The number of segments that were received over this connection during the most recent time interval.
Segments Retransmitted The number of segments that were retransmitted over this connection during the most recent time interval.
Segments Sent The number of segments that were sent over this connection during the most recent time interval.
Segments Sent or Received The number of segments that were sent or received over this connection during the most recent time interval.
Sysplex Name The name of the sysplex.
System ID The SMF system ID.
TCB Address The address of the TCB in the address space that opened the socket.
TCPIP Host Name The short TCP/IP host name that was discovered for the TCP/IP job name.
TCPIP Job Name The TCP/IP job name for which a connection endpoint is found.
Telnet APPL Name The target VTAM application name if the TCP connection is for a TN3270 or TN3270E session.
Telnet Logmode The VTAM logmode if the TCP connection is for a TN3270 or TN3270E session.
Telnet LU Name The VTAM LU name if the TCP connection is for a TN3270 or TN3270E session.
Telnet Protocol The Telnet mode. Valid values are TN3270, TN3270E, LINEMODE, and N/A.
Telnet User Client Name The user ID of the client if the TCP connection is for a TN3270 or TN3270E session.
Total Bytes The total number of bytes that were sent and received for this connection since the connection started.
Total Bytes Received The total number of bytes that were received from IP for this connection since the connection started.
Total Bytes Received String The total number of bytes that were received from IP for this connection since the connection started, formatted as a string.
Total Bytes Sent The total number of bytes that were sent to IP for this connection since the connection started.
Total Bytes Sent String The total number of bytes that were sent to IP for this connection since the connection started, formatted as a string.
Total Bytes String The total number of bytes that were sent and received for this connection since the connection started, formatted as a string.
Total Segments The total number of segments that were sent and received for this connection since the connection started.
Total Segments Received The total number of segments that were received from IP for this connection since the connection started.
Total Segments Retransmitted The total number of segments that were retransmitted over this connection since the connection started.
Total Segments Sent The total number of segments that were sent to IP for this connection since the connection started.
zOS Image Name The name of the z/OS operating system for which TCP/IP connection information is requested.