Direct Access Transport Library Functions      datcnowait(3DAT)



NAME
     datcnowait - wait for notification events

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

     DATRETURN
         datcnowait (
         IN    DATCNOHANDLE    cnohandle,
         IN    DATIMEOUT       timeout,
         OUT   DATEVDHANDLE    *evdhandle
         )


PARAMETERS
     cnohandle    Handle for an instance of CNO


     timeout       The duration to wait for a  notification.  The
                   value DATIMEOUTINFINITE can be used to wait
                   indefinitely.


     evdhandle    Handle for an instance of EVD


DESCRIPTION
     The datcnowait() function allows the Consumer to wait  for
     notification events from a set of Event Dispatchers all from
     the same Interface Adapter. The Consumer blocks until  noti-
     fied or the timeout period expires.


     An Event Dispatcher that is  disabled  or  in  the  "Waited"
     state does not deliver notifications. A uDAPL Consumer wait-
     ing directly upon an Event Dispatcher preempts the CNO.


     The consumer can optionally specify a timeout,  after  which
     it is unblocked even if there are no notification events. On
     a timeout, evdhandle is explicitly set to a null handle.


     The returned evdhandle is only a hint. Another Consumer can
     reap the Event before this Consumer can get around to check-
     ing  the  Event  Dispatcher.   Additionally,   other   Event
     Dispatchers  feeding  this CNO might have been notified. The
     Consumer is responsible for ensuring that all  EVDs  feeding
     this  CNO  are polled regardless of whether they are identi-
     fied as the immediate cause of the CNO unblocking.




SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions      datcnowait(3DAT)



     All the waiters on the CNO,  including  the  OS  Wait  Proxy
     Agent  if  it is associated with the CNO, are unblocked with
     the NUL handle returns for  an  unblocking  EVD  evdhandle
     when  the  IA instance is destroyed or when all EVDs the CNO
     is associated with are freed.

RETURN VALUES
     DATSUCES              The operation was successful.


     DATINVALIDHANDLE       The   cnohandle    parameter    is
                              invalid.


     DATQUEUEMPTY          The operation timed out  without  a
                              notification.


     DATINVALIDPARAMETER    One of the parameters  was  invalid
                              or  out  of range, a combination of
                              parameters  was  invalid,  or   the
                              timeout parameter is invalid.


     DATINTERUPTEDCAL     The operation was  interrupted by a
                              signal.


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard: uDAPL, 1.1, 1.2   
    
     MT-Level                     Safe                        
    


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










SunOS 5.11          Last change: 16 Jul 2004                    2