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

X25_LOCAL_BUSY (Local Busy) x25sioctl Operation

Purpose

Enables or disables receiving data packets on a port.

Description

Note: Only the user who called the CIO_START operation can call the X25_LOCAL_BUSY operation.

The X25_LOCAL_BUSY x25sioctl operation enables or disables receiving data and interrupt packets on a given session. This operation can be used to slow down large blocks of received data or reduce the number of buffers required. However, clear-and-reset packets are still passed on.

The effects of disabling received packets do not take place immediately after calling the X25_LOCAL_BUSY operation. Data packets that arrived before the call or packets currently being read off the card are passed on.

The X25_LOCAL_BUSY operation does not affect the outcome of the x25read or x25select entry points. These operations continue to wait for received packets. To query the status of a local busy on a session, use the X25_QUERY_SESSION operation.

Parameter Block

For the X25_LOCAL_BUSY operation, the arg parameter points to a buffer that contains the x25_local_busy structure. This structure contains the following fields:

busy_mode Specifies the handling of data packets in the session. This field accepts one of the following values:
0 Enables the receiving of data on this session.
1 Disables the receiving of data on this session.
session_id Identifies the session to which this operation applies.

Execution Environment

The X25_LOCAL_BUSY 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 call must be made by the user who issued the CIO_START operation.
EFAULT Indicates a specified address was not valid.
EINVAL Indicates the specified session ID was not valid, or the busy_mode field was illegal.

Implementation Specifics

The X25_LOCAL_BUSY 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.

Data Transmission and Reception for the X.25 Device Handler in AIX Kernel Extensions and Device Support Programming Concepts.

The CIO_START x25sioctl operation, X25_QUERY_SESSION x25sioctl operation.

Related Information

The x25sioctl entry point.


[ Previous | Next | Contents | Search ]