HPlogo 900 Series HP 3000 Computer Systems: MPE/iX Intrinsics Reference Manual > Chapter 4 Command Definitions

HPERRDEPTH

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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 (32650-90066, 32650-90152, and 32650-90368) 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.

Related Information

Intrinsics

HPERRMSG, ``HPERRREAD''

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)

Feedback to webmaster