Manual Pages for UNIX Operating System command usage for man dat_cno_create

Direct Access Transport Library Functions    dat_cno_create(3DAT)



NAME
     dat_cno_create - create a CNO instance

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

     DAT_RETURN
         dat_cno_create (
         IN    DAT_IA_HANDLE            ia_handle,
         IN    DAT_OS_WAIT_PROXY_AGENT  agent,
         OUT   DAT_CNO_HANDLE           *cno_handle
         )


PARAMETERS
     ia_handle     Handle for an instance of DAT IA.


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


     cno_handle    Handle for the created instance of CNO.


DESCRIPTION
     The dat_cno_create() 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  DAT_OS_WAIT_PROXY_AGENT_NULL 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
     DAT_SUCCESS                   The operation was successful.


     DAT_INSUFFICIENT_RESOURCES    The operation  failed  due  to
                                   resource limitations.





SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions    dat_cno_create(3DAT)



     DAT_INVALID_HANDLE            The  ia_handle  parameter   is
                                   invalid.


     DAT_INVALID_PARAMETER         One  of  the  parameters   was
                                   invalid,  out  of  range, or a
                                   combination of parameters  was
                                   invalid,  or the agent parame-
                                   ter is invalid.


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



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


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

























SunOS 5.11          Last change: 16 Jul 2004                    2