Restoring Files from a Disk File

Specifying the Disk File

You direct RESTORE to restore files from a disk file created by TurboSTORE by using file equations. These file equations follow the same rules that TurboSTORE used when it created the disk files. You must specify the name of the disk file to be used in the file equation, and specify the DEV=DISC option. All other options specified in the file equation will be ignored. For example, to restore from the disk file MYBACKUP.BACKUPS.SYS, issue the following file equation:

   :FILE DISKF=MYBACKUP.BACKUPS.SYS;DEV=DISC

You can then use this file equation in your RESTORE command, just as you would use a file equation for a tape device:

   :RESTORE *DISKF;@.@.@;SHOW

You can change the name and location of the disk backup file from what it was when STORE created it. You then specify their new name and/or location when issuing the file equation. See the "Storing to Disk Files" section in Chapter 3, "Preparing Storage Devices," for more information on the naming convention used by TurboSTORE when it creates disk backup files.

Restoring From Multiple Disk Files

If the backup to be restored contains more than one disk file, create only one file equation pointing to the first disk file. RESTORE will automatically open the subsequent disk files. Do not create any file equations for the other disk files.

Be sure that all of the disk files in a backup are present at the time of the backup. RESTORE will abort with an error if it is unable to open a disk file that is part of the backup.

All of the disk files for the backup must reside in the same group or HFS directory. RESTORE will use the fully qualified path for the file specified with the file equation to determine where the other disk files are located.

If you want to rename the disk files or change their location from where STORE originally created them, be sure that all disk files are put in the new location. Also, the base filename (i.e., without the ".#" extension), must all remain the same. RESTORE cannot locate disk files that are part of the same backup if they have different base filenames.

Restoring from Parallel Disk Files

If the backup was created by writing to multiple, parallel disk files with the the STORESET parameter, then files from that backup can be restored with the RESTORESET parameter. For each parallel disk file to be restored, a file equation must be issued for the first disk file in each parallel set.

For example, to restore from a two-way parallel disk backup, specify the following file equations:

   :FILE SET1=FULL1.BACKUPS.SYS;DEV=DISC

   :FILE SET2=FULL2.BACKUPS.SYS:DEV=DISC

These file equations can then be used with the RESTORESET parameter:

   :RESTORE ;@.@.SYS;SHOW;RESTORESET=(*SET1),(*SET2)

As when restoring from multiple disk files, the base names of all disk files in each parallel set must be the same, and all files of a parallel set must reside in the same group or HFS directory. However, the names can be changed from what they were when they were created by TurboSTORE.

Unlike restoring from tape devices, when performing a parallel restore, all parallel sets in the backup must be specified in the RESTORESET command. Tape devices can use console messages to request that media from an additional parallel backup be mounted. However, when restoring from disk backups, no operator messages are issued, and if a parallel set was not specified in the RESTORE command, RESTORE will fail to restore all files on the missing parallel sets, and will abort. Always specify all parallel sets in the RESTORESET parameter.

	NOTE: Just as storing to serial disk files with the STORESET command is not allowed when storing files, restoring from serial disk files using the RESTORESET command is not supported. You need only to specify a file equation for the first disk file in the backup, or in a parallel set. RESTORE will automatically find and open any additional files in the backup that it needs. All other RESTORE options (other than MOSET and NAME) can be used when restoring from disk files.

Verifying Disk Backups

Disk files can also be specified for the VSTORE command. All of the RESTORE guidelines regarding file equations and the RESTORESET parameters apply. For example, to verify all files written to the disk file backup, MYBACKUP, issue the following commands:

   :FILE DISCF=MYBACKUP

   :VSTORE *DISCF;@.@.@;SHOW