HPERRREAD
MPE documents | |
 Complete PDF | |
| Table of Contents | |
| Index | |
| Edition 7 E0701 | |
| Edition 7 E0300 ♥ | |
| Edition 6 E0195 |
Syntax
I32V I32 I32 I32
HPERRREAD (depth, errornum, procnum, status);
Parameters
- depth
32-bit signed integer by value (required)
Passes the index of the stack entry to read from. A 1 (one) implies the last entry that was pushed. Specification of depth equal to that of the actual stack depth implies the oldest entry on the stack. An error is returned if the value of this parameter does not correspond to an error in the stack.
- errornum
32-bit signed integer by reference (required)
Returns the error status that was read from the stack. This value is only valid if status is zero.
Bits (0:16) comprise status.info. A negative value indicates an error condition, and a positive value indicates a warning condition.
Bits (16:16) comprise status.subsys. The value represented by these bits defines the subsystem that set the status information.
- procnum
32-bit signed integer by reference (optional)
Do not specify this parameter. Instead, maintain the parameter position with a comma. Always returns zero.
If not specified, defaults to NIL.
- status
32-bit signed integer by reference (optional)
Returns the status of the HPERRREAD call. If no errors or warnings are encountered, status returns 32-bits of zero. If errors or warnings are encountered, errornum is interpreted as two 16-bit fields.
Bits (0:16) comprise status.info. A negative value indicates an error condition, and a positive value indicates a warning condition. Refer to the MPE/iX Error Message Manual Volumes 1, 2 and 3 for a description of its value.
Bits (16:16) comprise status.subsys. The value represented by these bits defines the subsystem that set the status information. The subsystem identifier for HPERRREAD is 187.
If not specified, defaults to NIL.
CAUTION: If an error or warning is encountered and the status parameter was not specified, HPERRREAD causes the calling process to abort.
Operation Notes
Allows the user to read any specified error from the process stack. The user specifies 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 specified 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. 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
|
HPERRMSG |
HPFADDTOPOINTER |