The snapshot function provides detailed information on one particular Adabas command, DL/I call, SQL statement or VSAM call.
This section covers the following topics:
This snapshot function interrupts program execution after executing the first Adabas command that matches the selection criteria specified in the DBLOG Menu. The Snapshot Report (see the following example screen) generated for the specified Adabas command is displayed immediately after program interruption.
The snapshot function automatically logs all Adabas buffers. Therefore, you do not have to mark any of the optional buffers in the DBLOG Menu before you start the snapshot function. The default Snapshot Report displays the control block (CB), which is either the classic control block (ACB) or the extended Adabas control block (ACBX).
This section covers the following topics:
To invoke the Snapshot Report screen for Adabas
commands
In the DBLOG Menu, specify an Adabas command
and additional criteria, if desired, and enter function code
S.
The message DBLOG snapshot facility started
now is displayed.
Execute a Natural program which contains the Adabas command specified in the DBLOG Menu.
The program stops executing and a Snapshot Report screen similar to the example below appears:
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 |
The Snapshot Report screen shows the control block (CB) by default. If you want to display different Adabas buffers or scroll through a report, choose the appropriate PF key or, in the Command line, enter its equivalent direct command described in this section.
The availability of a PF key depends on the buffer currently displayed. If a buffer extends beyond the screen or contains multiple format/record buffers, PF keys required to scroll through the buffer are provided on the screen.
| PF Key | Direct Command | Buffer |
|---|---|---|
| PF4 | CB |
Displays the control block. This is the default. |
| PF5 | FB |
Displays the format buffer. |
| PF6 | RB
or -- |
Displays the record buffer (RB) or
scrolls (--) to the beginning of a long buffer.
|
| PF7 | - |
Scrolls up one page in a long buffer. |
| PF8 | + |
Scrolls down one page in a long buffer |
| PF9 | SB
or ++ |
Displays the search buffer (SB) or scrolls
(++) to the end of a long buffer.
|
| PF10 | VB
or < |
Displays the value buffer (VB). For multiple
format/record buffers, shows the previous (<) record/format
buffer.
|
| PF11 | IB
or > |
Displays the ISN buffer (IB). For multiple
format/record buffers, shows the next (>) record/format
buffer.
|
For information on the fields displayed in a control block or buffer, see Displaying Adabas Buffers.
This snapshot function generates the
Snapshot
Report (see the following example screen) of the first
DL/I call that matches the selection criteria specified in the DBLOG
Menu. A snapshot does not interrupt the program flow. The snapshot
data is kept in the Natural DBLOG buffer to be displayed only if the user
enters the appropriate DBLOG command as described
below.
This section covers the following topics:
To invoke the Snapshot Report screen for DL/I
calls
In the DBLOG Menu, specify a DL/I call and
additional criteria, if desired, and enter function code S.
The message DBLOG snapshot facility started
now is displayed.
Execute a Natural program which contains the DL/I call specified in the DBLOG Menu. (Log data is written to the Natural DBLOG buffer.)
Display the snapshot data by entering the following command:
TEST DBLOG D
Or:
In the DBLOG Menu, enter function code
E.
A Snapshot Report screen for DL/I calls similar to the example below appears:
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 |
The following information is provided on the Snapshot Report screen for DL/I calls:
the PSB (Program Specification Block) Name
the PCB (Program Communication Block) Number
the PCB mask, which consists of the following:
DBD (Database Description) including Database Name
Segment Level number
Statuscode
Processing Options
Segment Name
Length of KFBA (Key Feedback Area)
Number of SENSGs (Sensitive Segments)
KFBA:
Key Feedback Area
Number of SSAs (Segment Search Argument)
all SSAs
the I/O Area
The first 120 bytes of the Key Feedback Area, of all SSAs (up to 15 SSAs are possible) and of the I/O area are displayed, both in decimal and hexadecimal format.
The DBD Name in the PCB is used to read the corresponding NDB (Natural equivalent of DBD) from the Natural FDIC system file. In this NDB, the segment whose name is given in the PCB is located and its minimum/maximum length and segment level number are displayed. The segment level number should match the number in the PCB. In this way, it is possible to detect inconsistencies between Natural NDBs and DL/I DBDs.
The PSB name is used to read the corresponding NSB (Natural equivalent of PSB) from the Natural FDIC system file. From this NSB, the number of sensitive segments is displayed. This number should match the number in the PCB. In this way, it is possible to detect inconsistencies between Natural NSBs and DL/I PSBs.
The snapshot function checks whether the DL/I DBD/PSB and the Natural NDB/NSB contain the same values in the fields Level Number and Number of SENSEGs. The same values, however, do not necessarily ensure that the DL/I DBD/PSB and the Natural NDB/NSB are fully consistent.
In the example above, the values in the Number of SENSEGs fields are different, because the Natural NATPSB procedure was not executed after the PSB had been changed by the DL/I PSBGEN procedure.
The snapshot function generates the Snapshot Report (see the following example screen) of the first SQL statement that matches the selection criteria specified in the DBLOG Menu. A snapshot does not interrupt the program flow.
Unlike the statements displayed with the DBLOG trace function, the snapshot shows the statement in its entirety (limited to 13 lines).
The snapshot data is kept in the Natural DBLOG buffer to be displayed
only if the user enters the appropriate DBLOG
command as described below.
This section covers the following topics:
To invoke the Snapshot Report screen for SQL
statements
In the DBLOG Menu, specify an SQL statement and
additional criteria, if desired, and enter function code S.
The message DBLOG snapshot facility started
now is displayed.
Execute a Natural program which contains the SQL statement specified in the DBLOG Menu. (Log data is written to the Natural DBLOG buffer.)
Display the snapshot data by entering the following command:
TEST DBLOG Q
Or:
In the DBLOG Menu, enter function code
E.
A Snapshot Report screen for SQL statements similar to the example below appears:
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 |
The following information is provided on the Snapshot Report screen for SQL statements:
| Column | Explanation |
|---|---|
| CU | Cursor number. |
| SN | Internal statement number. |
| M | Mode: D for dynamic or S for
static.
|
| Typ | Database type: DB2. |
| R | Only applicable if the Natural File Server for DB2 is in use.
Indicates by an asterisk in front of the corresponding statement that a reselection has been performed; if not, the column is left blank. See also Concept of the File Server in the Natural for DB2 documentation. |
| SQLC/W | Either the SQL return code in the SQLCODE field of the
SQLCA, or the warning in the SQLWARN0 field of the
SQLCA if SQLCODE is 0.
|
| Library | The library where the Natural program with the logged statement was cataloged. |
| Program | The name of the Natural program which contains the logged statement. |
| Store Clock Value | The time stamp of the Natural program which contains the logged statement. |
| Line | The source code line number of the logged statement. |
| LV | The call level of the Natural program which contains the logged statement. |
| CID (Hex) | The command ID of the logged statement in hexadecimal format. |
This snapshot function generates the
Snapshot
Report (see the following example screen) of the first
VSAM call that matches the selection criteria specified in the DBLOG
Menu. A snapshot does not interrupt the program flow. The snapshot
data is kept in the Natural DBLOG buffer to be displayed only if the user
enters the appropriate DBLOG command as described
below.
This section covers the following topics:
To invoke the Snapshot Report screen for VSAM
calls
In the DBLOG Menu, specify a VSAM call and
additional criteria, if desired, and enter function code S.
The message DBLOG snapshot facility started
now is displayed.
Execute a Natural program which contains the VSAM call specified in the DBLOG Menu. (Log data is written to the Natural DBLOG buffer.)
Display the snapshot data by entering the following command:
TEST DBLOG V
or
TEST DBLOG V SHOW
Or:
In the DBLOG Menu, enter function code
E.
A Snapshot Report screen for VSAM calls similar to the example below appears:
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 |
The following information is provided on the Snapshot Report screen for VSAM calls:
| Field | Explanation |
|---|---|
| VSAM Call | VSAM call issued. |
| File 02 | Flag 02 from the DCR copybook. |
| Flag 03 | Flag 03 from the DCR copybook. |
| Flag 04 | Flag 04 from the DCR copybook. |
| Flag 06 | Flag 06 from the DCR copybook. |
| VSAM Key | First 8 bytes of the VSAM key. |
| NAT Pgm | Natural program name. |
| PgmLine | Source code line number of the Natural program. |
| FileType | File type KSDS, ESDS or RRDS. |
| CID(HEX) | Command ID, equivalent to that of ADABAS. |
| CMD CODE | Equivalent ADABAS command. |
| FILENAME | VSAM file accessed. |
| PATHNAME | Path name for the VSAM file accessed. |
| RETCODE | Return code from the VSAM call. |
| ProbCode | Problem code from the VSAM call. |
| Key Len | VSAM key length. |
| Nat Resp | Natural return code, if any. |
| Record | First 62 bytes of the VSAM record. |
| CBA | First 62 bytes of the CBA record. |
| SB | First 62 bytes of the search buffer. |
| FB | First 62 bytes of the format buffer. |
| RB | First 62 bytes of the record buffer. |
| ISN | First 62 bytes of the ISN buffer. |
| VB | First 62 bytes of the value buffer. |