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

70 Chapter3
NetIPC Intrinsics
IPCCONNECT
IPCCONNECT
Requests a connection to another process.
Syntax
IPCCONNECT ([ calldesc ], destdesc [, flags ][, opt ], vcdesc [, result ]
Parameters
calldesc (input)
32-bit integer, by value. A call socket descriptor for a
call socket belonging to this process. Required for X.25
level 3 access. For TCP access, if -1, or if omitted, a call
socket is created temporarily to establish the
connection.
destdesc (input)
32-bit integer, by value. Destination descriptor.
Describes the location of the named call socket. (this is
the call socket to which the connection request will be
sent). A destination descriptor can be obtained by
calling IPCDEST. For TCP access you can also obtain a
destination descriptor by calling IPCLOOKUP.
flags (input)
32 bits, by reference. A bit representation of various
options. No flags are defined for access to the X.25
protocol. The following flag bits are defined:
• flags [0] (input). (TCP only.) Makes the connection a
“protected” one. A protected connection is one which
only privileged users may establish or use.
• flags [21] (input). (TCP only.) Enables
checksumming on the Transmission Control
Protocol (TCP) connection for error checking.
Checksumming mayalsobe set by the corresponding
IPCRECVCN call. If either side specifies “checksum
enabled” then the connection will be checksummed.
TCP checksum may be enabled globally, over all
connections, when configuring the Network
Transport. Checksumming enabled by either
IPCRECVCN or the network transport (remote or
local) configuration overrides a 0 setting (checksum
disabled) for this flag. Checksum error checking is