Preparing a Products Header File

Command Line Interface

Before you can compile the TDP library source files, you must set up a file named products.h for C and C++ or Products.java for Java. This file contains the options that describe how the TDP library files are to be compiled.

To set up a products header file

  1. For C and C++, copy the product_model.h file from the lib sub-directory of the current Target Deployment Port to a directory of your choice, and rename it to products.h.

The directory of your choice may be the directory where the generated source files or instrumented source files are located.

  1. For Java, copy the Products_defaults.java.txt file from the lib sub-directory of the current Target Deployment Port to com/rational/test/Products.java.

  2. Open products.h or Products.java in a text editor and add the following define at the beginning of the file:

#define ATL_WITHOUT_STUDIO

  1. Make any necessary changes by adjusting the corresponding macros in the file.

The product_model.h file is self-documented, and you can adjust every macro to one of the values listed. Each macro is set to a default value, so you can keep everything unchanged if you don't know how to set them.

Note   Pay attention to correctly set the macros starting with USE_, because these macros set which features of Test RealTime   you are using. Certain combinations are not allowed, such as using several test features simultaneously.

Ensure that the ATL_TRACES_FILE macro correctly specifies the name of the trace file which will be produced during the execution. If you are using Component Testing, this value may be overridden by a Test Script Compiler command line option.

Take note of the directory where this file is stored, you will need it in order to compile the generated or instrumented source files.

Related Topics

Preparing an Options Header File