FastSort Manual

Introduction to FastSort

FastSort Manual—429834-003

1-7

Programmatic FastSort

Programmatic FastSort consists of system procedures that are called by user-written

applications and the interactive SORT process. The FastSort procedures manage the

process creation, control, and communication for the SORTPROG process. You can

use procedure calls in an application program to specify the same parameters that you

can specify with FastSort interactive commands.

Table 1-2 summarizes the procedures in programmatic FastSort, in the order in which

you would normally call them.

Process Control

EXIT Ends the interactive FastSort session (same as Ctrl-Y).

RUN Starts a sort or merge run and optionally specifies the SORTPROG

process start parameters, the allocation of required disk space, and

whether duplicate records should be removed.

Table 1-2. FastSort System Procedures

Procedure Name Description

SORTBUILDPARM Specifies parameters for parallel sorting and record blocking.

SORTMERGESTART Begins the SORTPROG process and passes parameters for

a sort or merge run from the calling process to SORTPROG.

SORTMERGESEND Sends input records from the calling process to the

SORTPROG process, one for each call.

SORTMERGERECEIVE Returns output records from the SORTPROG process to the

calling process, one for each call.

SORTERROR Provides the message text for the last FastSort error code

returned by a procedure.

SORTERRORDETAIL Provides the FastSort error code for the most recent error

and if an input file caused the error, identifies the input file.

SORTERRORSUM Provides information that SORTERROR and

SORTERRORDETAIL provide and identifies the cause of the

most recent error.

SORTMERGESTATISTICS Reports information about a sort or merge run and ends the

run.

SORTMERGEFINISH Ends the sort or merge run and stops the SORTPROG

process.

Table 1-1. FastSort Interactive Commands (page2of2)

Command Description