MPE/iX Intrinsics Reference Manual (32650-90875)

442 Chapter8
Command Definitions (HPMERGEEND-LOGSTATUS)
HPSORTSTAT
HPSORTSTAT
NM callable only.
Prints the SORT/XL statistics on $STDLIST.
Syntax
I32 I32A
HPSORTSTAT(
status,statistics );
Parameters
status 32-bit signed integer by reference (optional)
Returns the status of the HPSORTSTAT 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 HPSORTSTAT is 195.
statistics 32-bit signed integer array (optional)
Contains the following statistical information about the SORT/XL
operation:
• Number of sorted records
• Number of intermediate passes
• Number of bytes used for the work area
• Number of compares
• CPU time in milliseconds
• Elapsed time in milliseconds
This parameter is returned from the HPSORTEND intrinsic.
NOTE The statistics array should be the same array that was passed to the
HPSORTINIT and HPSORTEND intrinsics. It must be referenced by the same
name.