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

Libraries and Utility Routines
HP COBOL Manual for TNS/E Programs—520347-003
13-39
COBOL_SET_SORT_PARAM_VALUE_
°
CPU
specifies a processor in which the sort or subsort is to occur.
°
CREATE-NEW-OUTPUT
specifies whether the output (GIVING) file is to be created anew or the existing
output file is to be used.
subsort-or-file-number must not be specified or must be 0.
°
CREATE-NEW-SCRATCH
specifies whether the scratch file is to be created anew or the existing scratch
file is to be used.
Allowable
Value for
param-value Meaning
-1 If the param-value associated with SUBSORT-COUNT is 0 or
has not been specified, the sort process selects a processor.
If the param-value associated with SUBSORT-COUNT is
greater than 1, the selection of a processor depends on subsort-
or-file-number:
•
If subsort-or-file-number is 0 or not specified, the
processor for the distributor/collector process will be the
same as that in which the run unit is executing.
•
If subsort-or-file-number is greater than 0, the sort
process will select a processor for the specified subsort
depending on CPU-MASK and NO-CPU-MASK.
0 - maximum
processor
number of the
system
Specifies a specific processor. If the param-value associated
with SUBSORT-COUNT is 0 or not specified the processor
selected will be used for the distributor/collector process. If
subsort-or-file-number is specified, it indicates which
subsort will use the specified processor.
Allowable Value
for param-value Meaning
0 (default) If the output file exists and is large enough for the sort, the data
is purged from the file. If the file is too small, the file is purged
and a new one is created.
nonzero The file is purged and a new one is created.
Allowable Value
for param-value Meaning
0 (default) If the scratch file exists and is large enough for the sort, the
data is purged from the file. If the file is too small, the file is
purged and a new one is created.
nonzero The file is purged and a new one is created.