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

X25_COUNTER_WAIT (Wait Counter) x25sioctl X.25 Device Handler Operation

Purpose

Waits for the contents of counters to change.

Description

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

The X25_COUNTER_WAIT x25sioctl operation waits for the contents of a counter to change. The process that called this operation is suspended until the value of one of its counters exceeds the value specified by the counter_value field.

For the X25_COUNTER_WAIT operation, the arg parameter points to the x25_counter_list structure. This structure contains the following fields:

counter_num Identifies the number of elements in the counter array.
counter_array Specifies an array of the following:
flags Indicates if the counter information was successfully matched. If successful, the top bit of the flags field is set on the return of the Counter Wait operation.
counter_id Identifies the counter to wait on.
counter_value Specifies the value the counter must exceed in order for the counters to match successfully.

Execution Environment

The X25_COUNTER_WAIT 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.
EIDRM Indicates the counter has been removed.
EINVAL Indicates one or more of the counters in the list does not exist.
ENOMEM Indicates the operation ran out of memory.

Implementation Specifics

The X25_COUNTER_WAIT 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_COUNTER_GET x25sioctl X.25 Device Handler Operation, X25_COUNTER_READ x25sioctl X.25 Device Handler Operation, X25_COUNTER_REMOVE x25sioctl X.25 Device Handler Operation.

The x25sioctl entry point.

Using Counters to Correlate Messages in AIX Communications Programming Concepts.


[ Previous | Next | Contents | Search ]