Tivoli Storage Manager for Windows Administrator's Guide


Querying Policy


Task Required Privilege Class
Query any policy domain, policy set, management class, or copy group Any administrator

You can request information about the contents of policy objects. You might want to do this before creating new objects or when helping users to choose policies that fit their needs.

You can specify the output of a query in either standard or detailed format. The examples in this section are in standard format.

On a managed server, you can see whether the definitions are managed objects. Request the detailed format in the query and check the contents of the Last update by (administrator) field. For managed objects, this field contains the string $$CONFIG_MANAGER$$.

Querying Copy Groups

To request information about backup copy groups (the default) in the ENGPOLDOM engineering policy domain, enter:

query copygroup engpoldom * *

The following shows the output from the query. It shows that the ACTIVE policy set contains two backup copy groups that belong to the MCENG and STANDARD management classes.


+--------------------------------------------------------------------------------+
|Policy     Policy     Mgmt       Copy      Versions  Versions    Retain   Retain|
|Domain     Set Name   Class      Group         Data      Data     Extra     Only|
|Name                  Name       Name        Exists   Deleted  Versions  Version|
|---------  ---------  ---------  --------  --------  --------  --------  -------|
|ENGPOLDOM  ACTIVE     MCENG      STANDARD         5         4        90      600|
|ENGPOLDOM  ACTIVE     STANDARD   STANDARD         2         1        30       60|
|ENGPOLDOM  STANDARD   MCENG      STANDARD         5         4        90      600|
|ENGPOLDOM  STANDARD   STANDARD   STANDARD         2         1        30       60|
|ENGPOLDOM  TEST       STANDARD   STANDARD         2         1        30       60|
+--------------------------------------------------------------------------------+

To request information about archive copy groups in the ENGPOLDOM engineering policy domain, enter:

query copygroup engpoldom * type=archive

The following shows the output from the query.


+--------------------------------------------------------------------------------+
|Policy        Policy        Mgmt          Copy            Retain                |
|Domain        Set Name      Class         Group          Version                |
|Name                        Name          Name                                  |
|---------     ---------     ---------     ---------     --------                |
|ENGPOLDOM     ACTIVE        MCENG         STANDARD           730                |
|ENGPOLDOM     ACTIVE        STANDARD      STANDARD           365                |
|ENGPOLDOM     STANDARD      MCENG         STANDARD           730                |
|ENGPOLDOM     STANDARD      STANDARD      STANDARD           365                |
|ENGPOLDOM     TEST          STANDARD      STANDARD           365                |
+--------------------------------------------------------------------------------+

Querying Management Classes

To request information about management classes in the ENGPOLDOM engineering policy domain, enter:

query mgmtclass engpoldom * *

The following figure is the output from the query. It shows that the ACTIVE policy set contains the MCENG and STANDARD management classes.


+--------------------------------------------------------------------------------+
|Policy       Policy       Mgmt         Default      Description                 |
|Domain       Set Name     Class        Mgmt                                     |
|Name                      Name         Class ?                                  |
|---------    ---------    ---------    ---------    ------------------------    |
|ENGPOLDOM    ACTIVE       MCENG        No          Engineering Management       |
|                                                    Class with Backup and       |
|                                                    Archive Copy Groups         |
|ENGPOLDOM    ACTIVE       STANDARD     Yes         Installed default            |
|                                                    management class            |
|ENGPOLDOM    STANDARD     MCENG        No          Engineering Management       |
|                                                    Class with Backup and       |
|                                                    Archive Copy Groups         |
|ENGPOLDOM    STANDARD     STANDARD     Yes         Installed default            |
|                                                    management class            |
|ENGPOLDOM    TEST         STANDARD     Yes         Installed default            |
|                                                    management class            |
|                                                                                |
+--------------------------------------------------------------------------------+

Querying Policy Sets

To request information about policy sets in the ENGPOLDOM engineering policy domain, enter:

query policyset engpoldom *

The following figure is the output from the query. It shows an ACTIVE policy set and two inactive policy sets, STANDARD and TEST.


+--------------------------------------------------------------------------------+
|Policy        Policy        Default       Description                           |
|Domain        Set Name      Mgmt                                                |
|Name                        Class                                               |
|                            Name                                                |
|---------     ---------     ---------     ------------------------              |
|ENGPOLDOM     ACTIVE        STANDARD      Installed default policy              |
|                                           set                                  |
|ENGPOLDOM     STANDARD      STANDARD      Installed default policy              |
|                                           set                                  |
|ENGPOLDOM     TEST          STANDARD      Policy set for testing                |
+--------------------------------------------------------------------------------+

Querying Policy Domains

To request information about a policy domain (for example, to determine if any client nodes are registered to that policy domain), enter:

query domain *

The following figure is the output from the query. It shows that both the ENGPOLDOM and STANDARD policy domains have client nodes assigned to them.


+--------------------------------------------------------------------------------+
|Policy       Activated    Activated     Number of    Description                |
|Domain       Policy       Default      Registered                               |
|Name         Set          Mgmt              Nodes                               |
|                          Class                                                 |
|---------    ---------    ---------    ----------    ------------------------   |
|APPCLIEN-    BASE         APPCLIEN-             1    Policy domain for          |
| TS                        TMC                        application clients       |
|ENGPOLDOM    STANDARD     STANDARD             21    Engineering Policy         |
|                                                      Domain                    |
|STANDARD     STANDARD     STANDARD             18    Installed default policy   |
|                                                      domain.                   |
+--------------------------------------------------------------------------------+


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