FastSort Manual

Using FastSort System Procedures
FastSort Manual—429834-003
5-3
SORTBUILDPARM Procedure
The call to SORTBUILDPARM must precede the call to SORTMERGESTART.
SORTBUILDPARM stores your parameters in the sort control block, and
SORTMERGESTART passes the parameters to the SORTPROG process.
status returned value
INT
returns a FastSort error code if an error occurred; if not, status returns 0.
ctlblock input
INT:ref:200
is the same global storage array you name in the call to SORTMERGESTART. You
should not rely on the information in ctlblock, because this information can
change without warning.
cpu-mask input
INT:value
specifies processors (CPUs) in which FastSort can run subsort processes.
FastSort can use a processor number (0 – 15) if the respective bit of the mask is
set to on. If you omit cpu-mask or the call to SORTBUILDPARM, all bits of the
mask are on. The not-cpu-mask parameter can override bit settings of cpu-
mask.
not-cpu-mask input
INT:value
specifies the processors (CPUs) in which subsort processes cannot run. FastSort
cannot use a processor number (0 – 15) if the respective bit of the mask is set to
on.
buffer input
INT(32):value
{ status := } SORTBUILDPARM ( ctlblock ! i
{ CALL } ,[ cpu-mask ] ! i
,[ not-cpu-mask ] ! i
,[ buffer ] ! i
,[ buffer2 ] ! i
,[ buffer-length ] ! i
,[ build-flags ] ! i
,[ define-name ] ! i
, reserved1 ! reserved
, reserved2 ! reserved
,[ scratchvols ] )! i