UPDATE MGMTCLASS (Update a management class)
Use this command to change a management class. To allow clients to use the updated management class, you must activate the policy set that contains the management class.
Important: The UPDATE MGMTCLASS command
fails if a copy storage pool is specified as the destination for files
that were migrated by a Tivoli® Storage
Manager for Space Management client.
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 policy set belongs.
Syntax
>>-UPDate MGmtclass--domain_name--policy_set_name--class_name---> >--+------------------------------------+-----------------------> '-SPACEMGTECHnique--=--+-AUTOmatic-+-' +-SELective-+ '-NONE------' >--+------------------------+-----------------------------------> '-AUTOMIGNonuse--=--days-' >--+-----------------------------+------------------------------> '-MIGREQUIRESBkup--=--+-Yes-+-' '-No--' >--+------------------------------+-----------------------------> '-MIGDESTination--=--pool_name-' >--+-----------------------------+----------------------------->< '-DESCription--=--description-'
Parameters
- domain_name (Required)
- Specifies the policy domain to which the management class belongs.
- policy_set_name (Required)
- Specifies the policy set to which the management class belongs. You cannot update a management class that belongs to the ACTIVE policy set.
- class_name (Required)
- Specifies the management class to update.
- SPACEMGTECHnique
- Specifies whether a file using this management class is eligible
for migration. This parameter is optional. This parameter is effective
only for Tivoli Storage
Manager for Space Management clients,
not for backup-archive clients or application clients. Possible values
are:
- AUTOmatic
- Specifies that the file is eligible for both automatic migration and selective migration.
- SELective
- Specifies that the file is eligible for selective migration only.
- NONE
- Specifies that the file is not eligible for migration.
- AUTOMIGNonuse
- Specifies the number of days that must elapse since a file was
last used before it is eligible for automatic migration. This parameter
is optional. If SPACEMGTECHNIQUE is not AUTOMATIC,
the server ignores this attribute. You can specify an integer from
0 to 9999.
This parameter is effective only for Tivoli Storage Manager for Space Management clients, not for backup-archive clients or application clients.
- MIGREQUIRESBkup
- Specifies whether a backup version of a file must exist before
a file can be migrated. This parameter is optional. This parameter
is effective only for Tivoli Storage
Manager for Space Management clients,
not for backup-archive clients or application clients. Possible values
are:
- Yes
- Specifies that a backup version must exist.
- No
- Specifies that a backup version is optional.
- MIGDESTination
- Specifies the primary storage pool where the server initially
stores files migrated by Tivoli Storage
Manager for Space Management clients.
This parameter is effective only for Tivoli Storage
Manager for Space Management clients,
not for backup-archive clients or application clients.
The command fails if you specify a copy storage pool as the destination.
- DESCription
- Specifies a description of the management class. This parameter is optional. The maximum length of the description is 255 characters. Enclose the description in quotation marks if it contains any blank characters. To remove a previously defined description, specify a null string ("").
Example: Update the policy domain and storage pool of a specific management class
For the management class ACTIVEFILES, in policy set VACATION in the EMPLOYEE_RECORDS policy domain, change the storage pool where migrated files are stored.update mgmtclass employee_records vacation
activefiles migdestination=diskpool2
Related commands
Command | Description |
---|---|
ASSIGN DEFMGMTCLASS | Assigns a management class as the default for a specified policy set. |
COPY MGMTCLASS | Creates a copy of a management class. |
DEFINE COPYGROUP | Defines a copy group for backup or archive processing within a specified management class. |
DEFINE MGMTCLASS | Defines a management class. |
DEFINE POLICYSET | Defines a policy set within the specified policy domain. |
DELETE MGMTCLASS | Deletes a management class and its copy groups from a policy domain and policy set. |
QUERY COPYGROUP | Displays the attributes of a copy group. |
QUERY MGMTCLASS | Displays information about management classes. |
QUERY POLICYSET | Displays information about policy sets. |
UPDATE COPYGROUP | Changes one or more attributes of a copy group. |