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 an 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.
