IMG.SAVE

Creates a physical backup of a database.

Note: The SAVE-IMAGE Proc calls IMG.SAVE and should be used in preference to it.

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 FSCheckpointPath is not set, the database's free space table is used.

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.

IMG.SAVE now proceeds, as requested. If you have attached just one tape unit, you will be prompted to mount additional reels as necessary.

On completion, you should check the integrity of the tape with VERIFY-IMAGE or IMG.VERIFY.

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.

: