HP 3000 Manuals

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