Reference Guide

30 Allgemeines zur Befehlszeilenschnittstelle
Ausführliche Fehlermeldungen
Wenn die CLI einen Fehler feststellt, werden die Fehlerdaten in eine Datei
geschrieben. Die ausführliche Fehlerberichterstattung bei der Arbeit mit
der CLI funktioniert wie folgt:
• Wenn die CLI aufgrund eines Fehlers beendet werden oder die
Ausführung eines Skriptbefehls abbrechen muss, werden vor dem Beenden
des Programms Fehlerdaten erfasst und gespeichert.
• Die Speicherung der CLI-Fehlerdaten erfolgt automatisch in einer Datei
mit vorgegebenem Namen.
• Eine frühere Version der CLI-Fehlerdatendatei wird dabei ggf. ohne
Warnung oder Abbruchmöglichkeit überschrieben.
Bei der Erfassung von Fehlern wird zwischen zwei Fehlertypen unterschieden:
• Fehlerhafte Eingabe von Parametern oder Befehlssyntax durch den
Benutzer.
• Ausnahmefehler, die durch Fehler bei der Ausführung des Programms
bedingt sind.
Wenn die CLI einen dieser beiden Fehlertypen feststellt, schreibt sie
die Informationen zu dem betreffenden Fehler direkt in die Befehlszeile
und setzt einen Return-Code. Je nach Return-Code wird in der Datei
gegebenenfalls zudem erfasst, welcher Parameter den Fehler verursacht hat.
Um das Erkennen von Syntaxfehlern zu erleichtern, werden in der Datei
darüber hinaus Informationen zur erwarteten Befehlssyntax festgehalten.
Wenn beim Ausführen eines Befehls ein Ausnahmefehler auftritt, speichert
die CLI die Informationen zu diesem Fehler in einer Datei namens
excprpt.txt. Die CLI versucht, die Datei excprpt.txt in dem von der
Systemeigenschaft devmgr.datadir spezifizierten Verzeichnis zu speichern.
Standardmäßig ist dies unter Windows das Verzeichnis „client/data“ im
Hauptinstallationsverzeichnis und unter Linux das Verzeichnis /var/opt/SM.
Falls es aus irgendeinem Grund nicht möglich ist, die Datei excprpt.txt in
dem durch devmgr.datadir spezifizierten Verzeichnis zu speichern, wird sie
in dem Verzeichnis gespeichert, von dem aus die CLI ausgeführt wird. Name
oder Position der Datei können vom Benutzer nicht verändert werden.
Die Datei excprpt.txt wird bei jedem Auftreten eines Ausnahmefehlers
überschrieben. Um die in der Datei excprpt.txt enthaltenen Informationen
dauerhaft zu speichern, müssen Sie sie deshalb in eine neue Datei übertragen
oder die Datei in ein anderes Verzeichnis kopieren.