MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 7 355
Command Definitions (HP32208-HPLOACNMPROC)
HPERRMSG
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 represented by these bits
defines the subsystem that set the status information. The subsystem
identifier for HPERRMSG is 187.
If not specified, defaults to NIL.
CAUTION If an error or warning is encountered and the status parameter was not
specified, HPERRMSG causes the calling process to abort.
Operation Notes
Allows the user to obtain or display error messages from the system catalog by supplying
the corresponding error statuses. The caller can supply a status whose corresponding
message is to be displayed, or specify that the messages corresponding to one or more
errors in the process error stack be displayed. The caller can optionally provide a buffer
and ask that the error messages be placed in that buffer rather than be displayed to the
user.
For errors that are displayed from the process error stack, any parameters that were
pushed with the errors are inserted into the corresponding messages. Also, when dumping
the entire stack, the user is warned if any entries on the process stack were overwritten.
(This happens if more than 16 entries were pushed onto the stack.) If any entries were
overwritten, the oldest entries are the ones lost.
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.
NOTE 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
Intrinsics HPERRDEPTH, ``HPERRREAD
Manual MPE/iX Error Message Manual Volumes 1, 2 and 3