DBLOG ausführen

#### Search Results

Search

# DBLOG ausführen

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:

- Grundprinzipien der Datenbankprotokollierung

- Verarbeitung und Speicherung der Daten

- DBLOG aktivieren und deaktivieren

- DBLOG mit Auswahlkriterien benutzen

## Grundprinzipien der Datenbankprotokollierung

Die folgende Grafik veranschaulicht den Ablauf, wenn Datenbankaufrufe aus einem Natural-Programm mit der DBLOG Utility protokolliert werden:

### Legende

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

## Verarbeitung und Speicherung der Daten

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.

## DBLOG aktivieren und deaktivieren

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.

## DBLOG mit Auswahlkriterien benutzen

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:

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

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

3. Führen Sie ein Natural-Programm aus, das Adabas-Kommandos, SQL-Statements oder VSAM-Aufrufe enthält.

4. 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:

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

### On this page

- Grundprinzipien der Datenbankprotokollierung
- Verarbeitung und Speicherung der Daten
- DBLOG aktivieren und deaktivieren
- DBLOG mit Auswahlkriterien benutzen