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

Chapter 3 89
NetIPC Intrinsics
IPCDEST
protolen (input)
32-bit integer, by value. The length in bytes of the
protocol address.
flags
32 bits, by reference. A bit representation of various
options. No flags are currently defined.
opt (input)
Record or byte array, by reference. A list of options,
with associated information.
• destination network address (code = 16, length=n,
n byte buffer) (input). (X.25 only.)This option allows
a user to bypass the use of the network directory and
associated IP address by specifying the destination
node network address.
The first two bytes of the option data field contain
the “protocol” value of the module. For X.25, the
protocol value is 2. The rest of the option data field is
relative to that protocol. For X.25, two subformats
are defined: one for the PVC numbers and one for
SVC addresses. The third and fourth bytes of the
data field contain a format identifier, where 1
indicates a PVC number and 0 indicates a SVC
address. The PVC number is a 4 byte field. For a
PVC, the total length of the option field is 8 bytes.
The SVC field is composed of up to 16 nibbles where
the first nibble is the nibble length of the remaining
address. An odd number of nibbles can be passed
since the length indicates the significance of the
remaining field. This implies that the option data
length for an SVC is between 5 and 12 bytes
inclusive.
destdesc (output)
32-bit integer, by reference. Destination descriptor.
Describes the location of the named call socket. May be
used in subsequent NetIPC calls to IPCCONNECT.
result (output)
32-bit integer, by reference. The error code
returned; zero if no error.