HPMERGEOUTPUT

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