CIO_QUERY (Query Statistics) tsioctl PCI MPQP Device Handler Operation

Purpose

Provides the means to read counter values accumulated by the IBM® ARTIC960Hx PCI adapter (PCI MPQP) and device handler.

Description

The CIO_QUERY operation reads the counter values accumulated by the PCI MPQP device handler. The counters are initialized to 0 by the first tsopen entry point operation.

The CIO_QUERY operation returns the Reliability/Availability/Serviceability field of the define device structure (DDS).

The CIO_QUERY operation functions with a 4-Port Multiprotocol Interface adapter that has been correctly configured for use on a qualified network. Consult the adapter specifications for more information on configuring the adapter and network qualifications.

The t_query_parms Parameter Block

For this operation, the extptr parameter points to an t_query_parms structure. This structure is defined in the /usr/include/sys/mpqp.h file and has the following fields:

Item Description
status Contains additional information about the completion of the status block. Device-dependent codes may also be returned.
CIO_OK Indicates that the operation was successful.
bufptr Specifies the address of a buffer where the returned statistics are to be placed.
buflen Specifies the length of the buffer; it should be at least 45 words long (unsigned long).
reserve Reserved for use in future releases.

Statistics Logged for PCI MPQP Ports

The following statistics are logged for each PCI MPQP port.

Note: When using the X.21 physical interface, X.21 centralized multiport (multidrop) operation on a leased-circuit public data network is not supported.

Execution Environment

The CIO_QUERY operation can be called from the process environment only.

Return Values

Item Description
EFAULT Indicates a specified address is not valid.
EINVAL Indicates a parameter is not valid.
EIO Indicates an error has occurred.
ENOMEM Indicates the operation was unable to allocate the required memory.
ENXIO Indicates an attempt to use unconfigured device.