Direct Access Transport Library Functions      datepreset(3DAT)



NAME
     datepreset - transition the local Endpoint from a  Discon-
     nected to an Unconnected state

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

     DATRETURN
         datepreset (
         IN    DATEPHANDLE    ephandle
         )


PARAMETERS
     ephandle    Handle for an instance of Endpoint.


DESCRIPTION
     The datepreset() function transitions the  local  Endpoint
     from a Disconnected to an Unconnected state.


     The operation might cause the loss  of  any  completions  of
     previously posted DTOs and RMRs that were not dequeued yet.


     The datepreset() function is valid for  both  Disconnected
     and Unconnected states. For Unconnected state, the operation
     is no-op because the Endpoint is already in  an  Unconnected
     state. For an Unconnected state, the preposted Recvs are not
     affected by the call.

RETURN VALUES
     DATSUCES           The operation was successful.


     DATINVALIDHANDLE    ephandle is invalid.


     DATINVALIDSTATE     Parameter in an  invalid  state.  End-
                           point  is  not  in the valid state for
                           reset.


USAGE
     If the Consumer wants to ensure  that  all  Completions  are
     dequeued,  the  Consumer can post DTO or RMR operations as a
     "marker"   that   are   flushed   to   recvevdhandle    or
     requestevdhandle. Now, when the Consumer dequeues the com-
     pletion of the "marker" from the EVD, it is guaranteed  that
     all  previously  posted  DTO  and  RMR  completions  for the



SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions      datepreset(3DAT)



     Endpoint were dequeued for that EVD. Now,   it  is  safe  to
     reset the Endpoint without losing any completions.

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                     Unsafe                      
    


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



































SunOS 5.11          Last change: 16 Jul 2004                    2