The account-restore BASIC program restores an account from an account-save, file-save, or md-save magnetic media or pseudo tape.
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)
Parameter(s)
|
options |
frame.size |
Integer number that designates the frame size of the source system that created save media. 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. |
|
|
g |
Suppresses the generation of indexes in cases where indexes are not saved to tape. |
|
|
m |
Microdata, McDonnell Douglas compatibility. |
|
|
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, NT 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)
account-restore production
account name on tape: Enter
Restores the production account from tape and calls it production.
account-restore dm.old
account name on tape: dm
Restores the dm account from the tape and calls it dm.old.
account-restore old.d3.prod (500
account name on tape: prod
The example above 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.
See Also