MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 8 415
Command Definitions (HPMERGEEND-LOGSTATUS)
HPMERGEOUTPUT
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 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
Manual SORT-MERGE/XL Programmer's Guide