System Programmer Reference › Commands › RSPACE command

RSPACE command

Authorization: SYSADMIN

Use the RSPACE command to restore an entire file space or to move a file space from one file pool to another.

Before you can restore data using this command, the following requirements must be met:

• CA VM:Backup must be an enrolled administrator for the file pool to which the specified file space is being restored
• The file pool must be available
• The target file space must be defined in the target file pool

CA VM:Backup might require more virtual storage when it restores large file spaces. For more information about virtual storage requirements, see Virtual Storage.

For more information about restoring user storage groups, refer to Restoring SFS and BFS Data.

To restore subdirectories within a file space, select the Perform user functions option from the System Administrator Main Menu or create a restore job using TPI.

This command has the following format:

RSpace FROM fromspace [TO tospace] [("Options"...[)]]

Options:

DAte date
TIme time
OLDDate olddate
OLDTime oldtime

Definitions

FROM fromspace [TO tospace]

Specifies the complete name (filepoolid:userid) of the file space to restore (fromspace) and, optionally, of the (existing) file space to which to restore the file space (tospace). If you do not specify tospace, CA VM:Backup restores to fromspace. You must specify the APPC/VM resource name for the file pool ID, not the user ID of the file pool service virtual machine.

DAte date

Specifies the latest (most recent) date from which you want to restore the file space. Type the date in mm/dd/yy format. If omitted, CA VM:Backup uses the current date.

TIme time

Specifies the latest (most recent) time on date from which you want to restore the file space. Type the time in 24-hour, hh:mm format. If omitted, CA VM:Backup uses the current time.

OLDDAte olddate

Specifies the oldest (earliest) date from which you want to restore the file space. Type the date in mm/dd/yy format. If omitted, CA VM:Backup uses January 1, 1942.

OLDTIme oldtime

Specifies the oldest (earliest) time on olddate from which you want to restore the file space. Type the time in 24-hour, hh:mm format. If omitted, CA VM:Backup uses 23:59.

Time Periods

CA VM:Backup always restores the most recently backed up version of data within the requested time period.

Note: If the most recent version of a file space found within the given time period is from an incremental backup, CA VM:Backup will use all incremental backups and the full backup on which the selected backup is based to accomplish the restore even if their dates are before the search time period.

Examples

• To restore the latest version of file space SFS1:ABC to itself, enter the following command:

  vmbackup rspace from sfs1:abc 
  

• To restore file space SFS1:ABC to the file space SFS2:ABC (if the target file space does not already exist, the user must first create it), enter the following command:

  vmbackup rspace from sfs1:abc to sfs2:abc