KN3 Interface Read Queue Attributes

Use the KN3 Interface Read Queue attributes to analyze input at the Data Link Control (DLC) layer level. This layer provides z/OS(R) Communications Server tuning statistics for the following types of interfaces on a z/OS v1r12 or later system:

Some OSA-Express features support up to eight read queues while HiperSockets supports only a single read queue. Data is provided for each read queue associated with the supported datapath device (subchannel address). When interfaces share a datapath device number (data subchannel address), the statistics for each interface sharing the datapath device are identical.

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

Accelerated Bytes The number of received bytes subsequently routed outbound using queued direct I/O (QDIO) routing or the QDIO Accelerator since the statistics were last reset. The format is an unsigned long long integer.

This attribute applies to IPv4 interfaces only.

Accelerated Packets The number of received packets subsequently routed outbound using queued direct I/O (QDIO) routing or the QDIO Accelerator since the statistics were last reset. The format is an unsigned long long integer.

This attribute applies to IPv4 interfaces only.

Average Bytes Per SBAL The average number bytes per used storage block address list (SBAL) since the statistics were last reset. The format is an unsigned long long integer.

Average Packets Per SBAL The average number packets per used storage block address list (SBAL) since the statistics were last reset. 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:

Datapath Device Number The datapath device number. The format is an unsigned 2-byte integer displayed in hexadecimal.

Frame Invalidation Packets The number of frame invalidation packets identified by this interface. The format is an unsigned long long integer.

Frame validation packets are an innovation in OSA-Express3 transparent error handling for the inbound data stream. OSA-Express3 individually marks packets with errors as invalid and z/OS Communications Server later discards packets marked as invalid, reducing the number of unnecessary retransmissions and improving I/O efficiency.

Frame Invalidation Support Indicates whether the Frame Invalidation Packets counter is supported for this interface. If this attribute value is No, the value of the Frame Invalidation Packets attribute is zero. If this attribute value is Yes, the value of the Frame Invalidation Packets attribute may be greater than zero. This value is stored as an integer and displayed as a string. Valid values are:

Frame invalidation packets are packets that were received but were marked not valid by the OSA-Express feature. This marking of packets applies to OSA-Express3 and subsequent OSA features only.

Interface Index (not displayed) The interface index for this interface. The format is an unsigned integer.

Interface Name The interface name sharing the read queue. 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 type of interface. 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 this interface. This value is stored as an integer and displayed as a string. Valid values are:

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.

Percent Accelerated Bytes The percentage of Accelerated QDIO (queued direct I/O) Bytes in comparison to the number of Received Bytes since the statistics were last reset. The format is an integer between 0 and 100 inclusive.

Notes: This attribute applies to IPv4 interfaces only. The value is zero (0) for IPv6 interfaces.

Percent Accelerated Packets The percentage of Accelerated QDIO (queued direct I/O) Packets in comparison to the number of Received Packets since the statistics were last reset. The format is an integer between 0 and 100 inclusive.

Notes: This attribute applies to IPv4 interfaces only. The value is zero (0) for IPv6 interfaces.

Percent Frame Invalidation Packets The percentage of Frame Invalidation Packets in comparison to the number of Received Packets since the statistics were last reset. The format is an integer between 0 and 100 inclusive.

Percent Real PCI The percentage of Real PCI Interrupts in comparison to the number of Total PCI Interrupts since the statistics were last reset. The format is an integer between 0 and 100 inclusive.

Percent Threshold PCI Interrupts The percentage of Threshold Peripheral Component Interconnect (PCI) Interrupts in comparison to the number of Real PCI Interrupts since the statistics were last reset. The format is an integer between 0 and 100 inclusive.

Percent Unproductive PCI Interrupts The percentage of Unproductive Peripheral Component Interconnect (PCI) interrupts in comparison to the number of Real PCI Interrupts since the statistics were last reset. The format is an integer between 0 and 100 inclusive.

Percent Virtual PCI Interrupts The percentage of Virtual Peripheral Component Interconnect (PCI) interrupts in comparison to the number of Total PCI Interrupts since the statistics were last reset. The format is an integer between 0 and 100 inclusive.

QDIO Accelerator Whether or not internal queued direct I/O (QDIO) routing or the QDIO Accelerator is in effect. When this attributed displays as Yes, the following counters are being incremented:

If this attribute displays as No, the counters might be non-zero but are not being incremented. This attribute applies to IPv4 interfaces only. This value is stored as an integer and displayed as a string. Valid values are:

Queue ID The read queue identifier. The format is an unsigned integer.

Queue Workload Name The name that identifies the type of workload with packets that are directed to this queue. The OSA-Express features includes one primary queue and possibly several ancillary queues. The primary queue is used for packets that do not belong on an ancillary queue. For the primary queue, the workload name is always PRIMARY. The format is a string of up to 8 characters.

Read Control Device Number The read control device number. The format is an unsigned integer in hexadecimal format.

Read Processing Deferral Rate The number of read processing deferrals per minute for the PRIMARY read queue during the most recent sampling interval. The format is an integer.

Read Processing Deferrals The number of read processing deferrals for the PRIMARY read queue during the most recent sampling interval. The format is an integer.

Read Replenishment Deferral Rate The number of Read Replenishment Deferrals per minute for the PRIMARY read queue during the most recent sampling interval. The format is an integer.

