MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 8 441
Command Definitions (HPMERGEEND-LOGSTATUS)
HPSORTOUTPUT
HPSORTOUTPUT
NM callable only.
Retrieves records, one at a time, from SORT/XL program.
Syntax
I32 CA I32
HPSORTOUTPUT(
status,buffer,length );
Parameters
status 32-bit signed integer by reference (optional)
Returns the status of the HPSORTOUTPUT call. If no errors or warnings are
encountered,
status returns 32 bits of zero. If errors or warnings are
encountered,
status is interpreted as two 16-bit fields.
Bits (0:16) comprise
status.info . A negative value indicates an error
condition, and a positive value indicates a warning condition. Refer to the
MPE/iX Error Message Manual Volumes 1, 2 and 3 for a description of its
value.
Bits (16:16) comprise
status.subsys . The value represented by these bits
defines the subsystem that set the status information. The subsystem
identifier for HPSORTOUTPUT is 195.
buffer character array (optional)
Returns the next output record. The format of this record is as specified in
the
outputoption parameter of the HPSORTINIT intrinsic.
length 32-bit signed integer by reference (optional)
Returns the length of the
record parameter value. When no more records
remain, the value of this parameter is set to -1.
Operation Notes
Provides an alternative method for retrieving output records from SORT/XL.
HPSORTOUTPUT puts each output record from SORT/XL into the array specified by the
buffer parameter. If the HPSORTINPUT intrinsic was used, HPSORTOUTPUT signals the end
of the input process; call HPSORTOUTPUT only after HPSORTINPUT has passed all records.
Use HPSORTOUTPUT only if the
outputfiles parameter was not specified in the call to
HPSORTINIT. A call to HPSORTOUTPUT always precedes a call to HPSORTEND.
Related Information
Intrinsics HPSORT, HPMERGE
Manual SORT-MERGE/XL Programmer's Guide