VALIDATE POLICYSET (Verify a policy set)

Use this command to verify that a policy set is complete and valid before you activate it. The command examines the management class and copy group definitions in the policy set and reports on conditions that you need to consider before activating the policy set.

The VALIDATE POLICYSET command fails if any of the following conditions exist:
  • The policy set has no default management class.
  • A copy group within the policy set specifies a copy storage pool as a destination.
  • A management class specifies a copy storage pool as the destination for files that were migrated by a Tivoli® Storage Manager for Space Management client.
  • A TOCDESTINATION parameter is specified, and the storage pool is either a copy pool or has a data format other than NATIVE or NONBLOCK.
The server issues warning messages for the following conditions:
  • A copy group specifies a storage pool that does not exist as a destination for backed-up or archived files.

    If you activate a policy set with copy groups that specify nonexistent storage pools, the client backup or archive operations fail.

  • A management class specifies a storage pool that does not exist as a destination for files migrated by Tivoli Storage Manager for Space Management clients.
  • The policy set does not have one or more management classes that exist in the current ACTIVE policy set.

    If you activate the policy set, backup files bound to the deleted management classes are rebound to the default management class in the new active policy set.

  • The policy set does not have one or more copy groups that exist in the current ACTIVE policy set.

    If you activate the policy set, files bound to the management classes with deleted copy groups are no longer archived or backed up.

  • The default management class for the policy set does not contain a backup or archive copy group.

    If you activate the policy set with this default management class, clients using the default cannot back up or archive files.

  • A management class specifies that a backup version must exist before a file can be migrated from a client node (MIGREQUIRESBKUP=YES), but the management class does not contain a backup copy group.
If the server has data retention protection enabled, the following conditions must exist:
  • All management classes in the policy set to be validated must contain an archive copy group.
  • If a management class exists in the active policy set, a management class with the same name must exist in the policy set to be validated.
  • If an archive copy group exists in the active policy set, the corresponding copy group in the policy set to be validated must have a RETVER value at least as large as the corresponding values in the active copy group.

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

Read syntax diagramSkip visual syntax diagram
>>-VALidate POlicyset--domain_name--policy_set_name------------><

Parameters

domain_name (Required)
Specifies the name of the policy domain to which the policy set is assigned.
policy_set_name (Required)
Specifies the name of the policy set to be validated.

Example: Validate a specific policy set

Validate the policy set VACATION located in the EMPLOYEE_RECORDS policy domain.
validate policyset employee_records vacation

Related commands

Table 1. Commands related to VALIDATE POLICYSET
Command Description
ACTIVATE POLICYSET Validates and activates a policy set.
COPY POLICYSET Creates a copy of a policy set.
DEFINE COPYGROUP Defines a copy group for backup or archive processing within a specified management class.
DEFINE MGMTCLASS Defines a management class.
DELETE POLICYSET Deletes a policy set, including its management classes and copy groups, from a policy domain.
QUERY POLICYSET Displays information about policy sets.
UPDATE COPYGROUP Changes one or more attributes of a copy group.
UPDATE POLICYSET Changes the description of a policy set.