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

124 Chapter3
NetIPC Intrinsics
READOPT
READOPT
Obtains the option code and argument data associated with an opt
parameter argument.
Syntax
READOPT ( opt , entrynum , optioncode , datalength , data , result )
Parameters
opt (input)
Record or byte array, by reference. The
opt
parameter to be read. Refer to “NetIPC
Intrinsics/Common Parameters” for information on the
structure and use of this parameter.
entrynum (input)
16-bit integer, by value. The number of the option
entry to be obtained. The first entry is number zero.
optioncode (output)
16-bit integer, by reference. The option code
associated with the entry. These codes are described in
each NetIPC call
opt parameter description.
datalength (input/output)
16-bit integer, by reference. The length of the data
buffer into which the entry should be read. If the data
buffer is not large enough to accommodate the entry
data, an error will be returned. On output, this
parameter contains the length of the data actually
read. (The length of the data associated with a
particular option code is provided in each NetIPC call
opt parameter description.)
data (output)
Byte array, by reference. An array which will
contain the data read from the option entry. If the array
is not large enough to hold the data read, only as much
as requested will be returned and SOCKERR 137, more
data available will be returned in the
result
parameter.