RESTORE

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. You should not specify restorefile 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.

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

The filesetlist parameter has the form shown below:

  filesetitem[,filesetitem[...]]

where filesetitem can be ^indirectfile or fileset.

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.

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.

Both filestorestore and filestoexclude may be 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:

For HFS 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:

These wildcard characters can be used as follows

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

Examples of using character sets are:

You may specify up to a maximum of sixteen characters for each character set and you may not nest brackets.

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.

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.

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

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

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.

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.

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.

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

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

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.

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.

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 .

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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.

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

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.

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.

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

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.

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.

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

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.

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

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.

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

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.

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

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

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.

Specifies that RESTORE should use the supplied directoryname when looking for the disk store 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 STOREDIRECTORY option does not need to be specified. The user needs to have access permissions to the STOREDIRECTORY path and the STORE directory file.

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.

Allows RESTORE to restore individual database dataset files without specifying the database's root or DBCon file.

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.

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.

In the following example, all three tapes will be used in parallel during the restore:

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

In the following example, sets of tapes are used sequentially for the restore. Two tapes would be restoring at any particular moment, while the other two are rewinding so that the operator may switch reels.

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

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

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.

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.

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

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.

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.

STORE, VSTORE, REPLY, RECALL

STORE and TURBOSTORE/iX Manual

Magneto-Optical Media Management User's Guide

Volume Management