HPSORTSTAT [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation
MPE/iX Intrinsics Reference Manual
HPSORTSTAT
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).
MPE/iX 5.0 Documentation