Use this command to restore files from one or more copy storage pools to a primary storage pool. |You can only restore storage pools with |DATAFORMAT=NATIVE. TSM restores all the primary storage pool files that:
You can also use this command to identify volumes that contain damaged, primary files. During restore processing, a message is issued for every volume in the restored storage pool that contains damaged, non-cached files. Use the QUERY CONTENT command to identify damaged, primary files on a specific volume.
Restoration of file may be incomplete if backup file copies in copy storage pools were moved or deleted by other TSM processes during restore processing. To prevent this problem, do not issue the following commands for copy storage pool volumes while restore processing is in progress:
Also, you can prevent reclamation processing for your copy storage pools by setting the RECLAIM percentage to 100 with the UPDATE STGPOOL command.
Privilege Class
To issue this command, you must have system privilege, unrestricted storage privilege, or restricted storage privilege for the primary storage pool for which files are to be restored. If you are a restricted storage administrator and you want to restore files to a new primary storage pool, you must also have authority for the new storage pool.
Syntax
>>-RESTORE STGpool--primary_pool_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, and, if the device type is not FILE, each process also needs a drive. If you are restoring files in a sequential storage pool, each process needs an additional mount point for primary storage pool volumes and, if the device class is not FILE, an additional drive. For example, suppose you specify a maximum of 3 processes to restore a primary sequential storage pool from 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 restore, only one process is used and no mount points or drives are needed.
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 restored prior to the cancellation.
Examples
Task
Restore files from any copy storage pool to the primary storage pool, PRIMARY_POOL.
Related Commands
Table 243. Commands Related to RESTORE STGPOOL
Command | Description |
---|---|
BACKUP STGPOOL | Backs up a primary storage pool to a copy storage pool. |
CANCEL PROCESS | Cancels a background server process. |
QUERY CONTENT | Displays information about files in a storage pool volume. |
QUERY PROCESS | Displays information about background processes. |
RESTORE VOLUME | Restores files stored on specified volumes in a primary storage pool from copy storage pools. |
UPDATE STGPOOL | Changes the attributes of a storage pool. |