HPMERGESTAT [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation
MPE/iX Intrinsics Reference Manual
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
(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 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 Hewlett-Packard SORT, Hewlett-Packard MERGE
Commands None
Manuals SORT-MERGE/XL Programmer's Guide (32650-90080)
MPE/iX 5.0 Documentation