QUERY DOMAIN (Query a policy domain)

Use this command to display information on one or more policy domains.

Privilege class

Any administrator can issue this command.

Syntax

Read syntax diagramSkip visual syntax diagram
                 .-*-----------.  .-Format--=--Standard-----.   
>>-Query DOmain--+-------------+--+-------------------------+--><
                 '-domain_name-'  '-Format--=--+-Standard-+-'   
                                               '-Detailed-'     

Parameters

domain_name
Specifies the policy domain to query. This parameter is optional. You can use wildcard characters to specify names. If you do not specify a value for this parameter, all policy domains are displayed.
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 a summary of policy domains

Display partial information for all policy domains on the server. Issue the command:
query domain
Policy       Activated    Activated     Number of    Description
Domain       Policy       Default      Registered
Name         Set          Mgmt              Nodes
                          Class
---------    ---------    ---------    ----------    -----------------
EMPLOYEE-    VACATION     ACTIVEFI-             6    Employee Records
 _RECORDS                  LES                        Domain
PROG1                                           0    Programming Group
                                                      Test Domain
PROG2                                           0    Programming Group
                                                      Test Domain
STANDARD     STANDARD     STANDARD              1    Installed default
                                                      policy domain
See Field descriptions for field descriptions.

Example: Display the list of active-data pools

Display the active-data pool list. Issue the command:
query domain format=detailed
              Policy Domain Name: STANDARD
            Activated Policy Set: STANDARD
            Activation Date/Time: 05/16/2006 16:18:05
           Days Since Activation: 15
    Activated Default Mgmt Class: STANDARD
      Number of Registered Nodes: 1
                     Description: Installed default policy domain.
 Backup Retention (Grace Period): 30
Archive Retention (Grace Period): 365
  Last Update by (administrator): SERVER_CONSOLE
           Last Update Date/Time: 05/31/2006 15:17:48
                Managing profile:
                 Changes Pending: Yes
           Active Data Pool List: ADPPOOL
               
See Field descriptions for field descriptions.

Field descriptions

Policy Domain Name
The name of the policy domain.
Activated Policy Set
The name of the policy set that was last activated in the domain.

The definitions in the last activated policy set and the ACTIVE policy set are not necessarily identical. When you activate a policy set, the server copies the contents of the policy set to the policy set with the special name ACTIVE. The copied definitions in the ACTIVE policy set can be modified only by activating another policy set. You can modify the original policy set without affecting the ACTIVE policy set. Therefore, definitions in the policy set that was last activated might not be the same as those in the ACTIVE policy set.

Activation Date/Time
The date and time that the policy set was activated.
Days Since Activation
The number of days since the policy set was activated.
Activated Default Mgmt Class
The assigned default management class for the policy set.
Number of Registered Nodes
The number of client nodes registered to the policy domain.
Description
The description of the policy domain.
Backup Retention (Grace Period)
The number of days to retain inactive backup versions of files when any of the following conditions occur:
  • A file is rebound to a new management class, but neither the new management class nor default management class contains a backup copy group.
  • The management class to which a file is bound no longer exists, and the default management class does not contain a backup copy group.
  • The backup copy group is deleted from the management class to which a file is bound and the default management class does not contain a backup copy group.
Archive Retention (Grace Period)
The number of days to retain an archive file that meets either of the following conditions:
  • The management class to which a file is bound no longer exists, and the default management class does not contain an archive copy group.
  • The archive copy group is deleted from the management class to which a file is bound and the default management class does not contain an archive copy group.
Last Update by (administrator)
The administrator that defined or most recently updated the policy domain. If this field contains $$CONFIG_MANAGER$$, the policy domain is associated with a profile that is managed by the configuration manager.
Last Update Date/Time
When the administrator defined or most recently updated the policy domain.
Managing Profile
The profile or profiles to which the managed server subscribed to get the definition of this policy domain.
Changes Pending
Whether or not changes are being made but not activated. Once the changes are activated, the field resets to No.
Active Data Pool List
The list of active-data pools in the domain.

Related commands

Table 1. Commands related to QUERY DOMAIN
Command Description
COPY DOMAIN Creates a copy of a policy domain.
DEFINE DOMAIN Defines a policy domain that clients can be assigned to.
DELETE DOMAIN Deletes a policy domain along with any policy objects in the policy domain.
UPDATE DOMAIN Changes the attributes of a policy domain.