tcl.account-restore Verb: Access/TCL

tcl.account-restore

Command tcl.account-restore Verb: Access/TCL
Applicable release versions: AP, R83
Category TCL (746)
Description restores an account from an "account-save", "file-save" or "md-save" magnetic media.

The account/master dictionary will not be restored if it already exists in the "mds" file.

The system prompts for the "ACCOUNT NAME ON TAPE". It only has to be entered if the account name on tape is different than the account name stated in the command line.

Additional changes saved on a transaction log and/or incremental save tape may also be applied, once the account/master dictionary has been restored. The default settings prompt for both of these.

An "account-restore" may be started from any tape of a multi-tape "file-save".

To save time in searching a tape, the "list-file-stats" listing may be consulted to determine the reel on which the data for the master dictionary starts. The listing is only generated if the "s" option is chosen while doing a save.

After the restore is complete, the system creates indices for files having an index specified in the file-defining item.

The appropriate media/device must be attached prior to issuing this command.
Syntax account-restore account.name {(options)}
Options frame.size (integer number). Designates the frame size of the source system which created "save" media. This option automatically affects modulos, which are either divided or multiplied by the given number, according to the data frame size on the target machine (see the "what" command for determining data frame size). If the target frame size is bigger than the source frame size, all modulos are divided by the ratio (target / source = ratio). For example, if the target system has 2K data frames and the source system had 500-byte frames, the modulos would all be divided by 4. This file resizing operation occurs after the reallocation parameter has been checked, unless file resizing has been disabled during the initial boot process.

a Indicates that the tape is already positioned at the data section of the correct account. This means that it is positioned PAST the label, right at the beginning of the data. For example, if the "t-fwd" command was executed to position to the right spot on the tape, a "t-rdlbl" command would have to be executed to be positioned at the beginning of the data.

c "compatible" tape. This is used on tapes produced on "licensee" systems (Ultimate, McDonnell Douglas, ADDS, GA, etc.) The restore process runs noticably slower. (AP only)

d Data-sensitive files. All files except the md will be restored as ds-type files (case sensitive). (AP only)

f Disables the "fast" restore on 6.1 and above. This should always be used when restoring non-AP tapes.

n Disables file reallocation process.

s Ignores tape label information. (R83 only)

s Suppresses messages on txlog tapes. (AP only)

z Bypasses prompts for restore from incremental or transaction logs. (AP only)
Example
account-restore production
account name on tape: <return>

This restores the "production" account from tape and calls it 
"production". 

account-restore dm.old
account name on tape: dm

This restores the "dm" account from the tape and calls it 
"dm.old". 

account-restore OLD.R83.PROD (500
account name on tape: PROD

This restores an account created on a system with 500 byte data frames. If the 
target were to have a data frame size of 2K, for instance, all new modulos will 
be divided by 4 to prevent files from being drastically oversized.
Purpose
Related tcl.md-restore
tcl.f-resize
tcl.sel-restore
tcl.file-save_rp
tcl.file-save
tcl.save
tcl.admin.files
tcl.set-8mm
tcl.set-floppy
tcl.set-half
tcl.set-sct
tcl.set-sct-dma
tcl.set-device
files
tcl.list-restore-errors
tcl.update-md
tcl.indexer
dummy.restore
tcl.tlog-restore
tcl.set-tape-type
tcl.account-save
tcl.list-file-stats
tcl.what
account
tcl.t-select
tcl.t-stat
reallocation
tcl.case
filename.restore-errors
restore