HP 3000 Manuals

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