Sie können die folgenden beiden Eigenschaften festlegen:
pureQuery verwendet das Framework von java.util.logging. In diesem Framework nennt pureQuery die übergeordnete Protokollfunktion com.ibm.pdq.logger. Durch die Verwendung von Konventionen und Tools für Java™-Protokollierungs-APIs können Sie und Ihre Anwendungen die Protokollebene und Protokolldatei für die Protokollfunktion von com.ibm.pdq festlegen, sodass pureQuery-Protokollnachrichten an diese Protokollfunktion weitergeleitet werden.
Jeder Anwendungsserver, der Verwaltungstools zum Konfigurieren von Protokollfunktionen im Framework von java.util.logging enthält (wie z. B. WebSphere Application Server 6.1), kann die Protokollfunktion von com.ibm.pdq zum Steuern der pureQuery-Protokollierung und -Traceerstellung konfigurieren. Eine solche Konfiguration bietet eine Alternative zum Konfigurieren von pureQuery-Protokollierung mit pureQuery-Eigenschaften. pureQuery verwendet die Protokollfunktionsebene von com.ibm.pdq, wenn sie höher ist als die Ebene, die für die pureQuery-Eigenschaft pdq.traceLevel angegeben ist, und wenn die Protokollfunktionsebene von com.ibm.pdq höher ist als INFO. In WebSphere Application Server Integrated Solutions Console können Sie die Protokollfunktionsebene von com.ibm.pdq festlegen, indem Sie Fehlerbehebung > Protokolle und Trace auswählen.
Wenn die Tracestufe der Protokollfunktion von com.ibm.pdq auf eine Ebene gesetzt ist, die inklusiver ist als INFO, und wenn pureQuery-Eigenschaften keine Ebene angeben, die inklusiver ist als die Tracestufe der Protokollfunktion von com.ibm.pdq, übernimmt pureQuery die Ebene der Protokollfunktion von com.ibm.pdq.
Wollen Sie WebSphere Application Server mit Ihrer pureQuery-Anwendung verwenden, müssen Sie die Ebene auf höher als INFO setzen, wenn Sie pureQuery-Protokolleinträge im Protokoll für WebSphere Application Server anzeigen wollen.
pureQuery integriert Protokollierung nicht explizit in JDBC-Treiberprotokolle. JDBC-Treiber, die jedoch auch über die Java-Protokollierungs-API Daten protokollieren, können an der Protokollierungsframeworkintegration teilnehmen. Dies bedeutet, dass pureQuery- und JDBC-Treiberprotokolleinträge nur im selben Protokoll verzahnt sind, wenn der JDBC-Treiber auch das Java-Protokollierungsframework verwendet und wenn beide Protokollfunktionen zum Schreiben in dasselbe Ziel konfiguriert sind.
Ausnahmebedingungen, die in Nicht-pureQuery-API-Anwendungen auftreten, die unter pureQuery ausgeführt werden, werden in pureQuery-Protokolldateien angezeigt, wenn Protokollierung für pureQuery konfiguriert ist. Einige pureQuery-Einträge werden möglicherweise auch in einem JDBC-Treiberprotokoll angezeigt (sofern konfiguriert).
Wenn Ihre Anwendung IBM® Data Server Driver für JDBC und SQLJ zum Herstellen einer Verbindung zu einer unterstützten DB2-Datenbank verwendet und die Methode getJccSpecialRegisterProperties() für ein Verbindungsobjekt aufruft, kann pureQuery die Ergebnisse des ersten Aufrufs dieser Methode für das Objekt protokollieren. Die Nachricht, die pureQuery in das Protokoll schreibt, listet alle Werte ungleich null für die Sonderregister auf, die der Treiber für die Datenbank unterstützt.
Setzen Sie die Tracestufe auf FINE, um diese Nachricht im Protokoll anzuzeigen.
Bei der Verwendung von DB2 Call Level Interface (CLI) oder IBM Data Server Driver mit pureQuery Runtime können Sie die pureQuery Runtime-Eigenschaft als Konfigurationsschlüsselwort verwenden.
Sie können die beiden Schlüssel in der Konfigurationsdatei db2cli.ini oder dsdriver.cfg festlegen.
Sie können einen absoluten Pfad oder einen Pfad verwenden, der relativ zu dem Verzeichnis ist, in dem die CLI-Anwendung ausgeführt wird. Ist die Datei vorhanden, werden neue Protokollnachrichten an den vorhandenen Inhalt der Datei angehängt.
Sie können einen absoluten Pfad oder einen Pfad verwenden, der relativ zu dem Verzeichnis ist, in dem die CLI-Anwendung ausgeführt wird. Ist die Datei vorhanden, werden neue Protokollnachrichten an den vorhandenen Inhalt der Datei angehängt.
Die folgenden Zeilen setzen in der Datei db2cli.ini traceFile auf /user/CLIOPTtraces.log und traceLevel auf INFO:
traceFile=/user/CLIOPTtraces.log traceLevel=INFO