[ Previous | Next | Contents | Search ]
AIXLink/X.25 1.1 for AIX: Guide and Reference

X25_LINK_CONNECT (Connect Link) x25sioctl Operation

Purpose

Connects the link to the data circuit-terminating equipment (DCE).

Description

Note: Only a process that has opened the router special file can issue the X25_LINK_CONNECT operation.

The X25_LINK_CONNECT x25sioctl operation connects the X.25 link to the network. If required, the connection is made using the automatic calling unit (ACU). If the link is already connected, no action is taken.

For the X25_LINK_CONNECT operation, the arg parameter points to the x25_connect_data structure. This structure contains only a status field. This field has meaning only when the return code is EIO.

Execution Environment

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

Return Values

A return code of -1 indicates an unsuccessful operation. If -1 is returned, the kernel sets the errno global variable to one of the following values:

EACCES Indicates the calling application does not have root authority.
EIO Indicates an I/O error occurred. The status field in the x25_connect_data structure contains one of the following values:
CIO_BAD_MICROCODE
                          Indicates that the microcode download failed.
CIO_HARD_FAIL
                          Indicates that a hardware failure was detected.
CIO_TIMEOUT
                          Indicates that a time out occurred.
ENOBUFS Indicates no buffers are available.

Implementation Specifics

The X25_LINK_CONNECT operation functions with an X.25 Interface Co-Processor/2 that has been correctly configured for use on a qualified network. Consult adapter specifications for more information on configuring the adapter and network qualifications.

Related Information

The X25_LINK_DISCONNECT x25sioctl operation, X25_LINK_STATUS x25sioctl operation.

The x25sioctl entry point.


[ Previous | Next | Contents | Search ]