HPERRREAD

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.

CAUTION: If an error or warning is encountered and the status parameter was not specified, HPERRREAD 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, the stack is cleared, and the information it contained is lost. 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