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

X25_COUNTER_GET (Get Counter) x25sioctl X.25 Device Handler Operation


Gets a counter for asynchronous notification.


Note: Only user-mode processes can use counter operations.

The X25_COUNTER_GET x25sioctl operation uses the arg parameter to return a counter ID. The ID can be used to wait and test for incoming X.25 data.

Execution Environment

The X25_COUNTER_GET 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:

EFAULT Indicates a specified address is not valid.
ENOSPC Indicates there are no counters available to allocate.

Implementation Specifics

The X25_COUNTER_GET 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 x25sioctl entry point.

The X25_COUNTER_READ x25sioctl X.25 Device Handler Operation, X25_COUNTER_REMOVE x25sioctl X.25 Device Handler Operation, X25_COUNTER_WAIT x25sioctl X.25 Device Handler Operation.

Using Counters to Correlate Messages in AIX Communications Programming Concepts.

[ Previous | Next | Contents | Search ]