MPE/iX Intrinsics Reference Manual (32650-90875)

612 Chapter10
Command Definitions (QUIT-ZSIZE)
SORTOUTPUT
SORTOUTPUT
NM and CM callable.
Provides an alternative method of specifying how records are output from the SORT
program.
Syntax
CA I16
SORTOUTPUT(
record,length );
Parameters
record 16-bit character array
Returns the next output record. The format of this record is specified in
the
outputoption parameter of the SORTINIT intrinsic.
length 16-bit signed integer
Returns the length of the
record parameter value. When no more records
remain, the value of this parameter is set to -1.
Operation Notes
SORTOUTPUT signals the beginning of the SORT program and receives each output record
from the SORT program into an array specified by the
record parameter. SORTOUTPUT
signals the end of the input process if SORTINPUT intrinsic is called. Use SORTOUTPUT only
if the
outputfiles parameter in a call to the SORTINIT intrinsic is not specified. If
SORTINPUT is called, then SORTOUTPUT is called only after SORTINPUT has passed all
records. A call to SORTOUTPUT always precedes a call to the SORTEND intrinsic.
NOTE If you are coding a CM application, you must call SORTEND in the same
routine in which you call the SORTINIT intrinsic. This is not the case when
you code an NM application.
Condition Codes
CCE (2) Request granted. No error occurred during the SORT program.
CCG (0) Not returned.
CCL (1) Request denied. An error occurred during the SORT program.
Related Information
Intrinsics HPSORT, HPMERGE
Manual SORT-MERGE/XL Programmer's Guide