Die DBLOG Utility protokolliert jedes Adabas-Kommando, jeden SYNC/ROLB-Aufruf, jedes SQL-Statement oder jeden VSAM-Aufruf, nachdem ob dieses bzw. dieser durch das Datenbanksystem verarbeitet worden ist.
Folgende Themen werden behandelt:
Die folgende Grafik veranschaulicht den Ablauf, wenn Datenbankaufrufe aus einem Natural-Programm mit der DBLOG Utility protokolliert werden:
|
|
Die Protokollierung von Datenbankaufrufen
(Adabas-Kommando, SYNC/ROLB-Aufruf, SQL-Statement oder VSAM-Aufruf) wird
aktiviert, wenn Sie die entsprechende Funktion im
DBLOG-Menü oder das Natural-Systemkommando
TEST DBLOG benutzen.
Im DBLOG-Menü können Sie individuelle Auswahlkriterien festlegen, z.B. um die Protokollierung auf eine bestimmte Datenbankkennung (DBID) oder Dateinummer (FNR) einzuschränken. |
|
|
Ein Natural-Programm setzt ein Statement ab, das
einen Datenbankaufruf initiiert, z.B. FIND oder
READ.
|
|
|
Der Database Log Agent leitet den Datenbankaufruf an den Database Handler weiter. |
|
|
Der Database Handler passt den Datenbankaufruf an die jeweilige Datenbank an (Adabas, SQL oder VSAM), ruft die durch den Datenbankaufruf angeforderten Daten ab und gibt diese Daten an den Database Log Agent zurück. |
|
|
Der Database Log Agent protokolliert im Natural-DBLOG-Puffer die vom Database Handler zurückgegebenen Daten leitet diese Daten and das Natural-Programm weiter. |
|
|
Die Report-Funktion der DBLOG Utility liest die im
Natural-DBLOG-Puffer aufgezeichneten Daten und selektiert Datensätze gemäß den
im DBLOG-Menü im Schritt
angegebenen Auswahlkriterien.
|
|
|
Anhand der selektierten Datensätze erstellt die Report-Funktion der DBLOG Utility einen Report, der angezeigt, in eine Arbeitsdatei geschrieben oder zur Stapelverarbeitung benutzt werden kann. |
Die von der DBLOG Utility protokollierten Daten werden im
Natural-DBLOG-Puffer aufgezeichnet. Die Anfangsgröße und die maximale Größe des
Pufferspeichers werden mit dem Natural-Profilparameter
DSIZE
festgelegt, siehe Parameter-Referenz-Dokumentation.
Falls die Anfangsgröße nicht reicht, erhöht Natural (falls nötig, öfters) automatisch die Puffergröße bis zur angegebenen maximalen Größe. Nachdem der Maximalwert erreicht ist, werden nur die aktuellsten Protokollierungsdaten im Natural-DBLOG-Puffer gehalten.
Falls die Größe des DBLOG-Puffers mangels Speicherplatz nicht weiter
vergrößert werden kann, gibt Natural die Fehlermeldung
NAT7545 aus, die anzeigt, dass der Speicherplatz für den
DBLOG-Puffer nicht ausreicht. Alle vor dem Auftreten dieses
Speicherplatzmangels protokollierten Daten werden im Natural-DBLOG-Puffer
gehalten und können mit dem Kommando TEST DBLOG
angezeigt werden.
DBLOG kann sowohl im Online- als auch im Batch-Modus benutzt werden. SYNC/ROLB-Aufrufe können unter CICS, unter IMS TM oder im Batch-Modus protokolliert werden. Weitere Informationen zum Batch-Modus siehe Natural in Batch Mode in der Natural-Operations-Dokumentation.
Die aufgezeichneten Protokollierungen werden im Bildschirm DBLOG Trace angezeigt.
Die DBLOG Utility verfügt über Standardeinstellungen für die
Datenaufzeichnung. Wenn Sie das DBLOG-Menü benutzen,
können Sie Auswahlkriterien für die Kommandos, Aufrufe oder Statements, die
protokolliert werden sollen, und für die angezeigten Informationen angeben. Im
DBLOG-Menü sind Funktionen zum Aktivieren oder
Deaktivieren der Protokollierung vorhanden. Außerdem können Sie das
Natural-Systemkommando TEST DBLOG benutzen, um die
DBLOG-Ausführung zu steuern.
Die Felder im DBLOG
Trace-Bildschirm, im DBLOG-Menü und das
Natural-Systemkommando TEST
DBLOG werden in den folgenden Abschnitten der
DBLOG-Dokumentation beschrieben.
In diesem Abschnitt werden die Kommandos beschrieben, mit denen Sie DBLOG mit den DBLOG Utility-Standardeinstellungen aktivieren oder deaktivieren können. Weitere Informationen siehe TEST DBLOG -Kommando.
Um DBLOG für Adabas zu aktivieren oder zu deaktivieren:
Geben Sie folgendes Natural-Systemkommando (Kippschalterfunktion) ein:
TEST DBLOG
Oder:
Geben Sie zum Aktivieren Folgendes ein:
TEST DBLOG ON
oder
TEST DBLOG START
Geben Sie zum Deaktivieren Folgendes ein:
TEST DBLOG OFF
Oder:
Geben Sie im DBLOG-Menü den Funktionscode
B (zum Aktivieren) oder den Funktionscode E (zum
Deaktivieren) ein.
Um DBLOG für SQL zu aktivieren oder zu deaktivieren:
Geben Sie folgendes Natural-Systemkommando (Kippschalterfunktion) ein:
TEST DBLOG Q
Oder:
Geben Sie zum Aktivieren Folgendes ein:
TEST DBLOG Q ON
oder
TEST DBLOG Q START
Geben Sie zum Deaktivieren Folgendes ein:
TEST DBLOG Q OFF
Oder:
Geben Sie im DBLOG-Menü den Funktionscode
B (zum Aktivieren) oder den Funktionscode E (zum
Deaktivieren) ein.
Um DBLOG für VSAM zu aktivieren oder zu deaktivieren:
Geben Sie folgendes Natural-Systemkommando (Kippschalterfunktion) ein:
TEST DBLOG V
Oder:
Geben Sie Folgendes zum Aktivieren ein:
TEST DBLOG V ON
oder
TEST DBLOG V START
Geben Sie Folgendes zum Deaktivieren ein:
TEST DBLOG OFF
Oder:
Geben Sie im DBLOG-Menü den Funktionscode
B (zum Aktivieren) oder den Funktionscode E (zum
Deaktivieren) ein.
In den folgenden Beispielen wird erklärt, wie Sie im DBLOG-Menü Auswahlkriterien eingeben können, um Adabas-Kommandos, Aufrufe, SQL-Statements oder VSAM-Aufrufe selektiv zu protokollieren.
Um DBLOG mit Auswahlkriterien zu benutzen:
Rufen Sie das DBLOG-Menü auf, indem Sie eines der folgenden Natural-Systemkommandos eingeben:
Für Adabas:
TEST DBLOG MENU
Für SQL:
TEST DBLOG Q MENU
Für VSAM:
TEST DBLOG V MENU
Das DBLOG-Menü erscheint.
Geben Sie im DBLOG-Menü die
Einschränkungen für das Protokollieren an und aktivieren Sie die
Protokollierung: Füllen Sie die Eingabefelder vollständig aus und geben Sie den
Funktionscode B ein.
Die Meldung DBLOG started now
erscheint.
Führen Sie ein Natural-Programm aus, das Adabas-Kommandos, SQL-Statements oder VSAM-Aufrufe enthält.
Rufen Sie den DBLOG Trace-Bildschirm auf und deaktivieren Sie die Protokollierung, indem Sie eines der folgenden Natural-Systemkommandos eingeben:
Für Adabas:
TEST DBLOG
Für SQL:
TEST DBLOG Q
Für VSAM:
TEST DBLOG V
oder
TEST DBLOG V SHOW
Der DBLOG Trace-Bildschirm erscheint:
Löschen Sie den Inhalt des Natural-DBLOG-Puffers und deaktivieren Sie die Protokollierung, indem Sie eines der folgenden Natural-Systemkommandos eingeben:
Für Adabas:
TEST DBLOG OFF
Für SQL:
TEST DBLOG Q OFF
Für VSAM:
TEST DBLOG V OFF
DBLOG wird beendet und die Eingabeaufforderung NEXT erscheint.
Weitere Informationen siehe TEST DBLOG -Kommando.
