HP 3000 Manuals HP 3000 Manuals
HPMERGEERRORMESS
NM callable only.
Accepts Hewlett-Packard MERGE intrinsic error code values and returns the
error messages associated with them.
Syntax
_______________________________________________
| |
| I32 CA I32 |
| HPMERGEERRORMESS(status,message,length);|
_______________________________________________
Parameters
status 32-bit signed integer by reference
Passes the status of a previous Hewlett-Packard
MERGE intrinsic call that failed. The status value
passed in is used to locate the appropriate message
catalog entry associated with the status value.
If no errors or warnings were encountered, status
returns 32-bits of zero. If errors or warnings
were 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
represented by these bits defines the subsystem
that set the status information. The subsystem
identifier for HPMERGEERRORMESS is 196.
NOTE HPMERGEERRORMESS returns information on the success of its
execution in the status parameter. It is good programming practice
to specify this parameter and check its value after the intrinsic
call. If an error or warning condition is encountered, and you did
not specify the status parameter, HPMERGEERRORMESS causes the
calling process to abort.
message character array (optional)
Returns the text of the error message. This
parameter may be up to 80 characters long.
length 32-bit signed integer by reference (optional)
Returns the length of the message parameter.
Related Information
Intrinsics Hewlett-Packard SORT, Hewlett-Packard MERGE
Commands None
Manuals SORT-MERGE/XL Programmer's Guide (32650-90080)