OLD-SAVE

Saves an account for loading on a 5.3 or 6.0 Reality system.

The Procs OLD-ACCOUNT-SAVE and OLD-FILE-SAVE use the OLD-SAVE command and should be used in preference to OLD-SAVE.

Caution

You must always perform a VERIFY-SAVE as soon as possible after completing a save procedure. This verifies the integrity of the data saved to tape to ensure that it can be restored.

The Migration Utilities described in the optional manual User's Guide to Reality Migration Utilities should be used in preference to OLD-SAVE.

Should you decide not to use the migration utilities, OLD-SAVE must be used in place of SAVE, where appropriate, to avoid file and/or item loss on restore. However, because of additional 7.0 features there are a number of potential problems on restoring to a pre-7.0 Reality system - see Restrictions.

Command Class

TCL-II command.

Restrictions

SYSMAN and SYSPROG accounts only. If run from SYSPROG, accounts with update/retrieval lock codes are not saved.
When restored, the account must be updated using UPDATE-ACCOUNT. (See the relevant documentation for your system for details).
Item-ids to be restored must not be more than 50 characters long.
All data is saved to tape, but on restore, very large items are truncated to the maximum system size.
Any single level files must have a data pointer in the dictionary.
Binary items are not restored.
Passwords are irreversibly encrypted on Reality. If passwords are not removed before accounts are saved, then, on restore, an encrypted form of password is expected at the PASSWORD: prompt.
The account to be saved must have MD entries of type Q for MD, Proc, and M/DICT.
The save must be single reel.

Procedure

Log on to SYSMAN or SYSPROG.
Load a write-enabled tape and put the unit on-line.
Attach the tape unit(s) using ASSIGN with the default channel.
At the TCL prompt use:

OLD-SAVE SYSTEM * (I {options}

Of the following options at least I must be specified:

D Dumps data files (default).

F Lists file names as well as account name.

I Saves individual account for which you are subsequently prompted.

P Prints the standard terminal output to the printer assigned to you process.

S Creates file statistics in STAT-FILE.

Z Creates file statistics in user-specified file. Z is overridden by S.
Depending on the options specified, the system displays a series of up to two prompts (of the form '?') for the following information in order given:
- An optional description to be included in the tape label. Up to 44 characters can be entered.
- If the option Z was specified, the name of the file to hold the file statistics.
You are now prompted as follows for the account to save:
```
ACCOUNT NAME?
```
Enter the name of the account to be saved. The save now proceeds and, when completed, the TCL prompt is redisplayed. The tape unit(s) remain(s) attached.

A typical OLD-SAVE procedure is shown below:

:ASSIGN =TAPE 1 LABEL=1
[1021] DEVICE(S) TAPE 1 NOW ASSIGNED
       RECORD SIZE = 24000    DENSITY = 1600

:OLD-SAVE SYSTEM * (VFIS

? TEST

ACCOUNT NAME?  PERSNL

SYSTEM
PERSNL
  COCARS
   .
   .
   .
[99]45 TAPE RECORDS WRITTEN
: