Benutzerschnittstelle für die Traceerstellung für eigenständige Clients

Zum Aktivieren der Traceerstellung können Sie die Systemeigenschaft in der Langform oder die Systemeigenschaft in der Kurzform verwenden.

Anmerkung: Dieser Artikel referenziert eine oder mehrere Protokolldateien des Anwendungsservers. Alternativ dazu wird empfohlen, den Server so zu konfigurieren, dass er die HPEL-Protokoll- und -Traceinfrastruktur (High Performance Extensible Logging) verwendet und nicht die Dateien SystemOut.log , SystemErr.log, trace.log und activity.log auf verteilten oder IBM® i-Systemen. Sie können HPEL auch in Verbindung mit Ihren nativen z/OS-Protokolleinrichtungen verwenden. Wenn Sie HPEL verwenden, können Sie mit dem Befehlszeilentool LogViewer im Verzeichnis "bin" des Serverprofils auf alle Ihre Protokoll- und Tracedaten zugreifen. Weitere Informationen zur Verwendung von HPEL finden Sie in der Dokumentation zum Einsatz von HPEL für die Fehlerbehebung in Anwendungen.

Systemeigenschaft in der Langform

Die Langform hat Priorität vor der Kurzform. Für die Langform werden für WebSphere Application Server spezifische Systemeigenschaften verwendet.

Tabelle 1. Systemeigenschaft in der Langform. Die Tabelle enthält eine Liste der Systemeigenschaften in der Langform und die zugehörigen Beschreibungen.
Eigenschaft Beschreibung
com.ibm.ejs.ras.lite.traceSpecification Die Zeichenfolge für die Tracespezifikation.
com.ibm.ejs.ras.lite.traceFileName Das Traceziel (<Datei>, stdout, stderr, java,util.logging).
com.ibm.ejs.ras.lite.maxFileSize Die maximale Größe der Tracedatei in MB (falls das Traceziel eine Datei ist).
com.ibm.ejs.ras.lite.maxFiles Die maximale Anzahl der verwalteten Tracedateien (falls das Traceziel eine Datei ist).
com.ibm.ejs.ras.lite.traceFormat Das Traceausgabeformat. Sie können zwischen dem Basisformat (Standardeinstellung) und dem erweiterten Format wählen.

Beispiel für die Langform:

-Dcom.ibm.ejs.ras.lite.traceSpecification=SIB*=all
-Dcom.ibm.ejs.ras.lite.traceFileName=c:/trace.log
-Dcom.ibm.ejs.ras.lite.maxFileSize=20
-Dcom.ibm.ejs.ras.lite.maxFiles=8

Systemeigenschaft in der Kurzform

Die Kurzform verwendet eine Systemeigenschaft, die mit vorhandenen Clients von WebSphere Application Server kompatibel ist, aber aufgrund der Tatsache, dass sie nicht qualifiziert ist, mit anderen Technologien anderer Anbieter in Konflikt kommen kann, die in derselben JRE (Java™ Runtime Environment) ausgeführt werden.

Die Systemeigenschaft in der Kurzform lautet wie folgt:

traceSettingsFile
Mit dieser Eigenschaft muss eine ladbare Eigenschaftendatei angegeben werden, die die folgenden Eigenschaften enthalten kann:
Tabelle 2. Eigenschaften in der ladbaren Systemeigenschaftendatei. Die Tabelle enthält eine Liste der ladbaren Systemeigenschaften und die zugehörigen Beschreibungen.
Eigenschaft Beschreibung
traceFileName Das Traceziel (Datei, stdout, stderr, java,util.logging).
maxFilesSize Die maximale Größe der Tracedatei in MB (falls das Traceziel eine Datei ist).
maxFiles Die maximale Anzahl der verwalteten Tracedateien (falls das Traceziel eine Datei ist).
<traceSpec> Die Tracespezifikation.
traceFormat Das Traceausgabeformat. Sie können zwischen dem Basisformat (Standardeinstellung) und dem erweiterten Format wählen.

Das folgende Beispiel veranschaulicht, wie die Systemeigenschaft in der Kurzform verwendet wird:

SIBTrm=all:SIBMfp=all
traceFileName=c:/trace.log

Sonderbedeutungen der Namenswerte für Tracedateien

Einige Namenwerte für Tracedateien haben eine Sonderbedeutung:
  • stdout - Bewirkt, dass die Tracedatensätze in die Standardausgabe geschrieben werden.
  • stderr - Bewirkt, dass die Tracedatensätze in die Standardfehlerausgabe geschrieben werden.
  • java.util.logging - Bewirkt, dass die Tracedatensätze nach "java.util.logging" geschrieben werden.

Die Verwendung jedes anderen Namens bewirkt, dass die Tracedatensätze in eine Datei dieses Namens geschrieben werden.


Symbol, das den Typ des Artikels anzeigt. Konzeptartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cjj_stdalonecli_trace
Dateiname:cjj_stdalonecli_trace.html