Direct Access Transport Library Functions    datrspcreate(3DAT)



NAME
     datrspcreate - create a Reserved Service Point

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

     DATRETURN
         datrspcreate (
         IN    DATIAHANDLE    iahandle,
         IN    DATCONQUAL    connqual,
         IN    DATEPHANDLE    ephandle,
         IN    DATEVDHANDLE   evdhandle,
         OUT   DATRSPHANDLE   *rsphandle
         )


PARAMETERS
     iahandle     Handle for an instance of DAT IA.


     connqual     Connection Qualifier of the  IA  the  Reserved
                   Service Point listens to.


     ephandle     Handle for the Endpoint  associated  with  the
                   Reserved  Service  Point that is the only End-
                   point that can accept a Connection Request  on
                   this  Service Point. The value DATHANDLENUL
                   requests   the   Provider   to   associate   a
                   Provider-created  Endpoint  with  this Service
                   Point.


     evdhandle    The Event Dispatcher to which an event of Con-
                   nection Request arrival is generated.


     rsphandle    Handle to an opaque Reserved Service Point.


DESCRIPTION
     The datrspcreate() function  creates  a  Reserved  Service
     Point  with  the specified Endpoint that generates, at most,
     one Connection Request that is delivered  to  the  specified
     Event Dispatcher in a Notification event.

RETURN VALUES
     DATSUCES                   The operation was successful.






SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions    datrspcreate(3DAT)



     DATINSUFICIENTRESOURCES    The operation  failed  due  to
                                   resource limitations.


     DATINVALIDHANDLE            The iahandle, evdhandle,  or
                                   ephandle     parameter     is
                                   invalid.


     DATINVALIDPARAMETER         The  connqual  parameter   is
                                   invalid.


     DATINVALIDSTATE             Parameter in an invalid state.
                                   For  example,  an Endpoint was
                                   not in the Idle state.


     DATCONQUALINUSE          Specified Connection Qualifier
                                   is in use.


USAGE
     The usage of a Reserve Service Point is as follows:

         o    The DAT Consumer creates a Local Endpoint and  con-
              figures it appropriately.

         o    The DAT Consumer creates a Reserved  Service  Point
              specifying the Local Endpoint.

         o    The Reserved Service Point performs the following:

             o    Collects native transport information  reflect-
                  ing a received Connection Request.

             o    Creates a Pending Connection Request.

             o    Creates a  Connection  Request  Notice  (event)
                  that  includes  the  Pending Connection Request
                  (which includes, among others, Reserved Service
                  Point Connection Qualifier, its Local Endpoint,
                  and information about remote Endpoint).

             o    Delivers the Connection Request Notice  to  the
                  Consumer-specified target (CNO) evdhandle. The
                  Local Endpoint is transitioned from Reserved to
                  Passive Connection Pending state.

         o    Upon receiving a connection  request,  or  at  some
              time  subsequent  to  that,  the  DAT Consumer must
              either accept() or reject() the Pending  Connection



SunOS 5.11          Last change: 16 Jul 2004                    2






Direct Access Transport Library Functions    datrspcreate(3DAT)



              Request.

         o    If accepted, the original Local Endpoint is now  in
              a Connected state and fully usable for this connec-
              tion, pending only native  transport  mandated  RTU
              messages.  This  includes binding it to the IA port
              if that was not done previously.  The  Consumer  is
              notified  that the Endpoint is in a Connected state
              by a Connection Established Event on  the  Endpoint
              connectevdhandle.

         o    If rejected, the Local Endpoint  point  transitions
              into  Unconnected state. The DAT Consumer can elect
              to destroy it or reuse it for other purposes.

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                    3