DTR Console

Use

The Design Time Repository (DTR) console is a command line based administrative tool deployed on the AS Java system where the DTR is running. The tool is located in the /usr/sap/<SID>/SYS/global/com.sap.dtr.console folder. It is platform-independent. For Microsoft Windows OS, use the run.bat to start the console application. You use this tool to trigger the replication process on the individual workspaces.

Starting the Tool

For more information, see Starting Command Line Tools .

Help

You can use the command help to get an overview of the existing commands. To obtain information about a specific command, enter help <command name> . This will show the command syntax and a short description of the command.

You can create a printout with the full list of the commands and their parameters, arguments, and examples of their usage using the command help -x <location to export the commands>\DTRConsole.doc .

Spooling Log Messages

By default, the command line tool writes user messages directly to the console. In some cases you may need to redirect the location in which the information for the error messages is logged. You can redirect these user messages to a file using the spool command.

For example, to start spooling to file c:\temp\spool.txt , use the command as follows:

spool c:\ temp \spool.txt

Note that if such a file already exists, it will be overwritten.

Commands

Using this command line tool you can create a replica (that is, a copy) of your DTR repository on another DTR server. For more information, see Replicating a Track into a Different DTR Repository .

List of Commands

Command Name	Description
cd	Changes the current directory.
cdd	Changes the current directory to the deepest child.
checkin	Checks in an open activity.
checkout	Checks out a resource.
close	Closes a propagation list.
connect	Connects to a new DTR system. This creates a new session.
copyAsFusion	Copies a folder to a new location by syncing and uploading. Optionally replaces certain folders by fusions
copyWorkspaceState	Copies the state of a workspace into another workspace.
count	Counts the files in a subtree.
debughttp	Starts HTTP protocol debugging.
delete	Deletes a resource.
dematerialize	Dematerializes a propagation list.
discard	Resolves a predecessor-successor collision by discarding one of the colliding versions.
exec	Executes the specified OS command in a separate process.
exit	Exits the application.
export	Exports an activity or a propagation list.
format	Defines the output format for the commands.
gc	Triggers the garbage collection.
get	Gets a resource.
help	Provides help for commands.
import	Imports an export file that was created by the export command.
input	Puts user input as a resource.
integrate	Integrates an activity or a propagation list into a workspace.
integrations	Finds workspace integration.
listActivities	Lists activities/propagation lists.
listBaselines	Lists all baselines for the given workspace.
listConflicts	Lists conflicts.
listGroups	Lists versionSetGroups.
listWorkspaces	Lists workspaces.
ls	Prints the members of a given directory.
lsmp	Lists mount points.
massResolve	Mass collision resolution.
materialize	Materializes a propagation list.
mcd	Creates a directory and changes into it (md + cd).
mcw	Creates a workspace and changes into it (mw + cd).
mkactivity	Creates an activity.
mkbaseline	Creates a new baseline.
mkdir	Creates a directory.
mkfusion	Creates a fusion.
mkproplist	Creates a propagation list.
mkvsgroup	Creates a versionSetGroup.
mkworkspace	Creates a workspace.
mount	Mounts a remote folder to a local folder.
options	Shows the methods and functionalities supported by the DTR.
populateproplist	Populates a propagation list.
populatevsgroup	Populates a versionSetGroup.
propagatebaseline	Propagates a baseline.
propfind	Gets properties for a resource.
proppatch	Sets or removes properties for a resource.
purge	Purges (overwrites) versions that have already been checked in.
put	Puts a resource.
pwd	Displays the current directory.
replicate	Replicates a workspace.
revert	Reverts the changes made to the given resource.
sat	Switches the Single Activity Trace on/off.
script	Runs a set of commands from a (script) file.
sessions	Manages users' sessions.
spool	Writes the trace to specified trace file.
startup	Provides common options/arguments for the application startup.
sync	Sync files/folders.
timing	Activates/deactivates command's execution time reporting.
traceperf	Starts/stops performance tracing of this application/the specified profile.
unmount	Removes a mount point from the sync database.
vars	Lists currently defined variables, or clears variables or sets the variable value.
vgraph	Presents all information that is needed to create the version graph for a resource.
webdetails	Opens a browser to show resource details (MS Windows Only).
where	Lists the workspaces in which a version or one of its successors has been integrated.