HPlogo Using NS 3000/iX Network Services: HP 3000 MPE/iX Computer Systems > Chapter 7 Remote Process Management

Common RPM Parameters

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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.

Feedback to webmaster