MPE/iX Intrinsics Reference Manual (32650-90905)

Chapter 7 351
Command Definitions (HP32208-HPLOACNMPROC)
HPERRDEPTH
HPERRDEPTH
NM callable only.
Returns the current depth of the process error stack.
Syntax
I32 I32
HPERRDEPTH(
depth , status );
Parameters
depth 32-bit signed integer by reference (required)
Returns the current number of entries on the process error stack.
status 32-bit signed integer by reference (optional)
Returns the status of the HPERRDEPTH call. If no errors or warnings are
encountered,
status returns 32-bits of zero. If errors or warnings are
encountered,
status 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 represents the subsystem
that set the status information. The subsystem identifier for HPERRDEPTH
is 187.
Default = NIL
CAUTION If an error or warning is encountered and the status parameter was not
specified, HPERRDEPTH causes the calling process to abort.
Operation Notes
HPERRDEPTH can be used to check the depth of the error stack before using HPERRMSG.
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, then the stack is cleared and the information it contained is lost.