MPE/iX Intrinsics Reference Manual (32650-90875)

354 Chapter7
Command Definitions (HP32208-HPLOACNMPROC)
HPERRMSG
that the messages are placed in buffer , separated by
carriage return/line feed characters.
depth 32-bit signed integer by value (optional)
Specifies the number of error entries from the stack that are to be
displayed. A 1 (one) implies the last error entry made.
Default = 0
errorproc 16-bit signed integer (reserved)
Do not specify this parameter, but maintain parameter position.
Default = 0
errornum 32-bit signed integer by value (optional)
Passes a subsystem error identification number whose corresponding
message from the system catalog is to be displayed or returned. An
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.
Bits (16:16) comprise
status.subsys . The value represented by these bits
defines the subsystem that set the status information.
If not specified, defaults to 0.
buffer character array (optional)
Specifies the buffer where text from the system catalog error messages are
to be placed.
If not specified, defaults to NIL.
buflength 16-bit signed integer by reference (optional)
Passes the length of the buffer input:
• As an input parameter, the length of the buffer where the error
messages are to be placed. If the resulting messages are longer than
this length, they are truncated. This procedure does not verify that the
buffer parameter has enough storage to hold the number of bytes
specified by
buflength . If there is not enough storage, the caller's
stack may be corrupted.
• As an output parameter, the actual length (in bytes) of the messages
that were returned.
If
buffer is specified, buflength must also be specified.
If not specified, defaults to NIL.
status 32-bit signed integer by reference (optional)
Returns the status of the HPERRMSG 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.