1dat_psp_create_any(3DDiArTe)ct Access Transport Library Funcdtaito_npssp_create_any(3DAT)
2
3
4

NAME

6       dat_psp_create_any - create a persistent Public Service Point
7

SYNOPSIS

9       cc [ flag... ] file... -ldat [ library... ]
10       #include <dat/udat.h>
11
12       DAT_RETURN
13           dat_psp_create_any(
14           IN    DAT_IA_HANDLE    ia_handle,
15           IN    DAT_CONN_QUAL    conn_qual,
16           IN    DAT_EVD_HANDLE   evd_handle,
17           IN    DAT_PSP_FLAGS    psp_flags,
18           OUT   DAT_PSP_HANDLE   *psp_handle
19           )
20
21

PARAMETERS

23       ia_handle     Handle for an instance of DAT IA.
24
25
26       conn_qual     Connection  Qualifier  of the IA on which the Public Ser‐
27                     vice Point is listening.
28
29
30       evd_handle    Event Dispatcher that provides the  Connection  Requested
31                     Events  to  the Consumer. The size of the event queue for
32                     the Event Dispatcher controls the size of the backlog for
33                     the created Public Service Point.
34
35
36       psp_flags     Flag that indicates whether the Provider or Consumer cre‐
37                     ates an Endpoint  per  arrived  Connection  Request.  The
38                     value  of  DAT_PSP_PROVIDER  indicates  that the Consumer
39                     wants to get an Endpoint from the Provider;  a  value  of
40                     DAT_PSP_CONSUMER  means  the  Consumer  does not want the
41                     Provider to provide an Endpoint for each arrived  Connec‐
42                     tion Request.
43
44
45       psp_handle    Handle to an opaque Public Service Point.
46
47

DESCRIPTION

49       The  dat_psp_create_any()  function creates a persistent Public Service
50       Point that can receive multiple requests for  connection  and  generate
51       multiple  Connection  Request  instances that are delivered through the
52       specified Event Dispatcher in Notification events.
53
54
55       The dat_psp_create_any() function allocates an unused Connection Quali‐
56       fier, creates a Public Service point for it, and returns both the allo‐
57       cated Connection Qualifier and the created Public Service Point to  the
58       Consumer.
59
60
61       The  allocated  Connection  Qualifier  should be chosen from "nonprivi‐
62       leged" ports that are not currently used or reserved  by  any  user  or
63       kernel  Consumer or host ULP of the IA. The format of allocated Connec‐
64       tion Qualifier returned is specific to IA transport type.
65
66
67       The dat_psp_create_any() function is blocking. When the Public  Service
68       Point is created, DAT_SUCCESS is returned, psp_handle contains a handle
69       to an opaque Public Service Point Object, and  conn_qual  contains  the
70       allocated   Connection  Qualifier.  When  return  is  not  DAT_SUCCESS,
71       psp_handle and conn_qual return values are undefined.
72
73
74       There is no explicit backlog for a Public Service Point. Instead,  Con‐
75       sumers  can  control  the size of backlog through the queue size of the
76       associated Event Dispatcher.
77
78
79       The psp_flags parameter allows Consumers to request that  the  Provider
80       create  an  implicit  Endpoint for each incoming Connection Request, or
81       request that the Provider should not create one per Connection Request.
82       If  the  Provider  cannot satisfy the request, the operation shall fail
83       and DAT_MODEL_NOT_SUPPORTED is returned.
84
85
86       All Endpoints created by the Provider  have  DAT_HANDLE_NULL   for  the
87       Protection  Zone  and  all Event Dispatchers. The Provider sets up End‐
88       point attributes to match the Active side connection request. The  Con‐
89       sumer  can change Endpoint parameters. Consumers should change Endpoint
90       parameters, especially PZ and EVD, and are advised to change parameters
91       for  local accesses prior to the connection request acceptance with the
92       Endpoint.
93

RETURN VALUES

95       DAT_SUCCESS                   The operation was successful.
96
97
98       DAT_INSUFFICIENT_RESOURCES    The operation failed due to resource lim‐
99                                     itations.
100
101
102       DAT_INVALID_HANDLE            The  ia_handle or evd_handle parameter is
103                                     invalid.
104
105
106       DAT_INVALID_PARAMETER         The conn_qual or psp_flags  parameter  is
107                                     invalid.
108
109
110       DAT_CONN_QUAL_UNAVAILABLE     No Connection Qualifiers available.
111
112
113       DAT_MODEL_NOT_SUPPORTED       The  requested Model was not supported by
114                                     the Provider.
115
116

ATTRIBUTES

118       See attributes(5) for descriptions of the following attributes:
119
120
121
122
123       ┌─────────────────────────────┬─────────────────────────────┐
124       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
125       ├─────────────────────────────┼─────────────────────────────┤
126       │Interface Stability          │Standard: uDAPL, 1.1, 1.2    │
127       ├─────────────────────────────┼─────────────────────────────┤
128       │MT-Level                     │Safe                         │
129       └─────────────────────────────┴─────────────────────────────┘
130

SEE ALSO

132       libdat(3LIB), attributes(5)
133
134
135
136SunOS 5.11                        16 Jul 2004         dat_psp_create_any(3DAT)