DSRUTIL is used to manage, validate, monitor, and control OpenEdge Replication for databases that are enabled for replication. The utility can be run while the database is online and in single-user or multi-user mode with the following syntax and qualifiers:

Syntax

The command for the utility is as shown:

dsrutil db-name -C qualifier

Parameters

db-name
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.

Qualifiers

terminate
Shuts down the replication server or agent without shutting down the database. This is useful when changing replication properties, ensuring forward processing on the source database and reporting on the target database.
restart
Restarts the replication server or agent without shutting down and restarting the database. This is useful when changing replication properties or when replication ended with an error.
transition
Instructs an OpenEdge Replication target database to become a source database. This command is useful when the replication agent is configured for manual recovery transition, and the connection to the replication server has been lost for a considerable amount of time. You can use DSRUTIL transition to transition to a source database to allow for continuous forward processing of transactions, in the event of a production database failure.
transition failover
Instructs an OpenEdge Replication source database and an OpenEdge Replication target database to switch roles, so the target becomes the source, and the source becomes the target. This allows continued forward processing on the production database (the new source) while maintenance is performed on the old source database or machine.
monitor
Displays a real‑time, interactive view of OpenEdge Replication server and agent status, activity, and latency, allowing administrators to observe replication health without modifying database state. It provides progress indicators such as:
  • Blocks received, processed, and acknowledged
  • Transaction activity counts
  • Synchronization points
  • AI block sequence and block numbers
  • Replication latency between source and target
Use this tool to monitor the stability and health of your replication process, so you can ensure continuous operation of your database.
canceldefer
Cancels the replication server's attempts to connect to replication agents on the 5-minute interval when defer-agent-startup mode is enabled. This is useful when a replication server is connected to one target database but is unable to connect to the second target database. This option causes the replication server to begin startup synchronization and replication to the connected target database, which minimizes the possibility of data loss in the event of a source database failure.
connectagent
Connects replication server to a replication agent. Normally, the replication server attempts to connect to replication agents only at startup or in the event that a connection to a replication agent is lost. This is useful when a second agent is bought online after the replication server is started, enabling connection to the second agent without shutting down and restarting the replication server.
disablesitereplication
Terminates the replication server or replication agent and then disables OpenEdge Replication for the database. For example, you might use this command if your target database cannot be reached and the AI extents of the source database are LOCKED, causing the source database update activity to be blocked, unless replication is disabled. This command allows you to disable OpenEdge Replication for the database while the broker remains online.
applyextent
Instructs an OpenEdge replication agent that is configured for manual transition and is in the pre-transition state to apply the notes in an after-image extent to the target database. This command is useful when the source database experiences a failure, and the source AI extents are accessible from the target database machine. Before the target database is manually transitioned to become a replication source database, this command applies transactions described by the AI notes in the extent to the target database, minimizing data loss.
logginglevel
Resets the replication logging level while replication remains running.
validate
Verifies syntactical correctness of the repl.properties file before starting replication or transition and reports any errors to both standard out and the database log file. You can run the utility in multi-user mode to validate changes to repl.properties before transitioning or restarting replication. Running this command on the source database pings the broker of the target database and reports the network connectivity of the target database.