HPMERGEOUTPUT [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation
MPE/iX Intrinsics Reference Manual
HPMERGEOUTPUT
NM callable only.
Retrieves records, one at a time, from MERGE/XL.
Syntax
___________________________________________
| |
| I32 CA I32 |
| HPMERGEOUTPUT(status,buffer,length);|
___________________________________________
Parameters
status 32-bit signed integer by reference (optional)
Returns the status of the HPMERGEOUTPUT 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 HPMERGEOUTPUT is 196.
buffer character array (optional)
Returns the next output record. The record format
is determined by the value of the keysonly
parameter in the HPMERGEINIT intrinsic.
length 32-bit signed integer by reference (optional)
Returns the length (in bytes) of the buffer
parameter value. Returns a length value of -1 when
no more records remain.
Related Information
Intrinsics Hewlett-Packard SORT, Hewlett-Packard MERGE
Commands None
Manuals SORT-MERGE/XL Programmer's Guide (32650-90080).
MPE/iX 5.0 Documentation