HP 3000 Manuals

RESTORE [ MPE/iX Commands Reference Manual Volume I ] MPE/iX 5.0 Documentation


MPE/iX Commands Reference Manual Volume I

RESTORE 

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

Syntax 

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

     where option is:

                                         [ {LOCAL                }]
[;SHOW[=showparmlist]] [;ONERROR={QUIT}] [;{GROUP=groupname      }]
                       [         {SKIP}] [ {ACC[OUN]T=accountname}]

[;CREATE= ]
[{ACCT   }]
[{GROUP  }] [;CREATOR[=username]] [;GID[=filegroupname]] [;KEEP ]
[{CREATOR}]                                              [NOKEEP]
[{PATH   }]

[;OLDDATE] [;DIRECTORY] [;LISTDIR] [;FCRANGE=filecode/filecode[,...]]
[NEWDATE ]                         [;FILES=maxfiles                 ]

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

[;VOLSET=volumesetname] [;COPYACD] [;NOACD] [;TREE] [;NOTREE]

The following parameters are available with TurboStore 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.

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)

                      @.@.@                 and/or system supervisor (OP)

                      The filesetlist parameter has the form shown below:

                           filesetitem[,filesetitem[...]]

                      where filesetitem can be ^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.

                      __________________________________________________ 

                      NOTE  ^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[..]]

                      The system restores any file that matches
                      filestorestore unless the file also matches
                      filestoexclude, which specifies files to be
                      excluded from the restore operation.  You may
                      specify an unlimited number of filestoexclude.

                      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        Both filestorestore and filestoexclude may be
filestoexclude        entered in MPE or HFS syntax.  Wildcards are
                      permitted for both MPE and HFS syntax.

                      The MPE syntax is as follows:

                           filename[.groupname[.accountname]]

                      A lockword may be specified for files to be
                      restored, 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 name syntax, the lowercase letters are
                      treated distinctly 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.

                      These wildcard characters can be used as follows

                      n@                    Restore all files starting
                                            with the character n.

                      @n                    Restore all files ending with
                                            the character n.

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

                      n@x                   Restore all files starting
                                            with the character n and
                                            ending with the character x.

                      ?n@                   Restore all files whose
                                            second character is n.

                      n?                    store all two-character files
                                            starting with the character
                                            n.

                      ?n                    Restore 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]@                Restore all files that begin
                                            with the letters A, B, or C.

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

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

                      You may specify up to a maximum of sixteen
                      characters for each character set and you may not
                      nest brackets.  You may not use character sets with
                      the TRANSPORT option.

                      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 ranged [ad-de] may cause unpredictable results.

                      __________________________________________________ 

                      NOTE  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.

                      __________________________________________________ 

                      MPE and HFS Naming Equivalences 

                      When an MPE name component is a single @ wildcard,
                      the @ will be "folded" to include all MPE and HFS
                      named files at that level and below.  To specifiy
                      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 wildcard characters.
                      Equivalent MPE and HFS formats are grouped together
                      as follows.

                      file.group.acct/    One particular file in one
                      ACCT/               particular group in one
                      GROUP/FILE          particular account.

                      file.group/LOGON-   One particular file in one
                      ACCT/GROUP/FILE     particular group in the logon
                                          account.

                      file ./FILE         One particular file in the
                                          logon group and account.

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

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

                      @.group/LOGON-      All the files (MPE and HFS) in
                      ACCT/GROUP/         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.

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

                      ?@.@.acct           All MPE named files 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 the files and directories
                                          (MPE and HFS) on the system.

                      ?@.@.@              All MPE named files on 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, the
                      following file equation entered before the RESTORE
                      command would send the listing to a line printer:

                           FILE SYSLIST; DEV=LP 

showparmlist          Tells RESTORE what information to display for the
                      files that are restored.  If you specify ;SHOW and
                      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 characters.  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 or
                      more characters.

                      __________________________________________________ 

                      NOTE  If an 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.  You cannot use
                                            NAMESONLY 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.

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

GROUP= groupname      Specifies that the files being restored will be
                      restored to an existing group identified as
                      groupname.  If you specify LOCAL, you cannot
                      specify groupname.

ACCOUNT= accountname  Specifies that the files being restored will be
                      restored to an existing account identified as
                      accountname.  If you specify LOCAL, you cannot
                      specify accountname.

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, 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.

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 media 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 media.  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 media 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
                      backup.

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 or 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 of the store
                      procedure.  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.

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.

                      You cannot use DEV with the VOLSET, VOLCLASS, or
                      VOL options.

VOL                   The volume on which the restored 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.

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.

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.

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

                      VOLUME SET NOTES 

                      The VOLSET, VOLCLASS, VOL and DEV options are
                      mutually exclusive.  You can only use the VOLSET,
                      VOLCLASS and VOL options with NMStore tapes.

                      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               Directs RESTORE to copy the ACD associated with the
                      files or directories from the media.  This option
                      is on by default.

NOACD                 Directs RESTORE to not copy the ACD associated with
                      the files or directories from the media.  This
                      option overrides the default COPYACD option.

TREE                  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                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.  NOTREE yields a
                      horizontal cut in the hierarchical directory.

THE FOLLOWING OPTIONS ARE AVAILABLE ONLY IF TURBOSTORE XL OR TURBOSTORE
XL II IS INSTALLED ON YOUR SYSTEM. TURBOSTORE IS NOT PART OF THE
FUNDAMENTAL OPERATING SYSTEM, BUT MAY BE PURCHASED SEPARATELY.

For additional information on TURBOSTORE XL, refer to the Store and 
Turbostore/iX Manual.

RESTORESET            Specifies parallel and sequential backup devices.
                      This option cannot be use if the restorefile 
                      parameter is specified.

                      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.  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 restoring files and the
                      effect is to accelerate the restore process.

                      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.

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.

MOSET                 Specifies parallel Magneto Optical (MO) backup
                      devices.  This option is not available if the
                      storefile option is specified.

                      Parallel devices are specified by either of the two
                      following commands:

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

                           ;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.

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.

   *   Command process 

       The output generated by RESTORE is sent to a file whose formal
       designator is SYSLIST. Any errors encountered during the restore
       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.

   *   Required capabilities for restoring files 

       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.

   *   Lockword requirements 

       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.

   *   Disk space requirements 

       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.

Use 

This command may be issued from a session, job, or program.  If you press
[Break] during a restore, the operation continues while you interact with
the Command Interpreter.  Both ABORT and RESUME can be used within BREAK.

The user must have System Manager (SM), System Supervisor (OP), or
Privileged Mode (PM) capability to use this command for privileged files.

Examples 

To restore all files belonging to your logon group from the restorefile 
T, enter:

     :FILE T;DEV=TAPE 
     :RESTORE *T;@;KEEP;SHOW 

In response, the system operator receives 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 

     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   REEL
     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.

Related Information 

Commands              STORE, VSTORE, REPLY, RECALL

Manuals               STORE and TURBOSTORE/iX Manual (30319-90001)

                      Magneto-Optical Media Management User's Guide 
                      (36398-90001)

                      Volume Management (32650-90045)



MPE/iX 5.0 Documentation