The RESTORE function restores a database from a database SAVE data set created while the Adabas nucleus was inactive.
Notes:
This document covers the following topics:
To use the RESTORE (database) function, the following conditions must be met:
The correct SAVE data set must be supplied. It must have been created by an offline database SAVE operation with the same version of Adabas as is used for the RESTORE.
The output database must have the same physical layout (device types, extent sizes) as the original database. The Associator and Data Storage data sets must be present and must have been previously formatted. The SAVE data set to be restored may have originated for this or from a different database.
No Adabas nucleus may be active on the output database or on a database with the DBID of the output database.
If the SAVE operation was performed with the DRIVES parameter, the SAVE data sets created can also be restored with the same DRIVES parameter. Alternatively, the SAVE data sets can be concatenated to a single SAVE data set for a RESTORE operation without the DRIVES parameter which then defaults to DRIVES=1. SAVE datasets can also be arranged in multiple concatenations for use with DRIVES values greater than one. In all cases the data sets must be in ascending order, but the sequence can be broken into separate concatenations at any point,
For example, a SAVE taken with DRIVES=4 can be restored using DRIVES=1 by concatenating SAVE dataset 1 with 2, 3 and 4 in that order. DRIVES=2 may be used by concatenating dataset 1 with 2 and 3 with 4. When DRIVES is greater than 1, the RESTORE operation is performed from the separate DDRESTn files in parallel.
The result of this function is a database with the same physical status it had at the time of the ADASAV SAVE operation.
- BUFNO: Count of Buffers Per Drive
The BUFNO value, multiplied by the DRIVES parameter value, allocates fixed buffers for RESTORE operation. A value of 2 or 3 usually provides optimum performance; up to 255 is possible. A value greater than 5, however, provides little advantage and allocates a lot of space. The default is 1 (one buffer per drive).
- CLOGDEV: Command Log Device Type
The device type to be assigned to the dual/multiple command log (CLOG). This parameter is required only if the device type to be used for the CLOG is different from that specified by the ADARUN DEVICE parameter.
- DRIVES: Tape Drives for Parallel Restore
DRIVES is the number of tape drives to be used for parallel restore processing. The number can range 1 to 8, inclusively; the default is 1.
- EXCLUDE: Exclude Specified Files from Restore
EXCLUDE lists the numbers of the files to be excluded from the restore operation; that is, the files that are not to be restored. This list can include a list of more than one Adabas file number or a range of file numbers. Ranges of file numbers should be specified using a dash (-) in the format:
fnfirst-fnlast.For a database restore:
no files specified in the EXCLUDE parameter will exist in the restored database; and
all files specified in the EXCLUDE parameter must exist on the save data set (if they are not included in a range of files).
The parameter is optional: if not specified, no files are excluded. A file number may be listed only once individually or in a range.
The EXCLUDE parameter is provided for use in recovery jobs built by the Adabas Recovery Aid (ADARAI).
- NEWDBID: New ID for Restored Database
NEWDBID may be used to assign a different database ID to the restored database. The ID can be in the range 1-64535; if Adabas Online System Security is installed, DBID 999 is reserved.
If NEWDBID is specified, the ADARUN DBID parameter must specify the ID of the database on the SAVE data set.
No Adabas nucleus may be active with the DBID specified on NEWDBID.
- NEWDBNAME: New Database Name
NEWDBNAME assigns a new name to the restored database. If NEWDBNAME is not specified, the restored database keeps its old name.
- NOUSERABEND: Termination without Abend
When a parameter error or a functional error occurs while this utility function is running, the utility ordinarily prints an error message and terminates with user abend 34 (with a dump) or user abend 35 (without a dump). If NOUSERABEND is specified, the utility will not abend after printing the error message. Instead, the message "utility TERMINATED DUE TO ERROR CONDITION" is displayed and the utility terminates with condition code 20.
Note:
When NOUSERABEND is specified, we recommend that it be specified as the first parameter of the utility function (before all other parameters). This is necessary to ensure that its parameter error processing occurs properly.- OVERWRITE: Overwrite Existing Database
If the restore operation is to overwrite an existing database, the OVERWRITE parameter must be specified.
No Adabas nucleus may be active on the database to be overwritten.
- PLOGDEV: Protection Log Device Type
The device type of the dual/multiple protection log (PLOG). This parameter is required only if the device type of the PLOG is different from that specified by the ADARUN DEVICE parameter.
- TEST: Test Syntax
The TEST parameter tests the operation syntax without actually performing the operation. Only the syntax of the specified parameters can be tested; not the validity of values and variables.
ADASAV RESTORE OVERWRITE
A database is to be restored. An existing database might be overwritten.
ADASAV RESTORE EXCLUDE=10,11,12
Files 10 through 12 are excluded from the restore of the database from an offline-save data set.