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

Chapter 3 67
NetIPC Intrinsics
ADDOPT
Description
The ADDOPT intrinsic specifies the values of an opt parameter’s option
entry fields and adds any associated data. The intrinsic also updates
the size of the
opt parameter.
The parameter must be initialized by INITOPT before options are added
by ADDOPT. Consider this program fragment:
data_offset:=10;
{10 bytes from beginning of data array}
INITOPT (opt,1, result);
{one option entry}
ADDOPT (opt, 0, 8, 2, data_offset,result);
{first entry is entry zero, option code 8; entry's data
area contains a 2-byte integer specifying an offset from
data parameter address}
IPCSEND (cd, data, dlen,flags,opt, result);
{sends data located at offset from data address specified
in
opt }
INITOPT and ADDOPT allow you to initialize the
opt parameter for use in
another intrinsic. These auxiliary intrinsics make the structure of the
opt parameter largely transparent.
Condition codes returned by ADDOPT are:
• CCE — Succeeded.
• CCL — Failed because of a user error.
• CCG — Not returned by this intrinsic.
This intrinsic can be called in split stack mode.