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

HPSORTEND
» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

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 (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 HPSORTEND is 195.

statistics

32-bit signed integer array (optional)

Returns SORT/XL operation information:

ValueMeaning
1Number of records sorted
2Number of intermediate passes
3Number of bytes used for the Hewlett-Packard SORT program work area
4Number of compares
5CPU time used in milliseconds
6Elapsed 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.

Operation Notes

HPSORTEND initiates the merge phase of the Hewlett-Packard SORT program and writes to the output file if the HPSORTOUTPUT intrinsic is not used. HPSORTEND is required if you called HPSORTINIT. Call HPSORTEND either after all calls to the output file are completed by the HPSORTINIT intrinsic, or after all calls to the HPSORTOUTPUT intrinsic are completed. HPSORTEND must be called in the same process as the HPSORTINIT intrinsic.

Related Information

Intrinsics

HPSORT, HPMERGE

Commands

None

Manuals

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



HPSETDUMP
  		 


HPSORTERRORMESS  
Feedback to webmaster