Tivoli Storage Manager for HP-UX Administrator's Reference
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 ]