NetIPC 3000/XL Programmer's Reference Manual (5958-8600)

86 Chapter3
NetIPC Intrinsics
IPCCREATE
Description
The IPCCREATE intrinsic creates a call socket, returning a call socket
descriptor. A call socket descriptor is an identifying number which may
be used in other NetIPC intrinsic calls. A process may own a maximum
of 64 (call and VC) sockets. If a socket has been given away (via the
IPCGIVE intrinsic), it is included in this total until another process
takes it (via IPCGET).
Only the
socketkind and calldesc parameters are required.
Condition codes returned by this intrinsic are:
• CCE — Succeeded.
• CCL — Failed.
• CCG — Not returned by this intrinsic.
IPCCREATE runs in waited mode. It does not return until the request is
completed.
Protocol-Specific Considerations
The following Table 3-5 outlines parameters that are specific to the
particular protocol you are accessing.
X.25 Considerations
For direct access to X.25, the protocol parameter must be 2 (X.25). The
opt parameter network name must include the X.25 network NI name.
The
opt parameter address option (code 128) is used to contain the
protocol relative address of the source socket.
X.25 compares the protocol relative address contained in an incoming
call (in the CUD field) to the protocol relative addresses assigned to all
X.25 call sockets at the source sockets’ destination. If the protocol
relative address of the source socket matches the incoming call’s
address (CUD) the call is routed to that socket.
Table 3-5 IPCCREATE Protocol Specific Parameters
Parameters TCP X.25
flags
0 Protected socket n/a
opt
140 n/a NI name required
144 none defined Bit 2: catch-all socket
flag