HP 3000 Manuals HP 3000 Manuals
HPERRREAD
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.
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
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)