QUERY MGMTCLASS (Query a management class)

Use this command to display information about management classes.

Privilege class

Any administrator can issue this command.

Syntax


>>-Query MGmtclass---------------------------------------------->

   .-*--*--*------------------------------------------.   
>--+--------------------------------------------------+--------->
   |              .-*--*----------------------------. |   
   '-domain_name--+---------------------------------+-'   
                  |                  .-*----------. |     
                  '-policy_set_name--+------------+-'     
                                     '-class_name-'       

   .-Format--=--Standard-----.   
>--+-------------------------+---------------------------------><
   '-Format--=--+-Standard-+-'   
                '-Detailed-'

Parameters

domain_name

Specifies the policy domain associated with the management class to query. This parameter is optional. You can use wildcard characters to specify this name. If you do not specify a value for this parameter, management classes in all policy domains are queried. You must specify this parameter when querying an explicitly named management class.

policy_set_name

Specifies the policy set associated with the management class to query. This parameter is optional. You can use wildcard characters to specify this name. If you do not specify a value for this parameter, management classes in all policy sets are queried. You must specify this parameter when querying an explicitly named management class.

class_name

Specifies the management class to query. This parameter is optional. You can use wildcard characters to specify this name. If you do not specify a value for this parameter, all management classes are queried.

Format

Specifies how the information is displayed. This parameter is optional. The default value is STANDARD. Possible values are:

Standard: Specifies that partial information is displayed.
Detailed: Specifies that complete information is displayed.

Example: Display information for all management classes

Query all management classes for all policy domains. Create the output in standard format. See Field descriptions for field descriptions.

query mgmtclass

Policy       Policy       Mgmt         Default     Description
Domain       Set Name     Class        Mgmt
Name                      Name         Class ?
---------    ---------    ---------    ---------   ------------------
EMPLOYEE-    ACTIVE       ACTIVEFI-    Yes         Modified default
 _RECORDS                  LES                      management class
EMPLOYEE-    HOLIDAY      ACTIVEFI-    Yes         Modified default
 _RECORDS                  LES                      management class
EMPLOYEE-    HOLIDAY      FILEHIST-    No          Test modified
 _RECORDS                  ORY                      management class
EMPLOYEE-    VACATION     ACTIVEFI-    Yes         Original default
 _RECORDS                  LES                      management class
EMPLOYEE-    VACATION     FILEHIST-    No          Test modified
 _RECORDS                  ORY                      management class
PROG1        SUMMER       MCLASS1      No          Technical Support
                                                    Mgmt Class
PROG2        SUMMER       MCLASS1      No          Technical Support
                                                    Mgmt Class
STANDARD     ACTIVE       STANDARD     Yes         Installed default
                                                    management class
STANDARD     STANDARD     STANDARD     Yes         Installed default
                                                    management class

To display information about management classes in a specific policy domain, for example the domain ENGPOLDOM, issue the following command:

query mgmtclass engpoldom * *

Example: Display detailed information for a specific management class

Query the ACTIVEFILES management class that is assigned to the VACATION policy set of the EMPLOYEE_RECORDS policy domain. Create the output in detailed format. See Field descriptions for field descriptions.

query mgmtclass employee_records vacation 
activefiles format=detailed

             Policy Domain Name: EMPLOYEE_RECORDS
                Policy Set Name: VACATION
                Mgmt Class Name: ACTIVEFILES
           Default Mgmt Class ?: Yes
                    Description: Installed default management class
     Space Management Technique: None
        Auto-Migrate on Non-Use: 0
     Migration Requires Backup?: Yes
          Migration Destination: SPACEMGPOOL
 Last Update by (administrator): $$CONFIG_MANAGER$$
          Last Update Date/Time: 05/31/1998 13:15:45
               Managing Profile: EMPLOYEE
                Changes Pending: Yes

Field descriptions

Policy Domain Name: The policy domain.
Policy Set Name: The policy set.
Mgmt Class Name: The management class.
Default Mgmt Class?: Whether the management class is the default management class for the policy set.
Description: The description of the management class.
Space Management Technique: The space management technique for the management class, for Tivoli® Storage Manager for Space Management clients.
Auto-Migrate on Non-Use: The number of days that must elapse since a file was last accessed before it is eligible for automatic migration by Tivoli Storage Manager for Space Management clients.
Migration Requires Backup?: Whether a backup version of a file must exist before a file can be migrated by Tivoli Storage Manager for Space Management clients.
Migration Destination: The storage pool that is the destination for files migrated by Tivoli Storage Manager for Space Management clients.
Last Update by (administrator): The administrator or server that most recently updated the management class. If this field contains $$CONFIG_MANAGER$$, the management class is associated with a domain that is managed by the configuration manager.
Last Update Date/Time: The date and time when the management class was most recently defined or updated.
Managing Profile: The profile or profiles to which the managed server subscribed to get the definition of this management class.
Changes Pending: Whether or not changes are being made but not activated. Once the changes are activated, the field resets to No.

Related commands

Table 1. Commands related to QUERY MGMTCLASS
Command	Description
COPY MGMTCLASS	Creates a copy of a management class.
DEFINE MGMTCLASS	Defines a management class.
DEFINE PROFASSOCIATION	Associates objects with a profile.
DELETE MGMTCLASS	Deletes a management class and its copy groups from a policy domain and policy set.
QUERY DOMAIN	Displays information about policy domains.
UPDATE MGMTCLASS	Changes the attributes of a management class.