SET BKREPLRULEDEFAULT (Set the server replication rule for backup data)

Use this command to set the server replication rule for backup data.

Restriction: The replication rule that you set with this command is applied only if file space rules and client node rules for backup data are set to DEFAULT.

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

You can specify normal-priority replication rules or high-priority replication rules. In a replication process that includes both normal and high-priority data, high-priority data is replicated first. Before you specify a rule, consider the order in which you want the data to be replicated.

For example, suppose that your client nodes contain archive data and active backup data. Replication of the active backup data is a higher priority than the archive data. To prioritize the backup data, issue the SET BKREPLRULEDEFAULT command and specify the ACTIVE_DATA_HIGH_PRIORITY replication rule. To prioritize the archive data, issue the SET ARREPLRULEDEFAULT command and specify the ALL_DATA replication rule for archive data. The ALL_DATA rule for archive data replicates archive data with a normal priority.

Privilege class

To issue this command, you must have system privilege.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-Set BKREPLRuledefault--+-ALL_DATA------------------+--------><
                          +-ACTIVE_DATA---------------+   
                          +-ALL_DATA_HIGH_PRIORITY----+   
                          +-ACTIVE_DATA_HIGH_PRIORITY-+   
                          '-NONE----------------------'   

Parameters

ALL_DATA
Replicates active and inactive backup data. The data is replicated with normal priority.
ACTIVE_DATA
Replicates active backup data. The data is replicated with normal priority.
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
Replicates active and inactive backup data. Data is replicated with a high priority.
ACTIVE_DATA_HIGH_PRIORITY

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

NONE
Backup data is not replicated.

Example: Set the server replication rule for backup data

Set up the default rule for backup data to replicate only active data and to replicate the data with a high priority.
set bkreplruledefault active_data_high_priority

Related commands

Table 1. Commands related to SET BKREPLRULEDEFAULT
Command Description
QUERY FILESPACE Displays information about data in file spaces that belong to a client.
QUERY NODE Displays partial or complete information about one or more clients.
QUERY REPLICATION Displays information about node replication processes.
QUERY REPLRULE Displays information about node replication rules.
QUERY STATUS Displays the settings of server parameters, such as those selected by the SET commands.
REPLICATE NODE Replicates data in file spaces that belong to a client node.
SET ARREPLRULEDEFAULT Specifies the server node-replication rule for archive data.
SET REPLRETENTION Specifies the retention period for replication history records.
SET SPREPLRULEDEFAULT Specifies the server node-replication rule for space-managed data.
UPDATE FILESPACE Changes file-space node-replication rules.
UPDATE REPLRULE Enables or disables replication rules.
VALIDATE REPLICATION Verifies replication for file spaces and data types.