DBLOG Snapshot-Funktion

#### Search Results

Search

# DBLOG Snapshot-Funktion

Die Snapshot-Funktion liefert ausführliche Informationen zu einem bestimmten Adabas-Kommando, SQL-Statement oder VSAM-Aufruf.

Folgende Themen werden behandelt:

- Snapshot-Funktion für Adabas-Kommandos

- Snapshot-Funktion für SQL-Statements

- Snapshot-Funktion für VSAM-Aufrufe

## Snapshot-Funktion für Adabas-Kommandos

Die Snapshot-Funktion unterbricht die Programmausführung nach der Ausführung des ersten Adabas-Kommandos, das die Auswahlkriterien erfüllt, die im DBLOG-Menü angegeben wurden. Der für das angegebene Adabas-Kommando generierte Snapshot Report (siehe folgenden Beispiel-Bildschirm) wird unmittelbar nach der Programmunterbrechung angezeigt.

Die Snapshot-Funktion protokolliert automatisch alle Adabas-Puffer. Deshalb ist vor dem Start der Snapshot-Funktion kein Markieren der optionalen Puffer im DBLOG-Menü nötig. Der Standard-Snapshot Report zeigt den Steuerblock (CB), bei dem es sich entweder um den klassischen Steuerblock (ACB) oder den erweiterten Steuerblock (ACBX) handelt.

Folgende Themen werden behandelt:

- Snapshot Report für Adabas-Kommandos aufrufen

- Puffer im Snapshot Report anzeigen

### Snapshot Report für Adabas-Kommandos aufrufen

Um den Snapshot Report-Bildschirm für Adabas-Kommandos aufzurufen:

1. Geben Sie im DBLOG-Menü ein Adabas-Kommando und, falls gewünscht, zusätzliche Kriterien an und geben Sie den Funktionscode `S` ein.

   Die Meldung `DBLOG snapshot facility started now` erscheint und zeigt an, dass die DBLOG-Snapshot-Funktion jetzt gestartet wurde.

2. Führen Sie ein Natural-Programm aus, das das im DBLOG-Menü angegebene Adabas-Kommando enthält.

   Die Programmausführung wird gestoppt und ein Snapshot Report-Bildschirm erscheint (Beispiel):

       16:36:39             ***** NATURAL TEST UTILITIES *****              2006-12-12
                                   - Snapshot Report -

       Command Code : L3           Command ID   :  ??? 00200101 File Number  : 013C
       Response Code:      0       ISN          :          1300
       ISN Low Limit: 00000000     ISN Quantity :             0
       FB Length    : 0009         RB Length    : 0014          SB Length    : 0008
       VB Length    : 0014         IB Length    : 0000          Com. Option 1:
       Com. Option 2: V            Additions 1  : AE]?          Additions 2  :  ? ?
       Additions 3  :              Additions 4  :
       Global FID   : 0000000000000000 Command Time : 00000019 Pgm: SAGTEST  Lin: 0020
       Control Block
       0000 * 30D5D3F3 00200101 013C0000 00000514 * ?NL3 ?????    ?? * 0000
       0010 * 00000000 00000000 00090014 00080014 *          ? ? ? ? * 0010
       0020 * 000000E5 C1C5BBCA 40404040 00120014 *    VAE]?     ? ? * 0020
       0030 * 00000000 00000000 00000000 00000000 *                  * 0030
       0040 * 00000000 00000000 00000019 00000000 *            ?     * 0040
       0050 * 00000000 00000000 00000000 00000000 *                  * 0050
       0060 * 00000000 00000000 00000000 00000000 *                  * 0060
       0070 * 00000000 00000000 00000000 00000000 *                  * 0070

       Command ===> CB________________________________________________________________
       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help        Exit  CB    FB    RB     -     +    SB    VB    IB    Canc

### Puffer im Snapshot Report anzeigen

