Direct Access Transport Library Functions
datpspcreateany(3DAT)
NAME
datpspcreateany - create a persistent Public Service
Point
SYNOPSIS
cc [ flag... ] file... -ldat [ library... ]
#include
DATRETURN
datpspcreateany(
IN DATIAHANDLE iahandle,
IN DATCONQUAL connqual,
IN DATEVDHANDLE evdhandle,
IN DATPSPFLAGS pspflags,
OUT DATPSPHANDLE *psphandle
)
PARAMETERS
iahandle Handle for an instance of DAT IA.
connqual Connection Qualifier of the IA on which the
Public Service Point is listening.
evdhandle Event Dispatcher that provides the Connection
Requested Events to the Consumer. The size of
the event queue for the Event Dispatcher con-
trols the size of the backlog for the created
Public Service Point.
pspflags Flag that indicates whether the Provider or
Consumer creates an Endpoint per arrived Con-
nection Request. The value of DATPSPROVIDER
indicates that the Consumer wants to get an
Endpoint from the Provider; a value of
DATPSPCONSUMER means the Consumer does not
want the Provider to provide an Endpoint for
each arrived Connection Request.
psphandle Handle to an opaque Public Service Point.
DESCRIPTION
The datpspcreateany() function creates a persistent Pub-
lic Service Point that can receive multiple requests for
connection and generate multiple Connection Request
instances that are delivered through the specified Event
SunOS 5.11 Last change: 16 Jul 2004 1
Direct Access Transport Library Functions
datpspcreateany(3DAT)
Dispatcher in Notification events.
The datpspcreateany() function allocates an unused Con-
nection Qualifier, creates a Public Service point for it,
and returns both the allocated Connection Qualifier and the
created Public Service Point to the Consumer.
The allocated Connection Qualifier should be chosen from
"nonprivileged" ports that are not currently used or
reserved by any user or kernel Consumer or host ULP of the
IA. The format of allocated Connection Qualifier returned is
specific to IA transport type.
The datpspcreateany() function is blocking. When the Pub-
lic Service Point is created, DATSUCES is returned,
psphandle contains a handle to an opaque Public Service
Point Object, and connqual contains the allocated Connec-
tion Qualifier. When return is not DATSUCES, psphandle
and connqual return values are undefined.
There is no explicit backlog for a Public Service Point.
Instead, Consumers can control the size of backlog through
the queue size of the associated Event Dispatcher.
The pspflags parameter allows Consumers to request that the
Provider create an implicit Endpoint for each incoming Con-
nection Request, or request that the Provider should not
create one per Connection Request. If the Provider cannot
satisfy the request, the operation shall fail and
DATMODELNOTSUPORTED is returned.
All Endpoints created by the Provider have DATHANDLENUL
for the Protection Zone and all Event Dispatchers. The Pro-
vider sets up Endpoint attributes to match the Active side
connection request. The Consumer can change Endpoint parame-
ters. Consumers should change Endpoint parameters, espe-
cially PZ and EVD, and are advised to change parameters for
local accesses prior to the connection request acceptance
with the Endpoint.
RETURN VALUES
DATSUCES The operation was successful.
SunOS 5.11 Last change: 16 Jul 2004 2
Direct Access Transport Library Functions
datpspcreateany(3DAT)
DATINSUFICIENTRESOURCES The operation failed due to
resource limitations.
DATINVALIDHANDLE The iahandle or evdhandle
parameter is invalid.
DATINVALIDPARAMETER The connqual or pspflags
parameter is invalid.
DATCONQUALUNAVAILABLE No Connection Qualifiers
available.
DATMODELNOTSUPORTED The requested Model was not
supported by the Provider.
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 3
Direct Access Transport Library Functions
datpspcreateany(3DAT)
SunOS 5.11 Last change: 16 Jul 2004 4
|
