Background documentationrecover_replace Locate this document in the navigation structure

 

Use this command to specify the succeeding data carrier when you are asked by the system to do so.

The reply to this DBM command displays information about the import of the backup. Pay particular attention to the message number displayed in the Returncode field.

Note that this information is only given when the backup operation is completed or interrupted. For this reason, the reply to this command can take a long time.

If you have executed the DBM command and the restore process was interrupted again (message number -8020), specify the next succeeding data carrier with recover_replace.

Repeat this procedure until the data from all the data carriers belonging to the backup has been imported.

Prerequisites

  • You have the server permission Backup.

  • You have executed the DBM command for recovering the database (see: recover_start). The operation was interrupted because the data stored on the data carrier was imported completely. You are still in the same database session.

Structure

recover_replace <medium_name> [ExternalBackupID <ext_backup_ID>] [<loc> [<nnn>]]

Options

Option

Description

<medium_name>

Backup template, or complete file or device name of the succeeding data carrier

If you restore a backup, which was made with a backup template defined for several data carriers, enter the name of the group of parallel data carriers here.

ExternalBackupID <external_backup_ID>

Only for restoring a backup, which was created using a backup tool:

name under which the backup is known to the backup tool

<loc>

Name of the device/the file in which the backup to be recovered is stored

Operating system functions must be able to address the device/file using <loc>.

<nnn>

Only for importing log backups and only for data carriers of the FILE type:

version number of the log backup on the data carrier to be imported

Result

OK

Returncode <value>

...

Values for the Reply Fields

Value

Description

Date

Date

Time

Start time of the backup

Server

Name of the database computer

Database

Name of the database

Kernel Version

Version of the database kernel

Pages Transferred

Number of pages transferred

Pages Left

Number of pages still to be transferred

Volumes

Number of data carriers used

Medianame

Name of the backup template

Location

File or device name

Errortext

Error message text

See also:

Messages documentation

Label

Backup ID

Is Consistent

Only for data backup: Backup is internally consistent

First LOG Page

For data backup: First page of the log backup to be read

For log backup: First page saved in the log area

Last LOG Page

For log backup only: Last page saved in the log area

DB Stamp 1 Date DB Stamp 1 Time

Time stamp for the first page of the log backup

DB Stamp 2 Date DB Stamp 2 Time

Time stamp for the last page of the log backup

Page Count

Total number of pages backed up

Devices Used

Number of backup devices used

Database ID

Database ID used to identify data and log backups that belong together

In the event of errors, see Reply Format.

More Information

Database Administration, Restoring Databases