MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 8 437
Command Definitions (HPMERGEEND-LOGSTATUS)
HPSORTINIT
retrieve the sorted records.
outputoption 32-bit signed integer by value (optional)
Passes a value determining the format of the output records:
Value Meaning
0 Output record the same as input record (default)
1 Output record, a 32-bit integer output in binary format,
value is the logical (relative) record number of the record
2 Output record contains only the key fields, concatenated
together with the major keys on the left, followed by the
remaining keys
3 Output record is the logical record number (in binary
format) followed by the key fields
reclength 32-bit signed integer by value (optional)
Maximum length of a record in bytes. If you do not specify
reclength , the
record length is taken from the first file specified in the
inputfiles
parameter. If you do not specify inputfiles , you must specify this
parameter.
numrecs 32-bit signed integer by value (optional)
Upper bound to the number of records to be sorted. Use
numrecs only if all
input records do not reside on disk.
numrecs may be used to determine the
size of the temporary scratch files that SORT builds. The size of the
scratch file(s) that SORT uses is calculated in the following way:
If all records are on disk, the size of the scratch file number is derived from
the current EOF value of the input file and any value supplied for this
parameter is ignored. (If there are multiple input files, then the sum of
their EOFs is used).
If all files to be sorted do not reside on disk, or if you do not specify any
input files at all, and you supply this parameter,
numrecs will determine
the size of the scratch file(s). Otherwise if you do not supply this
parameter, a default value of 10,000 records per tape file is used.
numkeys 32-bit signed integer by value (optional)
Number of keys used during the comparison of records. This parameter
can be either equal to or greater than one. If you specify the
numkeys
parameter, you must also specify the keys parameter. Together, numkeys
and keys describe the way records are sorted.
keys 32-bit integer array (optional)
Passes information about the keys used during the comparison of records.
If you specify the
keys parameter, you must specify the numkeys
parameter. Together, keys and numkeys describe the way records are
sorted.
For each key, there are four entries in the array. The first element gives the