Use this command to generate a backup set for a client node. When you use the GENERATE BACKUPSET command, the server creates a copy of the client node's previously backed up, active files specified with this command, and stores them on sequential media. The client node can then restore their backup set from the server as well as from the media to which the backup set was written.
This command generates a background process that can be cancelled with the CANCEL PROCESS command. If the background process created by this command is cancelled, the media may not contain a complete backup set. You can use the QUERY PROCESS command to display information about the background process that is created by this command.
Privilege Class
To issue this command, you must have system privilege or policy privilege for the domain to which the client node is assigned.
Syntax
>>-GENerate BACKUPSET--node_name--backup_set_name_prefix--------> .-*----------------------. >-----+------------------------+--------------------------------> | .-,-----------------. | | V | | '----file_space_name---+-' .-SCRatch--=--Yes-----. >-----DEVclass--=--device_class_name----+---------------------+-> '-SCRatch--=--+-Yes-+-' '-No--' >-----+-------------------------------+-------------------------> | .-,---------------. | | V | | '-VOLumes=----volume_names---+--' .-RETention--=--365---------. >-----+---------------------------+-----------------------------> '-RETention--=--+-days----+-' '-NOLimit-' .-Wait--=--No------. >-----+------------------------------+---+------------------+-->< '-DESCription--=--description--' '-Wait--=--+-No--+-' '-Yes-'
Parameters
When you select a name, TSM adds a suffix to construct your backup set name. For example, if you name your backup set mybackupset, TSM adds a unique number such as 3099 to the name. The backup set name is then identified to TSM as mybackupset.3099. To later display information about this backup set, you can include a wildcard with the name, such as mybackupset* or you can specify the fully qualified name, such as mybackupset.3099.
If you do not specify this parameter, scratch volumes are used for the backup set.
If you specify NOLIMIT, the server retains the volumes containing the backup set forever, unless a user or administrator deletes the volumes from server storage.
Examples
Task
Generate a backup set of a file space called /srvr that belongs to client node JANE. Name the backup set PERS_DATA and retain it for 75 days. Specify that volumes VOL1 and VOL2 contain the data for the backup set. The volumes are to be read by a device that is assigned to the AGADM device class.
Related Commands
Table 121. Commands Related to GENERATE BACKUPSET
Command | Description |
---|---|
DEFINE BACKUPSET | Defines a previously generated backup set to a server. |
DELETE BACKUPSET | Deletes a backup set. |
QUERY BACKUPSET | Displays backup sets. |
QUERY BACKUPSETCONTENTS | Displays contents contained in backup sets. |
UPDATE BACKUPSET | Updates a retention value associated with a backup set. |