REMOVE REPLSERVER (Remove a replication server)

Use this command to remove or to switch to a replication server from the list of replication servers. This command deletes all information about replication state for all nodes that were replicated to that server.

You can issue the command on a source or on a target replication server.
Restriction: You cannot delete client node data by using the REMOVE REPLSERVER command.

Use the command to switch replication servers and to remove replication information for an old server. The command does not affect the current replication mode or state of any node definitions. Issue the command on both the source and target servers to keep the replication state information about both servers consistent.

Restriction: If you specify the default replication server for the REMOVE REPLSERVER command and a node replication process is running, the command fails and no replication information is removed.

This command runs as a background operation and it cannot be canceled. Tivoli® Storage Manager deletes replication information that is associated with the specified server as a series of batch database transactions. If a system failure occurs, a partial deletion can occur.

Privilege class

To issue this command, you must have system privilege.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-REMove REPLServer--GUID-------------------------------------><

Parameters

replication_guid (Required)

The unique identifier for the replication server that is being removed. You can use wildcards to specify the Replication Global Unique Identifier (GUID), however, only one GUID can match the wildcard. If the wildcard sequence matches more than one GUID, the command fails. You must qualify the wildcard string until only the GUID that you want to delete is found.

Example: Use a wildcard to remove a replication server

Remove a replication server by using a wildcard character to indicate the GUID.
remove replserver e*

Related commands

Table 1. Commands related to REMOVE REPLSERVER
Command Description
REMOVE REPLNODE (Remove a client node from replication) Removes a node from replication.
QUERY REPLSERVER (Query a replication server) Displays information about replicating servers.