Building Development Components Centrally 

Use

The Development Component Utility Script (dc.bat) is a tool you can use for central builds in the SAP NetWeaver Developer Studio. It is used for component-based development with the Design Time Repository as the central source code management system.

You use this procedure only in Scenario 2: Development with Components, because here you use the component model but not the Component Build Service.

Prerequisites

·        The SAP NetWeaver Developer Studio must be installed on the same PC as the Development Component Utility Script. This is installed together with the SAP NetWeaver Developer Studio. Among others, it uses Java classes from archives installed together with the SAP NetWeaver Developer Studio.

·        The development configuration must have been imported into the SAP NetWeaver Developer Studio before.

·        The same Windows user account, under which the development configuration was imported, must also be used to call the DC Utility (the administrative data of the DTR client are stored at different locations for different users).

·        Before calling the script, you must set these environment variables as follows:

¡        SAPDEVSTUDIOHOME must point to the "eclipse" folder in your installation directory of the SAP NetWeaver Developer Studio, for example, C:\ProgramFiles\SAP\JDT\eclipse

¡        JAVA_HOME must point to the installation directory of the Java SDK installation, for example, C:\jdk1.4.1_02

Before starting the batch script, you must close the SAP NetWeaver Developer Studio; otherwise problems may occur, because two applications try to access the same DTR client administration data at the same time.

Calling the Development Component Utility Script

...

The dc.bat file is located in the installation directory of the SAP NetWeaver Developer Studio.

C:\Program Files\SAP\JDT\eclipse\tools\dc\dc.bat

       1.      Open a command line window.

       2.      Switch to the directory of the dc.bat file (or set the directory in the PATH environment variable). 

       3.      Enter dc Options 2>> tracefile

¡        Options are the command line options.

¡        tracefile is the name of the file, into which you want to write the trace information.

¡        2>> is used to re-route the output usually written to the standard error channel to this file.

Optionally, you can re-route user messages from the standard output to a log file: dc options 1>logfile 2>> tracefile

logfile is the name of the file, into which you want to write the user messages.

When you enter dc help, a list of the available parameters appears, together with a description of how to use them.

The section below describes these parameters.

Utility Output

The DC script writes output to the standard output channel and standard error channel.

·        Into the standard output channel, it writes all messages important for the user (including error messages).

·        Into the standard error channel, it writes trace information used by the SAP Support.

We expressly recommend to re-route at least the standard error channel into a file, because otherwise, in the output to the console, user output and trace output will be mixed. This would make it very hard to read the output.