ACCOUNT.RESTORE

ACCOUNT.RESTORE

Top  Previous  Next

 

The ACCOUNT.RESTORE command restores a Pick style ACCOUNT-SAVE tape.

 

 

Format

 

ACCOUNT.RESTORE {options}

 

where

 

optionsis any combination of the following:
BINARYSuppresses translation of field marks to newlines when restoring directory files. Use this option when restoring binary data.
DET.SUPSuppresses display of the name of each file as it is restored.
DIRECTORYCauses new files to be created as directory files. Existing files are not reconfigured.
NO.CASECauses new files to be created with case insensitive record ids. Existing files are not reconfigured.
NO.INDEXDo not create alternate key indices.
NO.OBJECTOmits restore of object code. This is particularly useful when migrating to QM from other environments.
POSITIONEDAssumes that the tape is already positioned at the start of the data to be restored.

 

The ACCOUNT.RESTORE command processes a Pick style "compatible mode" tape or pseudo tape and restores data from it into a QM system.

 

The tape to be restored must first be opened to the process using the SET.DEVICE command.

 

The command prompts for the name of the target account.

 

Items in the save that originated in the MD file are restored to a file named MD-RESTORE from where the user can then determine which are relevant to QM and require transfer to the VOC file. Similarly, if a save includes a VOC file, this will be restored to VOC-RESTORE.

 

Note that restoring a file from a different database product may take considerably longer than restoring the same save on the other product because the file hashing order will be different and the data will not appear in group by group order.

 

The format of ACCOUNT.SAVE tapes varies between multivalue products. A Pick style "compatible mode" (R83 format) tape commences with

Label

EOF block

Label

Descriptor block

EOF block

Label

Data.....

 

ACCOUNT.RESTORE therefore normally starts by skipping forwards to the third label block. On some systems, the tape commences simply with a label block followed immediately by the data. To allow for the possibility of this and other formats, the T.RDLBL and T.READ commands can be used to position the tape before the first data block. Use of the POSITIONED option in ACCOUNT.RESTORE will then omit all other positioning from within ACCOUNT.RESTORE itself.

 

ACCOUNT.RESTORE reads the account name and other information from the label it finds on the tape. This account name is then offered as the default account name in a confirmation dialogue. If the name supplied in this dialogue exists in the accounts register, the tape is restored into that account.

 

If the account name supplied is not found in the accounts register, ACCOUNT.RESTORE prompts for a system pathname to be used as the path to the account. Therefore one can restore a backup of an existing account by issuing an ACCOUNT.RESTORE command and then supplying a different name for the account. Any required items can then be copied into another account via a Q-pointer.

 

 

See also:

ACCOUNT.SAVE, FILE.SAVE, FIND.ACCOUNT, QMSAVE, RESTORE.ACCOUNTS, SEL.RESTORE, SET.DEVICE, T.ATT, T.DUMP, T.LOAD, T.xxx