HPlogo 900 Series HP 3000 Computer Systems: MPE/iX Intrinsics Reference Manual > Chapter 4 Command Definitions

HPMERGEERRORMESS

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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)

Feedback to webmaster