SET REPLRETENTION (Set the retention period for replication records)

To maintain adequate information about replication processes, you can use this command to adjust the length of time that the source replication server retains replication records in its database. The SET REPLRETENTION command specifies the retention period for client-node replication records in the source replication-server database. You can use client node replication records to monitor running and completed processes.

A replication record is created when REPLICATE NODE command processing is started. By default, Tivoli® Storage Manager retains client-node replication records for 30 calendar days. A calendar day consists of 24 hours, from midnight to midnight. For example, suppose that the retention period is two calendar days. If a replication process completes at 11:00 p.m. on day n, a record of that process is retained for 25 hours until midnight on day n+1. To display the retention period for replication records, issue the QUERY STATUS command on the source replication server.

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

Privilege class

To issue this command, you must have system privilege.

Syntax

Read syntax diagramSkip visual syntax diagram
                      .-30-------------.   
>>-Set REPLRETention--+----------------+-----------------------><
                      '-number_of_days-'   

Parameters

number_of_days (Required)

The number of days that the source replication server retains replication records. You can specify an integer 0 - 9999. The default value is 30.

Example: Set a retention period for client-node replication records

You want to retain client-node replication records for 10 days.
set replretention 10

Related commands

Table 1. Commands related to SET REPLRETENTION
Command Description
QUERY REPLICATION Displays information about node replication processes.
QUERY REPLNODE Displays information about the replication status of a client node.
QUERY REPLRULE Displays information about node replication rules.
REPLICATE NODE Replicates data in file spaces that belong to a client node.
QUERY STATUS Displays the settings of server parameters, such as those selected by the SET commands.