MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 8 409
Command Definitions (HPMERGEEND-LOGSTATUS)
HPMERGEERRORMESS
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 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