IMG.SAVE
Creates a physical backup of a database.
Note
The
SAVE-IMAGE Proc calls
Syntax
IMG.SAVE {checkpointPath} {(options}
Syntax Elements
checkpointPath The path of a checkpoint file. See B option.
Options
B Specifies that IMG.SAVE should use a host file or partition for checkpointing. If checkpointPath is not specified, IMG.SAVE prompts for a checkpoint path.
If this option is not used,
IMG.SAVE uses the file specified in the
FSCheckpointPath
database configuration option. If
R Specifies that raw mode should be used; checkpoint blocks are saved separately at the end of the process. This can be faster, but may result in larger image.
S Multi-deck sequential save. Saves to multiple decks, one at a time. Starts the next tape when the first tape is full. If additional tapes are needed, load these onto the first desk you specified when prompted.
If this option is omitted, but more than one tape unit unit is specified, IMG.SAVE uses multi-deck parallel save. This saves to multiple decks at once (like dbsave), using a round-robin approach to saving tape blocks. Each tape deck can each have only one tape - multiple reels per device are not supported. If you need more tapes than you have tape decks, you can use tape images as additional decks.
Restrictions
- IMG.SAVE is only available in the SYSMAN and SYSPROG accounts.
- IMG.SAVE may only be run by the database owner.
- Only one instance of IMG.SAVE may be run at
a time on a database.
IMG.SAVE cannot be run at the same time as any of the other physical save and restore commands
.
See also the Overview of Save and Restore.
Comments
IMG.SAVE uses the tape unit(s) currently attached to the default channel.
IMG.SAVE prompts for the tape label text (up to 42 characters).
Procedure
- Ensure that the tape is loaded and on-line, that the tape is NOT write-protected, and you are logged on to SYSMAN or SYSPROG.
-
Use T-ATT or ASSIGN to attach the required tape units to the default channel. Set the tape density and record size if required.
Notes:
- The minimum tape record size for IMG.SAVE is 65536. If you specify a value less than this (or accept the default of 8000), the minimum value will be used.
- The record size used with encrypted tape devices must be a multiple of 8.
-
Enter at the TCL prompt:
IMG.SAVE
-
You are prompted for any text that you wish to include in the tape label(the time, date, reel number, and tape record size are automatically included in the label). The prompt is:
Tape label :
You can enter up to 42 characters of text.
On completion, you should check the integrity of the tape with
Example
:T-DEVICE 1 C:\TEMP\FASTBACKUP.RTI:C2 9
:T-ATT
[1021] Device(s) TAPE 1 now assigned,
record size = 8000 density = 0.
:IMG.SAVE
Tape Label :TEST
100% complete
Dump complete, written 223 tape blocks in 00 hrs 00 mins 04 secs
[560] Image Save completed.
:
See Also