Use this command to restore all files on damaged volumes in a primary storage pool that was backed up to a copy storage pool. TSM does not restore cached copies of files and removes those cached files from the database during restore processing.
Notes:
This command changes the access mode of the specified volumes to DESTROYED. When all files on a volume are restored to other locations, the destroyed volume is empty, and TSM deletes it from the database.
The restoration may be incomplete for one or more of the following reasons:
Privilege Class
To issue this command you must have system privilege, unrestricted storage privilege, or restricted storage privilege for the primary storage pool. If you have restricted privilege and want to restore files to a new primary storage pool, you must also have authority for the new storage pool.
Syntax
.-,--------------. V | >>-RESTORE Volume-------volume_name---+-------------------------> >-----+---------------------------------+-----------------------> '-COPYstgpool--=--copy_pool_name--' >-----+---------------------------------------+-----------------> '-NEWstgpool--=--new_primary_pool_name--' .-MAXPRocess--=--1-------. .-Preview--=--No------. >-----+------------------------+---+---------------------+------> '-MAXPRocess--=--number--' '-Preview--=--+-No--+-' '-Yes-' .-Wait--=--No------. >-----+------------------+------------------------------------->< '-Wait--=--+-No--+-' '-Yes-'
Parameters
When determining this value, consider the number of mount points (logical drives) and physical drives that can be dedicated to this operation. To access a sequential access volume, TSM uses a mount point, and, if the device type is not FILE, a physical drive. The number of available mount points and drives depends on other TSM and system activity and on the mount limits of the device classes for the sequential access storage pools that are involved in the restore.
Each process needs a mount point for copy storage pool volumes. If the device type is not FILE, each process also needs a drive. If you are restoring a sequential storage pool, each process needs an additional mount point for primary storage pool volumes and, if the device type is not FILE, an additional drive. For example, suppose you specify a maximum of three processes to back up a primary sequential storage pool to a copy storage pool of the same device class. Each process requires two mount points and two drives. To run all three processes, the device class must have a mount limit of at least 6, and at least 6 mount points and 6 drives must be available.
To preview a backup, only one process is used and no mount points or drives are needed.
Note: | If you preview a restore to see a list of offsite copy pool volumes to be mounted, you should you change the access mode of the identified volumes to UNAVAILABLE. This prevents reclamation and MOVE DATA processing for these volumes until they are transported to the onsite location for use in restore processing. |
You can continue with other tasks while the command is being processed. Messages created from the background process are displayed either in the activity log or the server console, depending on where messages are logged.
To cancel a background process, use the CANCEL PROCESS command. If you cancel this process, some files may have already been backed up prior to the cancellation.
Note: | You cannot specify WAIT=YES from the server console. |
Examples
Task
Restore files stored on volume PVOL2 in primary storage pool PRIMARY_POOL.
Related Commands
Table 221. Commands Related to RESTORE VOLUME
Command | Description |
---|---|
BACKUP STGPOOL | Backs up a primary storage pool to a copy storage pool. |
CANCEL PROCESS | Cancels a background server process. |
QUERY PROCESS | Displays information about background processes. |
RESTORE STGPOOL | Restores files to a primary storage pool from copy storage pools. |