Manual Pages for UNIX Operating System command usage for man dat_evd_post_se

Direct Access Transport Library Functions   dat_evd_post_se(3DAT)



NAME
     dat_evd_post_se  -  post  Software  event   to   the   Event
     Dispatcher event queue

SYNOPSIS
     cc [ flag... ] file... -ldat [ library... ]
     #include 

     DAT_RETURN
         dat_evd_post_se(
         IN        DAT_EVD_HANDLE    evd_handle,
         IN const  DAT_EVENT         *event
         )


PARAMETERS
     evd_handle    Handle for an instance of the Event Dispatcher


     event         A  pointer  to  a  Consumer  created  Software
                   Event.


DESCRIPTION
     The dat_evd_post_se() function posts Software events to  the
     Event  Dispatcher  event  queue.  This is analogous to event
     arrival on the Event Dispatcher software Event  Stream.  The
     event that the Consumer provides adheres to the event format
     as defined in . The first element in the  event  pro-
     vides  the  type of the event (DAT_EVENT_TYPE_SOFTWARE); the
     rest  provide  the  event-type-specific  parameters.   These
     parameters  are opaque to a Provider. Allocation and release
     of the memory referenced by the event pointer in a  software
     event are the Consumer's responsibility.


     There is no ordering between  events  from  different  Event
     Streams.  All  the  synchronization  issues between multiple
     Consumer  contexts  trying  to  post  events  to  an   Event
     Dispatcher instance simultaneously are left to a Consumer.


     If the event queue  is  full,  the  operation  is  completed
     unsuccessfully  and returns DAT_QUEUE_FULL. The event is not
     queued. The queue overflow condition does takes  place  and,
     therefore,   the   asynchronous   Event  Dispatcher  is  not
     effected.

RETURN VALUES
     DAT_SUCCESS              The operation was successful.





SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions   dat_evd_post_se(3DAT)



     DAT_INVALID_HANDLE       The   evd_handle    parameter    is
                              invalid.


     DAT_INVALID_PARAMETER    The event parameter is invalid.


     DAT_QUEUE_FULL           The Event Dispatcher queue is full.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Unsafe                      |
    |_____________________________|_____________________________|
    | Standard                    | uDAPL, 1.1, 1.2             |
    |_____________________________|_____________________________|


SEE ALSO
     libdat(3LIB), attributes(5)


























SunOS 5.11          Last change: 16 Jul 2004                    2