Use
The system displays the content of the
backup history. You can restrict or extend what is displayed using options.Prerequisites
You have the DBM operator authorization
Backup or DBInfoRead.You have fetched the backup history (
Fetching the Backup History).Syntax
backup_history_list <options>
Options
-c <columns> |
With option –c you can restrict the number of columns to be displayed. The keywords for the individual columns are:KEY LABEL ACTION STAMP1 STAMP2 START STOP FIRSTLOG LASTLOG LOG MEDIA PAGES VOLUMES RC ERROR If several columns are specified, you separate them by commas. |
-k <key> |
Only the line of the backup history that contains the keyword specified under <key> is displayed.This option cannot be used with the -r option. |
-l <label> |
Only the lines of the backup history that contain the specified backup ID are displayed.This option cannot be used with the -r option. |
-a <action> |
Only the lines of the backup history that correspond to the specified backup type are output. This option cannot be used with the -r option. |
-r |
All data backups that are required to recover the database instance are displayed. If the log volume is intact, only the data backups that match the available log are displayed. |
-r LAST |
Beginning with the last complete data backup, all backups that are required to recover the database instance are displayed. |
-r <key> |
Beginning with the complete data backup specified in <key>, all backups that are required to recover the database instance are displayed. |
-u <yyyymmddhhmmss> |
Only those lines in the backup history that contain data that was saved in the database instance before the specified time are displayed. This option cannot be used with the -r option. |
-m |
For each line that relates to a backup, information is supplied on the backup medium used. |
-e |
For each line that relates to a backup, information is supplied on the relevant external backup ID. |
Reply
OK<NL>
(END|CONTINUE)<NL>
<history_line><NL>
[<media_line><NL>]
[<external_backup_id-line><NL>]
<history_line><NL>
[<media_line><NL>]
[<external_backup_id-line><NL>]
....
Values for the individual fields of the reply
END |
The contents of the backup history have been transferred in full. The file is closed automatically. |
CONTINUE |
The backup history contains further entries that were not transferred due to the limited storage available for replies. You can interrogate this data by entering the above command or close the backup history. |
<history_line> |
Information on the completed backups. The individual columns are separated by |. A separate line is output for each backup. |
<media_line> |
Information on the medium used for the backup |
<external_backup_id_line> |
If the backup was created using an external backup tool, information on the external backup ID is provided here. You have to specify this information when restoring a backup from an external backup tool.The line is prefixed with E: which, in turn, is followed by columns separated with |. |
In the event of errors, see
Reply Format.