dat_evd_resize(3DAT)				     Direct Access Transport Library Functions				      dat_evd_resize(3DAT)

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(5) 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(5)

SunOS 5.11							    16 Jul 2004 					      dat_evd_resize(3DAT)