MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 8 433
Command Definitions (HPMERGEEND-LOGSTATUS)
HPSORTEND
HPSORTEND
NM callable only.
Releases the SORT/XL work area and ends the sorting operation.
Syntax
I32 I32A
HPSORTEND(
status,statistics );
NOTE HPSORTEND must be called to terminate SORT/XL and release the work space.
Parameters
status 32-bit signed integer by reference (optional)
Returns the status of the HPSORTEND call. If no errors or warnings are
encountered,
status returns 32 bits of zero. If errors or warnings are
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 HPSORTEND is 195.
statistics 32-bit signed integer array (optional)
Returns SORT/XL operation information:
Value Meaning
1 Number of records sorted
2 Number of intermediate passes
3 Number of bytes used for the Hewlett-Packard SORT
program work area
4 Number of compares
5 CPU time used in milliseconds
6 Elapsed time in milliseconds
NOTE The statistics array should be the same array that was passed to the
HPSORTINIT intrinsic. It must be referenced by the same name.