account-restore Command

The account-restore BASIC program restores an account from an account-save, file-save, or md-save magnetic media or pseudo tape.

NOTE

For Windows Only: If any of your data contains encrypted data, the OpenSSL libraries must be present when restoring a save. Otherwise the restore process will terminate. See encrypt-file Command for more information.

The account master dictionary is not 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 multitape 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 indexes for files having an index specified in the file-defining item, except in the case where indexes are saved to tape and the account-restore b option is not used

NOTE

  • The appropriate media/device must be attached prior to issuing this command.

  • After performing an account-restore on FSI files, the nt_indexer command is run automatically to create indexes on FSI files.

Syntax

account-restore account.name {(options)}

Synonym(s)

md-restore

Parameter(s)

options

frame.size

Integer number that designates the frame size of the source system that created save media. Specifying a frame size automatically enables the f option, which has the effect of disabling fast restores. This option automatically affects modulos, which are either divided or multiplied by the specified number, according to the data frame size on the target machine. 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 2 KB 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.

b

Ignores any indexes saved on tape.

c

Compatible tape. This is used on tapes produced on licensee systems. The restore process runs noticeably slower.

d

Data-sensitive files. All files except the master dictionary are restored as ds-type files and are case-sensitive.

f

Disables fast restores. This option is required if the data being restored needs to be logged by hot-backup or transaction logging.

g

Suppresses the generation of indexes in cases where indexes are not saved to tape.

m

Microdata, McDonnell Douglas compatibility. This option is required if you are restoring from an account-save that saved multiple accounts (for example, account-save acc1 acc2 acc3) and you want to restore any of the accounts (other than the first account). For example:

account-restore acc1 restores acc1 and does not require the m option.

account-restore acc2 (m restores acc2 and it requires the m option since the account being restored is not the first account in the account-save.

n

Disables file reallocation process.

s

Suppresses messages on transaction log tapes.

w

Allows restoring a tape made on a byte-swapped machine (for example, Windows and Linux) to a nonbyte-swapped machine (for example, AIX).

z

Bypasses prompts for restore from incremental or transaction logs.

 

WARNING

If incremental saves and/or the transaction logger is being used, the restore process may not be complete until those tapes have been restored as well.

Example(s)

Restores the production account from tape and calls it production.

account-restore production

account name on tape: Enter

Restores the dm account from the tape and calls it dm.old.

account-restore dm.old

account name on tape: dm

This example is an account created on a system with 500-byte data frames. If the target were to have a data frame size of 2 KB, for example, all new modulos are divided by 4 to prevent files from being drastically oversized.

account-restore old.d3.prod (500

account name on tape: prod

 

See Also

Account

account-save Command

admin.files Utility

case Command

Dummy Restore

encrypt-file Command

f-resize Command

file-save Command

indexer Command

list-file-stats Command

list-restore-errors Command

reallocation

Restore

restore-errors File

save Command

sel-restore Command

set-8mm Command

set-device Command

set-floppy Command

set-half Command

set-sct Command

t-select Command

t-stat Command

tlog-restore Command

update-md Command

what Command