CIO_QUERY (Query Statistics) mpioctl MPQP Device Handler Operation

Purpose

Note: This function is supported in AIX® 5.1 and earlier only.

Provides the means to read counter values accumulated by the Multiprotocol Quad Port (MPQP) device handler.

Description

The CIO_QUERY operation reads the counter values accumulated by the MPQP device handler. The counters are initialized to 0 (zero) by the first mpopen 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:

Field	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 MPQP Ports

The following statistics are logged for each MPQP port.

Bytes transmitted
Bytes received
Frames transmitted
Frames received
Receive errors
Transmission errors
DMA buffer not large enough or not allocated
Autoresponse transmission fail-safe time out
Autoresponse received time out
CTS time out
CTS dropped during transmit
DSR time out
DSR dropped
DSR on before DTR on a switched line
X.21 call-progress signal (CPS)
X.21 unrecognized CPS
X.21 invalid CPS
DCE clear during call establishment
DCE clear during data phase
X.21 T1-T5 time outs
X.21 invalid DCE-provided information (DPI)

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.