RESTORE


RESTORE

     Returns files that have been stored on backup media to the system.  (CM)

SYNTAX

     RESTORE [restorefile][;filesetlist][;option][;...]]

where option is

[;SHOW[=showparmlist]]

{SKIP}
[;ONERR[OR]={QUIT}]
{FULL}

{LOCAL }
[;{GROUP=groupname }[;...]]
{ACC[OUN]T=accountname}

{GROUP }
[;CREATE[={ACCT }[,...]]]
{CREATOR}
{PATH }
[;CREATOR[=username]]
[;GID[=filegroupname]]

[;{KEEP }]
{NOKEEP }

[;{OLDDATE}]
{NEWDATE}

[;DIRECTORY]
[;LISTDIR]
[;PROGRESS[=minutes]]

[;FCRANGE=filecode/filecode[,...]]
[;FILES=maxfiles]

[;DEV=device]
[;VOL=volumename]
[;VOLCLASS=volumeclassname]
[;VOLSET=volumesetname]

[;COPYACD] [;NOACD]
[;TREE] [;NOTREE]

[;STOREDIR[ECTORY]=directoryname]
[;PART[IAL]DB]

[;RESTORESET=(device[,...])]

** TurboSTORE/iX II and TurboSTORE/iX 7x24 True-Online Backup
products only:

[;RESTORESET=(device[,...])[,(device[,...])[,...]]]

[;MOSET=(ldev[,...])[,(ldev[,...])[,...]]]
[;NAME=backupname]


PARAMETERS

restorefile         The name of the device that contains the files you
want restored to the system. This file must be
backreferenced, using an asterisk (*). A FILE
equation for restorefile should be set up before
invoking RESTORE. If you want to restore files from
a file called SOURCE enter this file equation before
running RESTORE:

FILE SOURCE;DEV=TAPE

The restorefile can now reference a remote device.
For example,

FILE REMOTE;DEV=REMSYS#TAPE
RESTORE *REMOTE;@;SHOW

NM Restore will restore all files from the specified
remote device. Although the initial tape mount
request will appear on the remote console, all of
Restore's console messages will be displayed on the
local console. Currently, labeled tapes and
Magneto-optical devices cannot be used for remote backup.

A message is displayed on the system console
requesting the operator to mount the tape
identified by the restorefile parameter and to
allocate the device.

If restorefile is not supplied and the RESTORESET
option is not used, then RESTORE creates a default
file name. The default file name is the user's
logon username. No file equation is used.

Sequential and parallel devices are specified with
the RESTORESET option. Similarly, magneto-optical
devices are specified using the MOSET option.
Restorefile should not be specified when using
RESTORESET or MOSET.

A disk file can also be specified with a file
equation for restorefile. An example of such a file
equation would be:

FILE MYDISC=DISCBACK.DAILY.BACKUP;DEV=DISC

Note that DEV=DISC must be specified for RESTORE to
recover files from disk backups. All other
information in the file equation will be ignored by RESTORE.

NOTE TurboSTORE/iX 7x24 True-Online Backup must be used
to create disk backups.

filesetlist Specifies the set of files to be restored. The
default depends on the user's capability, as shown below:

Default Capability

@ None
@.@ Account manager (AM)
@.@.@ System manager (SM)
and/or system supervisor (OP)

This parameter has the form

filesetitem[,filesetitem[...]]

where filesetitem may consist of ^indirectfile or fileset.

indirectfile A file name that backreferences a disk file.
The syntax is

^indirectfile or !indirectfile

This file may consist of fileset(s) and option(s),
but only options can appear after the first
semicolon (;) on each line. An option specified
on one line will operate on all files in the filesetlist.

^indirectfile is the preferred format. If you use
!indirectfile, the CI will interpret this as a
variable reference, so you will have to specify
!!indirectfile instead.

fileset Specifies a set of files to be restored, and
optionally those files to be excluded from the
RESTORE operation. The fileset parameter has the form

filestorestore[-filestoexclude[..]]

Any file that matches filestorestore will be
restored unless the file also matches a
filestoexclude, which specifies files that are to
be excluded from the RESTORE operation. An
unlimited number of filestoexclude may be
specified.

