Chapter 6 493
Command Definitions P-R
RESTORE
If no suboptions are specified, then CREATE defaults to
ACCOUNT,GROUP,CREATOR,PATH for SM or OP, to GROUP,CREATOR,PATH
for AM, and to PATH for everything else.
If CREATE is specified, the necessary directory structures are created,
provided the user has the appropriate capabilities. System Manager (SM)
or System Supervisor (OP) capability is needed for account, group, and
user creation. Account Manager (AM) capability is needed for group and
user creation.
GROUP Instructs MPE/iX to examine the file label of the file being restored and
create the group that it finds named in the file label. The user must have
Account Manager (AM), System Manager (SM), or System Supervisor (OP)
capability.
ACCOUNT Instructs MPE/iX to examine the file label of the file being restored and
create the account that it finds named in the file label. The user must have
system manager (SM) or system supervisor (OP) capability .
CREATOR Instructs MPE/iX to examine the file label of the file being restored and
create the creator that it finds named in the file label. The user must have
the appropriate capabilities: AM, SM, or OP if the user is in the logon
account; SM or OP for users outside the logon account. If the
CREATOR=username parameter is specified, that creator identification will
be used, instead of the user in the file label.
If CREATE=CREATOR is not used, the default behavior is: If the creator of
the file is not found in the system directory, the file will not be restored.
You will get an error message telling you that the creator does not exist In
order to restore this "orphan" file, you must use the CREATOR option or the
CREATE option.
Refer to the "EXAMPLES" section for this command.
PATH Instructs RESTORE to create the hierarchical portion of the path necessary
to restore the files. The user must have the appropriate access capabilities.
Read and traverse access is required over the path and insert entry access
is required for the node where the next entry is being created. If the path
information information exists on the media then the path is created using
the information. Otherwise, a default ACD and the restoring process'
uid/gid are used. Note that the suboptions ACCOUNT and GROUP are
required to get the accounts and groups created, respectively.
CREATOR= username All files will have their creator identifications changed to the specified
user name. If username does not exist, then the file is not restored, unless
CREATE is specified.
If CREATOR=username is not specified, the creator in is determined from the
file label as it appears on the tape.
GID Changes the file gid to the supplied file group name. If filegroupname is
omitted, then the gid present on the media is preserved. This option
overrides the account and local options with respect to the gid changes.
