1dat_cno_create(3DAT)Direct Access Transport Library Functiondsat_cno_create(3DAT)
2
3
4

NAME

6       dat_cno_create - create a CNO instance
7

SYNOPSIS

9       cc [ flag... ] file... -ldat [ library... ]
10       #include <dat/udat.h>
11
12       DAT_RETURN
13           dat_cno_create (
14           IN    DAT_IA_HANDLE            ia_handle,
15           IN    DAT_OS_WAIT_PROXY_AGENT  agent,
16           OUT   DAT_CNO_HANDLE           *cno_handle
17           )
18
19

PARAMETERS

21       ia_handle     Handle for an instance of DAT IA.
22
23
24       agent         An  optional  OS  Wait  Proxy Agent that is to be invoked
25                     whenever  CNO  is  invoked.  DAT_OS_WAIT_PROXY_AGENT_NULL
26                     indicates that there is no proxy agent
27
28
29       cno_handle    Handle for the created instance of CNO.
30
31

DESCRIPTION

33       The  dat_cno_create()  function  creates a CNO instance. Upon creation,
34       there are no Event Dispatchers feeding it.
35
36
37       The agent parameter specifies the proxy agent,  which  is  OS-dependent
38       and which is invoked when the CNO is triggered. After it is invoked, it
39       is   no   longer   associated   with   the   CNO.    The    value    of
40       DAT_OS_WAIT_PROXY_AGENT_NULL  specifies  that no OS Wait Proxy Agent is
41       associated with the created CNO.
42
43
44       Upon creation, the CNO is not associated with any EVDs, has no  waiters
45       and has, at most, one OS Wait Proxy Agent.
46

RETURN VALUES

48       DAT_SUCCESS                   The operation was successful.
49
50
51       DAT_INSUFFICIENT_RESOURCES    The operation failed due to resource lim‐
52                                     itations.
53
54
55       DAT_INVALID_HANDLE            The ia_handle parameter is invalid.
56
57
58       DAT_INVALID_PARAMETER         One of the parameters was invalid, out of
59                                     range, or a combination of parameters was
60                                     invalid,  or  the  agent   parameter   is
61                                     invalid.
62
63

ATTRIBUTES

65       See attributes(5) for descriptions of the following attributes:
66
67
68
69
70       ┌─────────────────────────────┬─────────────────────────────┐
71       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
72       ├─────────────────────────────┼─────────────────────────────┤
73       │Interface Stability          │Standard: uDAPL, 1.1, 1.2    │
74       ├─────────────────────────────┼─────────────────────────────┤
75       │MT-Level                     │Safe                         │
76       └─────────────────────────────┴─────────────────────────────┘
77

SEE ALSO

79       libdat(3LIB), attributes(5)
80
81
82
83SunOS 5.11                        16 Jul 2004             dat_cno_create(3DAT)
Impressum