Since "-" is a valid character for HFS syntax file
names, a blank character must separate it from HFS
file sets to obtain the special negative file set meaning.

filestorestore
filestoexclude Both filestorestore and filestoexclude may be
entered in MPE or HFS syntax. Wildcards are
permitted for both MPE as well as HFS syntax.

The MPE syntax is as follows:

filename[.groupname[.accountname]]

A lockword may be specified for files to be
stored, in the form:

filename/lockword.group.account

The HFS syntax is as follows:

/dir_lev_1/dir_lev_2/.../dir_lev_i/.../filedesig

or

./dir_lev_i/dir_lev_j/.../dir_lev_k/.../filedesig

If the name begins with a dot (.), then it is
fully qualified by replacing the dot with the
current working directory (CWD).

Each of the components dir_lev_i and filedesig can
have a maximum of 255 characters with the full
path name being restricted to 1023 characters.
Each of the components dir_lev_i and filedesig can
use the following characters:

Letters a to z
Letters A to Z
Digits 0 to 9
Special characters - _ .

For HFS syntax, the lowercase letters are distinct
from the uppercase letters (no upshifting). Names
in MPE syntax are upshifted.

Both MPE and HFS name components can use the
characters @, #, and ? as wildcard characters.
These wildcard characters have the following meaning:

@ specifies zero or more alphanumeric characters.
# specifies one numeric character.
? specifies one alphanumeric character.

The characters can be used as follows:

n@ -- All files starting with the character n.

@n -- All files ending with the character n.

n##...# -- All files starting with character n
followed by up to seven digits (useful
for storing all EDIT/3000 temporary
files).

n@x -- All files starting with the character n and
ending with the character x.

?n@ -- All files whose second character is n.

n? -- All two-character files starting with
the character n.

?n -- All two-character files ending with the
character n.

Also, character sets may be specified in the
following syntax:

[ct] specifies letter c or t.
[c-t] specifies any letter from range c to t.
[e-g1] specifies any letter range e to g
or digit 1.

Examples of using character sets are:

[A-C]@ All files that begin with the
letters A, B, or C.

myset[e-g1] All files that begin with the name
myset and end in e, f, or g, or 1.

myset[d-e1-6] All files that begin with the name
myset and end in d or e, or 1, 2, 3,
4, 5, or 6.

Up to a maximum of sixteen characters may be
specified for each character set and brackets may
not be nested.

A character set specifies a range for only one (1)
ascii character. The range [a-d]@ gets all files
that begin with the letter "a" through the letter
"d". The range [ad-de] may cause unpredictable results.

Since the hyphen (-) is a valid character for HFS
syntax file names, it is allowed inside a
character set, immediately following a left
bracket ([) or preceding a right bracket (]).
When specified between two characters, the hyphen
implies a range of characters.

Specifying Database Files

When specifying TurboIMAGE and ALLBASE/SQL
databases to be restored, only the root file or
DBCon file needs to be specified. RESTORE will
determine which other files belong to that
database, and will restore all of them. If
dataset file(s) are specified without specifying a
root file, then a warning will be printed for
each file, and they will not be restored.
Individual database files can be restored
without the root file by specifying the
;PARTIALDB option on the RESTORE command line.

NOTE Database corruption may result if not all database
files are restored from a backup. Be sure that you
only want to restore certain database files before
overriding the default behavior with PARTIALDB.

MPE and HFS Naming Equivalences

When the MPE filename component is a single "@"
wildcard, the "@" will be "folded" to include all
MPE and HFS named files at that level and below.
To specify only MPE-named files, use "?@" instead.

MPE wildcards are not expanded in filestoexclude.
This means that @.@.@-@.@.@ is NOT an empty
fileset. It contains all of the HFS named files
on the system.

A fileset may be entered in any of the following
formats and may use wild card characters.
Equivalent MPE and HFS formats are grouped together.

file.group.acct
One particular file in one particular
group in one particular account.

file.group
One particular file in one particular
group in the logon account.

file
./file One particular file in the CWD.

@.group.acct
/ACCT/GROUP/
All files (MPE and HFS) in one
particular group in one particular account.

?@.group.acct
All MPE name files in one particular
group in one particular account.

