Documentation Comments

Use this form to comment on this topic. You can also provide any general observations about the Online Documentation, or request that additional information be added in a future release.

Reality V15.0 ()

OLD-FILE-SAVE (m6049aa+oldfilesave.htm)

To	Reality
Version
Topic
Submitted by
Company
Location
Email address
Comment

OLD-FILE-SAVE

Creates a tape comprising a files section only, with a format suitable for loading on a 5.3 or 6.0 Reality system.

Caution

You must always perform a VERIFY-SAVE immediately after completing a save procedure to verify 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-FILE-SAVE.

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

Command Class

Proc.

Restrictions

SYSMAN and SYSPROG accounts only. If run from SYSPROG, accounts with update/retrieval lock codes are not saved.
Once restored, accounts must be updated using UPDATE-ACCOUNT.
Item-ids to be restored must not be more than 50 characters long.
All data is saved, but very large items are truncated at maximum system size on restore.
Any single level files must have a data pointer in the dictionary.
Binary items are not restored.
Passwords are irreversibly encrypted. 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.
You should DX SYSMAN, SYSPROG, SYSFILES, HOTEL, English TUTORIAL ATP and DENAT before the save.
The save must be single reel.

Procedure

The procedure is very similar to the FILE-SAVE procedure.