FastSort Manual

Using SORT and SUBSORT DEFINEs
FastSort Manual—429834-003
7-4
Setting SORT DEFINE Attributes
PROGRAM file-name
specifies a local or remote program file name to run in place of the default program
file, such as:
SET DEFINE PROGRAM $data.fastsort.sortprog
SCRATCH file-name
specifies a disk file name or disk volume name for an initial scratch file. This
attribute is required. For example:
SET DEFINE SCRATCH $data.fastsort.scratch
If the file already exists, it must be unstructured. If the initial scratch file becomes
full, then either the SCRATCHON or NOSCRATCHON attribute determines the
volume for an overflow scratch file.
SCRATCHON (volume-name [, volume-name ]...)
specifies volumes that FastSort should use for overflow scratch files. If the volume
specified in the SCRATCH attribute becomes full, FastSort tries to create additional
overflow scratch files on a SCRATCHON volume. To specify a list of volume
names, enclose the names in parentheses and separate with commas, as follows:
SET DEFINE SCRATCHON ( $data4 , $data5 )
FastSort recognizes the wild-card characters * and ? for the SCRATCHON
attribute. For example:
SET DEFINE SCRATCHON $data*
specifies as available for overflow scratch files all volumes whose names begin
with the string $data.
SET DEFINE SCRATCHON $data?
specifies as available for overflow scratch files those volumes whose names begin
with the string $data and contain a single trailing character.
You can specify up to 31 SCRATCHON volumes. If you specify SCRATCHON, you
cannot specify NOSCRATCHON. Note that this attribute requires up to 276
additional bytes of stack space.
SEGMENT size
specifies the size in pages of the extended data segment for FastSort, such as:
SET DEFINE SEGMENT 256
The value must be at least 256 pages but must not represent more than 90 percent
of available memory. If you specify SEGMENT, you must omit MODE. The default
is the same as MODE AUTOMATIC.