restore-accounts Command

The restore-accounts BASIC program restores all accounts that do not already exist on the system from the attached file-save tape or a tape created by an account-save with an active list of accounts. File statistics can be built with the restore operation. It is therefore not necessary to do a file-save after a restore operation to create file statistics.

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.

Syntax

restore-accounts {(options}

restore-accounts {host} {(options}

Parameter(s)

host	For Windows: If a host is specified, the account is restored onto the host system specified.
options	frame.size	Integer number that designates the frame size of the source system, which 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. 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 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.
	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.
	e	Indicates that the tape label is in Adds, Mentor format.
	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.
	n	Disables file reallocation process.
	o	Overwrite option. Applicable only when using the optional host specification.
	q	Indicates that the tape label is in non-D3 format. For example. R91.
	r	Restores accounts to the FSI.
	u	Indicates that the tape label is in Ultimate format.

This is generally used with the last file-save completed after upgrading to a new release of D3. It is important to restore the D3 file system from the media on which D3 is provided, since changes may have been made.

restore-accounts uses account-restore (az in its processing loop. The a and z options are described under account-restore.

Example(s)

Restores all accounts from the current peripheral storage device.

restore-accounts

Restores all accounts on a tape created on a licensee compatible system.

restore-accounts (cu