Restoring Files

• a single file, a group of files, or all files on the STORE tape

• multiple sets of files

• all files in a set that you specify, excluding files that you don't want to restore

• a set of files that share the same file code

To restore a single file

To restore a file from the tape to the system disk, first issue a FILE command to name the backup device and describe its type. (If you do not use a FILE command, RESTORE creates a default file name based on your username.) Then issue a RESTORE command specifying the file you want to restore, any options you want to use, and the backreferences to the file name of the backup device.

For example, to restore the file FILE1 in the group OPERATOR of the SYS account, enter:

   FILE T;DEV=TAPE

   RESTORE *T;FILE1.OPERATOR.SYS

You may omit the backreference, as shown in the following example. If you do so, you must include the semi-colon (";") to serve as a placeholder.

   RESTORE ;FILE1.OPERATOR.SYS

Or, for example, to restore my_file in the directory my_dir, enter:

   RESTORE *T;/my_dir/my_file

You must use a FILE command if you want the device to be automatically allocated. Refer to "To assign a file name to a backup device" in chapter 6 for more information on the FILE command.

To restore several files

To restore two or more files at the same time, list each file in the RESTORE command line, and separate the file names with commas. For example, to restore two MPE files, one in the RESEARCH account and one in the ACCTNG account, you would enter:

   FILE T;DEV=TAPE

   RESTORE *T;FILE1.PUB.RESEARCH,FILE2.PUB.ACCTNG

Or, to restore the same two files using HFS syntax, you would enter:

   FILE T;DEV=TAPE

   RESTORE *T;/RESEARCH/PUB/FILE1,/ACCTING/PUB/FILE2

To use wildcard characters to reference files

To restore all the files in a particular group and account, or all files in a particular directory, use the wildcard character @ to indicate all the files in the set. For example, to restore all files in MYGROUP of the SYS account, enter:

   FILE T;DEV=TAPE

   RESTORE *T;@.MYGROUP.SYS

When you want to restore all files from a set of STORE tapes, it is best to use / (representing "all files") in place of @.@.@. For example:

   FILE T;DEV=TAPE

   RESTORE *T;/

If you omit a list of files in the RESTORE command, MPE/iX restores a file set based on your capabilities. In particular, it restores:

	NOTE: For complete information about wildcard characters, read "To use wildcard characters and character sets" in Chapter 6.

To use character sets to reference files

You can use a character set, which is a series of characters to substitute for a single character, to name groups of files in the RESTORE command line. For example, to restore all files beginning with the character a, b, c, d, e, or f in the current working directory, enter:

   FILE T;DEV=TAPE

   RESTORE *T;[a-f]@

Or, to restore all files ending with e, f, g, or 1 in the current working directory, enter:

   FILE T;DEV=TAPE

   RESTORE *T;@[e-g1]

If you are following MPE syntax, you may specify a maximum of 16 characters for each fully qualified file designator part. You cannot nest brackets.

You cannot use character sets when restoring transport tapes.

	NOTE: For complete information about wildcard characters, read "To use wildcard characters and character sets" in chapter 6.

To specify files to exclude

At times it may be easier to describe the set of files you want to restore as a large set minus a certain subset. For example, suppose you want to restore all files in all groups of the PERSONEL account except the files in the FORMS group. Describe the set of files to store as shown in the following example:

   FILE T;DEV=TAPE

   RESTORE *T;@.@.PERSONEL - @.FORMS.PERSONEL

You can describe an unlimited number of excluded subsets for a set of files. For example, to restore all files from the PERSONEL account except files in the FORMS and RECORDS groups, enter:

FILE T;DEV=TAPE

RESTORE *T;@.@.PERSONEL - @.FORMS.PERSONEL - @.RECORDS.PERSONEL

	NOTE: When you use the minus sign (-) to indicate a set of files to exclude, you must precede and follow it with a space. Otherwise, MPE/iX will interpret it as part of the preceding file name, since the minus sign is a valid character in HFS syntax.

For transport tapes, you can specify only one excluded subset.

To restore multiple sets of files

You can restore multiple sets of files the same way that you restore more than one individual file, that is, by separating the file sets with commas in RESTORE command line. For example, to restore all files to the PERSONEL account except the files in the FORMS group and to restore all files in the PAY group of the ACCTG account, enter:

   FILE T;DEV=TAPE

   RESTORE *T;@.@.PERSONEL - @.FORMS.PERSONEL,@.PAY.ACCTG

	NOTE: When you use the minus sign (-) to indicate a set of files to exclude, you must precede and follow it with a space. Otherwise, MPE/iX will interpret it as part of the preceding file name, since the minus sign is a valid character in HFS syntax.

To restore files with specific file codes

MPE/iX file codes distinguish different types of files. Using the FCRANGE parameter of the RESTORE command, you can restore only files with certain file codes. You can select up to eight file code ranges to restore.

For example, the files with codes 1100, 1101, and 1102 are HP WORD files. Files with codes 1152 and 1153 are SLATE files. To restore all HP WORD and SLATE files from a tape, enter:

   FILE T;DEV=TAPE

   RESTORE *T;/;FCRANGE=1100/1102,1152/1153

The FCRANGE parameter is not valid when restoring from transport tapes.

To specify a maximum number of restored files

By default, MPE V/E restores a maximum of 4000 files at a time. If you are restoring more than 4000 files using the TRANSPORT parameter, use the FILES= parameter of the RESTORE command to specify the maximum number of files to be restored. If you do not use the TRANSPORT parameter, the FILES= parameter is not necessary; if present, it is ignored.

To set the maximum number of files restored to 6000 from a transport tape enter the following:

   FILE T;DEV=TAPE

   RESTORE *T;@.OPERATOR.SYS;FILES=6000

To list restored files

Whenever you restore a set of files, the system displays the total number of files restored at your terminal. If there is an error, it also displays the names of files not restored, the reason each was not restored, and the total number of files not restored . Use the SHOW parameter to display the names and additional information about the files restored and to list them on your system printer as well as at your terminal.

To print information at the system printer as well as at your terminal, use the SHOW=OFFLINE option:

   FILE T;DEV=TAPE

   RESTORE *T;@.OPERATOR.SYS;SHOW=OFFLINE