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

Libraries and Utility Routines
HP COBOL Manual for TNS/E Programs—520347-003
13-42
COBOL_SET_SORT_PARAM_VALUE_
°
NOPURGE-OUTPUT
specifies whether FastSort is to purge an existing output (GIVING) file if it
seems too small.
subsort-or-file-number must not be specified or must be 0.
•
NOWAIT-IO
specifies whether FastSort performs NOWAIT I-O in passing records to and
from the HP COBOL run-time interface (for input and output procedures, for
example).
subsort-or-file-number must not be specified or must be 0. If param-
value is nonzero, you must also specify SECOND-BUFFER.
NOWAIT-IO is ignored if the file if being read or written by FastSort. If
SECOND-BUFFER is not specified, FastSort error 74 occurs. If SECOND-
BUFFER cannot be allocated, run-time error 123 occurs, followed by FastSort
error 74.
°
OUT-FILE-EXCL
specifies the exclusion mode with which the sort opens a GIVING file.
Allowable values are:
subsort-or-file-number must not be specified or must be 0.
Allowable Value for
param-value Meaning
0 (default) FastSort purges an existing GIVING file that seems too
small before writing the new data to it.
nonzero FastSort does not purge an existing GIVING file that seems
too small unless it has the wrong file type or wrong record
length.
Allowable Value for
param-value Meaning
0 (default) FastSort must use waited I-O.
nonzero FastSort must use NOWAIT I-O.
Value Exclusion Mode Specified
-1 Default (exclusive for disk or tape, shared for any other file type)
0Shared
1 Exclusive
3 Protected