HPERRDEPTH

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

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.

Related Information