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

80 Chapter3
NetIPC Intrinsics
IPCCONTROL
wrtdata (input)
Record or byte array, by reference. If the request is
to change the default timeout, ( request code 3 or 262)
the value in the first two bytes of the
wrtdata buffer
will become the new timeout, in tenths of a second. A
zero value indicates an indefinite timeout: a call to
IOWAIT returns only after the next I/O request
completes.
If the request is to enable tracing, (
request code 259)
or for X.25 requests 9 or 15, this parameter may
(optionally) contain information in the same format as
the
opt parameter in other intrinsics.
wlen (input)
32-bit integer, by value. Length in bytes of the
wrtdata parameter.
readdata (output)
Record or byte array, by reference. If the request
enables tracing, the trace file's name is returned in this
parameter. If the request asks for the socket’s address,
that address is returned here. If the request is for the
local node name, the fully qualified node name is
returned in
readdata .
rlen (input/output)
32-bit integer, by reference. The maximum number
of bytes that you expect to receive in the readdata
parameter. If readdata returns the trace file name,
rlen returns the length of this name, in bytes. If
readdata returns the socket’s address, rlen will
return the byte length of the address.
flags (input)
32 bits, by reference. A bit representation of various
options. The following flag is defined:
• flags [31] (input) — (TCP only.) If NetIPC tracing is
enabled (
request = 259), this flag indicates that
Transport Layer protocol activity (headers and
internal messages) should also be traced.
result (output)
32-bit integer, by reference. The error code
returned; zero if no error.