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.)
Printable version
