onbar argument: Backup the storage spaces (SQL administration API)
Use the onbar argument with the admin() or task() function to backup the storage spaces.
Syntax
EXECUTE FUNCTION
admin
task
("onbar backup
whole system
levellevel
logs
"
)
;
| Element | Purpose | Key considerations |
|---|---|---|
| onbar backup | Performs a complete backup of the storage spaces | If you do not specify a level, a level 0 backup is performed. |
| whole system | Performs a whole-system backup | This is equivalent of issuing the onbar command with the -w option from the command line. If you do not specify a level, a level 0 backup is performed. |
| level level | Specifies the level of backup to perform on storage
spaces:
|
If you request an incremental backup and a level
backup has not been performed for a particular storage space, this
function backs up that storage space at the previous level. For example, if you request a level-1 backup, and the function finds no level-0 backup, a level-0 backup is made instead. This is equivalent of issuing the onbar command with the -L level option from the command line. |
| logs | Performs a back of the logical-log files | This is equivalent of issuing the onbar command with the -l option from the command line. |
Usage
This function is equivalent to invoking specific options of the onbar command to create backups of the storage spaces and logical-log files.
Examples
The following example creates a
level 0 backup of the storage spaces:
EXECUTE FUNCTION task("onbar backup");
The following example creates a level 1 backup
of the storage spaces:
EXECUTE FUNCTION task("onbar backup level 1");
The following example creates a level 1 backup
of the logical-log files:
EXECUTE FUNCTION task("onbar backup logs");
The following example creates a whole system level
0 backup of the storage spaces:
EXECUTE FUNCTION task("onbar backup whole system");
The following example creates a whole system level
2 backup of the storage spaces:
EXECUTE FUNCTION task("onbar backup whole system level 2");