HP 3000 Manuals HP 3000 Manuals
New Intrinsic Overview HPSORT-HPMERGE intrinsics are used in the same way that SORT-MERGE intrinsics are: they correspond one-to-one in their placement in programs. In NM, using HPSORT-HPMERGE intrinsics is more efficient. Although the two sets of intrinsics coordinate closely, they differ in certain areas: parameter data types, error checking, and miscellaneous parameter changes. Data Types MPE V/E architecture is based on a 16-bit word, and the MPE XL emulates this environment in CM. MPE XL architecture is based on a 32-bit word, and the HPSORT-HPMERGE intrinsic parameters adhere to the 32-bit standards. The 16-bit parameters you use in SORT-MERGE calls are 32-bit parameters when they are used in HPSORT-HPMERGE calls. Error Checking HPSORT-HPMERGE intrinsics have an optional status parameter, a 32-bit signed integer passed by reference. The status parameter is optional, but recommended. If an error or warning condition is encountered, and you did not specify the status parameter, your process will abort. Using the status parameter is analogous to using condition codes and the PRINTFILEINFO intrinsic. The parameter has two 16-bit fields. One reports errors and warnings, and the other indicates the subsystem where they occurred. The status parameter codes are interpreted in the appendixes of SORT-MERGE/XL Programmer's Guide (32650-90080), and in the MPE XL Intrinsics Reference Manual (32650-90028). Parameter Changes This is an overview of the parameter differences between SORT-MERGE intrinsics and HPSORT-HPMERGE counterparts. Every HPSORT-HPMERGE intrinsic call has status as its first optional parameter so that information will not be repeated for each intrinsic. The data type difference mentioned above is also not repeated for each intrinsic. For details about the HPSORT-HPMERGE intrinsics, refer to MPE XL Intrinsics Reference Manual (32650-90028). HPMERGEEND and HPSORTEND (NM) (new). Use the new statistics parameter in the HPMERGEINIT, HPMERGEEND, and HPMERGESTAT or the HPSORTINIT, HPSORTEND, and HPSORTSTAT intrinsics to obtain and print statistical information.
NOTE The statistics parameter does not return the number of compares for HPSORT-MERGE intrinsics.
HPMERGEERRORMESS and HPSORTERRORMESS (NM) (new). In MPE V/E, you use errorcode for checking error conditions and returning intrinsic status. In MPE XL NM, use the status parameter instead. HPMERGEINIT and HPSORTINIT (NM) (new). The altseq parameter, a character array for the HPSORT-HPMERGE intrinsics, is different. The character values are the character representations of the integer array used for in the SORT-MERGE intrinsic counterparts. You can indicate the new IEEE format for floating-point real numbers in the keys parameter. The statistics parameter is different. statistics does not return the number of comparisons. The failure and errorparam parameters are not used in the HPSORT-HPMERGE intrinsics. The MPE V/E spaceallocation is now called memsize in MPE XL NM. HPMERGEOUTPUT, HPSORTINPUT, and HPSORTOUTPUT (NM) (new). Change record to buffer: The parameter name has changed, but the parameter has the same meaning. HPMERGESTAT and HPSORTSTAT (NM) (new). The statistics parameter is now required in MPE XL NM.