Tivoli Storage Manager for HP-UX Administrator's Reference

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 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 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.

Examples

Task 1

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.

Command:
query copygroup admin_records 
standard standard format=detailed

Output:
 
+--------------------------------------------------------------------------------+
|            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                                      |
|Last Update by (administrator): $$CONFIG_MANAGER$$                              |
|         Last Update Date/Time: 1998.06.04 17.51.49                             |
|              Managing profile: ADMIN_INFO                                      |
+--------------------------------------------------------------------------------+

where:

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 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.

Retain Extra Versions
The number of days to retain a backup version after that version becomes inactive (that is, a more recent backup version is stored).

Retain Only Version
The number of days to retain the last backup version of a file that has been deleted from the client file system.

Copy Mode
Whether TSM backs up a file only if the file has changed since the last backup. This value can be Modified or Absolute. The copy mode value is only used for incremental backups. This value is ignored during selective backups.

Copy Serialization
Whether a file can be in use during a backup operation.

Copy Frequency
The minimum days between backups.

Copy Destination
The name of the storage pool where the server initially stores files associated with this copy group.

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 copy group.

Task 2

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.

Command:
query copygroup prog1 summer mclass1 
type=archive format=detailed

Output:
 
+--------------------------------------------------------------------------------+
|            Policy Domain Name: PROG1                                           |
|               Policy Set Name: SUMMER                                          |
|               Mgmt Class Name: MCLASS1                                         |
|               Copy Group Name: STANDARD                                        |
|               Copy Group Type: Archive                                         |
|                Retain Version: 730                                             |
|            Copy Serialization: Shared Static                                   |
|                Copy Frequency: Cmd                                             |
|                     Copy Mode: Absolute                                        |
|              Copy Destination: ARCHPOOL                                        |
|Last Update by (administrator): $$CONFIG_MANAGER$$                              |
|         Last Update Date/Time: 1998.06.05 17.42.49                             |
|              Managing profile: ADMIN_INFO                                      |
+--------------------------------------------------------------------------------+

where:

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.

Retain Version
The number of days to keep an archive copy.

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.

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.

Related Commands

Table 152. Commands Related to QUERY COPYGROUP

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.


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