MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 8 411
Command Definitions (HPMERGEEND-LOGSTATUS)
HPMERGEINIT
HPMERGEINIT
NM callable only.
Initializes the MERGE/XL subsystem.
Syntax
I32 I32A PROC I32A
HPMERGEINIT(
status
,
inputfiles
,
preprocessor,outputfiles,
PROC 32V I32V
postprocessor,keysonly,numkeys
,
I32A CA PROC PROC
keys,altseq,keycompare,errorproc,
I32A I32V I32A
statistics,memsize,charseq)
;
Parameters
status
32-bit signed integer by reference (optional)
Returns the status of the HPMERGEINIT 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 HPMERGEINIT is 196.
inputfiles
32-bit signed integer array (optional)
Passes the file identification numbers of the input files to be merged. The
last element of this array should be set to zero. If the files are opened with
either the NOBUF or MR (multirecord) access option, MERGE/XL program
performs the buffering and blocking/deblocking.
preprocessor
procedure (reserved)
Do not specify this parameter, but maintain parameter position.
outputfiles
32-bit signed integer array (optional)
Passes the file identification number of the output file in the first array
element. If the file is opened with either the NOBUF or MR (multirecord)
access option (
aoption
), MERGE/XL performs the buffering and
blocking/deblocking.
If you do not specify this parameter, you must call the HPMERGEOUTPUT