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

Chapter 3 73
NetIPC Intrinsics
IPCCONNECT
Description
The IPCCONNECT intrinsic is used to establish a VC socket (for a virtual
circuit) to another process. The calling process must first create a call
socket for itself and obtain the destination descriptor of a call socket
belonging to the other process.
A successful result means that the connection request has been
initiated. The process which requested the connection (via IPCCONNECT)
must then call IPCRECV with the VC socket descriptor value in order to
complete the connection. IPCCONNECT is a non-blocking call: the calling
process is not blocked pending completion of its request.
Only the destination descriptor and VC socket descriptor parameters
are required (that is, the intrinsic is option variable).
Condition codes returned by this intrinsic are as follows:
• CCE — Succeeded.
• CCL — Failed.
• CCG — Not returned by this intrinsic.
Protocol-Specific Considerations
The following Table 3-2 outlines parameters that are specific to the
particular protocol you are accessing.
Table 3-2 IPCCONNECT Protocol Specific Parameters
Parameters TCP X.25
flags
0 Protected connection n/a
21 Enable checksum n/a
opt
2 n/a Call user data (CUD)
3 Maximum send size n/a
4 Maximum receive size n/a
128 TCP source port
address
n/a
142 n/a Facilities set name
144 None defined Bit 17: access to CUD
145 n/a Facility field