Using NS3000/iX Network Services (36920-90008)

132 Chapter 7
Remote Process Management
Common RPM Parameters
Common RPM Parameters
The following discussion of the flags and result parameters may help to
clarify the more condensed information given under each intrinsic.
Flags Parameter
The flags parameter is a bit representation, 32 bits long, of various
options. Normally an option is invoked if the appropriate bit is on (that
is, set equal to 1). Borrowing Pascal-type syntax, we shall use
[0] to
refer to the high order bit in the two-word parameter, flags
[31] to refer
to the low order bit, and a similar designation to refer to each of the bits
in between. Bits that are not defined for a given intrinsic must be off
(zero).
Result Parameter
If an RPM intrinsic call is successful, the result parameter will return a
zero. Otherwise, the value returned represents an RPM error code.
RPM error messages are listed in the NS 3000/iX Error Messages
Reference Manual. You can also obtain the appropriate error message
by calling IPCERRMSG.
NOTE When nowait I/O is used, the result parameter is not updated upon
completion of an intrinsic. Therefore, the value of result will indicate
only whether the call was successfully initiated. To determine whether
the call completed successfully, you can use the IPCCHECK intrinsic
immediately afterward.
In addition, when called on an HP 3000, these intrinsics cause MPE
condition codes to be set. Usually CCE indicates successful completion,
CCL indicates failure, and CCG is either not used or represents a
warning.