Administrator's Reference

BACKUP STGPOOL (Back Up Primary Storage Pool to Copy Storage Pool)

Use this command to back up primary storage pool files to a copy storage pool. If a file already exists in the copy storage pool, the file is not backed up unless the copy 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.

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--------------------.
>-----+-----------------------------------+--------------------->
      '-Preview--=--+-No----------------+-'
                    +-Yes---------------+
                    |             (1)   |
                    '-VOLumesonly-------'
 
      .-Wait--=--No------.
>-----+------------------+-------------------------------------><
      '-Wait--=--+-No--+-'
                 '-Yes-'
 

Notes:

  1. Applies only to sequential storage pools.

Parameters

primary_pool (Required)
Specifies the primary storage pool.

copy_pool (Required)
Specifies the copy storage pool.

MAXPRocess
Specifies the maximum number of parallel processes to use for backing up files. Using multiple, parallel processes may improve throughput for the backup. This parameter is optional. Enter a value from 1 to 999. The default is 1.

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.

Preview
Specifies if you want to preview but not perform the backup. The preview displays the number of files and bytes to be backed up and a list of the primary storage pool volumes that you must mount. This parameter is optional. The default is NO. Possible values are:

No
Specifies that the backup is done.

Yes
Specifies that you want to preview the backup but not do the backup.

VOLumesonly
Specifies that you want to preview the backup only as a list of the volumes that must be mounted. This choice requires the least processing time.

Wait
Specifies whether to wait for the server to complete processing this command in the foreground. This parameter is optional. The default is NO. Possible values are:

No
Specifies that the server processes this command in the background.

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.

Yes
Specifies that the server performs this operation in the foreground. You must wait for the operation to complete before continuing with other tasks. The server displays the output messages to the administrative client when the operation completes.
Note:You cannot specify WAIT=YES from the server console.

Examples

Task

Back up the primary storage pool named PRIMARY_POOL to the copy storage pool named COPYSTG.

Command:
backup stgpool primary_pool 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.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]