RESTORE Command

Use the RESTORE command to select the files you want to restore and submit requests to CA VM:Backup for processing.

When you use the RESTORE command from a full-screen terminal, you bypass some or all of the CA VM:Backup screens.

You cannot use the RESTORE command to specify files backed up from SFS or BFS directories. You can use the XRESTORE Command instead, for SFS files.

This command offers selection, display, and destination options. Selection options specify the criteria CA VM:Backup is to use to create a 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 your files.

Follow these guidelines when using these options:

You can specify RESTORE command options in any order.
If you do not specify selection options, CA VM:Backup displays the latest version of files backed up from your 191 minidisk within the default search period.
You cannot specify both display and destination options on the same command.
When you use destination options:
- You can restore to any user's virtual reader or any of your minidisks, regardless of your expertise level.
- CA VM:Backup restores your files without displaying the restore selection list.
- You can use the RESTORE command with CP SMSG.
You cannot use destination options to restore data to an SFS or BFS directory. If you want to restore files to an SFS or BFS directory, you must either display the restore selection list on the file selection screen on your terminal and select files to restore from that screen or you can use the XRESTORE Command instead.
If you specify neither display nor destination options, CA VM:Backup displays the restore selection list on your terminal.
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.

This command has the following syntax:

RESTORE [filename [filetype]] [("Options"]

Options:

["Selection Options"]...
["Display Options"]
["Destination Options"]...

Selection Options:

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

Display Options:

  DISK [APpend]
| PRInter 
| TERMinal

Destination Options:

  QUIET
| TOUSER userid [TORDR | TODISK vaddr]

Definitions

filename [filetype]

Specifies the filename and the filetype of the file you want to restore. You can use CMS pattern matching to specify 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 from which of your minidisks you want to restore. You can only specify your own user ID; either type your user ID or an asterisk (*), which indicates your user ID, for userid. Specify any of your virtual addresses for vaddr. To search all of your minidisks, enter * * for userid and 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 Gregorian (mm/dd/yy) or Julian (yyddd) format. The default for FROM date is the default restore selection period (set by the CA VM:Backup system administrator) subtracted from the current date. The default for TO date is today's date.

When restoring files, make sure that the search period includes all of the days from which you want to restore data. CA VM:Backup restores only data that was backed up within the specified time period. When restoring domains, CA VM:Backup will go back to the full backup, even if it was taken before the FROM date.

LATEST | ALL

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 is the default. LATEST includes only the most recent version of each file backed up within the specified time period.

DISK [APpend]

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. TERMINAL is the default.

QUIET

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 minidisk/file space-level detail catalogs, you must provide the filenames of the files to be restored.

TOUSER userid [TORDR | TODISK vaddr]

TOUSER userid: Specifies the user ID to receive the restored data. For userid, type an asterisk (*) or your own user ID to send it to yourself, or type another user's user ID if appropriate.
TORDR: Tells CA VM:Backup to restore backed-up data to the virtual reader of the user identified by TOUSER.
TODISK vaddr: 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

To display the most recent version of every file backed up from your 191 minidisk on the file selection screen, accept the defaults by entering:
```
vmbackup restore
```
To display on the file screen all versions of all files with a filetype of SCR backed up from your 199 minidisk between February 19, 2010 and February 22, 2012, enter:
```
vmbackup restore * scr (from 02/19/10 to 02/22/12 for * 199 all
```
To append information about the most recent version of all files with a filename of PROFILE backed up from any of your minidisks to an existing RESTORE OUTPUT file on your A-disk, enter:
```
vmbackup restore profile * (for * * disk append
```
To send to your virtual printer a file containing information about every version of every file with a filetype of EXEC that has been backed up from your 191 minidisk since February 22, 2013, enter:
```
vmbackup restore * exec (from 02/22/13 all printer
```
To restore all versions of files with the filetype MEMO that have been backed up from your 191 minidisk to your virtual reader, enter:
```
vmbackup restore * memo (all touser * quiet
```
To restore the most recent version of the file ALL NOTEBOOK to user ID MARY's virtual reader, enter:
```
vmbackup restore all notebook (touser mary tordr quiet
```
To restore all versions of files with the filetype NOTE that were backed up from your 191 minidisk directly to your 192 minidisk on or before February 19, 2013, enter:
```
vmbackup restore * note (to 02/19/13 touser * todisk 192 quiet all
```
To restore the most recent version of all files backed up from your 234 minidisk to your 191 minidisk, enter:
```
vmbackup restore * * (for * 234 quiet touser * todisk 191 latest
```