Commands of the DC Tool 

Synchronization

Before you can build DCs locally you have to synchronize them. For this purpose, two commands syncalldcs and syncdc are provided. Both commands have in common that you can specify in which state the DCs will be synchronized. Note that it depends on the state of the compartment which sync mode you can use. For example if the compartment has archive state, it does not make sense to sync its DCs as active or inactive source.

In case option -y is used for syncalldcs or syncdc, the DCs concerned will be synchronized even if they are up-to-date. In order to ensure that the used DCs are synchronized as well, use option --syncused.

Note: in case no compartment is specified for command syncalldcs, all compartments are considered, so that all DCs of the configuration are synchronized with one command (provided that the right mode is used).

Commands unsyncdc and unsyncalldcs are provided to remove those DCs from the local disk that were synchronized before. While unsyncdc removes one specific DC, unsyncalldcs removes all DCs of the specified compartment. If no compartment has been specified, all synchronized DCs are affected.

DC Build Commands

All build commands have in common that they work only for DCs that belong to compartments with source state.

Since DCs from a compartment with archive state are not available, they cannot be built as sources.

The various build commands differ mainly regarding the set of DCs that shall be built.

For example, with command builddc you can specify exactly one DC to build.

Command buildalldcs allows you to build all DCs of a compartment. In case no compartment is specified, all compartments with source state are considered. As previously mentioned, all used DCs must be synchronized before a DC build is triggered. Otherwise the DC build will fail.

The result of each DC build is shown immediately after the build finishes. Command listbuildresults shows the results of all DC builds made so far. In the context of DC build, the command listbuildorder is also of interest.

With the commands

●      changeparentdc

●      deletedc

●      movedc

●      renamedc

we recommended that you unsynchronize (that is, remove from the client) those DCs that will be affected by these commands before you execute such a command. Otherwise, it is possible that problems may occir with respect to refreshing in SAP NetWeaver Developer Studio due to the changes in DTR caused by the commands.

Note that these commands check in the changes they have made with respect to DCs that are stored in DTR. However, with these commands you cannot perform any further steps related to the development process such as activation or release for transport.

Note that some of the DC refactoring commands will show error messages when the DCs concerned are checked out by another developer. Also, keep in mind that DC refactoringoperations might affect other DCs at build-time, deploy-time or run-time.

Note that some commands require certain privileges in DTR. If you do not have the required privileges the command will fail. For details please refer to the online help of the refactoring commands.

For the command syntax, the part that is enclosed in:

●      [] – is optional.

●      <> – describes the required parameter of an option and is mandatory.

●      (…|…)– describes an enumeration of valid parameters

List of Commands

Command Name	Description
BUILDALLDCS	Builds DCs of a compartment locally.
BUILDDC	Builds only DCs of a compartment with a source state.
BUILDLIST	Builds only DCs of a components with a source state and imported development configuration.
BUILDUSINGDCS	Builds synchronized DCs for compartments with source state only.
CHANGEPARENTDC	Creates and checks in an activity for changes to the DTR.
DELETEDC	Deletes a DC.
EXECTIME	Displays execution time of commands.
EXIT	Terminates the application.
EXPORTDC	Creates and checks out an activity for the export that is exported into an archive file.
HELP	Displays command usage information.
IMPORTCONFIG	Imports a development configuration file.
IMPORTDC	Imports DC content from an archive file.
IMPORTLOCALDC	Imports a locally available DC.
LISTBUILDORDER	Shows the DC build order in a compartment.
LISTBUILDRESULTS	Shows a DC build results.
LISTDCS	Lists DCs of a compartment.
LISTSYNCEDDCS	Lists the synchronized, locally installed and local-only state DCs.
LISTUSEDDCS	Lists DCs that are used by the specified DC at build time.
LISTUSINGDCS	Lists DCs that use the specified DC at build time.
LOADCONFIG	Loads a configuration.
LOGFILE	Specifies user massage log files.
MAN	Shows online manual.
MOVEDC	Moves a selected DC.
REFRESH	Refreshes DC meta data.
REMOVECONFIG	Removes the development configuration from the local disk.
RENAMEDC	Renames a specified DC.
RETURNCODE	Describes return codes.
SHOWCONFIG	Informs about a loaded or imported configuration.
STOPONERROR	Stops an application after the next error.
SYNCALLDCS	Synchronizes compartments to the local disk.
SYNCDC	Synchronizes a DC to the local disk.
TRACEFILE	Specifies a trace file for the stack traces.
UNSYNCALLDCS	Removes synchronized DCs from the local disk.
UNSYNCDC	Removes a synchronized DC from the local disk.
VERBOSITY	Specifies how detailed the user massages should be.
VERSION	Shows application version number.