Direct Access Transport Library Functions
                                          datepgetstatus(3DAT)



NAME
     datepgetstatus - provide a quick snapshot of the Endpoint

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

     DATRETURN
         datepgetstatus (
         IN    DATEPHANDLE    ephandle,
         OUT   DATEPSTATE     *epstate,
         OUT   DATBOLEAN      *recvidle,
         OUT   DATBOLEAN      *requestidle
         )


PARAMETERS
     ephandle       Handle for an instance of the Endpoint.


     epstate        Current state of the Endpoint.


     recvidle       Status of the incoming DTOs on the Endpoint.


     requestidle    Status of the outgoing  DTOs  and  RMR  Bind
                     operations on the Endpoint.


DESCRIPTION
     the datepgetstatus() function  provides  the  Consumer  a
     quick snapshot of the Endpoint. The snapshot consists of the
     Endpoint state and whether  there  are  outstanding  or  in-
     progress,  incoming  or outgoing DTOs. Incoming DTOs consist
     of Receives. Outgoing DTOs consist of  the  Requests,  Send,
     RDMA Read, RDMA Write, and RMR Bind.


     The epstate parameter returns  the  value  of  the  current
     state  of  the Endpoint ephandle. State value is one of the
     following: DATEPSTATEUNCONECTED,  DATEPSTATERESERVED,
     DATEPSTATEPASIVECONECTIONPENDING,
     DATEPSTATEACTIVECONECTIONPENDING,
     DATEPSTATETENTATIVECONECTIONPENDING,
     DATEPSTATECONECTED, DATEPSTATEDISCONECTPENDING,  or
     DATEPSTATEDISCONECTED.


     A recvidle value of DATRUE specifies that  there  are  no
     outstanding or in-progress Receive DTOs at the Endpoint, and



SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions
                                          datepgetstatus(3DAT)



     DATFALSE otherwise.


     A requestidle value of DATRUE specifies that there are no
     outstanding  or  in-progress Send, RDMA Read, and RDMA Write
     DTOs, and RMR Binds at the Endpoint,  and  DATFALSE  other-
     wise.


     This call provides a snapshot of the Endpoint  status  only.
     No  heroic synchronization with DTO queuing or processing is
     implied.

RETURN VALUES
     DATSUCES           The operation was successful.


     DATINVALIDHANDLE    The ephandle parameter is invalid.


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






Direct Access Transport Library Functions
                                          datepgetstatus(3DAT)






















































SunOS 5.11          Last change: 16 Jul 2004                    3