COBOL Manual for TNS and TNS/R Programs

Libraries and Utility Routines
HP COBOL Manual for TNS and TNS/R Programs—522555-006
13-52
COBOL85^SET^SORT^PARAM^TEXT and
COBOL_SET_SORT_PARAM_TEXT_
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 or MERGE statements
that refer to this file name. If a subsequent call to a FastSort routine refers to the
same sd-name and to the same parameter, that call resets the specifications for
any subsequent SORT or MERGE statements 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 one of:
CPU-MASK
SCRATCH-FILE
SWAP-FILE
NO-CPU-MASK
SORT-PROGRAM
param-text
is the identifier of an alphanumeric data item whose contents is used for the
parameter specified by param-id. If this parameter is omitted, any text previously
set for this value of param-id is reset to its default value.
The value of param-text depends on the value of param-id and sometimes
on the value of subsort-number (see Table 13-17).
subsort-number
is a numeric operand whose value specifies the sort process to which the
parameter pertains. The number of subsorts must have been set previously, and
the specified subsort-number must be in the range 0 to that number.
The value of subsort-number depends on the value of param-id
(seeTable 13-17
).
return-code
is an identifier of a numeric data item in which an error value will be returned. The
expected values and their respective meanings are:
Value Meaning
0 The call was correct.
1 file-name does not name a sort-merge file.
2 param-id is not one of the allowed values.
3 param-text does not conform to the expected values.
4 subsort-number was not within the range of the specified number of
subsorts.
5 Space for the options block cannot be allocated.