DAT_EVD_CLEAR_UNWAITABLE(3DAT) Direct Access Transport Library Functions

NAME

dat_evd_clear_unwaitable - transition the Event Dispatcher into a
waitable state

SYNOPSIS

cc [ flag... ] file... -ldat [ library... ]
#include <dat/udat.h>

DAT_RETURN
dat_evd_clear_unwaitable(
IN DAT_EVD_HANDLE evd_handle
)

PARAMETERS

evd_handle
Handle for an instance of Event Dispatcher.

DESCRIPTION

The dat_evd_clear_unwaitable() transitions the Event Dispatcher into
a waitable state. In this state, calls to dat_evd_wait(3DAT) are
permitted on the EVD. The actual state of the Event Dispatcher is
accessible through dat_evd_query(3DAT) and is DAT_EVD_WAITABLE after
the return of this operation.


This call does not affect a CNO associated with this EVD at all.
Events arriving on the EVD after it is set waitable still trigger the
CNO (if appropriate), and can be retrieved with
dat_evd_dequeue(3DAT).

RETURN VALUES

DAT_SUCCESS
The operation was successful.


DAT_INVALID_HANDLE
The evd_handle parameter is invalid.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+---------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+---------------------------+
|Interface Stability | Standard: uDAPL, 1.1, 1.2 |
+--------------------+---------------------------+
|MT-Level | Safe |
+--------------------+---------------------------+

SEE ALSO

dat_evd_dequeue(3DAT), dat_evd_query(3DAT),
dat_evd_set_unwaitable(3DAT), dat_evd_wait(3DAT), libdat(3LIB),
attributes(7)

July 16, 2004 DAT_EVD_CLEAR_UNWAITABLE(3DAT)