HPlogo SORT-MERGE/XL Programmer's Guide > Chapter 1 Introduction

Error Checking

MPE documents

Complete PDF
Table of Contents
Index

Good programming practice specifies that each intrinsic call should be checked to ensure that the call was successful. Each intrinsic contains a status parameter that returns a value indicating the success or failure of the routine.

If no error occurred with the intrinsic call, a value of zero (0) is returned in the status parameter.

If an error did occur with the intrinsic call, the first 16 bits, bits (0:16), of status contain the error condition code. The first 16 bits are always negative; all SORT-MERGE/XL errors are fatal. HPSORT and HPMERGE status returns are in Appendixes A and B.

The last 16 bits, bits (16:16), of status contain the subsystem identification number. The subsystem number for SORT/XL is 195. The subsystem number for MERGE/XL is 196. (Refer to the MPE/iX Intrinsics Reference Manual for information about calculating the error number and subsystem from the status parameter.)

The HPMERGEERRORMESS and HPSORTERRORMESS intrinsics return the appropriate error message for each of these error code values. (For information about the use of the error message intrinsics, refer to Chapter 2.)




Keys


Large File Support