Setup

ST-Developer applications, makefiles, and project files use several environment variables to find the programming libraries, header files, and tools.

On Windows, the ST-Developer installer sets environment values and registry keys. On MacOS and UNIX, a special "logicals" file is run as part of your shell login scripts to set the variables.

On UNIX, the Rose_Logicals file sets these environment variables using csh syntax, while Rose_Logicals.sh uses Bourne/Korn syntax. In the following example, replace /usr/local/steptools with the ST-Developer installation directory:

    % source /usr/local/steptools/Rose_Logicals  # CSH users
    % set path=($path $ROSE_BIN)                 # set path
     
    $ . /usr/local/steptools/Rose_Logicals.sh    # Bourne/Korn users
    $ PATH=$PATH:$ROSE_BIN                       # set path

Variables

The full list of possible environment variables is shown below. The main variable is $ROSE, which points to the root of the installation.

ST-Developer may include versions of the libraries built for different compilers or link options. The ROSE_LIB and ROSE_CONFIG variables are used by the Makefiles included with the sample programs. These variables are set by the install script to the default library version, but you can change them later if you need to use alternate library versions.

ROSE

The ST-Developer installation directory. On Windows this is also set in the registry under Software\STEP Tools, Inc.\ST-Developer. Used to find everything.

ROSE_BIN

Directory containing executables. Usually $ROSE/bin. On Windows, this is added to your search path by the installer. On MacOS or UNIX, add this to your shell search path.

ROSE_INCLUDE

Directory containing the ST-Developer C and C++ header files. Usually $ROSE/include. Used by makefiles and Visual Studio project files.

ROSE_LIB

Directory containing the ST-Developer C++ libraries. An ST-Developer install may contain several copies of the libraries built with different compiler versions or link options. This variable is set to a subdirectory under $ROSE/lib for the preferred version of the libraries. This variable is only used by makefiles. Not used by Visual Studio projects since the compiler version is already known.

ROSE_DLLDIR

Windows only. This is the directory containing DLL versions of the ST-Developer libraries. Usually $ROSE/dlls. This directory is automatically added to your search path by the Windows installer.

ROSE_CONFIG

This points to a makefile configuration file under $ROSE/config that defines settings for your compiler and build options. This is only used by makefiles for all sample programs.

ROSE_RUNTIME

Optional, UNIX only. Location of the ST-Runtime support files (compiled schemas and short names abbreviations). If not set, tools look for $ROSE/runtime. On Windows, runtime support is found through the registry. See Packaging Applications for Distribution for more information.

ROSE_LICENSE

Optional, UNIX only. Gives an alternate location for the ST-Developer license key file. If not set, tools look at $ROSE/license. On Windows, keys are found through the registry.