KN3 Interface Statistics Attributes

Use the KN3 Interface Statistics attributes to display information about status and data flow through the interface on a z/OS(R) v1r12 or later system. The statistics that are returned by the request are similar to those in the output of the Netstat DEVLINKS/-d report. Statistics are provided for all strategic interface types except for VIPA interfaces; the stack does not maintain counters for VIPA interfaces.

Notes: This attribute group is available only on systems running z/OS v1.12 or later.

Bandwidth Utilization The total percentage of bandwidth being used during the most recent sampling interval. This value is the sum of Transmit Bandwidth Utilization and Receive Bandwidth Utilization. The format is an integer between 0 and 100 inclusive.

Bytes Received The number of input bytes during the most recent sampling interval. The format is an unsigned long long integer.

Bytes Transmitted The number of output bytes during the most recent sampling interval. The format is an unsigned 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

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:

Device or Datapath Status The device or datapath status. This value is stored as an integer and displayed as a string. Valid values are:

Inbound Packet Discard Rate The number of inbound packets that have been discarded per minute during the most recent sampling interval. This rate applies to packets that were chosen to be discarded even though no errors had been detected to prevent them from being delivered to a higher-layer protocol as well as packets discarded due to error. One possible reason for discarding such packets can be to free up buffer space. The format is a four-byte unsigned integer.

Inbound Packets Discarded The number of inbound packets that have been discarded during the most recent sample. This number includes packets that were chosen to be discarded even though no errors had been detected to prevent them from being delivered to a higher-layer protocol. One possible reason for discarding such packets can be to free up buffer space. The format is a four-byte unsigned integer.

Interface Index The interface index. The format is a 4-byte unsigned integer.

Interface Index Specified (not displayed) Indicates whether the workspace is invoked with an Interface Index specified. This value is stored as an integer and displayed as a string. Valid values are:

Interface Name The interface Name. The format is an alphanumeric string no longer than 16 characters.

This value is specified with the intf_name parameter on the INTERFACE statement or the link_name parameter on the LINK statement in the TCPIP.PROFILE dataset. See the z/OS Communications Server IP Configuration Reference for more information about this parameter.

Interface Status The status of this interface. This value is stored as an integer and displayed as a string. Valid values are:

Interface Type The interface type. This value is stored as an integer and displayed as a string. Valid values are:

IP Address Version The version of the IP address for the interface. This value is stored as an integer and displayed as a string. Valid values are:

Multi/Broadcast Receive Packet Rate The number of received broadcast or multicast packet per minute delivered to a higher-layer protocol during the most recent sampling interval. The format is a 4-byte unsigned integer.

Multi/Broadcast Transmit Packet Rate The number of packets transmitted to a broadcast or multicast address per minute during the most recent sampling interval. The format is a 4-byte unsigned integer.

Origin Node An internal node name used to identify the system from which this row of data was obtained. The format is a string up to 32 characters in length.

Outbound Packet Discard Rate The number of outbound packets that has been discarded per minute during the most recent sampling interval. This rate applies to packets that were chosen to be discarded even though no errors had been detected to prevent them from being delivered to a lower-layer protocol as well as packets discarded due to errors. One possible reason for discarding such packets could be to free up buffer space. The format is a four-byte unsigned integer.

Outbound Packets Discarded The number of outbound packets that have been discarded during the most recent sample. This number includes packets that were chosen to be discarded even though no errors had been detected to prevent them from being delivered to a higher-layer protocol. One possible reason for discarding such packets could be to free up buffer space. The format is a four-byte unsigned integer.

Outbound Packets Discarded in Error The number of output packets discarded due to errors other than an out-of-storage condition during the last sampling interval. The format is an unsigned integer.

Percent Inbound Packets in Error The percentage of inbound packets that could not be received during the most recent sampling interval because of errors. The format is an integer between 0 and 100 inclusive.

Percent Outbound Packets in Error The percentage of outbound packets that could not be transmitted during the most recent sampling interval because of errors. The format is an integer between 0 and 100 inclusive.

Percent Packets Discarded The percentage of total interface packets (both transmitted and received) that were discarded during the most recent sampling interval. The format is an integer between 0 and 100 inclusive.

Percent Packets in Error The percentage of total interface packets (both transmitted and received) that were in error during the most recent sampling interval. The format is an integer between 0 and 100 inclusive.

Receive Bandwidth Utilization The percentage of bandwidth being used to receive data during the most recent sampling interval. The format is an integer between 0 and 100 inclusive.

Receive Error Rate The number of inbound packets or transmission units per minute that could not be received during the most recent sampling interval because of errors. The format is a four-byte unsigned integer.

Receive Packet Rate The number of packets received per minute during the most recent sampling interval. This rate applies to packets that were delivered by this sublayer to a higher sublayer and were not addressed to a multicast or broadcast address at this sublayer. The format is an unsigned integer.

Received Packets Discarded in Error The number of input packets discarded due to an error validating the packet during the last collection interval. The format is an unsigned integer.

Reset Time Stamp The time and date when the counters were last reset to zero. 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:

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.

Total Broadcast Packets Received The number of input packets addressed to a broadcast address since the statistics were last reset. The format is an unsigned long long integer.

Total Broadcast Packets Transmitted The number of output packets addressed to a broadcast address since the statistics were last reset. The format is an unsigned long long integer.

Total Bytes Received The number of input bytes since the statistics were last reset. The format is an unsigned long long integer.

Total Bytes Transmitted The number of output bytes since the statistics were last reset. The format is an unsigned long long integer.

Total Inbound Packets Discarded in Error The number of input packets discarded due to an error validating the packet since the statistics were last reset. The format is an unsigned integer.

Total Multicast Packets Received The number of input packets addressed to a multicast address since the statistics were last reset. The format is an unsigned long long integer.

Total Multicast Packets Transmitted The number of output packets addressed to a multicast address since the statistics were last reset. The format is an unsigned long long integer.

Total Outbound Packets Discarded in Error The number of outbound packets discarded due to errors other than an out-of-storage condition since the statistics were last reset. The format is an unsigned integer.

Total Outbound Packets Discarded for No Storage The number of output packets discarded due to an out-of-storage condition since the statistics were last reset. The format is an unsigned integer.

Total Outbound Packets Queued The number of output packets that are queued and waiting for neighbor resolution since the statistics were last reset. The format is an unsigned integer

Total Packets Discarded for Unknown Protocol The number of input packets discarded due to an unknown protocol type since the statistics were last reset. The format is an four-byte unsigned integer.

Total Received Packets Discarded for No Storage The number of input packets discarded due to an out-of-storage condition since the statistics were last reset. The format is an four-byte unsigned integer.

Total Unicast Packets Received The number of input unicast packets not addressed to a multicast or broadcast address since the statistics were last reset. The format is an unsigned long long integer.

Total Unicast Packets Transmitted The number of output packets not addressed to a multicast or broadcast address since the statistics were last reset. The format is an unsigned long long integer

Transmit Bandwidth Utilization The percentage of bandwidth being used to transmit data during the most recent sampling interval. The format is an integer between 0 and 100 inclusive.

Transmit Error Rate The number of outbound packets or transmission units, per minute, that could not be transmitted during the most recent sampling interval because of errors. The format is a four-byte unsigned integer.

Transmit Packet Rate The number of packets sent, per minute, during the most recent sampling interval. This rate applies to packets that higher-level protocols requested be transmitted and were not addressed to a multicast or broadcast address at this sublayer, including those that were discarded or not sent. The format is an unsigned integer.