HPlogo MPE/iX Intrinsics Reference Manual > Chapter 8 Command Definitions (HPMERGEEND-LOGSTATUS)

HPMERGESTAT

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

NM callable only.

Prints MERGE/XL statistics on $STDLIST.

Syntax



               I32     I32A
  HPMERGESTAT (status, statistics);

Parameters


status

32-bit signed integer by reference (optional)

Returns the status of the HPMERGESTAT 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 HPMERGESTAT is 196.

statistics

32-bit signed integer array (optional)

Contains the following statistical information about the MERGE/XL operation:

  • Number of input files

  • Number of merged records

  • Number of bytes used for the MERGE/XL work area

  • CPU time in milliseconds

  • Elapsed time in milliseconds

This parameter is returned from the HPMERGEEND intrinsic.


NOTE: The statistics array is the same array that was passed to the HPMERGEINIT and HPMERGEEND intrinsics. It must be referenced by the same name.

Operation Notes


Call HPMERGESTAT after you have called the HPMERGEEND intrinsic. A call to HPMERGESTAT is valid only if you supplied the statistics parameter in the calls to the HPMERGEINIT and HPMERGEEND intrinsics. The same array is then supplied to HPMERGESTAT.

Related Information


Intrinsics HPMERGEEND, HPMERGEERRORMESS, HPMERGEINIT, HPMERGEOUTPUT, HPMERGETITLE, MERGEEND, MERGEERRORMESS, MERGEINIT, MERGEOUTPUT, MERGESTAT, MERGETITLE
Manuals SORT-MERGE/XL Programmer's Guide




HPMERGEOUTPUT


HPMERGETITLE