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

library-reference
is a mnemonic-name in the SPECIAL-NAMES paragraph. This mnemonic-name is associated
with the DLL containing an object copy of COBOL_SET_SORT_PARAM_VALUE_.
sd-name
is the COBOL name of a file defined in an SD entry. The specification of the remaining
parameter is applied to any subsequent SORT statements that refer to this file name. If a
subsequent call to a FastSort routine refers to the same file name and to the same parameter,
that call resets the specifications for any subsequent sort operations that refer to the same file
name. Certain parameters can be reset to their default values, as indicated in the discussion
of the parameters below.
param-id
is an alphanumeric data item whose contents identify the parameter whose value is to be set.
The values param-id might contain are:
SAVE-SCRATCHMINSPACEBUFFER-SIZE
SCRATCH-BLOCKMINTIMECPU
SCRATCH-CHECKNOPURGE-OUTPUTCREATE-NEW-OUTPUT
SECOND-BUFFERNOWAIT-IOCREATE-NEW-SCRATCH
SEGMENTOUT-FILE-EXCLDATA-SLACK
SUBSORT-COUNTOUT-FILE-FORMATIN-FILE-COUNT
OUT-FILE-EXCLPRIORITYIN-FILE-EXCL
SYSTEMREMOVE-DUPLICATESINDEX-SLACK
Any letter in the value can be either uppercase or lowercase.
If param-id, param-value, and subsort-or-file-number are all omitted, the run-time
routines reset all values and texts previously set for sd-name to their default values. This option
releases the option block (about 700 characters long), so you may wish to use it if the SD will
not be referenced again in this program.
param-value
is a numeric operand whose value gives the value to be used for the parameter specified by
param-id. If this parameter is omitted, any value previously set for this value of param-id
will be reset to its default value.
In the case where a value may be zero or nonzero, the nonzero value must be greater than
-2,147,483,648 and less than 2,147,483,648. If it is outside this range, an arithmetic overflow
will result when the ENTER statement executes.
The value of param-value depends on the value of param-id. See Usage Considerations.
subsort-or-file-number
is a numeric operand whose value is the sort process to which the parameter pertains or, if
the parameter applies to a file, it is a file ordinal.
If a subsort-number is being supplied, the number of subsorts must have been set previously
(with the SUBSORT-COUNT parameter) and subsort-number must be in the range 1 to that
number. Subsort-number must be 0 if the parameter applies to the distributor/collector process
or if the number of subsorts has been set to zero (a normal sort is implied). In the latter case,
the parameter applies to the normal sort.
624 Libraries and Utility Routines