Provides the means to read counter values accumulated by the IBM® ARTIC960Hx PCI adapter (PCI MPQP) and device handler.
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.
The CIO_QUERY operation can be called from the process environment only.
| 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. |