@.group
/LOGONACCT/GROUP/
All the files (MPE and HFS) in one
particular group in the logon account.

?@.group All MPE named files in one particular
group in the logon account.

@.@.acct
/ACCT/ All the files (MPE and HFS) in all the
groups in one particular account, plus
all the files and directories under the
specified account.

?@.@.acct All MPE named files in all the groups in
one particular account.

thisisit.@.acct
Any MPE file named thisisit in all the
groups in one particular account.

@ All (MPE and HFS) files in the CWD.
This is the default for everyone,
regardless of permissions.

@.@ All (MPE and HFS) files in the logon account.

?@.@.@ All MPE named files in the system.

@.@.@
/ All the files and directories (MPE and
HFS) in the system.

SHOW Request to list names of restored files. Default
is a listing of the total number of all files
restored and not restored. For files not
restored, the reason and the names are listed.
This listing is sent to $STDLIST (formal
designator SYSLIST) unless a FILE command is
entered to send the listing to some other device.
For instance,

FILE SYSLIST; DEV=LP

entered before the RESTORE command would send the
listing to a line printer.


showparmlist Tells RESTORE what information to display for the
files that are restored. If you specify ;SHOW and
you omit showparmlist, then the default is SHORT
if the recordsize of SYSLIST is less than 132
characters, or LONG if the recordsize is equal to
or greater than 132. The format for showparmlist is:

showparm [,showparm[,showparm[,...]]]

where showparm may be one of the options described
below. If you do not specify SHORT or LONG, then
the base information is SHORT if SYSLIST is less
than 132 characters, or LONG if SYSLIST is 132
characters or more.

If a HFS-named file is specified in the
filesetlist, or the expansion of a wildcard
includes a HFS-named file, then a HFS-style output
listing will be used. This listing shows the same
information as the MPE format, but puts the name
of the file at the right end of the listing, to
allow for longer HFS names. If a HFS name is too
long to fit in the record size of the output file,
it will be wrapped onto the next line. Wrapping
is signified by a "*" as the last character on the line.


showparm SHORT Overrides a default of LONG and displays
file, group, and account name or the
fully qualified path name, volume
restrictions, file size (in sectors),
file code, and media number.

LONG Overrides a default of SHORT and
displays all the information that SHORT
does and adds the ending reel number,
record size, blocking factor, number of
extents, EOF, and file starting and
ending media number. For spoolfiles,
the old spoolfile name is also
displayed.

NAMESONLY Displays only the filename and the
starting and ending media number.
NAMESONLY is not allowed with SHORT or
LONG.

DATES Displays the creation date, the last
date of access, and the last date of
modification.

SECURITY For MPE format listing, causes SHOW to
display the creator and the file access
matrix for all the files which do not
have an active ACD. For files with
active ACDs only, the phrase
*ACD EXISTS* is displayed.

For HFS format listing, the phrase
*ACD EXISTS* or *ACD ABSENT* is
displayed, depending on whether the
file has an ACD.

PATH Forces all file listings to be in HFS
format. Full HFS pathnames are
displayed instead of MPE style names.

OFFLINE Sends another copy of the SHOW output to
the formal file designator OFFLINE,
which defaults to device LP.

ONERROR Tells RESTORE what to do if there is a tape read
error. If you omit this parameter, then the
default option is QUIT for labeled and unlabeled
tapes. ONERR is a synonym for ONERROR.

QUIT Tells RESTORE to abort after a tape read error.

SKIP Tells RESTORE to perform a
file-skip-forward past a tape error,
resynchronize, and resume reading from the tape.

FULL Tells RESTORE to restore a file even if
a media error occurred while reading the
file's data. SM or OP capability is
required to specify this option. A file
can be partially restored, with "holes"
where the missing data would be.
Warnings are issued on the RESTORE
listings for all files that are partially
restored. In the summary of files
restored at the end of the listing,
there is a total count of all partially files.

WARNING: Use of this option could lead
to corrupted copies of files. It
should only be used as a last resort,
when there is no other way to recover
file data. It should NEVER be used as
the default ONERROR option.


