HPMERGEERRORMESS

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