Allgemein
Diagnoselevel
Fehlerkategorien
Fehlerprotokolldatei bis CIB merge 3.8.x

---

Allgemein

Mit dem Parameter -L(!)<Fehlerprotokolldatei> schreibt CIB merge eine Beschreibung der Fehlermeldung in die angegebene Logdatei. Tritt kein Fehler auf, so wird eine leere Datei geschrieben. Siehe auch Kapitel -L<Logdatei>.

Fehlerprotokolldatei mit --verbose ab CIB merge 3.9.x

CIB merge schreibt ab version 3.9.x eine nach Fehlerkategorien und Diagnoseleveln frei skalierbare Fehlerprotokolldatei, die somit individuell auf die Bedürfnisse der User zugeschnitten werden kann.

Diagnoselevel

Die Diagnoselevel bezeichnen dabei die Detailtiefe der Protokolldatei wie folgt:

level	verbosity	name	standards	function	remarks
0	nothing	silent/still/stumm		quiet
1	severe errors	severe/schwer(wiegend)		errors
2	all errors	error(s)/Fehler
3	important consequences	initial	initial
4	helpful consequences	""/default/standard	default
5	all consequences	stack
6	helpful information	info(rmation)		trace
7	technical information	technical/technisch
8	timing information	timing/Zeit(en)			reserved
9	memory information	memory/Speicher			reserved

Wird --verbose nicht gesetzt, so wird der initial Level 3 gesetzt. Wird --verbose ohne einen Diagnoselevel gesetzt, so gilt der default Level 4.

Fehlerkategorien

CIB merge unterscheidet zur Protokollierung mit --verbose verschiedene Fehlerkategorien:

ALL/ALLE, DATA/DATEN, DIALOG, DOC/DOCUMENT/DOK/DOKUMENT, INCLUDE/EINFUEGEN, FIELD/FELD, FILE/DATEI, PAR, REF, SOURCE/QUELLE, SOURCEPATH/QUELLPFAD

Diese können beliebig kombiniert werden, z.B. --verbose +DATA +DOK +INCLUDE oder --verbose +ALL -SOURCE

Fehlerprotokolldatei bis CIB merge 3.8.x

Die Fehlerprotokolldatei und enthält Informationen für Anwendungsentwickler, Rohtextentwickler und den CIB Support. Eine Skalierung mit --verbose ist nicht möglich, die Datei ist wie folgt aufgebaut:

Die erste Zeile gibt die Fehlerart und Kategorie an.

Die zweite Zeile beschreibt, in welcher Datei der Fehler passiert ist. CIB merge Versionen < 3.8.108 geben in der zweiten Zeile Informationen für den CIB Support aus.

In den weiteren Zeilen erhält der Anwender die nötigen Hinweise für die Verfolgung der Fehlerursachen.

Die letzte Zeile der Fehlermeldungen enthält die folgenden Angaben:

Programmrückgabewert: xxxx - siehe Kapitel Programmrückgabewerte "==>" bezeichnet immer die Folgen in CIB merge.

Hinweise zur Analyse der Fehlerprotokolldatei

Feldanweisungen werden grundsätzlich von innen nach außen ausgewertet, CIB merge listet daher zuerst den "innersten" Fehler und anschließend die daraus folgenden Fehler in den äußeren Feldern aus.

Beispiel

Eine Variable wird in einer WENN-Bedingung mit einem festen Wert verglichen. Der Baustein ist Teil eines größeren Projekts und wird mit EINFÜGENTEXT in das Wurzeldokument eingefügt. Fehlt nun die Variable in der Datenversorgung, so wird CIB merge folgendes ausgeben:

FEHLER: Fehlbedienung: Fehlerhafte Feldanweisung
    Fehler während der Datei baustein.rtf
    unbekannte Variable
    Name: dummy_feld
==> konnte Feldanweisung nicht auswerten
    Befehl: REF
    Parameter: 2 Stück
    1: REF
    2: dummy_feld
    Schalter: 0 Stück
==> Feld nicht neu berechnet
==> linken Operanden nicht ausgewertet
==> Bedingung nicht ausgewertet
==> konnte Feldanweisung nicht auswerten
    Befehl: WENN
    Parameter: 6 Stück
    1: WENN
    2: {REF dummy_feld}
    3: <>
    4: ""
    5: "REF dummyfeld ist nicht leer"
    6: "REF Dummyfeld ist leer"
    Schalter: 0 Stück
==> Feldergebnis nicht neu berechnet und geschrieben
==> Feld nicht korrekt ausgewertet und geschrieben 
==> Dokument nicht vollständig bearbeitet und geschrieben
==> Datensatz-Nr.: 1
==> konnte Feldanweisung nicht auswerten
    Befehl: EINFÜGENTEXT
    Parameter: 2 Stück
    1: EINFÜGENTEXT
    2: "baustein.rtf"
    Schalter: 0 Stück
==> Feldergebnis nicht neu berechnet und geschrieben
==> Feld nicht korrekt ausgewertet und geschrieben 
==> Einzeldokument nicht vollständig bearbeitet und geschrieben
==> Mischvorgang abgebrochen 
==> Dokument nicht vollständig bearbeitet und geschrieben
==> Datensatz-Nr.: 1
==> Dokument nicht korrekt bearbeitet
Programmrückgabewert 0010