LOCAL Specifies that files will be restored regardless
of the system's directory structure. The files
will be stored in the user's current working
directory. The creator will be changed to the
current user.

GROUP= Specifies that the files being restored will be
groupname restored to an existing group identified as groupname.

ACCOUNT= Specifies that the files being restored will be
accountname restored to an existing account identified as accountname.

If you specify LOCAL, you cannot use the GROUP= or
ACCOUNT= options.

CREATE Allows you to restore files whose group, account,
or creator does not yet exist in the system's
directory. The account and groups will be created
with default capabilities.

If no suboptions are specified, then CREATE
defaults to ACCOUNT,GROUP,CREATOR,PATH for SM or
OP, GROUP,CREATOR,PATH for AM, and 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.

filegroupname The file sharing group name which will be the new
gid for all files being restored. If this
parameter is not specified then the gid on the
media is preserved.

KEEP If a file on the RESTORE tape has the same name as
a file already residing on the disk, KEEP
instructs the system to preserve the file on the
disk and to skip over the file on the RESTORE
tape. The file on tape is not restored and the
file on the disk remains as it was.

Default: If you do not specify KEEP, then the
file on the RESTORE tape replaces the identically
named file on the disk. The only exception is if
the file on the disk is being accessed when
RESTORE attempts to replace it. In that case,
RESTORE preserves the file on the disk (as if you
had specified KEEP) and skips over the file on the tape.

NOKEEP Instructs the system to restore every file on the
tape, even if it has the same name as a file
already residing on the disk. This is the default.


NEWDATE
OLDDATE Store and Restore maintain four times and dates
for each file: the creation date, modification
date, last access date, and the state change date.
NEWDATE changes all dates and times to the date
and time that RESTORE was executed. OLDDATE
retains all dates and times from the date the
files were STOREd. The default is NEWDATE.

DIRECTORY Instructs RESTORE to restore all the volume set
directories on the media. You must have system
supervisor (OP) or System Manager (SM) capability
to use this parameter. All HFS directories on the
media will also be restored.

PROGRESS Instructs RESTORE to report its progress at regular
intervals by displaying the message RESTORE
OPERATION IS nnn% COMPLETE. For interactive
users, this message is displayed on $STDLIST. For
jobs, this message is sent to the system console.

minutes A positive number specifying the number of minutes
between progress messages. The maximum is 60.
The default is 1 (one) minute.

LISTDIR This option may not be specified with any other
option, other than DIRECTORY. It displays
information from the tape directory and tape
label, but does not restore any files. The type
of tape created, the record size, and any files
that match your filesetlist are displayed. If
specified with DIRECTORY, the names of the all
volume set directories and all HFS directories on
the media are also displayed. The security
restrictions that apply to filesetlist also apply
here. The output goes to SYSLIST.

The LISTDIR option applies only to NMSTORE tapes.
It cannot be used for MPEv format tapes.

FCRANGE The set of file code ranges that are to be restored.

filecode/filecode A file code range. A filecode is an integer
between -32768 and 32767. FCRANGE=1000/1040 would
restore only those files having file codes between
1000 and 1040. You may specify a maximum of eight
file code ranges.

FILES=
maxfiles            If you are restoring a large number of files from
an MPE V/E (transport) tape, specify a number at
least as large as the number of files to be
restored. The default is 4000.

This parameter is ignored when you are restoring
MPE XL format store tapes. No limit is imposed.

When a FILES= option is put in an indirect file,
it is ignored.

DEV=device Specifies the device on which the restored files
are to reside. It takes one of two forms:

devclass Specifies the type of device. The
file is allocated to the home volume
set (within the specified device
class) of the group into which it is
being restored.

ldn Specifies a particular logical
device number (ldn) corresponding to
a particular device. The file will
be allocated to that device only if
one of the volumes in the home
volume set (of the group into which
a file is being restored) currently
occupies the device.

By default, MPE/iX attempts to restore the file on
a logical device compatible with the type and
subtype specified in the file's file label and
with the type and subtype of the mounted home
volume set (of the group into which a file is
being restored). If this fails, an attempt is
made to restore the file on the same device class
as specified in the file's file label and that of
the mounted home volume set (of the group into
which a file is being restored). If this fails,
an attempt is made to restore the file on any
member of the home volume set (of the group into
which a file is being restored). If this fails,
the file is not restored.

