DAT_EVD_RESIZE(3DAT) Direct Access Transport Library Functions

NAME

dat_evd_resize - modify the size of the event queue of Event
Dispatcher

SYNOPSIS

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

DAT_RETURN
dat_evd_resize(
IN DAT_EVD_HANDLE evd_handle,
IN DAT_COUNT evd_min_qlen
)

PARAMETERS

evd_handle
Handle for an instance of Event Dispatcher.


evd_min_qlen
New number of events the Event Dispatcher event queue
must hold.

DESCRIPTION

The dat_evd_resize() function modifies the size of the event queue of
Event Dispatcher.


Resizing of Event Dispatcher event queue should not cause any
incoming or current events on the event queue to be lost. If the
number of entries on the event queue is larger then the requested
evd_min_qlen, the operation can return DAT_INVALID_STATE and not
change an instance of Event Dispatcher

RETURN VALUES

DAT_SUCCESS
The operation was successful.


DAT_INVALID_HANDLE
The evd_handle parameter is invalid.


DAT_INVALID_PARAMETER
The evd_min_qlen parameter is invalid


DAT_INSUFFICIENT_RESOURCES
The operation failed due to resource
limitations


DAT_INVALID_STATE
Invalid parameter. The number of
entries on the event queue of the Event
Dispatcher exceeds the requested event
queue length.

USAGE

This operation is useful when the potential number of events that
could be placed on the event queue changes dynamically.

ATTRIBUTES

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


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

SEE ALSO

libdat(3LIB), attributes(7)

July 16, 2004 DAT_EVD_RESIZE(3DAT)