HPSORTOUTPUT
MPE documents | |
 Complete PDF | |
| Table of Contents | |
| Index | |
| Edition 7 E0701 ♥ | |
| Edition 7 E0300 | |
| Edition 6 E0195 |
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 | HPSORTEND, HPSORTERRORMESS, HPSORTINIT, HPSORTINPUT, HPSORTSTAT, HPSORTTITLE, SORTEND, SORTERRORMESS, SORTINIT, SORTINPUT, SORTOUTPUT, SORTSTAT, SORTTITLE |
| Manuals | SORT-MERGE/XL Programmer's Guide |
|
HPSORTINPUT |
HPSORTSTAT |