FastSort Manual

Using FastSort System Procedures
FastSort Manual—429834-003
5-38
SORTMERGESTATISTICS Procedure
,sorterrproc );
...
SORTMERGESTATISTICS Procedure
Use SORTMERGESTATISTICS to obtain information about a successful sort or merge
run after SORTPROG completes the run.
status returned value
returns a FastSort error code if an error occurred; if not, status returns 0.
ctlblock input
INT:ref:200
is the global storage array named in the call to SORTMERGESTART. You should
not rely on the information in ctlblock, because this information can change
without warning.
length input, output
INT:ref:*
indicates the length, in words, of the SORTPROG statistics that
SORTMERGESTATISTICS returns after run completion. You can set length to
the number of words you want returned, from 1 to 22. When
SORTMERGESTATISTICS returns statistics, it sets length to the number of
words actually returned. The default value for length is 0, which causes
SORTMERGESTATISTICS to not return any statistics.
Values less than 0 or greater than 21 when flag1 = 0 or greater than 22 when
flag1 = 1 will yield error 149 (INVALID STATISTICS LENGTH SPECIFIED).
statistics output
INT:ref:21 (flag1 = 0 or does not exist)
INT:ref:22 (flag1 = 1)
is a 21-word or 22-word array into which SORTPROG returns the statistics. The
array is 21 words long if VLM is off and 22 words long if VLM is on. For a
description of this array, see Table 5-5
on page 5-39. For more information about
the VLM option, see Using VLM
on page 9-10.
{ status := } SORTMERGESTATISTICS ( ctlblock ! i
{ CALL } ,length ! i, o
,statistics ! o
,[flag1 ] ! i
,[spare1 ] !reserved