Standarmäßig zeigt der Snapshot Report-Bildschirm den Steuerblock (CB). Sie können die enstprechend belegte PF-Taste drücken oder in der Kommandozeile das entsprechende Direktkommando eingeben, um andere Adabas-Puffer anzuzeigen oder durch einen Report zu blättern (siehe unten).

Die Verfügbarkeit einer PF-Tastenfunktion ist vom zurzeit angezeigten Puffer abhängig. Wenn ein Puffer mehr als eine Bildschirmseite umfasst oder mehrere Format-/Record Buffer enthält, sind in dem Bildschirm entsprechende mit Blätterfunktionen belegte PF-Tasten vorhanden.

PF-Taste | Direktkommando | Puffer
--- | --- | ---
PF4 | `CB` | Anzeige des Control Block. Dies ist die Standardeinstellung.
PF5 | `FB` | Anzeige des Format Buffer.
PF6 | `RB` oder `--` | Anzeige des Record Buffer (`RB`) oder Blättern (`--`) an den Anfang einer langen Pufferanzeige.
PF7 | `-` | In einer langen Pufferanzeige eine Seite nach oben blättern.
PF8 | `+` | In einer langen Pufferanzeige eine Seite nach unten blättern.
PF9 | `SB` oder `++` | Anzeige des Search Buffer(`SB`) oder Blättern (`++`) an das Ende einer langen Pufferanzeige.
PF10 | `VB` oder `<` | Anzeige des Wertpuffers (`VB`). Bei mehreren Format/Record Buffers Anzeige des vorigen (`<`) Format/Record Buffer.
PF11 | `IB` oder `>` | Anzeige des ISN Buffer (`IB`). Bei mehreren Format/Record Buffers Anzeige des nächsten (`>`) Format/Record Buffer.

Informationen zu den Feldern, die in einem Steuerblock oder Puffer abgezeigt werden, sind im Abschnitt Adabas-Puffer anzeigen enthalten.

## Snapshot-Funktion für SQL-Statements

Diese Snapshot-Funktion generiert den Snapshot Report (s. Beispiel-Bildschirm weiter unten) des ersten SQL-Statement, das die Auswahlkriterien erfüllt, die im DBLOG-Menü angegeben wurden. Bei einem Snapshot wird der Programmfluss nicht unterbrochen.

Im Gegensatz zu den Statements, die mit der DBLOG-Trace-Funktion angezeigt werden, zeigt der Snapshot das Statement in seiner Gesamtheit (begrenzt auf 13 Zeilen).

Die Snapshot-Daten werden im Natural-DBLOG-Puffer gehalten und werden nur dann angezeigt, wenn der Benutzer das entsprechende `DBLOG`-Kommando eingibt (s. unten).

Folgende Themen werden behandelt:

- Snapshot Report für SQL-Statements aufrufen

- Snapshot Report-Informationen für SQL-Statements

### Snapshot Report für SQL-Statements aufrufen

Um den Snapshot Report-Bildschirm für SQL-Statements aufzurufen:

1. Geben Sie im DBLOG-Menü ein SQL-Statement und, falls gewünscht, zusätzliche Kriterien an und geben Sie den Funktionscode `S` ein.

   Die Meldung `DBLOG snapshot facility started now` erscheint und zeigt an, dass die DBLOG-Snapshot-Funktion jetzt gestartet wurde.

2. Führen Sie ein Natural-Programm aus, das das im DBLOG-Menü angegebene SQL-Statement enthält. (Die Protokolldaten werden in den Natural-DBLOG-Puffer geschrieben.)

3. Geben Sie zur Anzeige der Snapshot-Daten das folgende Kommando ein:

       TEST DBLOG Q

   Oder:
   Geben Sie im DBLOG-Menü den Funktionscode `E` ein.

   Der Snapshot Report-Bildschirm für SQL-Statements erscheint (Beispiel):

       10:59:28              ***** NATURAL Test Utilities *****             2006-12-12
       User SAG                      - Snapshot Report -              Library SAG

       CU SN M Typ R SQLC/W     Library  Program  Store Clock Value   Line LV CID(Hex)
       01 01 D DB2              SAG      SAGTEST  2002/04/03 14:23:06 0150 01 01500101

       SQL Statement
       SELECT EMPNO,FIRSTNME,MIDINIT,LASTNAME,EDLEVEL,SALARY FROM DSN8510.EMP WHERE EM
       PNO > '000300' FOR UPDATE OF EDLEVEL

       Command ===>
       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help  Print Exit                                                  Canc

