System Programmer Reference › Commands › RPOOL command

RPOOL command

Authorization: SYSADMIN

Use the RPOOL command to restore either an entire file pool or at least one user storage group, or to move one or more user storage groups from one file pool to another.

CA VM:Backup restores all enrollment data, directory structures, files, authorizations, and aliases, but it does not restore the physical structure of the file pool itself. For example, CA VM:Backup does not restore the FILESERV startup parameters or the log minidisks.

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

• CA VM:Backup must be an enrolled administrator for the target file pool
• The file pool must be available
• The target user storage groups must be defined in the target file pool
• The minidisks that make up the user storage groups 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.

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

This command has the following format:

RPool FROM frompool [TO topool] [("Options"...[)]]

Options:

ALL | SKIP
GROUP numbers...
DAte date
TIme time
OLDDAte olddate
OLDTIme oldtime
PUBLIC | NOPUBLIC

Definitions

FROM frompool [TO topool]

Specifies the filepoolid of the file pool that contains the data to restore (frompool) and, optionally, of the file pool to which to restore the data (topool). If you do not specify topool, CA VM:Backup restores to frompool. Specify the APPC/VM resource name for the filepoolid, not the user ID of the file pool service virtual machine.

ALL | SKIP

Specifies how CA VM:Backup is to restore the file spaces in the file pool.

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

• If a file space exists in the backup but not in the target file pool, CA VM:Backup enrolls the file space in the target file pool using the backup enrollment information.
• If a file space exists in the target file pool but not in the backup, CA VM:Backup leaves the file space in the target file pool untouched.
• If a file space exists in both the target file pool and the backup, CA VM:Backup replaces the file space in the target file pool but does not modify the enrollment information.

  Note: If you want to remove file spaces that exist in the target but not in the backup, that is, you want the restored user storage groups or file pool to look just like the backed-up version, you must manually clear the user storage groups or file pool before running the restore.

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

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

GROUP numbers...

Specifies the user storage group numbers (2 through 32767) of the groups to restore. To restore more than one group, separate each unique number by at least one blank.

DAte date

Specifies the latest (most recent) date from which you want to restore the file pool or user storage groups. 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 pool or user storage groups. 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 pool or user storage groups. 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 pool or user storage groups. Type the time in 24-hour, hh:mm format. If omitted, CA VM:Backup uses 23:59.

PUBLIC | NOPUBLIC

Specifies whether CA VM:Backup is to issue the ENROLL PUBLIC command for the file pool. If you specify NOPUBLIC (default), CA VM:Backup will not issue the command, and only users enrolled in the file pool will be able to access these files and directories.

If you specify PUBLIC, CA VM:Backup issues the command. Issuing the ENROLL PUBLIC command is one of two actions that are required to enable users not enrolled in a particular file pool to access files and directories of users who are enrolled in that file pool. The other required action is for the users who are enrolled in the file pool to grant access to their files and directories to either PUBLIC or the users who are not enrolled in the file pool.

Refer to the IBM z/VM CMS File Pool Planning, Administration, and Operation publication for detailed information about the ENROLL PUBLIC command.

Examples

• You want to restore the latest version of the file pool SFS. You do not want to restore any file spaces that were erased from the file pool before 12/01/2013. Enter the following command:

  vmbackup rpool from sfs (olddate 12/01/13
  

• You want to restore user storage groups 2 and 3 from file pool TEST to file pool PROD as of 3 p.m. on November 22, 2013. You do not want to restore any file spaces that were erased from the user storage groups before 9/01/13. Enter the following command:

  vmbackup rpool from test to prod (group 2 3 date 11/22/13 time 15:00 olddate 9/01/13
  

• You want to restore all but user storage groups 2, 4, and 6 from the file pool TEST, which contains 10 user storage groups, and not restore file spaces belonging to users already enrolled in the current pool. You do not want to restore any file spaces that were erased from the user storage groups before 8/15/2013. Enter the following command:

  vmbackup rpool from test (group 3 5 7 8 9 10 11 skip olddate 8/15/13