Die DBLOG Utility protokolliert jedes Adabas-Kommando, jeden DL/I- oder 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, DL/I- oder 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, DL/I, 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. DL/I- und 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 DL/I zu aktivieren oder zu deaktivieren:
Geben Sie folgendes Natural-Systemkommando (Kippschalterfunktion) ein:
TEST DBLOG D
Oder:
Geben Sie zum Aktivieren Folgendes ein:
TEST DBLOG D ON
oder
TEST DBLOG D START
Geben Sie zum Deaktivieren Folgendes ein:
TEST DBLOG D 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, DL/I-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 DL/I:
TEST DBLOG D 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, DL/I-Aufrufe, 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 DL/I:
TEST DBLOG D
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 DL/I:
TEST DBLOG D 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.
