COBOL Manual for TNS/E Programs (H06.03+)

Libraries and Utility Routines
HP COBOL Manual for TNS/E Programs—520347-003
13-43
COBOL_SET_SORT_PARAM_VALUE_
°
OUT-FILE-FORMAT
specifies the format of the output file.
Allowable values are 0, 1, 2, and 3. The default value is 0. See the FastSort
Manual for details.
This parameter may cause problems if the record area is not large enough or
too large. Use it with caution.
subsort-or-file-number must not be specified or must be 0.
°
PRIORITY
specifies the desired execution priority of the sort or subsort process.
If the param-value associated with SUBSORT-COUNT is 0 or not specified,
PRIORITY applies to the normal process and subsort-or-file-number
must be omitted or 0.
If the param-value associated with SUBSORT-COUNT is greater than 0,
subsort-or-file-number specifies the subsort to which the priority
applies; 0 refers to the distributor/collector process.
°
REMOVE-DUPLICATES
specifies whether FastSort should remove records with duplicate keys during
the sort operation.
subsort-or-file-number must not be specified or must be 0.
°
SAVE-SCRATCH
specifies whether FastSort should save the scratch file after a sort run.
Allowable Value
for param-value Meaning
-1 (default) The process is to have the same priority as the calling
process.
1 - 199 Specifies the desired priority.
Allowable Value for
param-value Meaning
0 (default) Duplicates are not to be removed.
nonzero FastSort must remove every record whose keys duplicate
those of a previous record.
Allowable Value
for param-value Meaning
0 (default) FastSort must purge the scratch file after the sort run.
nonzero FastSort must save the scratch file, if it has an explicit name
(provided by a call to COBOL_SET_SORT_PARAM_TEXT_
with the SCRATCH-FILE parameter).