Where to set environment variables

An environment variable can be set in multiple places, inside and outside of Genero Studio. Where and when the environment variable is set is important.

Table 1 shows the locations where you can set the environment variables. The variables in higher-priority locations overwrite those of lower priority; for example, if the same variable is set in both the project and the node, the value in the node is used.

Note:

It is recommended practice to use Tools > Genero Configurations > Environment sets (row 7 in Table 1) where practical. This makes the environment sets easier to reuse and maintain. The disadvantage is that if the project is handed to new users, they must manually re-create the environment set. If portability is more important than reusability, consider setting the variable in the project (rows 1 to 4 in Table 1).

Note:

Environment variables at the node level (rows 1 to 3 in Table 1) can use predefined node variables.

Table 1. Setting environment variables
Priority Location How to define When to set at this location
1 (highest) Node Right-click on the node and select Advanced Properties. Select the Environment variables page and add or edit the User Variables.

The variable is specific to a node.

2

Node's parents (ancestors)

Right-click on the parent node and select Advanced Properties.

The variable is specific to a family of nodes.
3

Dependent node

Right-click on the dependent node and select Advanced Properties.

The dependent node requires the variable.
4 Project Add a project-level environment variable. The variable is used by all nodes in the project for the language. You want the variable to be portable and move with the project.
5

Specific setup

Add a specific setup-level environment variable.

The variable is used by all configurations which specify the same GSTSETUPDIR.
6

Global level

Add a global-level environment variable.

The variable is used for all projects by one user on a single machine.
7

Environment sets in the Genero configuration

Select Tools > Genero Configurations and then select the environment set.

The variable is used across multiple projects and multiple configurations. You want to define the variable once and re-use it. Recommended option.
8 (lowest)

System

System environment variables cannot be set from Genero Studio.

These environment variables contain the default values for the system. For further information, see Genero environment variables in the Genero Business Development Language User Guide.

Order within an Environment Set

Within an Environment Set, arrow keys can be used to change the order of the variables defined. This affects the way the variables are interpreted when the program is executed. For example:

Table 2. Variable interpretation examples
Project level Variables definition and order Result when application is executed
Project V1="hello"
Application V2="$(V1) world"

V1="goodbye"

V1="goodbye"

V2="hello world"

Application

V1="goodbye"

V2="$(V1) world"

V1="goodbye"

V2="goodbye world"

Note:

If a foreign language Language support (text encoding) is selected in Genero Studio preferences, the LANG variable must be set appropriately to correspond to the selected encoding. Set the variable for a specific environment set in Genero Studio configurations (Tools > Genero Configurations).

Example: Priority and Environment Variables

In this example, the program node in the project has a library node as a dependency. The environments have been defined as shown:

Table 3. Environment Set for levels used in the example
Level Environment Set
System environment
PATH=/bin;/usr/bin 
VAR1=hello 
VAR2=bonjour 
VAR3=guten tag
My Library Environment
PATH=$(PATH);$(ProjectDir)/scripts 
VAR1=goodbye
My Program Environment
PATH=$(PATH);$(ProjectDir)/scripts 
VAR1=$(VAR1) world 
VAR2=$(VAR2) $(VAR1)

If the project directory $(ProjectDir) is set to "/home/joe/project", the environment for the program will be:

PATH=/bin;/usr/bin/;/home/joe/project/scripts 
VAR1=goodbye world 
VAR2=bonjour goodbye world 
VAR3=guten tag