Direct Access Transport Library Functions
                                   datsetconsumercontext(3DAT)



NAME
     datsetconsumercontext - set Consumer context

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

     DATRETURN
         datsetconsumercontext (
         IN    DATHANDLE    dathandle,
         IN    DATCONTEXT   context
         )


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


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


DESCRIPTION
     The datsetconsumercontext() function associates a  Consu-
     mer  context  with  the specified dathandle. The dathandle
     can be one of the  following  handle  types:  DATIAHANDLE,
     DATEPHANDLE,         DATEVDHANDLE,        DATCRHANDLE,
     DATRSPHANDLE,        DATPSPHANDLE,        DATPZHANDLE,
     DATLMRHANDLE, DATRMRHANDLE, or DATCNOHANDLE.


     Only  a  single  Consumer  context  is  provided   for   any
     dathandle.  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 NUL 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
     DATSUCES              The operation was successful.


     DATINVALIDPARAMETER    The context parameter is invalid.





SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions
                                   datsetconsumercontext(3DAT)



     DATINVALIDHANDLE       The   dathandle    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                     Unsafe                      
    


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

































SunOS 5.11          Last change: 16 Jul 2004                    2






Direct Access Transport Library Functions
                                   datsetconsumercontext(3DAT)






















































SunOS 5.11          Last change: 16 Jul 2004                    3