The dsctl Command
The dsctl command provides a simplified interface into controlling the datasource within a replication scenario to
set the current replication position. Because dsctl uses the built-in datasource connectivity of the replicator,
differences in the storage and configuration of the current replicator metadata and position can be controlled without
resorting to updating the corresponding database directly.
dsctl [common-options ] [ command ] [ options ]
The command is driven by a number of command-specific instructions to get or set the datasource position, the full list of available commands is as follows:
| Option | Description | Version |
|---|---|---|
get | Return the available position information. | |
help | Print the help display. | |
reset | Clear the datasource position information. | |
set | Set the position. |
These must be used in conjunction with one of the following common options to select the required datasources or service:
| Option | Description | Version |
|---|---|---|
-conf | Path to the static services properties file. | |
-ds | Name of the datasource. | |
-service | Name of the replication service to get information from. |
If more than one service or datasource has been configured, one of these options must be used to select the service.
Otherwise, by default dsctl will use the corresponding configured service.