DEV cannot be used with the VOLSET, VOLCLASS, or
VOL options.

VOL The volume on which the files are to reside. If
there is no room on this volume, the device
restrictions will default to the volume's class;
if this fails, it will default to the volume's
set; if both fail, the files will not be restored.

The VOL option is allowed only with NMStore tapes.
VOL cannot be used with VOLCLASS.

volumename A volume name. If no VOLCLASS or VOLSET options
are specified, volumename must reside on the system volume set.

VOLCLASS The volume class on which the files are to reside.
If there is no room on this volume class, the
device restrictions will default to the volume
class's volume set; if this fails, the files will
not be restored.

VOLCLASS cannot be used with VOL.

volumeclassname A volume class name. If no VOLSET options are
specified, volumeclassname must reside on the
system volume set.


VOLSET Specifies the volume set on which the files are to
reside. If the specified directories do not exist
on that volume set, the file(s) will be restored
to the specified group and account.

The VOLSET option is allowed only for NMStore tapes.

volumesetname A volume set name. If the VOL or VOLCLASS options
are specified, the corresponding volume/volume
class name must reside within this volume set.

VOLUME SET NOTES

VOLSET, VOLCLASS, and VOL may not be used with the
DEV option.

You can inadvertently restore files to groups or
accounts that you did not intend. This can happen
if the accounting structure of the files you are
restoring does not match the accounting structure
of the target volume, volume class, or volume set.
For instance, if you restore files to
VOLSET=joes_vs (assume that joes_vs exists) but
the accounting structure of those files does not
exist on joes_vs, the files will be restored to
the volume set where the group and account exist.
This may not be where you intended them to go.
The system does not prevent this, so you must use
caution.

MPE/iX volume sets are not compatible with MPE V/E
private volumes, and MPE XL introduces a new
naming convention for volume sets. Refer to the
VSRESERVE and VSRELEASE commands.

COPYACD The COPYACD option directs RESTORE to copy the ACD
associated with the files or directories from the
media. This option is on by default.

NOACD The NOACD option directs RESTORE to not copy the
acd associated with the files or directories from
the media. This option overrides the default
COPYACD option.

TREE The TREE option forces every HFS syntax file set
to be scanned recursively, irrespective of the
slash specified or not at the end of the file set.

NOTREE The NOTREE option forces every HFS syntax file set
not to be scanned recursively irrespective of the
slash specified or not at the end of the file set.
This option yields a horizontal cut in the
hierarchical directory.

STOREDIR[ECTORY] Specifies that RESTORE should use the supplied
directoryname when looking for the store disk
directory file. This option should be specified
if the disk directory file for this backup
resides in a directory other than the default path
of /SYS/HPSTORE/store_dirs/. If a disk
directory file exists in the default directory
for this backup, the STOREDIR option does not
need to be specified. The user needs to have
access permissions to the storedir path and the
store directory file.

This option can be used with the LISTDIR option
to get a listing of all files on a backup
without mounting the backup media.

directoryname The name of the disk directory file to be used
by RESTORE. It can be in either MPE or HFS
format. If it is not a fully qualified
filename, it will be qualified by the CWD. This
file should either be a disk directory file
created by STORE or a symbolic link pointing to
one.

PART[IAL]DB Specify to allow RESTORE to verify individual
database dataset files without specifying the
database's root or DBCon file.

NOTE Database corruption may result if not all database
files are restored from a backup. Be sure that you
only want to restore certain database files before
overriding the default behavior with PARTIALDB.

THE FOLLOWING OPTIONS ARE AVAILABLE ONLY IF TURBOSTORE/iX II OR
TURBOSTORE/iX 7x24 TRUE-ONLINE BACKUP IS INSTALLED ON YOUR SYSTEM.
TURBOSTORE/iX PRODUCTS ARE NOT PART OF THE FUNDAMENTAL OPERATING
SYSTEM, BUT MAY BE PURCHASED SEPARATELY.

For additional information on TURBOSTORE/iX products, refer to the
STORE and TurboSTORE/iX Manual (30319-90001).

