Note: This function is supported in AIX® 5.1 and earlier only.
Initiates a session with the Serial Optical Link (SOL) device handler.
The CIO_START operation initiates a session with the SOL device handler. If the start is the first on the device, the device handler initializes and opens the SOL. For each successful CIO_START call issued, there should be a corresponding CIO_HALT operation issued.
After the CIO_START operation has successfully completed, the device is ready to transmit and receive data. The caller is free to issue any valid SOL operation. Once started, the adapter receives packets from any of the available optical ports.
The caller notifies the device handler of the network ID to use. The network ID corresponds to the destination service access point (DSAP) in the packet. The caller can issue multiple CIO_START operations. The SOL device handler can handle from 0 to the number of network IDs specified by the SOL_MAX_NETIDS label. This label is defined in the /usr/include/sys/soluser.h file.
For the CIO_START operation, the arg parameter points to the session_blk 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 CIO_START.
Possible returned
status values are:
|
| netid | Specifies
the network ID the caller uses on the network.
The Network ID is placed in the least significant byte of the netid field.
Note: Only even number IDs are valid. Odd number IDs are reserved
for group IDs not supported for this device and return a status value
of CIO_NETID_INV
|
The CIO_START operation functions with a Serial Link Adapter and Serial Optical Channel Converter that have been correctly configured for use on a qualified network. Consult hardware specifications for more information on configuring hardware and network qualifications.
The CIO_START operation can be called from the process environment only.
| Item | Description |
|---|---|
| EADDRINUSE | Indicates the network ID is in use. |
| EFAULT | Indicates the supplied 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. |
| ENETDOWN | Indicates a hardware error for which there is no recovery. |
| ENODEV | Indicates the specified minor number is not valid. |
| ENOSPC | Indicates the network ID table is full. |