Protokoll/Trace

Alle AE-Programme schreiben Informationen über ihre Aktivitäten in Protokolle. Durch entsprechende Einstellungen können erweiterte Informationen in einen Trace ausgegeben werden. Dies ist besonders nützlich bei der Suche und/oder Behebung eines Fehlers.

Alle Protokoll/Trace-Einstellungen befinden sich in der INI-Datei (siehe unten).
Die Dateien (Protokoll und Trace) werden standardmäßig bei jedem Neustart des Systems überschrieben. Um ältere Dateien für eine spätere Verwendung aufzubewahren, können Sie die Anzahl der historischen Dateien angeben, die mit „Log Count“ und „Trccount“ aufbewahrt werden sollen. Dazu muss im Dateinamen unbedingt die Zeichenfolge "##" enthalten sein. Diese wird im aktuellen Dateinamen durch "00" ersetzt. Die historischen Dateien heißen dann „01“, „02“ usw. Bei jedem Neustart des Programms werden diese verschoben. Die älteste Datei (mit der höchsten Nummer) wird gelöscht und alle anderen Dateien werden umbenannt (die Nummer wird um 1 erhöht).
Die Protokollinformationen werden ebenfalls in der AE-Datenbank gespeichert und können über Statistiken/Logging abgerufen werden.

Einstellungen in den INI-Dateien

[GLOBAL]
- logging=
  
  Name der Logdatei
  
  Erforderlich: Ja
- logcount=
  
  Anzahl der historischen Logdateien
  
  Erforderlich: Nein (00)
[Trace]
- file=
  
  Name der Trace-Datei
  
  Erforderlich: Ja
- trccount=
  
  Anzahl der historischen Trace-Dateien
  
  Erforderlich: Nein (00)
- diverse
  
  Steuerung des Trace-Umfanges
  
  Erforderlich: Nein (0)

Logdateien von Dienstprogrammen

Wenn der Parameter logging= nicht definiert ist, erstellen die Dienstprogramme standardmäßig die folgenden Logdateien:

Windows: .\UCYBDBxx_LOG_###.TXT

UNIX: ./UCYBDBxx_LOG_###.TXT

xx steht für die Abkürzung des entsprechenden Dienstprogramms:

AR: AEDB Archive
CC: AE DB Client Copy
LD: AE DB Load
RE: AE DB Reorg
UN: AE DB Unload

Das gleiche gilt auch im Falle, dass die INI-Datei nicht gefunden wird, weil sie nicht im angegebenen Ordner existiert (siehe Start-Parameter -I). Somit ist sichergestellt, dass auch bei Einstellungsfehlern eine Logdatei erzeugt wird.

Jobstatus in Logdateien

Während der Durchführung von Jobs werden Meldungen in die Logdatei geschrieben, die über den Jobstatus Auskunft geben. Folgende Zustände können hierbei auftreten:

A - Status ended

Job endete mit einem Rückgabewert ungleich 0.
E - Status ended

Job wurde mit dem Status ENDED_OK beendet.
R - Status running

Dieser Status wird periodisch in die Logdatei geschrieben, solange der Job durchgeführt wird.
V - Status vanished

Der Status tritt nur dann auf, wenn der Agent einen von ihm gestarteten Job nicht mehr auffindet (siehe auch: Im Falle einer Downtime des Agenten bei Ablauf der Jobdurchführung).
W - Status waiting

Job wurde noch nicht gestartet und befindet sich im Zustand „Warten“.

Siehe auch: