DAT_EVD_RESIZE(3DAT)DAT_EVD_RESIZE(3DAT)NAMEdat_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 lim‐
itations
DAT_INVALID_STATE
Invalid parameter. The number of entries
on the event queue of the Event Dis‐
patcher 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(5) for descriptions of the following attributes:
┌────────────────────┬───────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼───────────────────────────┤
│Interface Stability │ Standard: uDAPL, 1.1, 1.2 │
├────────────────────┼───────────────────────────┤
│MT-Level │ Unsafe │
└────────────────────┴───────────────────────────┘
SEE ALSOlibdat(3LIB), attributes(5)
Jul 16, 2004 DAT_EVD_RESIZE(3DAT)