DC Command Line Tool

Use

The DC tool is a command line tool that allows you to perform several tasks related to Development Components (DCs).

Starting the Tool

For more information, see Starting Command Line Tools .

Help

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

You can get a printout with the full list of the commands and their parameters, arguments and examples on their usage using the command help -x <location to export the commands>\DC.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 the 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

List of Commands

Command Name	Description
buildalldcs	Builds all DCs of the specified compartment locally.
builddc	Builds the specified DC locally.
buildlist	Builds all DCs specified in a list locally.
buildusingdcs	Builds all DCs that use the specified DC at build time.
changeparentdc	Changes the parent-child relationship between DCs.
createsda	Creates a Software Delivery Archive (SDA).
dcwrap	Creates a DC that wraps build artifacts.
deletedc	Deletes the specified DC(s).
displaysca	Displays package information of a Software Component Archive (SCA).
exec	Executes the specified OS command in a separate process.
exit	Exits the application.
exportdc	Exports the specified DC into an archive.
exportforassembly/eas	Exports the DC archives to prepare SCA assembly.
exportproductversiondescription	Exports the SLD description of a given product version.
exportscversiondescription	Exports the SLD description of a given software component version.
extracttranslation	Extracts all files matching a given pattern.
help	Provides help for commands.
importconfig/icfg	Imports a development configuration.
importdc	Imports the content of a DC from an archive.
importlocaldc	Imports a DC that is already available locally.
importsca/isca	Imports an SCA into a development configuration.
injecttranslation	Inject files from the source root with the ones available in the targeted root.
listavailabledcs	Shows the locally available DCs.
listbuildorder	Shows in which order the DCs in the compartment(s) are built.
listbuildresults/lbr	Shows the results of DC builds made so far.
listdcs/ldc	Shows the DCs of the specified compartment.
listuseddcs	Shows which DCs the specified DC uses at build time.
listusingdcs	Shows which DCs use the specified DC at build time.
loadconfig/lcfg	Loads a development configuration.
movedc	Moves the specified DC to another compartment.
packdcs	Creates DC archives for the specified DCs.
packsca	Packs a Software Component Archive (SCA).
refresh	Retrieves and evaluates DC metadata.
removeconfig/rcfg	Removes the development configuration from the local disk.
renamedc	Assigns a new name to the specified DC.
script	Runs a set of commands from a (script) file.
showconfig	Shows the content of the loaded/imported development configuration.
spool	Writes the trace to the specified trace file.
startup	Provides common options/arguments for the application startup.
syncalldcs	Syncs the specified compartment(s) with the local disk.
syncdc	Syncs the specified DC to the local disk.
timing	Activates/deactivates command execution time reporting.
tracefile	Specifies the trace file for technical messages such as stack traces.
traceperf	Starts/stops performance tracing of this application/the specified profile.
unpacksca	Unpacks a Software Component Archive (SCA).
unsyncalldcs	Removes the specified synced DCs from the local disk
unsyncdc	Removes the specified synced DC from the local disk.
vars	List currently defined variables, clears variables or sets variable value.