RGROUP command

System Programmer Reference › Commands › RGROUP command

RGROUP command

Authorization: SYSADMIN

To restore a single user storage group, use the RGROUP command. You can restore the user storage group to any user storage group in any file pool.

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 that contains the target user storage group.
The file pool must be available.
The target user storage group must be defined in the target file pool.
The minidisks that make up the user storage group being restored must be formatted and reserved. However, the minidisks can differ in number, size, and device type from those that originally contained the data. The user IDs owning the source file spaces need not be enrolled in the target user storage group.

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

If you need to restore multiple user storage groups, use the RPOOL command.

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

This command has the following format:

RGroup "Parms"... [("Options"...[)]]

Parms:

FROMPOol frompool 
FROMGRoup fromgroup 
[TOPOol topool] 
[TOGRoup togroup]
Options:

ALL | SKIP
DAte date
TIme time
OLDDate olddate
OLDTime oldtime

Definitions

FROMPOol frompool

Specifies the filepool ID of the file pool that contains the data to restore. Specify the Advanced Program-to-Program Communications (APPC)/VM resource name for frompool, not the user ID of the file pool service virtual machine.

FROMGRoup fromgroup

Specifies the user storage group number (2 through 32767) of the user storage group to restore.

TOPOol topool

Specifies the filepool ID of the file pool to which to restore the group. If you do not specify topool, CA VM:Backup restores to frompool. You must specify the Advanced Program-to-Program Communications (APPC)/VM resource name for topool, not the user ID of the file pool service virtual machine.

TOGRoup togroup

Specifies the user storage group number (2 through 32767) of the user storage group to which to restore the data. If you do not specify togroup, CA VM:Backup restores to fromgroup.

ALL | SKIP

Specifies how CA VM:Backup is to restore the file spaces in the user storage group.

ALL restores all file spaces from the backup user storage group, regardless of whether they already exist in the target user storage group. When the restore completes, the target user storage group appears exactly like the backup user storage group. Restore processing is as follows:

If a file space exists in the backup user storage group but not in the target user storage group, CA VM:Backup enrolls the file space in the target user storage group using the backup enrollment information.
If a file space exists in the target user storage group but not in the backup user storage group, CA VM:Backup leaves the file space in the target user storage group untouched.
If a file space exists in the both the target and backup user storage groups, CA VM:Backup replaces the file space in the target user storage group with the file space from the backup user storage group but does not modify the enrollment information.
Note: If you want to remove file spaces that exist in the target but not in the back up, that is, you want the restored user storage group to look just like the backed-up version, you must manually clear the storage group before running the restore.

SKIP restores only file spaces that exist in the backup user storage group but not in the target user storage group. Restore processing is as follows:

If a file space exists in the backup user storage group but not in the target user storage group, CA VM:Backup enrolls the file space in the target user storage group using the backup enrollment information.
If a file space exists in the target user storage group but not in the backup user storage group, CA VM:Backup leaves the file space in the target user storage group untouched.
If a file space exists in both the target and backup user storage group, CA VM:Backup leaves the file space in the target user storage group untouched.

DAte date

Specifies the latest (most recent) date from which you want to restore the storage group. 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 user storage group. 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 storage group. 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 storage group. 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 in the requested time period.

Set a start date using the OLDDATE option when restoring a user storage group. OLDDATE is necessary because of the way CA VM:Backup stores information about file pools in the catalogs. The start date prevents CA VM:Backup from restoring more data than you intended. For example, suppose you want to restore a user storage group. Two weeks ago (12/01/97), you deleted many file spaces and you do not want CA VM:Backup to restore them. Therefore, you specify an OLDDATE that is later than 12/01/97 but early enough to contain the data you want to restore. Setting an OLDDATE that is later than 12/01/97 ensures that CA VM:Backup does not restore file spaces that were deleted before this date. If you do not specify an OLDDATE, CA VM:Backup uses the default start date (01/01/1942). CA VM:Backup searches for and restores file spaces back to that date.

Note: If within the defined time period, the most recent version of a file space is from an incremental backup, RGROUP ignores OLDDATE. Instead, RGROUP uses all incremental backups and the full backup on which the selected backup is based, even if their dates are before the search time period.

Examples

You want to restore user storage group 2 from the file pool SFS to itself as it existed on November 22, 2013. You do not want to restore any file spaces that were erased from the user storage group before November 1, 2013. Enter the following command:
```
vmbackup rgroup frompool sfs fromgroup 2 (date 11/22/13 olddate 11/01/13
```
You want to restore user storage group 5 of file pool TEST to user storage group 8 of file pool PROD. You do not want to restore any file spaces that were erased from the user storage group before September 1, 2013. Enter the following command:
```
vmbackup rgroup frompool test fromgroup 5 topool prod togroup 8  (olddate 9/01/13
```