Release 10.1B: OpenEdge Replication
User Guide


DSRUTIL utility

Once you have initially set up, enabled, and started OpenEdge Replication, you can use the DSRUTIL utility to perform specific OpenEdge Replication server, OpenEdge Replication agent, source database, and target database requests.

Syntax

Operating system
Syntax
UNIX
Windows
DSRUTIL db-name -C ACTION [Server|Agent] [name|ALL] 

db-name

Database is the name of the database to perform the action on. The name of the database must be the first argument and must be a valid name.

-C action

The -C qualifier is used to specify the action to be performed on the database. You can supply the qualifiers described in Table 5–4.

Server | Agent

The action will be performed on the OpenEdge Replication server or the OpenEdge Replication agent.

name |ALL

The action will be performed on one OpenEdge Replication agent (name) or on all OpenEdge Replication agents (ALL). Each OpenEdge Replication server maintains a list of named OpenEdge Replication agents that it is communicating with. The agent name must be valid.

Table 5–4: DSRUTIL utility qualifiers
Qualifier
Description
applyextent
Allows you to apply AI extents generated by the source directly to the target database.
canceldefer
Instructs the OpenEdge Replication server to stop attempting to reconnect.
connectagent
Instructs the OpenEdge Replication server to start one or both of its configured agents.
disablesitereplication
Allows you to disable OpenEdge Replication while the source database is online.
monitor
Displays a PROMON-type series of screens that show the current state of replication.
recovery
Displays the replication recovery information.
relwaits
Frees up any pending waits that might be outstanding so that database activity can continue.
restart
Restarts the OpenEdge Replication server.
startagent
See connectagent.
terminate
Terminates the currently running OpenEdge Replication server or agent.
transition
Instructs an OpenEdge Replication agent to transition a replication-enabled database.
triggertransition
Forces the target database to go into a pre-transition state.

You can use the following command actions and modifiers with the DSRUTIL utility.


Copyright © 2006 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095