Previous Topic: UPDATE commandNext Topic: Configuration File Records

System Programmer Reference › Commands › XRESTORE Command

XRESTORE Command

Authorization: USER, SYSADMIN

Use the XRESTORE command to select files you want to restore from minidisks or directories, and to select deleted file spaces you want to restore. These requests are submitted automatically unless the REPORT option is specified.

You can use the XRESTORE command to specify files that are backed up from minidisks and SFS directories.

You can use the XRESTORE command to restore files only from a catalog with file-level detail.

You can use the XRESTORE command to restore a deleted file space from a catalog with either file-level or domain-level detail.

You cannot use the XRESTORE command to restore from an encrypted backup.

The XRESTORE command lets you:

Consider the following information when you use XRESTORE command options:

This command has the following format:

XRESTORE [filename [filetype]] [("Options"[)]]

Options:

"Selection Options"...
  TO {MDISK userid [vaddr] | DIR fqdn | RDR [userid]}
| REPORT [TERM | PRINT | DISK]
  TEST

Selection Options:

FOR {USER userid [vaddr|*] | DIR fqdn | FSPACE filepool filespace}
START begindate [begintime]
END enddate [endtime]
ALL | LATEST

Definitions

filename [ filetype ]

Specifies the filename and the filetype of the files you want to restore. You may specify these values with CMS wildcard characters (* and %). The default is all filenames and filetypes.

FOR {USER userid [vaddr | *] | DIR fqdn | FSPACE filepool filespace}

Allows you to specify files to be restored that were backed up from a specific user’s minidisk or from an SFS directory.

USER userid [vaddr | *]

Indicates that files are restored from either a specific minidisk or from all domains owned by the user ID.

userid

The user ID whose files are to be restored. You may only specify your own user ID unless you are authorized to restore for other user IDs.

vaddr |*

The minidisk address to be restored. 191 is the default. If an * is specified it indicates all domains, minidisks, and SFS directories.

DIR fqdn

The fully qualified directory to be restored. You can only specify your own directories if you are not authorized to restore for other user IDs.

FSPACE filepool filespace

The file pool and file space to be restored. The file space must not exist. CA VM:Backup creates it and enrolls it using the backed-up enrollment information. You must have system administrator authority to use this option.

Note: This option cannot be used with the filename or filetype parameters, or the TO, REPORT, or ALL options.

START begindate [begintime]

Specifies the beginning backup date and optional time at which to start searching the catalog for files to restore. Catalogs prior to this date and time will not be searched. Enter the date in Gregorian format (mm/dd/yy). The default begintime is 00:00:00.

END enddate [endtime]

Specifies the ending backup date and optional time to end searching of the catalog for files to restore. Catalogs for backups that are past this date and time will not be searched. Enter the date in Gregorian format (mm/dd/yy). The default endtime is 23:59:59.

ALL | LATEST

ALL indicates that all files that match the file specification and fall within the date range will be restored. LATEST is the default. LATEST specifies that only the latest version of a file will be restored.

TO {MDISK userid [vaddr] | DIR fqdn | RDR}

Indicates that files are to be restored directly to the indicated user’s minidisk, directory, or reader.

MDISK userid [vaddr]

Indicates that files are restored to a specific minidisk.

userid

Specifies the target user ID that receives the restored data.

vaddr

Specifies the target virtual address of the minidisk that receives the restored data. 191 is the default.

DIR fqdn

Specifies the target SFS fully qualified directory name that receives the restored data. If the directory does not exist, CA VM:Backup will create it. You can only specify your own user ID if you are not authorized to restore for other user IDs.

RDR [userid]

Specifies the target user ID that receives the restored data in its reader. You may only specify your own user ID unless you are authorized to restore for other user IDs.

REPORT [TERM | PRINT | DISK]

Indicates that a report of the files is to be created if files are found that meet the selection criteria.

TERM

Sends the list to your terminal.

PRINT

Sends the report of files found to the printer.

DISK

Writes the report of files found file to XRESTORE REPORT.

TEST

Indicates that TPI job template and exception files are to be created and written to your A-disk or directory if files are found that meet the selection criteria. The TPI files match the restore job that is created and submitted if the TEST option is not specified. The TEST option cannot be specified with the REPORT option.

Examples