 |
» |
|
|
|
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 (32650-90066, 32650-90152, and 32650-90368) 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 - Commands
None - Manuals
SORT-MERGE/XL Programmer's Guide (32650-90080).
|