### Snapshot Report-Informationen für SQL-Statements

Der Snapshot Report-Bildschirm für SQL-Statements enthält folgende Informationen:

Spalte | Erklärung
--- | ---
CU | Cursor-Nummer.
SN | Interne Statement-Nummer.
M | Modus: `D` für dynamisch oder `S` für statisch.
Typ | Datenbanktyp: Db2.
R | Gilt nur bei Benutzung des Natural File Server for Db2. Ein Stern vor dem betreffenden Statement zeigt an, dass eine Neuselektion durchgeführt wurde, andernfalls bleibt das Feld leer. Siehe auch Concept of the File Server in der Natural for Db2-Dokumentation.
SQLC/W | Entweder der SQL-Rückgabecode im Feld SQLCODE der `SQLCA` oder die Warnung im Feld SQLWARN0 der `SQLCA`, wenn `SQLCODE` `0` ist.
Library | Library, in der das Natural-Programm mit dem protokollierten Statement katalogisiert wurde.
Program | Name des Natural-Programms, das das protokollierte Statement enthält.
Store Clock Value | Zeitstempel des Natural-Programms, das das protokollierte Statement enthält.
Line | Quellcode-Zeilennummer des protokollierten Statement.
LV | Aufrufebene (Level) des Natural-Programms, das das protokollierte Statement enthält.
CID (Hex) | Kommandokennung (Command ID) des protokollierten Statement im Hexadezimalformat.

## Snapshot-Funktion für VSAM-Aufrufe

Diese Snapshot-Funktion generiert den Snapshot Report (s. Beispiel-Bildschirm weiter unten) des ersten VSAM-Aufrufs, der die Auswahlkriterien erfüllt, die im DBLOG-Menü angegeben wurden. Bei einem Snapshot wird der Programmfluss nicht unterbrochen.

Die Snapshot-Daten werden im Natural-DBLOG-Puffer gehalten und werden nur dann angezeigt, wenn der Benutzer das entsprechende `DBLOG`-Kommando eingibt (s. unten).

Folgende Themen werden behandelt:

- Snapshot Report für VSAM-Aufrufe aufrufen

- Snapshot Report-Informationen für VSAM-Aufrufe

### Snapshot Report für VSAM-Aufrufe aufrufen

Um den Snapshot Report-Bildschirm für VSAM-Aufrufe aufzurufen:

1. Geben Sie im DBLOG-Menü einen VSAM-Aufruf und, falls gewünscht, zusätzliche Kriterien an und geben Sie den Funktionscode `S` ein.

   Die Meldung `DBLOG snapshot facility started now` erscheint und zeigt an, dass die DBLOG-Snapshot-Funktion jetzt gestartet wurde.

2. Führen Sie ein Natural-Programm aus, das den im DBLOG-Menü angegebenen VSAM-Aufruf enthält. (Die Protokolldaten werden in den Natural-DBLOG-Puffer geschrieben.)

