[-@[<Ziffer>]]

A simple --merge as argument makes CIB merge start mixing immediately and use all arguments, which were used before.

Syntax

--merge

or

--merge=<Ziffer>

Description

With this call parameter, several jobs can be stored one after the other in a parameter file, each of which is processed separately.

Note:

An already set parameter is valid until a new value is assigned to it.

If not all data records/variables in the involved data files have been processed, CIB merge interprets the merge process as a mail merge, inserts a section change into the target document, and merges further starting from the root document.

In contrast, a --merge=1 is executed as a single merge run and ends at the end of the RTF text templates, no matter how many supplied data are still untouched. The number specifies how many data sets are passed through, thus limiting the merge to a certain number of data sets.

Examples

--merge=1

Here a single merge run is executed, i.e. the result RTF contains only the data from the first record.

--merge=3

The result is an RTF document with the first three data sets, even if the data sources contain more than three data sets.

The usage of this parameter is demonstrated in the use case example Serial Letter.

 

Note:

If the parameters are transferred to CIB merge in a parameter file, only the parameters placed before the --merge parameter are evaluated.