DSRUTIL utility
- Last Updated: May 19, 2025
- 1 minute read
- OpenEdge
- Version 12.2
- Documentation
Once you initially set up, enable, and start OpenEdge Replication, you can use the DSRUTIL utility to perform specific OpenEdge Replication server, OpenEdge Replication agent, source database, and target database requests.
Syntax
|
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.
-
-Caction - The
-Cqualifier is used to specify the action to be performed on the database. You can supply the qualifiers described in Table 1. -
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.
- -Passphrase
-
For encryption-enabled databases only, specifies to prompt for a passphrase to authenticate the key store.
CAUTION: If your database is enabled for transparent data encryption and configured for manual start, you must specify-Passphraseevery time the database is opened.For more information on encryption and key store authentication, see Manage the OpenEdge Database.
The command actions and modifiers you can use with the DSRUTIL utility are listed in the table that follows and described in the following sections.
| 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. |
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. |