RESTORESET Specifies parallel and sequential backup devices.

Consecutive tapes are specified in the following
way:

;RESTORESET = (*tape1,*tape2,*tape3,...)

This instructs MPE/iX to use only one drive at a
time for the RESTORE operation. When the first
reel of tape is exhausted, RESTORE will shift to
the next available drive, leaving the first free
for rewinding and changing reels. Thus, at any
given time, only one drive is occupied with the
RESTORE operation.

FOS RESTORE can restore files using serial devices.
However, it cannot restore files using parallel
devices.

Parallel devices are specified by

;RESTORESET=(*tape1),(*tape2),(*tape3)...

In this example, all three tapes will be used in
parallel during the restore.

A set of sequential tapes to be restored from in
parallel would be specified by

;RESTORESET=(*tape1,*tape2),(*tape3,*tape4)

In this example, two tapes would be restoring at
any particular moment, while the other two are
rewinding, permitting the operator to switch
reels.

This option cannot be use if the restorefile
parameter is specified.

device Specifies the device from which the file is to be
restored. It must be a magnetic tape or DDS.
This device should be specified in a file equation
before you invoke the RESTORE command, ie:

FILE DEVICE;DEV=TAPE

This file equation can also specify a remote
device or a disk file.

MOSET Specifies parallel Magneto Optical (MO) backup devices.

Parallel devices are specified by:

;MOSET = (12),(13),(15)

or

;MOSET = (MO),(MO),(MO)

All MO devices are used in parallel during the
RESTORE. The preferred format is specifying just
"MO", since RESTORE will use the the NAME
parameter to locate the correct media.

This option is not available if the restorefile
option is specified.

NAME This parameter must be specified with the MOSET
option, and cannot be specified without it. If
specifies the logical name to be used for the
backup. For example:

RESTORE @.@.@;;MOSET=(12);NAME=DAILY.D23OCT90.BOZO

This name could indicate that the restore should
be taken from the daily backup done on 23 Oct 1990
on the system called BOZO.

backupname A three field name of a total maximum length of 26
characters. The format is fname.gname.aname. The
name represents the "handle" to this particular
backup and can is used to retrieve files from this
backup. The fname, gname and aname can be up to 8
alphanumeric characters. For example:

DAILY.D24OCT90.SYSTEM


OPERATION

This command restores data into the system (on disk), from a file
 or files previously stored by the STORE command. A message is
 shown on the system console requesting the system operator to
 mount the device(s) identified by the restorefile parameter or
 the RESTORESET option, and to allocate the device(s).
     No message is displayed if AUTOREPLY is configured through SYSGEN.

If you press [Break] during a RESTORE operation, the operation
continues while you interact with the Command Interpreter. Both
ABORT and RESUME can be used within BREAK.

This command may be issued from a session, job, or program. The
user must have System Manager (SM), System Supervisor (OP), or
Privileged Mode (PM) capability to use this command for
privileged files.

The output generated by RESTORE is sent to a file whose formal
designator is SYSLIST. Any errors encountered during the RESTORE
operation will be reported to SYSLIST (and optionally OFFLINE).
The ONERR option determines if RESTORE will continue after
encountering an error restoring a file. Any file belonging to a
group whose home volume set has not been mounted will not be restored.

If you are restoring files that were stored on a large MPE V/E
tape or disk, such as a SYSGEN tape, you must include the
maxfiles parameter. Specify a number at least as large as the
number of files to be restored. The default is 4000.

Your capabilities determine which files you may restore. If you
have system manager or system supervisor capability, you can
restore any file from a STORE tape, assuming the account and
group to which the file belongs, and the user who created the
file, are defined in the system. If you have account manager
capability, you can restore any file in your account. To restore
files with negative file codes, you need Privileged Mode (PM),
system supervisor (OP), or system Manager (SM) capability. If
you have standard user capability, you can restore only those
files in your logon account.

With the ;CREATE option, you may build groups, accounts, and
creators which do not currently exist in the directory. This
way, you may restore files to your system without first defining
the account, group and user with the NEWACCT, NEWGROUP, and
NEWUSER commands. However, these structures will be created with
default capabilities.

