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

Chapter 3 85
NetIPC Intrinsics
IPCCREATE
connections that can be queued to a call socket. The
default value is 7.
• address option (option code=128, length= n ; n-byte
array), (input). Allows users to specify the socket’s
protocol relative address rather than having NetIPC
allocate an address. The format of this address is
defined by the protocol, for TCP and X.25 protocol
access, the address is a 2-byte array. For X.25, you
must either specify a protocol relative address, or
identify the socket as catch-all. (See the
opt protocol
flags “catch-all socket flag” (bit 2) description).
Address values in the range 30767 to 32767 decimal
(% 74057 to % 77777) can be used without special
capabilities. In privileged programs, values in the
range 1 to 30766 decimal (%1 to % 74056) can be
used. See the paragraph “User-specified Protocol
Addressing” at the beginning of this chapter for
more information.
• network name (code=140, length=8, packed array
of characters) (input). The X.25 network name is the
network interface (NI) name defined when the
network is configured with NMMGR. This option is
required for X.25 protocol access. This field is
left-justified.
• protocol flags (code 144, length=4, 4-byte buffer).
— catch-all socket flag (bit 2) (input). X.25
protocol access only. This flag identifies the socket
as a catch-all socket. Network administrator (NA)
capability is required to set this flag. User
capability is required to run a program that
creates a catch-all socket. The address option
(protocol relative address) does not apply to a
catch-all socket.
calldesc (output)
32-bit integer, by reference. Call socket descriptor.
The socket descriptor which identifies the created
socket.
result (output)
32-bit integer, by reference. The returned error
code; zero if no error.