QUERY COPYGROUP (Query copy groups)
Use this command to display information about one or more copy groups.
Privilege class
Any administrator can issue this command.
Syntax
>>-Query COpygroup----------------------------------------------> .-*--*--*--STANDARD----------------------------------------------. >--+----------------------------------------------------------------+--> | .-*--*--STANDARD--------------------------------. | '-domain_name--+-----------------------------------------------+-' | .-*--STANDARD--------------. | '-policy_set_name--+--------------------------+-' | .-STANDARD-. | '-class_name--+----------+-' '-STANDARD-' .-Type--=--Backup------. .-Format--=--Standard-----. >--+----------------------+--+-------------------------+------->< '-Type--=--+-Backup--+-' '-Format--=--+-Standard-+-' '-Archive-' '-Detailed-'
Parameters
- domain_name
- Specifies the policy domain that is associated with the copy group 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 queried. You must specify this parameter when querying an explicitly named copy group.
- policy_set_name
- Specifies the policy set associated with the copy group 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 sets are queried. You must specify this parameter when querying an explicitly named copy group.
- class_name
- Specifies the management class that is associated with the copy group 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 management classes are queried. You must specify this parameter when querying an explicitly named copy group.
- STANDARD
- Specifies the name of the copy group. This parameter is optional. The name of the copy group must be STANDARD. The default is STANDARD.
- Type
- Specifies the type of copy group to be queried. This parameter is optional. The default value is
BACKUP. Possible values are:
- Backup
- Specifies that you want to query backup copy groups.
- Archive
- Specifies that you want to query archive copy groups.
- 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 about the default backup copy group
Display information about the default backup copy group in the ENGPOLDOM engineering policy domain. Issue the following command:query copygroup engpoldom * *
The following
data 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
Example: Display detailed information on one backup copy group
Display complete information on the backup copy group assigned to the ACTIVEFILES management class in the VACATION policy set of the EMPLOYEE_RECORDS policy domain. Issue the command:query copygroup employee_records vacation
activefiles format=detailed
Example: Display information on the backup copy group in the STANDARD management class and policy set
From a managed server, display complete information on the backup copy group assigned to the STANDARD management class in the STANDARD policy set of the ADMIN_RECORDS policy domain. Issue the command:query copygroup admin_records
standard standard format=detailed
Policy Domain Name: ADMIN_RECORDS
Policy Set Name: STANDARD
Mgmt Class Name: STANDARD
Copy Group Name: STANDARD
Copy Group Type: Backup
Versions Data Exists: 2
Versions Data Deleted: 1
Retain Extra Versions: 30
Retain Only Version: 60
Copy Mode: Modified
Copy Serialization: Shared Static
Copy Frequency: 0
Copy Destination: BACKUPPOOL
Table of Contents (TOC) Destination:
Last Update by (administrator): $$CONFIG_MANAGER$$
Last Update Date/Time: 2002.10.02 17.51.49
Managing profile: ADMIN_INFO
Changes Pending: Yes
Example: Display information on an archive copy group
From a managed server, display complete information on the archive copy group STANDARD that is assigned to the MCLASS1 management class in the SUMMER policy set of the PROG1 policy domain. Issue the command:query copygroup prog1 summer mclass1
type=archive format=detailed
Policy Domain Name: PROG1
Policy Set Name: SUMMER
Mgmt Class Name: MCLASS1
Copy Group Name: STANDARD
Copy Group Type: Archive
Retain Version: 730
Retention Initiation: Creation
Minimum Retention:
Copy Serialization: Shared Static
Copy Frequency: Cmd
Copy Mode: Absolute
Copy Destination: ARCHPOOL
Last Update by (administrator): $$CONFIG_MANAGER$$
Last Update Date/Time: 2002.10.02 17.42.49
Managing profile: ADMIN_INFO
Example: Display information on the copy group for a NAS backup
Query the copy group for the NAS backup. Issue the command:query copygroup nasdomain
type=backup
Policy Domain Name: NASDOMAIN
Policy Set Name: ACTIVE
Mgmt Class Name: STANDARD
Copy Group Name: STANDARD
Copy Group Type: Backup
Versions Data Exists: 2
Versions Data Deleted: 1
Retain Extra Versions: 30
Retain Only Version: 60
Copy Mode: Modified
Copy Serialization: Shared Static
Copy Frequency: 0
Copy Destination: NASPOOL
Table of Contents (TOC) Destination: BACKUPPOOL
Last Update by (administrator): SERVER_CONSOLE
Last Update Date/Time: 10/02/2002 12:16:52
Managing profile:
Changes Pending: Yes
Field descriptions
- Policy Domain Name
- The name of the policy domain.
- Policy Set Name
- The name of the policy set.
- Mgmt Class Name
- The name of the management class.
- Copy Group Name
- The name of the copy group. This name is always STANDARD.
- Copy Group Type
- The type of the copy group.
- Versions Data Exists
- The maximum number of backup versions to retain for files that are currently on the client file system.
- Versions Data Deleted
- The maximum number of backup versions to retain for files that have been deleted from the client file system after being backed up using Tivoli Storage Manager.
- Retain Extra Versions
- The number of days to retain a backup version after that version becomes inactive.
- Retain Only Versions
- The number of days to retain the last backup version of a file that has been deleted from the client file system.
- Retain Version
- The number of days to keep an archive copy.
- Retention Initiation
- The time, which the server initiates the retention time that is specified by the RETAIN VERSION parameter. CREATION specifies that the retention time is initiated at the time an archive copy is stored on the server. EVENT specifies that the retention time is initiated at the time the server is notified of a retention-initiating event for the archive copy.
- Minimum Retention
- The minimum number of days to keep an archive copy when Retention Initiation is EVENT. The value of this parameter is not displayed when Retention Initiation is CREATION.
- Copy Serialization
- Whether a file can be in use during an archive operation.
- Copy Frequency
- The copy frequency of the copy group. For archive copy groups, this value is always CMD.
- Copy Mode
- Specifies that files in the copy group are archived regardless of whether they have been modified. For archive copy groups, this value is always ABSOLUTE.
- Copy Destination
- The name of the storage pool where the server initially stores files associated with this archive copy group.
- Table of Contents (TOC) Destination
- The name of the primary storage pool in which TOCs are initially stored for image backup operations in which TOC generation is requested.
- Last Update by (administrator)
- The name of the administrator or server that most recently updated the copy group. If this field contains $$CONFIG_MANAGER$$, the copy group is associated with a domain that is managed by the configuration manager.
- Last Update Date/Time
- The date and time when the copy group was most recently defined or updated.
- Managing Profile
- The profile or profiles to which the managed server subscribed to get the definition of this policy copy group.
- Changes Pending
- Whether or not changes are being made but not activated. Once the changes are activated, the field resets to No.
Related commands
Command | Description |
---|---|
DEFINE COPYGROUP | Defines a copy group for backup or archive processing within a specified management class. |
DELETE COPYGROUP | Deletes a backup or archive copy group from a policy domain and policy set. |
UPDATE COPYGROUP | Changes one or more attributes of a copy group. |