Use the KN3 Interface Write Queue attributes to display data link control (DLC) tuning statistics for each write queue supported for an active datapath device used by an OSA-Express QDIO ethernet or HiperSockets interface.
Note: This workspace returns data only on systems running z/OS v1.12 or later
Accelerated Bytes The number of transmitted bytes that were routed outbound using internal queued direct I/O (iQDIO) routing or QDIO Accelerator since the statistics were last reset. This attribute applies to IPv4 interfaces only. The format is an unsigned long long integer.
Accelerated Packets The number of transmitted packets that were routed outbound using internal queued direct I/O (iQDIO) routing or QDIO Accelerator since the statistics were last reset. This attribute applies to IPv4 interfaces only. The format is an unsigned long long integer.
Average Active SBALs The average number of active storage block address lists (SBALs) since the statistics were last reset. The format is an unsigned integer between 0 - 128 inclusive.
This counter represents the smoothed average number of SBALs waiting to be written. The average is calculated when the device driver write initiator has built as many writes as possible (due either to no remaining SBALs or no more data to be written) and is about to exit.
Average SBALs Per SIGA The average number of storage block address lists (SBALs) written per signal adapter (SIGA) since the statistics were last reset. The format is an unsigned integer.
For OSA-Express interfaces, an SBAL represents 16 4K write buffers (a single 64K write). For HiperSockets interfaces, the SBAL size is variable. For a specific write operation, all buffers might not be used (for example, those containing outbound packets).
Average Staging Queue Depth The average number of work elements left on the outbound work queue since the statistics were last reset. This format is one of the following:
A nonzero value indicates that the interface is not accepting outbound data as fast as the device driver is presenting it. The maximum number is calculated each time the device driver write initiator has built as many writes as possible (due either to no remaining storage block address lists (SBALs) or no more data to be written) and is about to exit.
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 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:
Interface Index (not displayed) The interface index associated with this interface. The format is an unsigned integer.
Interface Name The interface name sharing the write 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 the associated write queue. This value is stored as an integer and displayed as a string. Valid values are:
iQDIO Multiple Write SIGA Count The number of internal queued direct I/O (iQDIO) multiple write signal adapter (SIGA) instructions issued since the statistics were last reset. This attribute applies to HiperSocket interfaces only when the IQDMULTIWRITE parameter is specified on the GLOBALCONFIG profile statement. The format is an unsigned long long integer.
Maximum Active SBALs The maximum number of active storage block address lists (SBALs) since the statistics were last reset. The format is an unsigned integer between 0 - 128 inclusive.
This counter represents the maximum number of SBALs waiting to be written. The maximum number is calculated each time the device driver write initiator has built as many writes as possible (due either to no remaining SBALs or no more data to be written) and is about to exit.
Maximum Staging Queue Depth The maximum number of work elements that remain on the outbound work queue since the statistics were last reset. The following formats are valid:
A nonzero value indicates that the interface is not accepting outbound data as fast as the device driver is presenting it. The maximum number is calculated each time the device driver write initiator has built as many writes as possible (due either to no remaining storage block address lists (SBALs) or no more data to be written) and is about to exit.
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 outbound bytes that were routed using internal queued direct I/O (iQDIO) routing or QDIO Accelerator 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 outbound packets that were routed using internal queued direct I/O (iQDIO) routing or QDIO Accelerator 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.
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:
QDIO SIGA Count The number of queued direct I/O (QDIO) signal adapter (SIGA) instructions issued since the statistics were last reset. The format is an unsigned long long integer.
A SIGA instruction tells the QDIO interface that data is ready to be written. QDIO interfaces support adding additional writes to a write already in progress, removing the need for a new SIGA instruction. A low value for this counter indicates that write processing is benefitting from this additional QDIO write function.
Queue Priority The queue priority to which the attributes in a row of data pertain. The format is an unsigned integer.
Reset Time Stamp The z/OS time stamp when the counter values 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:
SBALs Per SIGA The number of storage block address lists (SBALs) written per signal adapter (SIGA) during the most recent sampling interval. The format is an unsigned integer.
For OSA-Express interfaces, an SBAL represents 16 4K write buffers (a single 64K write). For HiperSockets interfaces, the SBAL size is variable. For a specific write operation, all buffers might not be used (for example, those containing outbound packets).
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.
Transmitted Bytes The number of transmitted bytes since the statistics were last reset. The format is an unsigned long long integer.
Transmitted Packets The number of transmitted packets since the statistics were last reset. The format is an unsigned long long integer.
TRLE Name The transport resource list (TRL) name for this interface. The format is a string of up to 8 characters.
Used SBALs The number of storage block address list (SBAL) control blocks used since the statistics were last reset. The format is an unsigned long long integer.
For OSA-Express interfaces, an SBAL represents 16 4K write buffers (a single 64K write). For HiperSockets interfaces, the SBAL size is variable. For a specific write operation, all buffers might not be used (for example, those containing outbound packets).
Write Control Device Number The write control device number. The format is an unsigned 2-byte integer displayed in hexadecimal.