FastSort Manual

Using FastSort System Procedures
FastSort Manual—429834-003
5-18
SORTMERGESEND Procedure
record-loc-ext input
INT(32)
is the extended memory location of an input record. You must specify
record-loc-ext or record-loc, but you cannot specify both parameters.
record-loc-ext must be used instead of record-loc, for records of size
greater than 4072 bytes.
Guidelines
Follow these guidelines when you call the SORTMERGESEND procedure.
Omitting the Input File Name or Names
If you omit the in-file-name parameter from the call to SORTMERGESTART or if
in-file-name equals all blanks, you must call SORTMERGESEND to provide
records for sorting or merging. Each call to SORTMERGESEND gives SORTPROG
one input record.
Supplying Records From SORTMERGESEND for a Single Run
You cannot supply records from both SORTMERGESEND and disk files for the same
sort or merge run.
SORTMERGESEND can send input records for sorting or for merging but cannot send
records for both operations in the same run.
Sending Input Records From Extended Memory
You can send each input record from an extended data segment (which must be in use
at the time of the call). If you want SORTMERGESEND to send a record from a
location in an extended segment, specify record-loc-ext instead of record-loc
for the address of the record.
Blocking Records to Reduce Interprocess Messages
You can specify a single or double buffer for record blocking and deblocking in a call to
SORTBUILDPARM. SORTMERGESTART provides the buffer to transfer a block of
records instead of a single record in each interprocess message to or from
SORTPROG. Each call to SORTMERGESEND puts a record into this buffer.
For more information, see SORTBUILDPARM Procedure
on page 5-2.
Record blocking is valid only for sort runs. If you try to use record blocking with merge
runs, SORTPROG returns sort error 81 (BLOCKED INTERFACE NOT ALLOWED
WITH MERGE).