HP 3000 Manuals HP 3000 Manuals
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
(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).