MPE/iX Intrinsics Reference Manual (32650-90875)

356 Chapter7
Command Definitions (HP32208-HPLOACNMPROC)
HPERRREAD
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 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.