Use
Use this command to read a backup. As a reply to this command, you receive the information through the import of the backup. The output is, however, only given when the backup has been completely read in or is interrupted. This command may therefore take a long time to execute.
Prerequisites
You have the DBM operator authorization
Recovery.Syntax
recover_start <medium> <type> [ExternalBackupID <external_backup_ID>] [<nnn>] [UNTIL <date> <time>] [AUTOIGNORE]
<medium> |
Medium from which the backup is to be read. |
<type> |
Type of backup to be read: DATA (Complete data backup), PAGES (Incremental data backup) or LOG (Log backup) |
ExternalBackupID <external_backup_ID> |
To restore a backup created with an external backup tool, enter a backup ID name that the external tool will recognize. |
<nnn> |
Actual backup version on the backup carrier that is to be read; relevant only for media of type FILE. |
UNTIL <date> <time> |
For log backups you can enter an exact time up to which the log backups are to be read. |
AUTOIGNORE |
In the cases of a parallel restore, the process is automatically continued by the system ( Continue Parallel Restore or Backup Check). |
It is vital you follow the current media naming conventions (see
Defining or Changing Backup Media) to avoid error messages.Reply
OK<NL>
Return code <value><NL>
Date [<value>]<NL>
Time [<value>]<NL>
Server [<value>]<NL>
Database [<value>]<NL>
Kernel Version [<value>]<NL>
Pages Transferred [<value>]<NL>
Pages Left [<value>]<NL>
Volumes [<value>]<NL>
Medianame [<value>]<NL>
Location [<value>]<NL>
Error text [<value>]<NL>
Label [<value>]<NL>
Is Consistent [<value>]<NL>
First LOG Page [<value>]<NL>
Last LOG Page [<value>]<NL>
DB Stamp 1 Date [<value>]<NL>
DB Stamp 1 Time [<value>]<NL>
DB Stamp 2 Date [<value>]<NL>
DB Stamp 2 Time [<value>]<NL>
Page Count [<value>]<NL>
Devices Used [<value>]<NL>
Database ID [<value>]<NL>
Max Used Data Page [<value>]<NL>
Values for the individual fields of the reply
Date |
Date |
Time |
Time |
Server |
Name of the database server |
Database |
Name of the database |
Kernel Version |
Database kernel version |
Pages Transferred |
Number of pages transferred |
Pages Left |
Number of pages left |
Volumes |
Number of backup volumes used |
Medianame |
Name of backup medium |
Location |
File or device name |
Errortext |
Error message text |
Label |
Backup Label |
Is Consistent |
Only for data backup: backup is internally consistent |
First LOG Page |
For data backup: first page of log backup to be read For log backup: first page saved in log |
Last LOG Page |
Only for log backup: last page saved in log |
DB Stamp 1 Date |
Time stamp for first page of log backup |
DB Stamp 2 Date |
Time stamp for last page of log backup |
Page Count |
Total number of pages saved |
Devices Used |
Number of backup devices used |
Database ID |
Database ID used to identify data and log backups that belong together |
Max Used Data Page |
Maximum number of pages used (indication of minimum database size when backup is imported) |
Reply in the Event of an Error
If an error occurs while you are using an external backup tool, you will receive a reply in the following format:
ERR<NL>
<errcode>, <err_description><NL>
[<extended_description><NL>]
<errcode> |
Error message number See also: Messages: SAP DB 7.2 and 7.3 |
<err_description> |
Description of the error |
<extended_description> |
Cause of error |
The following errors may occur:
<errcode> |
<err_description> |
Explanation |
-24927 |
ERR_TOOLCHK: the external backup tool was not found |
The external backup tool could not be found or has been installed incorrectly. |
-24926 |
ERR_MEDIUMCHK: the medium cannot be used with an external backup tool |
The medium specified cannot be used with the backup tool the medium name refers to (Defining and Changing Backup Media). |
-24925 |
ERR_PREPARE: prepare of the backup operation failed |
The preparations necessary to use the backup tool were not made correctly. |
-24924 |
ERR_DBREQ: cannot start database kernel request |
The database instance was unable to start the restore operation. |
-24923 |
ERR_TOOLREQ: cannot start external backup tool correctly |
The backup tool could not be started correctly. |
-24922 |
ERR_OPCHK: cannot check state of backup operation |
Unable to check the status of the database instance or the backup tool. |
-24921 |
ERR_POSTOP: cannot finish backup operation correctly |
Although the recovery was successful, the post-processing steps required could not be performed. |
-24920 |
ERR_BACKUPOP: backup operation was unsuccessful |
The recovery failed due to a problem with the database or the backup tool. |
-24919 |
ERR_CLEANUP: cannot clean up correctly after backup operation |
Although the recovery was successful, the temporary system resources used could not be freed up again. |