HPlogo 900 Series HP 3000 Computer Systems: MPE/iX Intrinsics Reference Manual > Chapter 4 Command Definitions

HPSORTSTAT

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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 (32650-90066, 32650-90152, and 32650-90368) 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

Call HPSORTSTAT after you have called the HPSORTEND intrinsic. A call to HPSORTSTAT is valid only if the statistics parameter is specified to the HPSORTINIT and HPSORTEND intrinsics. The same array is supplied to HPSORTSTAT.

Related Information

Intrinsics

HPSORT, HPMERGE

Commands

None

Manuals

SORT-MERGE/XL Programmer's Guide (32650-90080).

Feedback to webmaster