Provides the means to read counter values accumulated by the Multiprotocol Quad Port (MPQP) device handler.
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).
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:
|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.|
The following statistics are logged for each 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.
The CIO_QUERY operation can be called from the process environment only.
|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.|
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 mpioctl entry point, mpopen entry point.
The CIO_GET_STAT mpioctl MPQP Device Handler Operation, CIO_HALT mpioctl MPQP Device Handler Operation, CIO_START mpioctl MPQP Device Handler Operation, MP_CHG_PARMS mpioctl MPQP Device Handler Operation, MP_START_AR and MP_STOP_AR mpioctl MPQP Device Handler Operations.