Direct Access Transport Library Functions    datrmrcreate(3DAT)



NAME
     datrmrcreate - create an RMR for the specified  Protection
     Zone

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

     DATRETURN
         datrmrcreate(
         IN    DATPZHANDLE     pzhandle,
         OUT   DATRMRHANDLE    *rmrhandle
         )


PARAMETERS
     pzhandle     Handle for an instance of the Protection Zone.


     rmrhandle    Handle for the created instance of an RMR.


DESCRIPTION
     The datrmrcreate() function creates an RMR for the  speci-
     fied  Protection  Zone.  This operation is relatively heavy.
     The created RMR can be bound to a memory region  within  the
     LMR  through a lightweight datrmrbind(3DAT) operation that
     generates rmrcontext.


     If the operation fails (does not  return  DATSUCES),  the
     return  values  of  rmrhandle  are  undefined and Consumers
     should not use them.


     The pzhandle parameter provide Consumers a way to  restrict
     access to an RMR by authorized connection only.

RETURN VALUES
     DATSUCES                   The operation was successful.


     DATINSUFICIENTRESOURCES    The operation  failed  due  to
                                   resource limitations.


     DATINVALIDHANDLE            The  pzhandle  parameter   is
                                   invalid.


ATRIBUTES




SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions    datrmrcreate(3DAT)



     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
     datrmrbind(3DAT) , libdat(3LIB), attributes(5)







































SunOS 5.11          Last change: 16 Jul 2004                    2