MPE/iX Intrinsics Reference Manual (32650-90875)

416 Chapter8
Command Definitions (HPMERGEEND-LOGSTATUS)
HPMERGESTAT
HPMERGESTAT
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.