 |
» |
|
|
|
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 (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 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 intrinsic to retrieve merged records.
- postprocessor
procedure (reserved) Do not specify this parameter, but maintain parameter position.
- keysonly
32-bit signed integer by value (optional) Flag that determines if only keys are sent as output. If set to 0, the entire record
is sent as output. If set to any value other than 0, the key fields are concatenated
together with he major key on the left and the remaining keys following.
Default: 0 - numkeys
32-bit signed integer (optional) Number of keys used during the comparison of records.
This parameter can be either equal to or greater than one.
If you specify the numkeys parameter, you must also specify
the keys parameter. Together, numkeys and keys describe
the way records are merged.
- keys
32-bit signed integer array (optional) Passes information about the keys used during the comparison of
records. If you specify the keys parameter, you must specify
the numkeys parameter.
Together, keys and numkeys describe the way records
are merged. For each key, there are four entries in the array. The first element gives the position of the first byte of the key
within the input record.
The second element gives the number of bytes in the key.
The third element indicates the type of data:
| Value | Meaning |
|---|
| 0 | Byte type (ASCII or EBCDIC) | | 1 | Twos complement (including 16-bit and 32-bit signed integer) | | 2 | Hewlett-Packard 3000 floating-point format (including real and long) | | 3 | IEEE standard floating-point format (32-bit, 64-bit, and 128-bit values) | | 4 | Packed decimal with odd number of digits | | 5 | Packed decimal with even number of digits | | 6 | Display trailing sign | | 7 | Display leading sign | | 8 | Display trailing sign separate | | 9 | Display leading sign separate | | 10 | Character | | 11 | Reserved for the operating system | | 12 | Short floating-point decimal | | 13 | Floating-point decimal |
The fourth element gives the ordering sequence of the records:
| Value | Meaning |
|---|
| 0 | ascending | | 1 | descending |
| | | |  | NOTE:
The integrity of the keys array must be maintained
throughout the MERGE/XL operation. Do not change it until after
you have called the HPMERGEEND intrinsic. | | | | |
- altseq
character array (optional) Passes an alternate collating sequence. The first
element is specified according to the following table,
where the sequence comprises the columns and the data
comprises the rows:
excess space above nonumber table—> | | ASCII | EBCDIC | ALTSEQ | | ASCII | chr(255) | chr(2) | chr(0) | | EBCDIC | chr(1) | chr(255) | undefined |
The second element specifies one fewer than the total
number of characters in the collating sequence. If the first element is CHR(0),
the remaining array elements comprise the actual collating sequence
responsible for the particular MERGE/XL operation. The defaults are: element 1 = CHR(255), element 2 = CHR(255)
- keycompare
procedure (reserved) Do not specify, but maintain parameter position.
- errorproc
procedure (reserved) Do not specify, but maintain parameter position.
- statistics
32-bit signed integer array (optional) Returns information on the MERGE/XL operation:
| Value | Meaning |
|---|
| 1 | Number of input files | | 2 | Number of merged records | | 3 | Number of bytes used for the MERGE/XL work area | | 4 | CPU time in milliseconds | | 5 | Elapsed time in milliseconds |
- memsize
32-bit signed integer by value (reserved) Do not specify, but maintain parameter position.
- charseq
32-bit signed integer array (optional) Passes language information. Set the first element to 1 and
the second element to the language ID of the native language collating
sequence to be used for keys of type character (keys parameter
equal to 10).
Related Information | |
- Intrinsics
Hewlett-Packard SORT, Hewlett-Packard MERGE - Commands
None - Manuals
SORT-MERGE/XL Programmer's Guide (32650-90080)
|
