Administrator's Reference

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.

Note:The UPDATE MGMTCLASS command fails if a copy storage pool is specified as the destination for space-managed files.

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 Space Manager clients (also known as HSM 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 HSM 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 HSM 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 from HSM clients. This parameter is effective only for HSM 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 ("").

Examples

Task

For the management class ACTIVEFILES, in policy set VACATION in the EMPLOYEE_RECORDS policy domain, change the storage pool where migrated files are stored.

Command:
update mgmtclass employee_records vacation activefiles migdestination=diskpool2

Related Commands

Table 297. Commands Related to UPDATE MGMTCLASS

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 COPYGROUP Defines a copy group for backup or archive processing within a specified management class.
DEFINE POLICYSET Defines a policy set within the specified policy domain.
DEFINE MGMTCLASS Defines a management class.
DELETE MGMTCLASS Deletes a management class and its copy groups from a policy domain and policy set.
QUERY COPYGROUP Displays the attributes of an existing 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.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]