HP 3000 Manuals HP 3000 Manuals
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
(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)