MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 7 357

Command Deﬁnitions (HP32208-HPLOACNMPROC)

HPERRREAD

CAUTION

If an error or warning is encountered and the

status

parameter was not

speciﬁed, HPERRREAD causes the calling process to abort.

Operation Notes

Allows the user to read any speciﬁed error from the process stack. The user speciﬁes how

far down into the stack to read, and the corresponding error status is returned in

errornum

. If any parameters were pushed onto the stack with the speciﬁed error, this

intrinsic does not return them. Refer to the HPERRMSG intrinsic for information on how to

display errors with their parameters.

NOTE

With the exception of HPERRMSG, HPERRREAD, and HPERRDEPTH, all intrinsics

that are called clear the process error stack.

If other intrinsics are called before or during the process of reading the error

stack, the stack is cleared, and the information it contained is lost.

NOTE

The internal software which moves error codes onto the error stack is a

proprietary part of the MPE/iX operating system. Hewlett-Packard currently

provides no user-callable procedure to move error codes onto the error stack.

Related Information

Intrinsics HPERRDEPTH, ``HPERRMSG

Manual MPE/iX Error Message Manual Volumes 1, 2 and 3