Manual Pages for UNIX Operating System command usage for man dat_set_consumer_context

Direct Access Transport Library Functions
                                   dat_set_consumer_context(3DAT)



NAME
     dat_set_consumer_context - set Consumer context

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

     DAT_RETURN
         dat_set_consumer_context (
         IN    DAT_HANDLE    dat_handle,
         IN    DAT_CONTEXT   context
         )


PARAMETERS
     dat_handle    Handle for a DAT Object associated  with  con-
                   text.


     context       Consumer context to be stored within the asso-
                   ciated  dat_handle.  The  Consumer  context is
                   opaque to the uDAPL Provider. NULL  represents
                   no context.


DESCRIPTION
     The dat_set_consumer_context() function associates a  Consu-
     mer  context  with  the specified dat_handle. The dat_handle
     can be one of the  following  handle  types:  DAT_IA_HANDLE,
     DAT_EP_HANDLE,         DAT_EVD_HANDLE,        DAT_CR_HANDLE,
     DAT_RSP_HANDLE,        DAT_PSP_HANDLE,        DAT_PZ_HANDLE,
     DAT_LMR_HANDLE, DAT_RMR_HANDLE, or DAT_CNO_HANDLE.


     Only  a  single  Consumer  context  is  provided   for   any
     dat_handle.  If there is a previous Consumer context associ-
     ated with the specified handle, the new context replaces the
     old  one. The Consumer can disassociate the existing context
     by providing a NULL pointer for the  context.  The  Provider
     makes no assumptions about the contents of context; no check
     is made on its value. Furthermore,  the  Provider  makes  no
     attempt to provide any synchronization for access or modifi-
     cation of the context.

RETURN VALUES
     DAT_SUCCESS              The operation was successful.


     DAT_INVALID_PARAMETER    The context parameter is invalid.





SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions
                                   dat_set_consumer_context(3DAT)



     DAT_INVALID_HANDLE       The   dat_handle    parameter    is
                              invalid.


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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Unsafe                      |
    |_____________________________|_____________________________|
    | Standard                    | uDAPL, 1.1, 1.2             |
    |_____________________________|_____________________________|


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































SunOS 5.11          Last change: 16 Jul 2004                    2






Direct Access Transport Library Functions
                                   dat_set_consumer_context(3DAT)






















































SunOS 5.11          Last change: 16 Jul 2004                    3