[-b]

Der Parameter --break verschiebt den Zeitpunkt, an dem CIB merge im Fehlerfall einen Mischvorgang abbricht.

Syntax

--break=<Abbruchniveau>
<Abbruchniveau>: all, loop, doc, par, never oder ok

Beschreibung

CIB merge bricht in verschiedenen Situationen mit Fehlermeldungen die Verarbeitung ab. Insbesondere bei Mischvorgängen kommt das zum Beispiel vor, wenn eine Variable eingesetzt wird, die nicht definiert ist.

In manchen Situationen ist es aber erwünscht, dass CIB merge nicht bei jedem Fehler sofort abbricht, sondern mit der Verarbeitung, wenn möglich, fortfährt. Dafür wurde in der Version 3.7.62 der Parameter B für break eingeführt.

Um die Stelle im Rohtext oder Textbaustein zu finden, gibt CIB merge nach der Fehlerursache auch die Folgefehler oder Folgesituationen mit aus. (Das entspricht einer Art "stack unrolling".) Dabei schreibt CIB merge noch die schließenden Klammern des Rohtexts, soweit das die Situation zulässt, damit der Text von anderen Anwendungen geöffnet werden kann.

<Abbruchniveau> bestimmt die Stelle, bis zu der fortgefahren oder ab der abgebrochen wird. Folgende Werte sind möglich:

Abbruchniveau	Bedeutung
all	immer abbrechen, nie fortfahren (default)
loop	fortfahren bis zum Schleifenende, diese abbrechen (Serie und Parameter auch)
doc	fortfahren bis zum Dokumentenende, Serie abbrechen (Parameter auch)
par	fortfahren bis zum Ende der Serie (–@), keine weiteren Parameter mehr
never	fortfahren bis alle Parameter abgearbeitet sind, kein Abbruch, aber Fehlercode zurückgeben
ok	fortfahren bis alle Parameter abgearbeitet sind, kein Abbruch, OK zurückgeben
CIB merge wird allerdings alle Fehler weiterhin in der Fehlerprotokolldatei ausgeben, nur mit dem Hinweis "==>fahre fort (Parameter "break" mit Niveau "XXX")" nach manchen Fehlern.

 

Beispiele

--break=loop

Falls sich der Mischlauf gerade in einer Schleife befindet, wird diese ab dem Fehler nur noch bis zum Ende durchlaufen, also nicht wiederholt. Direkt anschließend wird der Mischvorgang abgebrochen.

--break=never

CIB merge führt ungeachtet aller auftretenden Fehler den Mischauftrag bis zum Ende durch und gibt den Fehlercode des ersten aufgetretenen Fehlers zurück.

Die Verwendung des Parameters mit diesen beiden Beispielbelegungen wird im Anwendungsbeispiel Bausteine veranschaulicht.

Hinweis

Unabhängig von --break=<Abbruchniveau> werden alle bis zum Ende oder Abbruch des Mischauftrags auftretenden Fehler in der Logdatei mit protokolliert.