The system manager and system supervisor may restore
lockword-protected files without specifying the lockword only
when RESTORE is executed during a session. Users without SM or
OP capability must always supply the lockword. The exception is
AM. If you have AM and you are working in your own account, you
do not have to supply the lockword. If RESTORE is executed as a
job, however, all users lacking SM, OP, or AM capability must
supply file lockwords.

RESTORE determines whether sufficient disk space remains to
restore a file that already exists on the disk. If sufficient
space remains, RESTORE writes a new copy of the file to the disk
before purging the old copy of the file. The old copy of the
file is purged only if the RESTORE operation is successful.

When restoring backups created with TurboSTORE/iX 7x24
True-Online Backup, when the sync point occurred at the end of
the backup, RESTORE must read the complete store directory
information before restoring any files. If a store disk
directory file exists for this backup, or one is specified with
the STOREDIRECTORY option, then RESTORE can read the directory
information from this file before starting to restore files.
However, if a disk directory file does not exist, or is not
specified, then RESTORE may prompt the user to mount the last
media from the backup. RESTORE will skip to the final media
directory information, and then will prompt the user to mount
the first needed media for the backup. If you know that you
are restoring from a sync at end True-Online backup and do not
have a disk directory file, then you can speed up the restore
process by mounting the last piece of media first.

Files that have after image data from a sync-at-end True-Online
backup will be inaccessible between the time that the normal
file data is restored, and the after image log data is read in
from the end of the backup and restored. You will not be able
to read or modify these files until the after image log data
has been applied.


EXAMPLE

To restore all files belonging to your logon group from the
 restorefile T, enter:
     FILE T;DEV=TAPE
RESTORE *T;@;KEEP;SHOW

The system operator will receive a request to mount the tape
identified as T. If a file on T already exists in the system, it
will not be restored because the KEEP parameter was specified.

To restore a file ABC without specifying a restorefile, no file
equation need be used. For example:

RESTORE;ABC.PUB.SYS;SHOW (**Restores ABC.PUB.SYS**)

TURBO STORE/RESTORE, VERSION A.50.11 HP36398A
(C) 1986 HEWLETT-PACKARD CO.
WED NOV 23, 1994, 11:22 AM

WILL RESTORE 1 FILES; NUMBER OF FILES ON MEDIA 1

FILENAME GROUP ACCOUNT VOLUME RESTRICTIONS SECTORS CODE MEDIA
ABC .PUB .SYS DISC :C 0 1

FILES RESTORED : 1

If you restore all files without specifying a fileset, a warning
will appear, alerting you that all files, based on your
capabilities, will be restored.

RESTORE

>> TURBO-STORE/RESTORE VERSION A.50.03 HP36398A <<
(C) 1986 HEWLETT-PACKARD CO.
THU, JAN 6, 1994, 8:10 PM

WARNING: YOUR DEFAULT FILESET BECOMES '@' SINCE YOU HAVE NONE OF
OP, AM, OR SM CAPABILITY (S/R 1913)

To have the list of restored files printed on a line printer, enter:

FILE T;DEV=TAPE
RESTORE *T;@;SHOW=OFFLINE

To restore the file FILEA.GROUPA.ACCOUNTA when the creator,
USERA, does not exist on the system, you may use one of the
methods shown here:

RESTORE *TAPEFILE; FILEA.GROUPA.ACCOUNTA; CREATOR=USERB

This changes the creator of FILEA to USERB. USERB must exist on
the system.

RESTORE *TAPEFILE; FILEA.GROUPA.ACCOUNTA; CREATE=CREATOR

This creates USERA on the system.

RESTORE *TAPEFILE; FILEA.GROUPA.ACCOUNTA; CREATE

Creates USERA on the system, and GROUPA and ACCOUNTA, if
necessary, and if you have the require capabilities.

To restore only a subset of the fileset, enter

RESTORE *T;@.@.@-@.PUB.SYS

This restores all files except those in PUB.SYS.

ADDITIONAL INFORMATION

Commands: STORE, VSTORE

Manuals : STORE and TurboSTORE/iX Manual (30319-90001)
Magneto-Optical Media Manager User's Guide (36398-90001)
Volume Management Reference Manual (32650-90045)