Previous Topic: REPLY commandNext Topic: RESUME command

System Programmer Reference › Commands › RESTORE command

RESTORE command

Authorization: USER, SYSADMIN

To select files to restore and to submit requests to CA VM:Backup for processing, use the RESTORE command. When you use the RESTORE command from a full-screen terminal, you bypass some or all of the CA VM:Backup screens.

This command offers selection, display, and destination options. Selection options specify the criteria CA VM:Backup is to use to create a list of files to restore (the restore selection list). Display options tell CA VM:Backup where to send the restore selection list (your terminal, a printer, or your A-disk). Destination options tell CA VM:Backup where to restore the files.

Follow these guidelines when using these options:

If CA VM:Backup sends message 0824I because it could not locate files that meet the selection criteria, enter the RESTORE command without destination options.

The following pages describe using the RESTORE command from a full-screen terminal. You can also use the RESTORE command from a line-mode terminal. In either case, CA VM:Backup distinguishes between system administrator and user authorization levels. For end users, CA VM:Backup does not distinguish between expertise levels for this command; all users are considered experts.

For more information about using the RESTORE command from a line-mode terminal, see "Restoring from a Line-Mode Terminal" in the CA VM:Backup User Guide. The CA VM:Backup User Guide does not include information about restoring data backed up for other users. Neither does that book include information about restoring data to minidisks or directories belonging to other users. When a system administrator uses the RESTORE command from a line-mode terminal, CA VM:Backup asks for the source and target user IDs.

This command has the following format:

RESTORE [filename [filetype]] [(["Selection Options"...]
         ["Display Options"] ["Destination Options"]]

Selection Options:

FOR userid [vaddr] 
FROM begindate TO enddate 
ALL | LATEST

Display Options:

  DISK [APpend] 
| PRInter 
| TERMinal

Destination Options:

QUIET TOUSER userid [TORDR | TODISK vaddr]

Definitions

filename [filetype]

Specifies the filename and, optionally, the filetype of the file you want to restore, or you can use pattern matching to restore all files with similar filenames, filetypes, or both so that CA VM:Backup can create a restore selection list. The default is all filenames and all filetypes.

FOR userid [vaddr]

Tells CA VM:Backup which minidisk you want to restore. You can specify any user ID for userid. To specify your user ID, type either your user ID or an asterisk. Specify the virtual address of the minidisk you want to restore for vaddr. To search all the minidisks owned by a user ID, specify the user ID and type * for vaddr. You cannot specify a directory name. By default, CA VM:Backup searches your user ID and the virtual address 191.

FROM begindate TO enddate

Tells CA VM:Backup to search for files backed up during the specified time period. You can type the date in either mm/dd/yy or yyddd format. The default for FROM date is the default time period (specified on the LISTPD configuration file record) subtracted from the current date. The default for TO date is the date of the most current backup.

ALL | LATEST

Determines which versions of files CA VM:Backup includes in the restore selection list. ALL displays every version of every file backed up within the specified time period. LATEST includes only the most recent version of each file backed up within the specified time period.

DISK [APpend] | PRInter | TERMinal

Tells CA VM:Backup where to send the restore selection list.

DISK creates a file containing the restore selection list on your A-disk. The file is named RESTORE OUTPUT. If this file already exists on your A-disk and you specify the APPEND option, CA VM:Backup adds the new list to the existing list in the file. If this file exists on your A-disk and you do not specify APPEND, CA VM:Backup replaces the existing file with the new one.

PRINTER sends a file containing the restore selection list to your virtual printer.

TERMINAL sends the list to your terminal.

QUIET TOUSER userid [TORDR | TODISK vaddr]

Tells CA VM:Backup to restore files directly to a virtual reader or minidisk without displaying the restore selection list. You cannot use the QUIET option if the catalog with the information about the files meeting the selection criteria does not contain file-level detail. When restoring data using domain-level detail catalogs, you must provide the filenames of the files to be restored.

userid

Specifies the user ID that receives the restored data. Type an asterisk or your own user ID to send it to yourself, or type another user ID if appropriate.

TORDR | TODISK vaddr

TORDR tells CA VM:Backup to restore backed-up data to the virtual reader of the user identified by TOUSER. TODISK specifies the virtual address of the minidisk to which to restore the data. The minidisk must belong to the user ID identified by TOUSER. For vaddr, you must type a specific virtual address; you cannot use pattern matching.

Examples