QUERY REPLRULE (Query replication rules)

Use this command to display information about replication rules.

Issue this command on the server that acts as a source for replicated data.

Privilege class

Any administrator can issue this command.

Syntax


                   .-*-----------------------------.   
>>-Query REPLRule--+-------------------------------+-----------><
                   '-+-ALL_DATA------------------+-'   
                     +-ACTIVE_DATA---------------+     
                     +-ALL_DATA_HIGH_PRIORITY----+     
                     '-ACTIVE_DATA_HIGH_PRIORITY-'

Privilege class

Any administrator can issue this command.

Parameters

rule_name

Specifies the name of the replication rule that you want to display information about. This parameter is optional. You can use wildcard characters to specify one or more rules. If you do not specify this parameter, information about all rules is displayed in the query output. You can specify the following values:

ALL_DATA

Displays information about the ALL_DATA replication rule. This rule replicates backup, archive, or space-managed data. The data is replicated with a normal priority.

ACTIVE_DATA

Displays information about ACTIVE_DATA replication rule. This rule replicates only active backup data. The data is replicated with a normal priority. This rule is not valid for archive or space-managed data.

Attention: If you specify ACTIVE_DATA and one or more of the following conditions are true, inactive backup data on the target replication server is deleted, and inactive backup data on the source replication server is not replicated.

When a Tivoli® Storage Manager version earlier than Version 7.1.1 is installed on either the source or target replication servers.
When you are using the REPLICATE NODE command with the FORCERECONCILE=YES parameter.
When you are running the initial replication of a file space after you configure replication, restore the database, or upgrade both the source and target replication servers from a Tivoli Storage Manager version earlier than V7.1.1.

If the previous conditions are not true, all new and changed files since the last replication are replicated, including inactive files, and files are deleted when they expire.

ALL_DATA_HIGH_PRIORITY

Displays information about the ALL_DATA_HIGH_PRIORITY rule. This rule replicates backup, archive, or space-managed data. The data is replicated with a normal priority. In a replication process, high-priority data is replicated before normal-priority data.

ACTIVE_DATA_HIGH_PRIORITY

Displays information about the ACTIVE_DATA_HIGH_PRIORITY rule.

This rule is the same as the ACTIVE_DATA replication rule except data is replicated with a high priority.

Example: Display information about a server replication rule

The name of the rule is ALL_DATA_HIGH_PRIORITY

query replrule all_data_high_priority

Rule name: ALL_DATA_HIGH_PRIORITY 
Priority: High
Active-data only?: No
Enabled: Yes

Field descriptions

Rule name

Specifies the name of the rule that was queried.

Priority

Specifies the preference given to data during replication processing. In a replication process that includes high-priority and normal-priority data, high-priority data is replicated first.

Active data only?

Specifies whether the rule applies only to active backup data. The following values are possible:

Yes: Specifies that only active backup data is replicated for file spaces to which this rule is assigned.
No: Specifies that all backup data is replicated for file spaces to which this rule is assigned.

Enabled

Specifies whether the rule is enabled or disabled. The following values are possible:

Yes: Specifies that the rule is enabled for replication. Data in file spaces to which the rule is assigned is replicated.
No: Specifies that the rule is not enabled for replication. Data in file spaces to which the rule is assigned is not replicated.

Related commands

Table 1. Commands related to QUERY REPLRULE
Command	Description
QUERY REPLICATION	Displays information about node replication processes.
QUERY REPLNODE	Displays information about the replication status of a client node.
UPDATE REPLRULE	Enables or disables replication rules.