MPE/iX Intrinsics Reference Manual (32650-90875)

502 Chapter9
Command Definitions (MAIL-PUTJCW)
MERGEINIT
Bits (8:8) of the first element specify one fewer than the total number of
characters in the collating sequence (in this instance, chr(255) or %377).
The remaining array elements comprise the actual collating sequence
responsible for the particular MERGE operation.
keycompare procedure (reserved)
Do not specify this parameter, but maintain parameter position.
errorproc procedure (reserved)
Do not specify this parameter, but maintain parameter position.
statistics 16-bit signed integer array (optional)
Returns information on the MERGE operation, as follows:
Value Meaning
1 Number of input files
2,3 Number of merged records (32-bit integer)
4 Space available for merging
5,6 Number of comparisons (32-bit integer)
7,8 CPU time in milliseconds (32-bit integer)
9,10 Elapsed time in milliseconds (32-bit integer)
failure 16-bit signed integer (optional)
Returns a true value (-1) if a fatal error occurs; otherwise
failure returns
a false value (0). Refer also to the discussion of condition codes.
errorparm 16-bit signed integer (optional)
Returns the error number if an error occurs. Use the MERGEERRORMESS
intrinsic to obtain the error message text.
spaceallocation 16-bit signed integer (reserved)
Do not specify this parameter, but maintain parameter position.
charseq 16-bit signed integer array (optional)
Passes language information in a two-element array. Set the first element
to 1. Set the second element to the language ID number of the native
language whose collating sequence is to be used to sort keys of type 9
(character).
Condition Codes
CCE (2) Request granted. No error occurred during the MERGE program. The
value of the
failure parameter of the MERGEINIT intrinsic is set to false.
CCG (0) Not returned.
CCL (1) Request denied. An error occurred during the MERGE program. The value
of the
failure parameter of the MERGEINIT intrinsic is set to true.