Direct Access Transport Library Functions    datcnocreate(3DAT)



NAME
     datcnocreate - create a CNO instance

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

     DATRETURN
         datcnocreate (
         IN    DATIAHANDLE            iahandle,
         IN    DATOSWAITPROXYAGENT  agent,
         OUT   DATCNOHANDLE           *cnohandle
         )


PARAMETERS
     iahandle     Handle for an instance of DAT IA.


     agent         An optional OS Wait Proxy Agent that is to  be
                   invoked     whenever     CNO    is    invoked.
                   DATOSWAITPROXYAGENTNUL  indicates   that
                   there is no proxy agent


     cnohandle    Handle for the created instance of CNO.


DESCRIPTION
     The datcnocreate() function creates a CNO  instance.  Upon
     creation, there are no Event Dispatchers feeding it.


     The agent parameter specifies the proxy agent, which is  OS-
     dependent  and  which  is invoked when the CNO is triggered.
     After it is invoked, it is no  longer  associated  with  the
     CNO.  The  value  of  DATOSWAITPROXYAGENTNUL specifies
     that no OS Wait Proxy Agent is associated with  the  created
     CNO.


     Upon creation, the CNO is not associated with any EVDs,  has
     no waiters and has, at most, one OS Wait Proxy Agent.

RETURN VALUES
     DATSUCES                   The operation was successful.


     DATINSUFICIENTRESOURCES    The operation  failed  due  to
                                   resource limitations.





SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions    datcnocreate(3DAT)



     DATINVALIDHANDLE            The  iahandle  parameter   is
                                   invalid.


     DATINVALIDPARAMETER         One  of  the  parameters   was
                                   invalid,  out  of  range, or a
                                   combination of parameters  was
                                   invalid,  or the agent parame-
                                   ter 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