When the Adabas Delta Save Facility is installed on your system, either the demo or full version of Adabas Online System (AOS) provides access to the optional Delta Save control screens.
14:40:40 ***** A D A B A S ONLINE SYSTEM ***** YYYY-MM-DD
- Main Menu - PMAIN02
Code Basic Services Code Other Services
---- ---------------------- ---- -------------------
A Session monitoring 1 Cache Services
C Checkpoint maintenance 2 Delta Save Facility
F File maintenance 3 Trigger Maintenance
* Database maintenance 4 AOS Security
O Session opercoms 5 Transaction Manager
R Database report 6 Adabas Statistics
* Space calculation 7 Vista
? Help 8 Fastpath
. Exit 9 SAF Security
---- ---------------------- ---- -------------------
Code ....... _
Database ... 105 (RD-105)
Command ==>
PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8-----PF12-----
Help Exit
|
Note:
The exact sequence of screens and display characteristics
(intensified values, etc.) displayed when using AOS depends on the
configuration, the features installed on the system, and the current operating
status of the system, and therefore may differ from the features and
characteristics described in this document.
The remainder of this section describes how to use the Delta Save control screens to install, change, disable, and remove Delta Save logging from the system.
Select the "Delta Save Facility" option on the Adabas Online System (AOS) Main Menu.
When the Delta Save Facility is active, the Delta Save Facility main menu is displayed.
13:16:45 ***** A D A B A S BASIC SERVICES ***** YYYY-MM-DD
Enabled - Delta Save Facility - PDSF002
Code Function
---- ----------------------------
A Allocation/Status of DSF
C Change DSF logging area
D Disable DSF logging
E Enable DSF logging
F Files modified by utilities
I Install DSF logging area
R Remove/Deinstall DSF
S Size Estimate for Delta
? Help
. Exit
-------- ----------------------------
Code ......... _
Database ID .. 105 (ADA-MPM105)
Command ==>
PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8-----PF12-----
Help Exit Menu
|
This menu indicates the status of the Delta Save Facility in the upper left corner:
| Not installed | The ADARUN DSF=YES parameter is set but the Delta Save Facility is not yet installed. |
| Enabled | The Delta Save Facility is currently active and functioning normally. |
| Disabled | Delta Save logging has been deactivated. |
| Initializing | The Delta Save Facility has been installed but the initialization process has not yet completed. If this status continues, deinstall and then reinstall the product. |
If the Delta Save Facility is not yet installed, option I displays the following window:
14:55:16 ***** A D A B A S BASIC SERVICES ***** YYYY-MM-DD
Not installed - Delta Save Facility - PDSF002
+------------------------------------------------------------+
| |
| 15:16:44 Install DSF YYYY-MM-DD |
| |
| DSF Status .... Not installed |
| |
| Specify the values for the following parameters:- |
| |
| DLOG Area Size ...... (in Blocks) |
| DLOG Area Location .. (1st RABN) optional |
| Device Type ......... 3380 optional |
| |
| |
| PF1----- PF2------ PF3------ PF4------ PF6----- PF12 |
| Help Exit Menu |
+------------------------------------------------------------+
Command ==>
PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8-----PF12-----
Help Exit Menu
|
The DLOG area must be defined before Delta Save can begin operation.
Use the Install DSF screen to define the Delta Save logging (DLOG) area and thereby install Delta Save logging. Enter the DLOG size in blocks, and, optionally, the starting RABN in the Associator and/or the device type to be used for allocation:
DLOG Area Size (required) is the number of Associator blocks to be allocated. The area must be large enough to hold all blocks changed between two consecutive Delta Save operations. About 5 bytes of DLOG area storage are needed for every database write operation. To calculate the size of the DLOG area, see Calculating the DLOG Area Size
DLOG Area Location (optional) is the first RABN to be allocated.
Device Type (optional) is the device type to be used for DLOG area allocation.
When the DLOG area is defined, you are returned to the Delta Save Facility main menu and the message
DSF function Install DSF successfully executed
-is displayed. The status of the Delta Save Facility in the upper left corner of the screen is "disabled". The "disabled" state continues until the next successful full save operation is performed with the ADASAV SAVE utility function.
If the Delta Save Facility is disabled, option E displays the following window:
13:20:36 ***** A D A B A S BASIC SERVICES ***** YYYY-MM-DD
Disabled - Delta Save Facility - PDSF002
+---------------------------------------------+
| |
| DSF is currently disabled and needs to be |
| enabled before it can start logging. |
| To enable DSF, a FULL database backup must |
| be run using ADASAV SAVE. Once the FULL |
| database save completes, DSF will become |
| enabled automatically. |
| |
| |
+---------------------------------------------+
. Exit
-------- ----------------------------
Code ......... e
Database ID .. 105 (ADA-MPM105)
Command ==>
PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8-----PF12-----
Help Exit Menu
|
Once a successful full save operation is performed with the ADASAV SAVE utility function, Delta Save logging is automatically enabled.
You can use option A to display additional status and allocation information:
13:16:45 ***** A D A B A S BASIC SERVICES ***** YYYY-MM-DD
Enabled - Delta Save Facility - PDSF002
+-------------------------------------------------------------+
| |
| Allocation Display |
| |
| DSF Status .......... Enabled |
| |
| Last full save no ... 20 on 1997-01-30 at 11:19:04 |
| Last delta save no .. 5 on 1997-03-03 at 05:06:56 |
| |
| DLOG area size ...... 500 blocks |
| DLOG area usage ..... 5% |
| DLOG area location .. 6292 (start RABN) |
| Device type ......... 3380 |
| |
| Press 'Enter' to continue/exit |
+-------------------------------------------------------------+
Command ==>
PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8-----PF12-----
Help Exit Menu
|
In addition to information about the last full save and the last delta save, this display provides information about the current DLOG area size and location, the device type, and the percentage of the DLOG area size currently being used.
Option F, files modified by utilities, indicates the name and number of the files changed on the first line and other information for the file on a second line.
The second line indicates the areas logged (IX for index; DS for Data Storage; AC for address converter) as well as block use and modification statistics for each file:
total blocks changed in all logged areas;
total DS/AC blocks used, changed, and the percentage of the used that were changed;
total index blocks used, changed, and the percentage of the used that were changed.
Another line provides separate totals for the number of DS/AC blocks and index blocks changed for all files listed.
12:55:42 ***** A D A B A S BASIC SERVICES ***** YYYY-MM-DD
DBID 105 - Display DSF Files - PDSFF02
File No Logged Tot Blks AC/DS AC/DS Blk D % Index Indx Blks I %
/Name Areas Changed Blks Used Changed Log Blks Used Changed Log
------- ------------ --------- --------- --------- --- --------- --------- ---
13 - ADABAS-LISTING
IX 1081 281 0 0 1081 1081 100
80 - PRIME-TIME
IX 3 2 0 0 3 3 100
Accumulated Totals: DS/AC .. 0 Index .. 1084
PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8-----PF12-----
Help Repos Exit -- - + Menu
|
PF2 invokes a window that allows you to reposition the list to a specified file number.
Option S, size estimate for delta, displays the estimated number of changed blocks. This number provides an estimate of the number of database blocks that would be saved in a Delta Save operation at the current time.
Allow a few seconds for the system to perform the calculation. The estimate is not precise: the actual size may be larger or smaller.
17:05:45 ***** A D A B A S BASIC SERVICES ***** YYYY-MM-DD
Enabled - Delta Save Facility - PDSF002
+----------------------------------------------------------------+
| |
| - Estimated Number of Changed Blocks - |
| |
| |
| Fixed number of RABNs to be saved .... 530 blocks |
| Index RABNs changed by utilities ..... 1084 blocks |
| DS/AC RABNs changed by utilities ..... 0 blocks |
| |
| Number of RABNs logged in DLOG Area .. ca. 2000 blocks |
| |
| |
| Approximately 3600 blocks will be saved with the next |
| SAVE DELTA function. |
| |
| |
| Press 'Enter' to continue/exit |
+----------------------------------------------------------------+
Command ==>
PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8-----PF12-----
Help Exit Menu
|
The fixed area includes the blocks for the first 30 RABNs, all FDTs and all FCBs.
Separate totals are provided for the number of index blocks as opposed to the number Data Storage and address converter blocks changed by utilities.
The calculated number of blocks for the DLOG area is a rounded number.
The total of all blocks to be saved is approximate to the nearest 100.
Disabling Delta Save logging stops the logging and prevents any further ADASAV SAVE DELTA utility operations.
Option D displays a warning about disabling the Delta Save Facility and asks for confirmation.
13:18:20 ***** A D A B A S BASIC SERVICES ***** YYYY-MM-DD
Enabled - Delta Save Facility - PDSF002
+---------------------------------------------+
| |
| - Warning - |
| |
| When DSF logging is disabled, you may no |
| longer perform Delta Save operations. To |
| enable DSF logging again, you will need to |
| do a full database save using ADASAV SAVE. |
| |
| To confirm that you want to disable DSF |
| logging, enter 'CONFIRM' ... _______ |
| |
+---------------------------------------------+
Code ......... d
Database ID .. 105 (ADA-MPM105)
DSFF04: Size Estimate found nothing for this request
Command ==>
PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8-----PF12-----
Help Exit Menu
|
Note:
It is not possible to start or restart Delta Save logging with an
online function. Delta Save logging is started ("enabled") only after
successful completion of a full save operation.
If you confirm, you are returned to the Delta Save Facility main menu and the following message is displayed:
DSF function Disable DSF logging successfully executed.
Once Delta Save logging is disabled, you can either change the DLOG area (see the section Changing the DLOG Area) or logically remove Delta Save logging from the system (see the section Removing Delta Save Logging).
You can close the current DLOG area and allocate a new and possibly larger DLOG area elsewhere in the Associator. However, the DLOG area specification can only be changed when Delta Save logging is "disabled".
Option C displays a the following window allowing you to change the values for the DLOG area size and location, and the device type.
13:19:01 ***** A D A B A S BASIC SERVICES ***** YYYY-MM-DD
Disabled - Delta Save Facility - PDSF002
+------------------------------------------------------------+
| |
| 13:19:27 Change DLOG area 1997-02-20 |
| |
| DSF Status .... Disabled |
| |
| Change the values for the following parameters:- |
| |
| DLOG Area Size ...... 500 (in Blocks) |
| DLOG Area Location .. 6292 (1st RABN) optional |
| Device Type ......... 3380 optional |
| |
| |
| PF1----- PF2------ PF3------ PF4------ PF6----- PF12 |
| Help Exit Menu |
+------------------------------------------------------------+
DSF function Disable DSF logging successfully executed
Command ==>
PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8-----PF12-----
Help Exit Menu
|
In the "Change DLOG Area" window, enter the new DLOG size in blocks and optionally, the starting RABN in the Associator and/or the device type to be used for allocation.
Once Delta Save logging is "disabled", you can logically remove the Delta Save Facility from the system. This means that the DLOG is deallocated and the Delta Save logging status is reset to "not installed".
Option R displays the following window warning you about removing the Delta Save Facility and asking for confirmation.
13:20:36 ***** A D A B A S BASIC SERVICES ***** YYYY-MM-DD
Disabled - Delta Save Facility - PDSF002
+---------------------------------------------+
| |
| - Warning - |
| |
| When DSF logging is removed, Delta Save |
| operations will no longer be possible. To |
| use DSF again, a completely new install |
| (including a full database save with |
| ADASAV SAVE) must be done. |
| |
| To confirm the removal of DSF, enter |
| 'CONFIRM' ... _______ |
| |
+---------------------------------------------+
Code ......... r
Database ID .. 105 (ADA-MPM105)
Function interrupted with PF-key
Command ==>
PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8-----PF12-----
Help Exit Menu
|
If you confirm, your are returned to the Delta Save Facility main menu and the following message is displayed:
DSF004: Delta Save Facility terminated at user's request.
