backup_replace

A running backup operation was interrupted because the system reported that a data carrier is full.

Use the backup_replace command to replace the full data carrier. The system will now continue the backup operation. The remaining data to be backed up is saved to all data carriers in the group

After the system has executed this DBM command, information about the backup is output. The information is only given when the backup operation is finished or is interrupted again. For this reason, the response to this DBM command can take a long time.

Note Note

Pay special attention to the Returncode reply field, which contains a numeric value for a message.

End of the note.

If it is clear from the message number that the backup operation has been interrupted again and not completed, continue the session with a succeeding command (backup_replace, backup_ignore), or terminate the session with backup_cancel.

Prerequisites

You have the server permission Backup.
You have started backing up the database. The backup operation was interrupted because one of the data carriers was reported as full. You are still in the same database session.

Structure

backup_replace <location>

Options
Option	Description
`<location>`	Complete file or device name of the data carrier

Result

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

Messages documentation

Database Administration, Backing Up Data, Backing Up Log Entries