Restoring Files [ Performing System Operation Tasks ] MPE/iX 5.0 Documentation
Performing System Operation Tasks
Restoring Files
The next sections teach you how to restore:
* 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:
* @.group.account for users.
* @.@.account for the account manager (AM).
* @.@.@ (or /) for the system manager (SM) and system supervisor
(OP).
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
MPE/iX 5.0 Documentation