archive fake argument: Perform an unrecorded backup (SQL administration API)

Use the archive fake argument with the admin() or task() function to perform a 'fake' backup operation.

Certain database functionality requires the admin to perform a level-0 backup of the instance before it will be enabled. For example, after light appends have been used to load a table, one must perform a backup before logged DML activity can affect the table. In order to move a migrated 15.0.0.0 instance from compatibility mode (infrastructure 0) to native mode (infrastructure 1) the admin must take a full level-0 backup of the instance. This requirement exists to protect data consistency in the event of a failure, and should not be overridden unless taking a full backup is simply not feasible for some reason.

In this case it is possible to quickly convince the server that a backup has been taken, without actually archiving any data. Use the archive fake argument with the admin() or task() function to perform a “fake” backup operation. Add the optional “IV1” keyword to move the 15.0 instance from compatibility mode to native mode, enabling all version 15.0 features.

Syntax


1  EXECUTE FUNCTION
1 admin
1 task
2  (
2  "archive fake [IV1]"
2  ) ;

Usage

Use this function to perform a fake level-0 archive of your instance.

This function is equivalent to running onbar -b -F, or ontape -s -L 0 command with TAPEDEV set to the null device.

Example

The following example performs an unrecorded backup:
EXECUTE FUNCTION task("archive fake");