[--next-modus/--next]

The --next-mode parameter controls the behavior of the {NEXT} command and affects variables that are present in one data set but no longer exist in the next one.

Syntax

--next-mode=<Option>
<Option>: delete, empty oder keep

Description

Variables that are present in one data set but no longer exist in the next one can be deleted, cleared or retained using the --next-mode parameter.

Possible values for <Option> are:

Option	Description
delete	The variables are deleted and are therefore no longer defined.
empty	The variables are cleared. These are then still defined but empty like „“
keep	The variables are kept and the values remain unchanged.

Example

--next-mode=delete

If a variable is no longer present in the next record (e.g. missing node in the XML), this variable is deleted, which then leads to an error. This is desired so that the error does not remain undetected by simply leaving out the missing value.

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