CIO_QUERY (Query Statistics) sol_ioctl Serial Optical Link Device Handler Operation

Purpose

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

Enables the caller to read the counter values accumulated by the Serial Optical Link (SOL) device handler.

Description

The CIO_QUERY operation reads the counter values accumulated by the SOL device handler. The first call to the sol_open entry point initializes the counters to 0.

For the CIO_QUERY operation, the arg parameter points to the query_parms structure. This structure is defined in the /usr/include/sys/comio.h file and contains the following fields:

Field Description
status Indicates the status of the command. This field may have a value of CIO_OK or CIO_INV_CMD.
bufptr Specifies the address of a buffer where the returned statistics are to be placed.
buflen Specifies the length of the buffer.
clearall When the value of this field is CIO_QUERY_CLEAR, the counters are cleared upon completion of the call. The CIO_QUERY_CLEAR label can be found in the /usr/include/sys/comio.h file.

The counters placed in the supplied buffer by the CIO_QUERY operation are the counters declared in the sol_query_stats_t structure defined in the /usr/include/sys/soluser.h file.

The CIO_QUERY operation functions with a Serial Link Adapter and Serial Optical Channel Converter that have been correctly configured for use on a qualified network. Consult the hardware specifications for more information on configuring hardware and network qualifications.

Execution Environment

The CIO_QUERY operation can be called from the process environment only.

Return Values

Item Description
EFAULT Indicates the specified address is not valid.
EINVAL Indicates the parameter is not valid.
EIO Indicates a general error. If an extension was provided in the call, additional data identifying the cause of the error can be found in the status field.
ENODEV Indicates the specified minor number is not valid.