![]() |
![]() |
Use this command to generate a backup set for a backup-archive client node. A backup set is a collection of a client's active backed up data, stored and managed as a single object, on specific media, in server storage. While the server allows you to create a backup set for any client node, a backup set can only be used by a backup-archive client.
The server creates copies of active versions of a client's backed up objects that are within the one or more file spaces specified with this command, and consolidates them onto sequential media. Currently, the backup object types supported for backup sets include directories and files only.
The backup-archive client node can 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--------> .-*-------------------. >--+---------------------+--DEVclass--=--device_class_name------> |.-,---------------. | |V | | '--file_space_name-+--' .-SCRatch--=--Yes-----. >--+---------------------+--+---------------------------+-------> '-SCRatch--=--+-Yes-+-' | .-,------------. | '-No--' | V | | '-VOLumes=---volume_names-+-' .-RETention--=--365---------. >--+---------------------------+--------------------------------> '-RETention--=--+-days----+-' '-NOLimit-' .-Wait--=--No------. >--+-----------------------------+--+------------------+--------> '-DESCription--=--description-' '-Wait--=--+-No--+-' '-Yes-' .-NAMEType--=--SERVER------. >--+--------------------------+---------------------------------> '-NAMEType--=--+-SERVER--+-' +-UNIcode-+ '-FSID----' .-CODEType--=--BOTH-----------. >--+-----------------------------+----------------------------->< '-CODEType--=--+-UNIcode----+-' +-NONUNIcode-+ '-BOTH-------'
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.
For a server that has clients with support for Unicode-enabled file spaces, you can enter either a file space name or file space ID (FSID). If you enter a file space name, you may need to have the server convert the file space name that you enter. For example, you may need to have the server convert the name you enter from the server's code page to Unicode. See the NAMETYPE parameter for details. If you do not specify a file space name, or specify only a single wildcard character for the name, you can use the CODETYPE parameter to limit the operation to Unicode file spaces or to non-Unicode file spaces.
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.
Use this parameter only when you enter a partly or fully qualified file space name. The default value is SERVER. Possible values are:
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.
generate backupset jane pers_data /srvr devclass=agadm retention=75 volumes=vol1,vol2
Task
Generate a backup set of the Unicode-enabled file space, \\joe\c$, that belongs to client node JOE. Name the backup set JOES_DATA . Specify that volume VOL1 contain the data for the backup set. The volume is to be read by a device that is assigned to the AGADM device class. Have the server convert the \\joe\c$ file space name from the server code page to the UTF-8 code page.
generate backupset joe joes_data \\joe\c$ devclass=agadm volumes=vol1 nametype=unicode
Related Commands
Table 140. 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. |