Konfiguration des JDBC-Trace

Wenn Ihre Anwendung JDBC-bezogene Ausnahmenachrichten anzeigt, aktivieren Sie den JDBC-Trace-Service. Der erzeugte Protokolltext kann Ihnen bei der Ermittlung des Problems helfen.

[AIX Solaris HP-UX Linux Windows][IBM i]Sie können die Traceerstellung für die meisten JDBC-Datenbankimplementierungen über die Administrationskonsole aktivieren. Diesbezügliche Anweisungen finden Sie im Artikel "Traceerstellung beim Serverstart aktivieren".

[z/OS]Sie können die Traceerstellung für die meisten JDBC-Datenbankimplementierungen über die Administrationskonsole aktivieren. Diesbezügliche Anweisungen finden Sie im Artikel "Traceerstellung aktivieren".

Diese Methode aktiviert den JDBC-Trace für alle Anwendungen, die im angegebenen Server ausgeführt werden. Geben Sie den Datenbanktyp an, indem Sie die Tracegruppe WAS.database auswählen und eine der folgenden Tracezeichenfolgen in der Konsole eingeben:
  • com.ibm.ws.database.logwriter Tracezeichenfolge für Datenbanken, die den GenericDataStoreHelper verwenden. Sie können diese Tracezeichenfolge auch für nicht unterstützte Datenbanken verwenden.
  • com.ibm.ws.db2.logwriter Tracezeichenfolge für DB2-Datenbanken.
  • com.ibm.ws.oracle.logwriter: Tracezeichenfolge für Oracle-Datenbanken.
  • com.ibm.ws.derby.logwriter: Tracezeichenfolge für Derby-Datenbanken
  • com.ibm.ws.informix.logwriter Tracezeichenfolge für Informix-Datenbanken.
  • com.ibm.ws.sqlserver.logwriter Tracezeichenfolge für Microsoft-SQL-Server-Datenbanken.
  • com.ibm.ws.sybase.logwriter: Tracezeichenfolge für Sybase-Datenbanken.
Bei einigen JDBC-Treibern muss der Trace auf Datenquellenebene aktiviert werden. Zu diesen Treibern gehören:
  • Microsoft SQL Server JDBC Driver
  • DataDirect Connect for JDBC driver for MS SQL Server
Wenn Sie den Trace für diese Treiber über die Gruppe WAS.database konfigurieren, sind die Traceinformationen beschädigt. Der Anwendungsserver setzt den Trace für die Gruppe auf Serverebene. Dies bewirkt, dass der Trace-Service erst gestartet wird, nachdem Ihre Anwendung die erste Verbindung hergestellt hat. Da diese erste Verbindung keine Traceinformationen enthält, wird eine Wiederverwendung dieser Verbindung nicht protokolliert. Deshalb kann die Anwendung die Traceinformationen der Verbindungsverwendung nicht exakt zuordnen.

Setzen Sie den Trace für die zuvor genannten JDBC-Treiber über angepasste Datenquelleneigenschaften. Verwenden Sie beispielsweise die angepasste Eigenschaft "spyAttributes", um die JDBC-Traceerstellung für DataDirect Connect for JDBC Driver zu aktivieren. Einzelheiten zur angepassten Eigenschaft, mit der Sie die Traceerstellung für Ihre JDBC-Implementierung aktivieren können, finden Sie in der Treiberdokumentation.

Providerspezifische Konfiguration

Einige JDBC-Provider haben angepasste Eigenschaften und Konfigurationseinstellungenen, die Sie verwenden können, um ihre Traceeinstellungen zu optimieren.
  • DB2-Datenquellen
    Die angepassten Eigenschaften für eine Datenquelle mit DB2 Data Server Driver for JDBC and SQLJ sind im Folgenden aufgelistet:
    traceLevel

    Die gültigen Werte für traceLevel sind folgende:

    • TRACE_NONE = 0
    • TRACE_CONNECTION_CALLS = 1
    • TRACE_STATEMENT_CALLS = 2
    • TRACE_RESULT_SET_CALLS = 4
    • TRACE_DRIVER_CONFIGURATION = 16
    • TRACE_CONNECTS = 32
    • TRACE_DRDA_FLOWS = 64
    • TRACE_RESULT_SET_META_DATA = 128
    • TRACE_PARAMETER_META_DATA = 256
    • TRACE_DIAGNOSTICS = 512
    • TRACE_SQLJ = 1024
    • TRACE_XA_CALLS = 2048
    • TRACE_META_CALLS = 8192
    • TRACE_DATASOURCE_CALLS = 16384
    • TRACE_LARGE_OBJECT_CALLS = 32768
    • TRACE_SYSTEM_MONITOR = 131072
    • TRACE_TRACEPOINTS = 262144
    • TRACE_ALL = -1
    Fehler vermeiden Fehler vermeiden: Der Trace für Statement-Aufrufe stellt die Benutzerdaten den PreparedStatement-Objekten in Gruppen bereit, und der Trace für ResultSet-Aufrufe stellt die von Get-Anforderungen zurückgegebenen Daten aus den ResultSet-Objekten bereit.gotcha
    traceFile
    Gibt an, dass Trace für DB2 Data Server Driver for JDBC und SQLJ in die Tracefunktion des Anwendungsservers integriert werden soll:
    • Wenn Sie den Wert nicht setzen, werden die Traces integriert.
      Wenn Sie einen integrierten Trace verwenden, können Sie den Trace dynamisch aktivieren oder inaktivieren, indem Sie die folgende Eigenschaft in der Tracespezifikation des Anwendungsservers zur Laufzeit setzen:
      WAS.database=all
    • Wenn Sie die Eigenschaft "traceFile" auf einen gültigen Pfadnamen für eine Datei setzen, wird der Data-Server-Driver-Trace unabhängig von der Tracespezifikation des Anwendungsservers in die angegebene Datei geschrieben.
    traceFileAppend
    Gibt an, dass der Trace an die mit der Eigenschaft "traceFile" angegebene Datei angefügt oder die Daten überschrieben werden soll:
    • Wenn die Tracedaten an die aktuelle Datei angefügt werden sollen, setzen Sie die Eigenschaft auf "true".
    • Wenn die aktuelle Datei überschrieben werden soll, setzen Sie die Eigenschaft auf "false".
    Fehler vermeiden Fehler vermeiden: Wenn Sie die Werte für traceLevel, traceFile oder traceFileAppend ändern, müssen Sie den Anwendungsserver erneut starten, um die neuen Datenquellenobjekte mit den geänderten Einstellungen zu instanziieren.gotcha

Weitere Ressourcen

Wenn Sie mit JDBC-Trace-Service das Problem nicht eingrenzen und beheben können, rufen Sie die Website des IBM® Support für WebSphere Application Server auf. Auf dieser Website können Sie über die Suchfunktion nach bekannten Problemen und den entsprechenden Problemlösungen suchen. Das Auffinden des richtigen Fehlerbehebungstipps kann Zeit einsparen, die Sie ansonsten für das Öffnen und die Verfolgung eines PMR aufbringen müssen.


Symbol, das den Typ des Artikels anzeigt. Referenzartikel



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