[ Previous |
Next |
Contents |
Home |
Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 2
CIO_QUERY (Query Statistics) mpioctl MPQP Device Handler Operation
Purpose
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 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:
| 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.
The CIO_QUERY operation can be called from the process environment only.
Return Values
| 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. |
Implementation Specifics
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.
Related Information
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.
[ Previous |
Next |
Contents |
Home |
Search ]