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

88 Chapter3
NetIPC Intrinsics
IPCDEST
IPCDEST
Creates a destination descriptor.
Syntax
IPCDEST ( socketkind [, location ][, locationlen ], protocol ,
protoaddr , protolen [, flags ][, opt ], destdesc [, result ])
Parameters
socketkind (input)
32-bit integer, by value. Defines the type of socket.
The only type user processes can create is: 3 = call
socket.
location (input)
Character array, by reference. The name of the
node (either node or node.domain.organization )
on which the destination socket is to be created. If this
parameter is omitted, the local node is assumed.
locationlen (input)
32-bit integer, by value. The length in bytes of the
destination node name. Zero indicates that no location
was given (that is, the node is local). Maximum (for a
fully qualified name) is 50.
protocol (input)
32-bit integer, by value. Defines the Transport Layer
protocol to be used. The protocols currently available to
user processes are:
• 2 = X.25 protocol
• 4 = TCP
protoaddr (input)
Byte array, by reference. Protocol relative address
(remote address) with which the socket will be
associated. The format of this address, defined by the
protocol, is a 2-byte array (16 bits). Nonprivileged
programs must use addresses in the range 30767 to
32767 decimal (%74057 to %77777). For X.25 access to
level 3, this address is included in the CUD field of an
X.25 call packet. (See the discussion of IPCCONNECT for
the parameters providing access to the CUD).