Processing Save Tape Input

#### Search Results

Search

# Processing Save Tape Input

If the SAVETAPE keyword is specified, the report is printed from a save tape.

The save tape

- must have been created using ADASAV version 7.1 or above;

- may have been created online or offline;

- may be a database save, file save, or delta save tape; and

- must be supplied as a DD/SAVE sequential input file.

ADAREP does not scan the complete save tape: normally, it is sufficient to supply only the first cassette/tape reel.

ADAREP reads through the save tape to pick up the general control blocks (GCBs), the block of unreadable blocks (BUB), the mirror table, the mirror BUB, the free space table (FST), and all the file control blocks (FCBs). Once these are in main memory, ADAREP continues as for a normal database report. The file definition tables (FDTs) are read from the save tape as they are needed: they are not buffered in main memory.

Note
Adabas versions 7.2 and above do not support and therefore do not save BUB or mirror information. However, BUB and mirror information on save tapes from Adabas 7.1 is still reported.

This document covers the following topics:

- Supplying Protection Log Input

- Checking Input Tapes

- Concurrent Parameters

- Reports for Delta Save Tapes

- Report Layout

## Supplying Protection Log Input

If an online save tape is used, the corresponding protection log may optionally be specified as a DD/PLOG sequential input file:

- If DD/PLOG is supplied, ADAREP scans the protection log for FCB and FST blocks to ensure that it has the most recent versions.

- If DD/PLOG is not supplied, ADAREP prints a warning message and continues. It displays the database status as of the beginning of the online save operation (time of SYN1/SYN4 checkpoint). Any secondary extents allocated during the online save operation are not reflected in the report because they are only visible on the protection log. In addition, the physical layout section may report phantom errors due to inconsistency in the FCB and FST blocks on the save tape. This happens only if a secondary extent was allocated during the short phase when ADASAV was saving the FCB and FST blocks.

Parameters PLOGNUM and SYN1 or SYN4 identify the protection log number and block number of the SYN1 or SYN4 checkpoint. The information provided by these parameters is supplied on the tape, so specifying PLOGNUM or the SYN1 or SYN4 parameters overrides the information on the tape.

When DD/PLOG is supplied, two tape units are needed in parallel: it is not possible to concatenate the save tape and the protection log as for ADASAV RESTONL.

## Checking Input Tapes

After opening the DD/SAVE and DD/PLOG input data sets, ADAREP cross-checks to ensure that the input tapes are correct:

- If an invalid save tape is supplied, ADAREP terminates and displays error-128 (invalid save tape supplied).

- If an invalid protection log is supplied, ADAREP displays an appropriate warning message, sets the condition code to 4, and continues.

## Concurrent Parameters

CPLIST/ CPEXLIST information and the number of records loaded for a file cannot be printed from the save tape. If the CPLIST/ CPEXLIST parameter is specified or the NOCOUNT parameter is not specified with SAVETAPE, ADAREP prints a warning message, changes these options internally, and continues processing.

The VOLSER number is printed on the report. When the VOLSER is not identifiable, asterisks are printed as VOLSER numbers.

## Reports for Delta Save Tapes

For delta save tapes, much of the information is either inaccessible or must be reconstructed:

- The delta save status is always enabled; the DLOG area usage is only one block (the header) which is displayed as "n%".

- The last full save number, last delta save number, and the date/time of the last delta save are taken from the DSID.

- The estimated number of changed blocks is MAXFILES times 5 plus 30 rounded to the next multiple of 100.

- The DLOG area location is derived from the GCBs.

- The date/time of last full save cannot be reconstructed and is always displayed as "unknown".

## Report Layout

The purpose of the save tape report is to determine what the save tape contains.

The save tape report is preceded by a short header indicating the kind of save tape supplied, whether it was created online or offline, when it was created, the version of ADASAV used to create it, the database ID on the save tape, and possibly the delta save identifier of the save tape. For online save tapes, the session number of the corresponding protection log and the block number of the SYN1/SYN4 checkpoint (either supplied or derived from the tape) is displayed.

    A D A R E P    Vv.r   SMs     DBID = nnnnn  STARTED             yyyy-mm-dd   hh:mm:ss

    PARAMETERS:
    -----------

    ADAREP REPORT SAVETAPE

    ***********************************************************
    *                                                         *
    *  REPORT FROM            ONLINE DATABASE SAVE            *
    *  CREATED AT             yyyy-mm-dd  hh:mm:ss            *
    *  BY ADASAV VERSION      V vr                            *
    *  DBIB                   nnnnn                           *
    *  DSID                   1 / 0 /   yyyy-mm-dd  hh:mm:ss  *
    *  PLOG SESSION NR        17                              *
    *  SYN1 BLOCK NR          137                             *
    *                                                         *
    ***********************************************************

    **********************
    *                    *
    *  DATA BASE REPORT  *                                          yyyy-mm-dd   hh:mm:ss
    *                    *
    **********************

The database ID printed in the first line of the report is taken from the ADARUN DBID parameter. This DBID is not cross-checked with the database ID on the save tape. Instead, the save tape DBID is used throughout the report once the save tape is opened and the GCBs read.

The physical layout for file save reports is a table of RABN ranges indicating how each RABN in the database is used. Because a file save tape contains only the FCBs of the saved files, gaps exist in the physical layout table and are reported as "unknown" ranges rather than errors.

### On this page

- Supplying Protection Log Input
- Checking Input Tapes
- Concurrent Parameters
- Reports for Delta Save Tapes
- Report Layout