CIB merge technical documentation (EN)

6. Call parameters in detail

6.12. Parameter --default-mode

[--defaultmodus/--default-modus]

The --default-mode parameter provides a mechanism to determine a default value for each variable if the variable is undefined or empty.


Syntax
--default -mode=<Value>
<Value>: -/off/aus/no/none/kein/keiner/nein, undefiniert/undefined/+, leer/empty oder beides/alles/both/all/voll/full

Description

The --default-mode parameter is only to be used in combination with the --default-prefix parameter. This defines the prefix that is placed in front of a variable name. When the REF field is evaluated, it is determined whether the value is suitable for the default behavior, otherwise the value or an error is output. The default behavior occurs under the following conditions:

  • “Variable is undefined and behavior accordingly selected” or
  • “Variable is defined and empty and behavior accordingly selected”.
  • If one of the conditions applies, the variable name is composed of the default prefix and the old name. If such a default is again not set, there is another one for all together. Only if this does not exist, the usual error is reported that a variable is not defined. You can choose between 'no default', 'default for empty', 'default for undefined' and 'default for both'. The default is "no default“.

Possible values for <Value> are:

Option

Description

-/off/aus/no/none/kein/keiner/nein

Standard, no default

undefiniert/undefined/+

Default for undefined variables

leer/empty

Default for empty variables

beides/alles/both/all/voll/full

Default for both cases



Example
--default-mode=all

The system searches for a suitable default value if a variable is empty or undefined.

The use of the parameter is described in detail in the use case example Gap Text.