Use this command to define a new backup or archive copy group within a specific management class, policy set, and policy domain. The server uses the backup and archive copy groups to control how clients back up and archive files, and to manage the backed-up and archived files. To allow clients to use the new copy group, you must activate the policy set that contains the new copy group.
You can define one backup and one archive copy group for each management class. To ensure that client nodes can back up files, include a backup copy group in the default management class for a policy set.
Note: | The DEFINE COPYGROUP command fails if you specify a copy storage pool as a destination. |
The DEFINE COPYGROUP command has two forms, one for defining a backup copy group and one for defining an archive copy group. The syntax and parameters for each form are defined separately.
Use this command to define a new backup copy group within a specific management class, policy set, and policy domain.
Privilege Class
To issue this command, you must have system privilege, unrestricted policy privilege, or restricted policy privilege for the policy domain to which the copy group belongs.
Syntax
>>-DEFine COpygroup--domain_name--policy_set_name--class_name---> .-STANDARD--. .-Type--=--Backup--. >-----+-----------+---+------------------+----------------------> '-STANDARD--' '-Type--=--Backup--' .-FREQuency--=--0-----. >-----DESTination--=--pool_name---+---------------------+-------> '-FREQuency--=--days--' .-VERExists--=--2-----------. >-----+---------------------------+-----------------------------> '-VERExists--=--+-number--+-' '-NOLimit-' .-VERDeleted--=--1-----------. >-----+----------------------------+----------------------------> '-VERDeleted--=--+-number--+-' '-NOLimit-' .-RETExtra--=--30----------. >-----+--------------------------+------------------------------> '-RETExtra--=--+-days----+-' '-NOLimit-' .-RETOnly--=--60----------. .-MODE--=--MODified-----. >-----+-------------------------+---+-----------------------+---> '-RETOnly--=--+-days----+-' '-MODE--=--+-MODified-+-' '-NOLimit-' '-ABSolute-' .-SERialization--=--SHRSTatic------. >-----+----------------------------------+--------------------->< '-SERialization--=--+-SHRSTatic--+-' +-STatic-----+ +-SHRDYnamic-+ '-DYnamic----'
Parameters
You cannot define a copy group for a management class that belongs to the ACTIVE policy set.
If a backup operation causes the limit to be exceeded, the server expires the oldest backup version that exists in server storage. Possible values are:
The number of backup versions to retain is controlled by this parameter until versions exceed the retention time specified by the RETEXTRA parameter.
If a user deletes a file from the client file system, the next backup causes the server to expire the oldest versions of the file in excess of this number. The expiration date for the remaining versions is determined by the retention time specified by the RETEXTRA or RETONLY parameter. Possible values are:
If you specify NOLIMIT, the server deletes inactive backup versions based on the VEREXISTS parameter (when the file still exists on the client file system) or the VERDELETED parameter (when the file no longer exists on the client file system).
If you specify NOLIMIT, the server retains the last remaining backup version forever, unless a user or administrator deletes the file from server storage.
The MODE value is used only for full incremental backup. This value is ignored during partial incremental backup or selective backup.
Platforms that do not support the STATIC option default to SHRSTATIC.
Attention: Be careful about using the SHRDYNAMIC and DYNAMIC values. These values allow TSM to back up a file or directory while modifications are occurring. As a result, the backup version might be a fuzzy backup. A fuzzy backup does not accurately reflect what is currently in the file or directory because it contains some, but not all, modifications. If a file that contains a fuzzy backup is restored, the file may or may not be usable, depending on the application that uses the file. If a fuzzy backup is not acceptable, be sure to use a serialization value that allows TSM to create a backup version only if the file or directory is not being modified (SHRSTATIC or STATIC).
Examples
Task
Create a backup copy group named STANDARD for management class ACTIVEFILES in policy set VACATION in the EMPLOYEE_RECORDS policy domain. Set the backup destination to BACKUPPOOL. Set the minimum interval between backups to three days, regardless of whether the files have been modified. Retain up to five backup versions of a file while the file exists on the client file system.
define copygroup employee_records vacation activefiles standard type=backup destination=backuppool frequency=3 verexists=5 mode=absolute
Use this command to define a new archive copy group within a specific management class, policy set, and policy domain.
Privilege Class
To issue this command, you must have system privilege, unrestricted policy privilege, or restricted policy privilege for the policy domain to which the copy group belongs.
Syntax
>>-DEFine COpygroup--domain_name--policy_set_name--class_name---> .-STANDARD--. >-----+-----------+---Type--=--Archive--------------------------> '-STANDARD--' .-FREQuency--=--Cmd--. >-----DESTination--=--pool_name----+--------------------+-------> '-FREQuency--=--Cmd--' .-RETVer--=--365---------. .-MODE--=--ABSolute--. >-----+------------------------+---+--------------------+-------> '-RETVer--=--+-days----+-' '-MODE--=--ABSolute--' '-NOLimit-' .-SERialization--=--SHRSTatic------. >-----+----------------------------------+--------------------->< '-SERialization--=--+-SHRSTatic--+-' +-STatic-----+ +-SHRDYnamic-+ '-DYnamic----'
Parameters
You cannot define a copy group for a management class that belongs to the ACTIVE policy set.
If you specify NOLIMIT, the server retains archive copies forever, unless a user or administrator deletes the file from server storage.
The value of the RETVER parameter can affect the management class to which the server binds an archived directory. If the client does not use the ARCHMC option, the server binds directories that are archived to the default management class. If the default management class has no archive copy group, the server binds directories that are archived to the management class with the shortest retention period.
Platforms that do not support the STATIC option default to SHRSTATIC.
Attention: Be careful about using the SHRDYNAMIC and DYNAMIC values. These values allow TSM to archive a file while modifications are occurring. As a result, the archive copy might be a fuzzy backup. A fuzzy backup does not accurately reflect what is currently in the file because it contains some, but not all, modifications. If a file that contains a fuzzy backup is retrieved, the file may or may not be usable, depending on the application that uses the file. If a fuzzy backup is not acceptable, be sure to use a serialization value that allows TSM to create an archive copy only if the file is not being modified (SHRSTATIC or STATIC).
Examples
Task
Create an archive copy group named STANDARD for management class MCLASS1 in policy set SUMMER in the PROG1 policy domain. Set the archive destination to ARCHIVEPOOL, where the archive copy is kept for 730 days.
define copygroup prog1 summer mclass1 standard type=archive destination=archivepool retver=730
Table 44. Commands Related to DEFINE COPYGROUP
Command | Description |
---|---|
ASSIGN DEFMGMTCLASS | Assigns an existing management class as the default for a specified policy set. |
COPY MGMTCLASS | Creates a copy of a management class. |
DEFINE MGMTCLASS | Defines a management class. |
DEFINE STGPOOL | Defines a storage pool as a named collection of server storage media. |
DELETE COPYGROUP | Deletes a backup or archive copy group from a policy domain and policy set. |
DELETE MGMTCLASS | Deletes a management class and its copy groups from a policy domain and policy set. |
EXPIRE INVENTORY | Manually starts inventory expiration processing. |
QUERY COPYGROUP | Displays the attributes of an existing copy group. |
QUERY MGMTCLASS | Displays information about management classes. |
UPDATE COPYGROUP | Changes one or more attributes of a copy group. |