Enables or disables receiving data packets on a port.
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.
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:
The X25_LOCAL_BUSY operation can be called from the process environment only.
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. |
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.
The x25sioctl entry point.