Administrator's Reference

DEFINE MGMTCLASS (Define a Management Class)

Use the DEFINE MGMTCLASS command to define a new management class in a policy set.

You can define one or more management classes for each policy set in a policy domain. A management class can contain a backup copy group, an archive copy group, or both. However, neither is required.

Note:

The DEFINE MGMTCLASS command will fail if a copy storage pool is specified as the destination for space-managed files.

You must specify an existing management class as the default management class for a policy set before you can activate the policy set. To specify an existing management class as the default management class, use the ASSIGN DEFMGMTCLASS command.

When a client node is registered with ADSM, the node is defined to a policy domain. This policy domain contains management classes appropriate for the information stored on the client node.

The user of a client node can use the default management class or select any management class in the active policy set. By entering clear descriptions of your management classes, users can easily select management classes that are appropriate for their storage management needs.

The following parameters affect only HSM clients that use this management class, and have no effect on backup-archive clients:

SPACEMGTECHNIQUE

AUTOMIGNONUSE

MIGREQUIRESBKUP

MIGDESTINATION

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 management class belongs.

Syntax

>>-DEFine MGmtclass--domainname--setname--classname------------->
 
>---+-------------------------------------+--------------------->
    '-SPACEMGTECHnique--=--+-AUTOmatic-+--'
                           +-SELective-+
                           '-NONE------'
 
    .-AUTOMIGNOnuse--=--0-------------.
>---+---------------------------------+------------------------->
    '-AUTOMIGNOuse--=--automigvalue---'
 
     .-MIGREQUIRESBkup--=--Yes------.
>----+------------------------------+--------------------------->
     '-MIGREQUIRESBkup--=--+-Yes-+--'
                           '-No--'
 
>----+------------------------------+--------------------------->
     '-MIGDESTination--=--poolname--'
 
>---+------------------------------+---------------------------><
    '-DESCription--=--description--'
 

Parameters

domainname

Specifies the name of the policy domain to which the management class belongs. This parameter is required.

setname

Specifies the name of the policy set to which the management class belongs. This parameter is required. You cannot define a management class to the ACTIVE policy set.

classname

Specifies the name of the new management class. This parameter is required. The maximum length of this name is 30 characters. You cannot use either default or grace_period as a class name.

SPACEMGTECHnique=smtvalue

Specifies whether the file is eligible for migration. This parameter is optional. Possible values are:

AUTOmatic

Specifies that the file is eligible for automatic migration or selective migration.

SELective

Specifies that the file is eligible for selective migration only.

NONE

Specifies that the file is not eligible for migration.

The default in the management class named STANDARD is NONE. This parameter is effective only for HSM clients, not for backup-archive clients.

AUTOMIGNOnuse=automigvalue

Specifies the number of days that must elapse since the file was last accessed before it is eligible for automatic migration. This parameter is optional. If SPACEMGTECHNIQUE is not AUTOMATIC, ADSM ignores this attribute. You can specify a value from 0-9999. The default value is 0.

This parameter is effective only for HSM clients, not for backup-archive clients.

MIGREQUIRESBkup=migreqvalue

Specifies whether a backup version of a file must exist before a file can be migrated. This parameter is optional. Possible values are:

Yes

A backup version must exist.

No

A backup version is optional.

Note:

This parameter is effective only for HSM clients, not for backup-archive clients. For HSM clients, the default is YES.

MIGDESTination=poolname

Specifies the name of a primary storage pool that is a destination for migrated files. A file must be associated with a management class that specifies an appropriate storage pool for migrated files. The type of storage devices in a storage pool and options specified for the storage pool affects the speed with which a migrated file can be recalled to a local file system. This parameter is optional. The default value is SPACEMGPOOL.

This parameter is effective only for HSM clients, not for backup-archive clients.

DESCription=description

Describes the management class by using a text string. This parameter is optional. The maximum length of the description is 255 characters. The description must be enclosed in quotation marks if it contains any blank characters.

Examples

Task 1

Define a management class called ACTIVEFILES for policy set VACATION in the EMPLOYEE_RECORDS policy domain.

Command:

define mgmtclass employee_records vacation activefiles

Task 2

Define a management class called MCLASS1, described as Technical Support Mgmt Class, for policy set SUMMER in the PROG1 policy domain.

Command:

define mgmtclass prog1 summer mclass1 description="technical support mgmt class"

Related Commands

Table 57. Commands Related to DEFINE MGMTCLASS

Command	Description
ASSIGN DEFMGMTCLASS	Assigns an existing management class as the default for a specified policy set.
COPY MGMTCLASS	Creates a copy of an existing 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.
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 one or more management classes.
QUERY POLICYSET	Displays information about one or more policy sets.
UPDATE COPYGROUP	Changes one or more attributes of a copy group.
UPDATE MGMTCLASS	Changes the attributes of a management class.