[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Technical Reference: Kernel and Subsystems, Volume 2
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
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. |
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.
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]