Environment variables

Mandatory environment variables

The following environment variables MUST be set to run the product:

TESTRTDIR for the graphical user interface
ATUDIR for Component Testing for C and Ada
ATS_DIR for System Testing for C
ATLTGT in the command line interface

Environment variable list


Environment Variable	Description
TESTRTDIR	A mandatory environment variable that points to the installation directory of the product.
ATTOLSTUDIO_VERBOSE	Setting this variable to 1 forces the product GUI to display verbose messages, including file paths, in the Build Message Window.

Runtime Analysis features

The Runtime Analysis Features use the following environment variables:


Environment Variable	Description
ATLTGT	A mandatory environment variable that points to the Target Deployment Port directory when you are using the product in the command line interface. When you are using the Instrumentation Launcher or the product GUI, you do not need to set ATLTGT manually, as it is calculated automatically.
ATL_TMP_DIR	Indicates the location for temporary files. By default, they are placed in /tmpfor UNIX or the current directory for Windows.
ATL_EXT_SRC	This variable allows you to instrument additional files with filename extensions other than the defaults (.c and .i). The .c extension is reserved for C source files that require preprocessing, while .i is for already preprocessed files. All other extensions supported by this variable are assumed to be of source files that need to be preprocessed.
ATL_EXT_OBJ	Lets you specify an alternative extension to .o(UNIX) or.obj(DOS) for object files.
ATL_EXT_ASM	Lets you specify more than .s extension for assembler source files when the compiler offers an option to generate an assembler listing without compiling it to the object file.
ATL_EXT_TMP_CMD	Windows only. Lets you specify an alternative extension to the Windows temporary options file. Defaults to ._@@.
ATL_EXT_SRCCP	The variable lets you add C++ source file extensions (defaults are .C, .cpp, .c++, .cxx, .cc, and .i) to specify the C++ source files to be instrumented. Extensions .C to .cc in the list are reserved for source files under analysis. The .i extension is reserved for those to be processed, if the ATL_FORCE_CPLUSPLUS variable is set to ON. Any other extension implies that pre-processing is to be performed.
ATL_FORCE_CPLUSPLUS	If set to ON, this variable allows you to force C++ instrumentation whether the file extension is .c, .i, or any added extension.

Component Testing for C and Ada

Component Testing for C and Ada uses the following environment variables:


Environment Variable	Description
ATUDIR	Points to the /lib directory in the product installation directory.
ATUTGT	Points to the Target Deployment Port directory for Component Testing for C and Ada.

You can change default extensions for Component Testing for C and Ada through the use of environment variables when the Test Script Compiler or Test Report Generator is started.

The following table summarizes these environment variables and the extensions they modify.


Environment Variable	File	Default extension
ATTOLPTU	Test script	.ptu
ATTOLTDC	Table of correspondence file	.tdc
ATTOLLIS	List of errors	.lis
ATTOLRIO	Trace file	.rio
ATTOLRO	Test report	.ro
ATTOLROD	Unformatted test report	.rod
ATTOLDEF	Standard definitions file	.def
ATTOLSMB	Symbol table file	.smb

The rule whereby a "2" is added to the extension of the .rio trace file when the -compare option is used still applies if the default extension is changed in the ATTOLRIO environment variable.

System Testing for C

System Testing for C uses the following environment variable:


Environment Variable	Description
ATS_DIR	Points to the directory containing the System Testing binaries for C.

Test Process Monitor

The Test Process Monitor uses the following environment variables.


Environment Variable	Description
ATTOL_TPM_ROOT	This variable indicates the directory where Test Process Monitor databases are located for a project. ATTOL_TPM_ROOT is a mandatory variable and must be set when a project is created. It should be a shared directory accessible by all users who work on a project.
ATTOL_TPM_USER	This optional variable specifies the name of the user. If this variable is not set, the Test Process Monitor uses the current user, if possible.

C and C++ Instrumentation Launcher

The Instrumentation Launcher uses the following additional variables:


Environment Variable	Description
ATTOLBIN	If set, this variable must contain the path to the Instrumentor binaries. If not, this path is determined automatically from the PATH variable. This variable can be useful if the Target Deployment Port has been moved to a non-standard location.
ATTOLOBJ	If set, this variable points to a valid directory where the products.h file is generated and the Target Deployment Port (TP.oorTDP.obj) is compiled. By default, these files are generated in the current directory.
ATL_OVER_SET	This variable must indicate the path to a copy of the BatchCCDefaults.pl file if you want to change any Target Deployment Port compilation flags contained in that file.
ATL_EXT_LIB	Lets you specify additional alternative extensions for library files. By default .a or .lib are used.
ATL_FORCE_C_TDP	If set to ON, the tp.ini file is used instead of the tpcpp.ini file (used for C++ language). If the Target Deployment Port supports only C language, the tp.ini file is always used.
ATL_OVER_SET	As an alternative to using the --settings of the Instrumentation Launcher, you can copy and modify the <InstallDir> /lib/scripts/BatchCCDefaults.pl file. In this case, set ATL_OVER_SET to the directory and filename of the new copy of this file.

Ada tools

The Ada Link File Generator and Ada Unit Maker use the following additional variables:


Environment Variable	Description
ATTOLCHOP	Selects the default naming convention. The following values can be used: ATTOLCHOP="APEX" : for Apex naming ATTOLCHOP="GNAT" : for Gnat naming All other values end with a fatal error. By default, Gnat naming is used.
ATTOLALK_EXT	Specifies allowed extensions separated by the semicolon (':') character on UNIX systems and (';') on Windows. By default, the allowed extension list is ".ada:.ads:.adb"
ATTOLALK_NOEXT	Specifies forbidden extensions separated by the ':' character on UNIX systems and ';' on Windows. By default, the forbidden extension list is empty.
LD_LIBRARY_PATH	Specifies the location of libraries required by the Ada Link File Generator. By default, these libraries are located in the /lib directory of the installation directory.