3. Geben Sie zur Anzeige der Snapshot-Daten das folgende Kommando ein:

       TEST DBLOG V

   oder

       TEST DBLOG V SHOW

   Oder:
   Geben Sie im DBLOG-Menü den Funktionscode `E` ein.

   Der Snapshot Report-Bildschirm für VSAM-Aufrufe (Beispiel) erscheint:

       11:19:53            ***** Natural Test Utility *****                2019-10-14
       User SAG                  - Snapshot Report -                 Library SAG

               VSAM Call..... : GETNXT        CID(Hex).... : 00500101
               Flag 02  ..... : 32            CMD Code.... : L3
               Flag 03  ..... : 00            FILENAME.... : EMPLVS
               Flag 04  ..... : 00            PATHNAME.... :
               Flag 06  ..... : 90            RETCODE..... : 0000      (Hex)
               VSAM Key ..... : 11100102      ProbCode.... : 00000000  (Hex)
               NAT Pgm  ..... : VSAM01        Key Len..... :     8
               PgmLine  ..... : 0050          Nat Resp.... :
               FileType ..... : KSDS          DBID/FNR.... :   254 /     1

        Record:  CHAR : 11100102EDGAR               PETER               SCHINDLER
                 HEX  : FFFFFFFFCCCCD444444444444444DCECD444444444444444ECCCDCDCD44444
                        11100102547190000000000000007535900000000000000023895435900000

        CBA   :  CHAR :  VL3 &????               ? ? ? ?   AAANVSL3L
                 HEX  : 0EDF0500F00000000000000000000000000CCCDEEDFD000000000000000000
                        05330011E10000000000000007080708000111552333000000000000000000

        SB    :  CHAR : AA,8,A.
                 HEX  : CC6F6C40000000000000000000000000000000000000000000000000000000
                        11B8B1B0000000000000000000000000000000000000000000000000000000

        FB    :  CHAR : AA,8,A.
                 HEX  : CC6F6C40000000000000000000000000000000000000000000000000000000
                        11B8B1B0000000000000000000000000000000000000000000000000000000

        RB    :  CHAR :
                 HEX  : 44444444000000000000000000000000000000000000000000000000000000
                        00000000000000000000000000000000000000000000000000000000000000

        ISN   :  CHAR :
                 HEX  : 00000000000000000000000000000000000000000000000000000000000000
                        00000000000000000000000000000000000000000000000000000000000000

        VB    :  CHAR :
                 HEX  : 00000000000000000000000000000000000000000000000000000000000000
                        00000000000000000000000000000000000000000000000000000000000000

### Snapshot Report-Informationen für VSAM-Aufrufe

Der Snapshot Report-Bildschirm für VSAM-Aufrufe enthält folgende Informationen:

Feld | Erklärung
--- | ---
VSAM Call | Ausgebener VSAM-Aufruf.
File 02 | Flag 02 vom DCR Copybook.
Flag 03 | Flag 03 vom DCR Copybook.
Flag 04 | Flag 04 vom DCR Copybook.
Flag 06 | Flag 06 vom DCR Copybook.
VSAM Key | Erste 8 Bytes des VSAM-Schlüssels.
NAT Pgm | Natural-Programmname.
PgmLine | Quellcode-Zeilennummer des Natural-Programms.
FileType | Dateityp KSDS, ESDS oder RRDS.
CID(HEX) | Command ID, equivalent to that of ADABAS.
CMD CODE | Äquivalentes Adabas-Kommando.
FILENAME | VSAM-Datei, auf die der Zugriff erfolgt.
PATHNAME | Pfadname für die VSAM-Datei, auf die der Zugriff erfolgt.
RETCODE | Rückgabecode von dem VSAM-Aufruf.
ProbCode | Problemcode von dem VSAM-Aufruf.
Key Len | Länge des VSAM-Schlüssels.
Nat Resp | Natural-Rückgabecode, falls vorhanden.
Record | Erste 62 Bytes des VSAM-Datensatzes.
CBA | Erste 62 Bytes des CBA-Datensatzes.
SB | Erste 62 Bytes des Suchpuffers (Search Buffer).
FB | Erste 62 Bytes des Formatpuffers (Format Buffer).
RB | Erste 62 Bytes des Datensatzpuffers (Record Buffer).
ISN | Erste 62 Bytes des ISN-Puffers (ISN Buffer).
VB | Erste 62 Bytes des Wertpuffers (Value Buffer)

### On this page

- Snapshot-Funktion für Adabas-Kommandos
- Snapshot-Funktion für SQL-Statements
- Snapshot-Funktion für VSAM-Aufrufe