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

Table 1. Commands related to UPDATE MGMTCLASS
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.