Read Replenishment Deferrals The number of read replenishment deferrals for the PRIMARY read queue during the most recent sampling interval. The format is an integer.

Reads Exhausted The number of reads exhausted due to full read buffers during the most recent sampling interval. The format is an integer.

Reads Exhausted Rate The number of reads exhausted due to full read buffers per minute during the most recent sampling interval. The format is an integer.

Real PCI Interrupts The number of real Peripheral Component Interconnect (PCI) interrupts since the statistics were last reset. The format is an unsigned long long integer.

A real PCI is an execution of the queued direct I/O (QDIO) Program-Controlled Interrupt Exit as a result of a call from the system interrupt handler. Real PCIs can be viewed as the QDIO datapath device "pushing" read completions to the datapath device driver. The higher the ratio of real PCIs to virtual PCIs, the less successful the QDIO facility is at avoiding the overhead of the system interrupt handler.

Read PCI interrupts are provided for the primary read queue only. The value of this attribute is the sum of the interrupts for all read queues (primary and ancillary).

Received Bytes The number of bytes received by this read queue since the statistics were last reset. The format is an unsigned long long integer.

Received Packets The number of packets received by this read queue since the statistics were last reset. The format is an unsigned long long integer.

Reset Time Stamp The z/OS time stamp when the interface counter values were last reset. 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.

Threshold PCI Interrupts The number of threshold Peripheral Component Interconnect (PCI) interrupts for the PRIMARY read queue since the statistics were last reset. The value is the sum of the interrupts for all read queues (primary and ancillary). The format is an unsigned long long integer.

A threshold PCI is a real PCI generated by the queued direct I/O (QDIO) datapath device because one of the threshold conditions which controls the PCI processing was met. A count of zero indicates the QDIO datapath device driver is providing sufficient resources to keep pace with the inbound data stream from the interface.

A Threshold PCI Interrupt value is provided for the primary Read queue only.

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

Total PCI Interrupts The total number of Peripheral Component Interconnect (PCI) interrupts, including virtual and real interrupts since the statistics were last reset. The format is an unsigned long long integer.

Total Read Processing Deferrals The total number of read processing deferrals for the PRIMARY read queue since the statistics were last reset. The value is the sum of the deferrals for all read queues (primary and ancillary). The format is an unsigned long long integer.

A read processing deferral occurs when the queued direct I/O (QDIO) program-controlled interrupt (PCI) Exit must defer processing a read completion, because a control block cannot be obtained to present the inbound data. Read processing deferrals (along with read replenishment deferrals) can cause the value of the NWMIfStExtRNoReads field to be incremented.

Read processing deferrals are provided only for the primary read queue.

Total Read Replenishment Deferrals The total number of read replenishment deferrals for the PRIMARY read queue since the statistics were last reset. The value is the sum of the deferrals for all read queues (primary and ancillary). The format is an unsigned long long integer.

A read processing deferral occurs when the queued direct I/O (QDIO) program-controlled interrupt (PCI) Exit must defer processing a read completion, because a control block cannot be obtained to present the inbound data. Read processing deferrals (along with read replenishment deferrals) can cause the value of the Total Reads Exhausted attribute to be incremented.

Read Replenishment Deferrals are provided for the primary read queue only.

Total Reads Exhausted The total number of read operations exhausted due to full read buffers since the statistics were last reset. The format is an unsigned long long integer.

If this value is not zero, a lack of read buffers might be indicated for the queued direct I/O (QDIO) datapath device. A lack of read buffers can result in dropped packets, possibly leading to packet retransmission.

TRLE Name The transport resource list (TRL) name for this interface. The format is a string of up to 8 characters.

Unproductive PCI Interrupts The number of unproductive Peripheral Component Interconnect (PCI) interrupts for the PRIMARY read queue since the statistics were last reset. The value is the sum of the interrupts for all read queues (primary and ancillary). The format is an unsigned long long integer.

An unproductive PCI is a real PCI where the datapath device driver found no reads have completed. Unproductive PCIs primarily occur when the interval between two PCIs is minimal and the first PCI thread has already processed the read completion for which the second PCI was generated.

Unproductive PCI interrupts are provided for the primary read queue only.

Used SBALs The number of storage block address list control blocks (SBALs) used since the statistics were last reset. The format is an unsigned long long integer.

For OSA-Express interfaces, an SBAL represents 16 4K read buffers (a single 64K read). For HiperSockets interfaces, the SBAL size is variable. For a specific read operation, not all of the buffers may be used (some might contain inbound packets, for example).

Virtual PCI Interrupts The number of virtual Peripheral Component Interconnect (PCI) interrupts for the PRIMARY read queue since the statistics were last reset. The value is the sum of the interrupts for all read queues (primary and ancillary). The format is an unsigned long long integer.

A virtual PCI is an execution of the queued direct I/O (QDIO) Program-Controlled Interrupt Exit as a result of a call from the datapath device driver. Virtual PCIs can be viewed as the datapath device driver "pulling" read completions from the QDIO datapath device. The higher the ratio of virtual PCI to real PCI, the more successful the QDIO facility is at avoiding the overhead of the system interrupt handler.

Virtual PCI Interrupts are provided for the primary read queue only.