CIO_START (Start Device) sol_ioctl Serial Optical Link Device Handler Operation

Purpose

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

Initiates a session with the Serial Optical Link (SOL) device handler.

Description

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:
  • CIO_OK
  • CIO_NETID_FULL
  • CIO_NETID_DUP
  • CIO_NETID_INV
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.

Execution Environment

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

Return Values

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.