 |
» |
|
|
|
NM callable only. Reads any specified error from the process stack. 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 (32650-90066, 32650-90152, and 32650-90368) 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. Related Information | |
- Intrinsics
HPERRDEPTH, ``HPERRMSG - Commands
None - Manuals
Getting System Information Programmer's Guide (32650-90018) and MPE/iX Error Message Manual Volumes 1, 2 and 3 (32650-90066, 32650-90152, and 32650-90368)
|
