Command Line Interface
The command line interface (CLI) tools require several environment variables to be set.
These variables determine, for example, the Target Deployment Port (TDP) that you are going to use. The available TDPs are located in the product installation directory, under targets. Each TDP is contained in its own sub-directory.
Prior to running any of the CLI tools, the following environment variables must be set:
TESTRTDIR indicates the installation directory of the product
ATLTGT and ATUTGT specify the location of the current TDP: $TESTRTDIR/targets/<tdp>, where <tdp> is the name of the TDP.
PATH must include an entry to $TESTRTDIR/bin/<platform>/<os>, where <platform> is the hardware platform and <os> is the current operating system.
You must also add the product installation bin directory to your PATH.
Note Some command-line tools may require additional environment variables. See the chapters dedicated to each command in the Reference Manual section.
Note Environment variables concerning Java on Windows must not contain spaces. Use 8.3 naming conventions, for example: TESTRTDIR=C:\PROGRA~1\Rational\TESTRE~1.
Most of these environment variables are set during installation of the product. Under Linux, use the testrtinit.sh script to set these variables. See the Reference section for more information about these scripts.
If you are using Component Testing or System Testing features, the following additional environment variables must be set:
ATUDIR for Component Testing, points to $TESTRTDIR/lib
ATS_DIR, for System Testing, points to $TESTRTDIR/bin/<platform>/<os>, where <platform> is the hardware platform and <os> is the current operating system.
UNIX platforms require the following additional environment variable:
On Solaris and Linux platforms: LD_LIBRARY_PATH points to $TESTRTDIR/lib/<platform>/<os>
On HP-UX platforms: SHLIB_PATH points to $TESTRTDIR/lib/<platform>/<os>
On AIX platforms: LIB_PATH points to $TESTRTDIR/lib/<platform>/<os>
where <platform> is the hardware platform and <os> is the current operating system.
The following example shows how to set these variables for Test RealTime with a sh shell on a Suse Linux system. The selected Target Deployment Port is clinuxgnu.
TESTRTDIR=/opt/Rational/TestRealTime.v2002R2
ATCDIR=$TESTRTDIR/bin/intel/linux_suse
ATUDIR=$TESTRTDIR/lib
ATS_DIR=$TESTRTDIR/bin/intel/linux_suse
ATLTGT=$TESTRTDIR/targets/clinuxgnu
ATUTGT=$TESTRTDIR/targets/clinuxgnu
LD_LIBRARY_PATH=$TESTRTDIR/lib/intel/linux_suse
PATH=$TESTRTDIR/bin/intel/linux_suse:$PATH
export TESTRTDIR
export ATCDIR
export ATUDIR
export ATS_DIR
export ATLTGT
export ATUTGT
export LD_LIBRARY_PATH
export PATH