Die Snapshot-Funktion liefert ausführliche Informationen zu einem bestimmten Adabas-Kommando, DL/I-Aufruf, SQL-Statement oder VSAM-Aufruf.
Folgende Themen werden behandelt:
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:
Um den Snapshot Report-Bildschirm für
Adabas-Kommandos aufzurufen:
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.
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 |
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
( |
| PF11 | IB
oder > |
Anzeige des ISN Buffer (IB).
Bei mehreren Format/Record Buffers Anzeige des nächsten
( |
Informationen zu den Feldern, die in einem Steuerblock oder Puffer abgezeigt werden, sind im Abschnitt Adabas-Puffer anzeigen enthalten.
Diese Snapshot-Funktion generiert den Snapshot Report (s. Beispiel-Bildschirm weiter unten) des ersten DL/I-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:
Um den Snapshot Report-Bildschirm für
DL/I-Aufrufe aufzurufen:
Geben Sie im DBLOG-Menü einen
DL/I-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.
Führen Sie ein Natural-Programm aus, das den im DBLOG-Menü angegebenen DL/I-Aufruf enthält. (Die Protokolldaten werden in den Natural-DBLOG-Puffer geschrieben.)
Geben Sie zur Anzeige der Snapshot-Daten das folgende Kommando ein:
TEST DBLOG D
Oder:
Geben Sie im DBLOG-Menü den
Funktionscode E ein.
Der Snapshot Report-Bildschirm für DL/I-Aufrufe erscheint (Beispiel):
16:33:27 ***** NATURAL DBA Utility ***** 2006-12-12
User SAG - Snapshot Report - Library SAG
DL/I Call ......... : GHNP Pgm: SAGTEST Line: 0110
PSB Name .......... : PBNDL01
PCB Number ........ : 1 out of 3
Contents of this PCB Contents of NDB/NSB
Database Name ..... : DNDL01 DBD is physical
Segment Level ..... : 2 Segment Level .. : 2
Statuscode ........ : BLANK
Processing Options : A
Segment Name ...... : OFFERING DBID/FNR ....... : 246 12
Min/Max Length . : 41 41
Length of KFBA .... : 9
Number of SENSEGs . : 10 <WARNING> Number of SENSEGs: 5
Number of SSAs .... : 2
IOA: Char : ?010791DARMSTADT
Zone : 02FFFFFFCCDDEECCE44444444444444444444444400000000000000
Digit: 0901079141942314300000000000000000000000000000000000000
KFBA: Char : 004010791
Zone : FFFFFFFFF0000000000000000000000000000000000000000000000
Digit: 0040107910000000000000000000000000000000000000000000000
MORE
SSA 1 : Char : COURSE *- (COURSEN =004)
Zone : CDEDEC445644CDEDECD447FFF500000000000000000000000000000
Digit: 36492500C00D364925500E004D00000000000000000000000000000
SSA 2 : Char : OFFERING*F-
Zone : DCCCDCDC5C640000000000000000000000000000000000000000000
Digit: 66659957C6000000000000000000000000000000000000000000000 |
Im Snapshot Report-Bildschirm für DL/I-Aufrufe werden folgende Informationen angezeigt:
Name des PSB (Program Specification Block)
Nummer des PCB (Program Communication Block)
PCB-Maske mit folgenden Bestandteilen:
DBD (Database Description) einschließlich Datenbankname
Segment Level-Nummer
Statuscode
Verarbeitungsoptionen (Processing Options)
Segment-Name
Länge des KFBA (Key Feedback Area)
Anzahl der SENSGs (Sensitive Segments)
KFBA: Key Feedback Area
Anzahl der SSAs (Segment Search Argument)
alle SSAs
der I/O-Bereich
Die erstent 120 Bytes der Key Feedback Area, aller SSAs (möglich sind bis zu 15 SSAs) und des I/O-Bereihs werden sowohl im Dezimal- als auch im Hexadezimalformat angezeigt.
Der DBD-Name im PCB dient dazu, das entsprechende NDB (Natural-Äquivalent der DBD) aus der Natural-Systemdatei FDIC zu lesen. In diesem NDB wird das Segment, dessen Name im PCB gegeben ist, aufgesucht und seine minimale/maximale Länge und Segmentebenennummer werden angezeigt. Die Segmentebenennummer sollte mit der Nummer im PCB übereinstimmen. Auf diese Weise ist es möglich, Inkonsistenzen zwischen Natural NDBs und DL/I DBDs zu erkennen.
Die Snapshot-Funktion prüft, ob die DL/I DBD/PSB und die Natural NDB/NSB in den Feldern Level Number und Number of SENSEGs die gleichen Werte enthalten. Das Vorhandensein gleicher Werte stellt jedoch nicht unbedingt sicher, dass die DL/I DBD/PSB und die Natural NDB/NSB vollständig konsistent sind.
Im obigen Beispiel-Bildschirm sind die Werte in den Number of SENSEGs-Feldern verschieden, weil die Natural NATPSB-Prozedur nicht ausgeführt wurde, nachdem der PSB durch die DL/I PSBGEN-Prozedur geändert worden war.
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:
Um den Snapshot Report-Bildschirm für
SQL-Statements aufzurufen:
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.
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.)
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 |
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. |
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:
Um den Snapshot Report-Bildschirm für
VSAM-Aufrufe aufzurufen:
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.
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.)
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 |
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) |