Sie können die folgenden beiden Eigenschaften festlegen:
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 nutzt 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 Eigenschaft pdq.traceLevel von pureQuery 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.
pureQuery integriert Protokollierung nicht explizit in JDBC-Treiberprotokolle. JDBC-Treiber, die jedoch auch über die Java-Protokollierungs-API Daten protokollieren, nehmen an der Protokollierungsframeworkintegration teil. 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 for JDBC and 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.