HPSORTSTAT

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.

Operation Notes

Related Information