![]() |
![]() |
Use this command to back up primary storage pool files to a copy storage pool. You can only back up storage pools that have DATAFORMAT=NATIVE.
If a file already exists in the copy storage pool, the file is not backed up unless the copy of the file in the copy storage pool is marked damaged. However, a new copy is not created if the file in the primary storage pool is also marked damaged. In a random-access storage pool, neither cached copies of migrated files nor damaged primary files are backed up.
If migration for a storage pool starts during a storage pool backup, some files may be migrated before they are backed up. You may want to back up storage pools that are higher in the migration hierarchy before backing up storage pools that are lower. For example, when performing a storage pool backup to copy the contents of a storage pool offsite, if the process is not done according to the existing storage pool hierarchy, some files may not be copied to the copy storage pool. This could become critical for disaster recovery purposes. When performing a storage pool backup on multiple storage pools, the primary storage pool should be completed before starting the backup process on the next storage pool.
Privilege Class
To issue this command, you must have system privilege, unrestricted storage privilege, or restricted storage privilege for the copy storage pool in which backup copies are to be produced.
Syntax
>>-BAckup STGpool--primary_pool_name--copy_pool_name------------> .-MAXPRocess--=--1------. >--+-----------------------+------------------------------------> '-MAXPRocess--=--number-' .-Preview--=--No-------------------. .-Wait--=--No------. >--+----------------------------------+--+------------------+-->< '-Preview--=--+-No---------------+-' '-Wait--=--+-No--+-' +-Yes--------------+ '-Yes-' | (1) | '-VOLumesonly------'
Notes:
Parameters
Using multiple, parallel processes may improve throughput for the backup. The expectation is that the time needed to perform the storage pool backup will be decreased by using multiple processes. However, when multiple processes are running, in some cases one or more of the processes needs to wait to use a volume that is already in use by a different backup process.
When determining this value, consider the number of logical 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 backup.
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 backing up 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 3 processes to back up a primary sequential storage pool to a copy storage pool of the same device class. Each process requires 2 mount points and 2 drives. To run all 3 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.
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.
Examples
Task
Back up the primary storage pool named PRIMARY_POOL to the copy storage pool named COPYSTG.
Related Commands
Table 20. Commands Related to BACKUP STGPOOL
Command | Description |
---|---|
CANCEL PROCESS | Cancels a background server process. |
MOVE DRMEDIA | Moves DRM media onsite and offsite. |
QUERY DRMEDIA | Displays information about disaster recovery volumes. |
QUERY PROCESS | Displays information about background processes. |
QUERY STGPOOL | Displays information about storage pools. |
RESTORE STGPOOL | Restores files to a primary storage pool from copy storage pools. |
RESTORE VOLUME | Restores files stored on specified volumes in a primary storage pool from copy storage pools. |