Environment

This part describes the environment variables used by the Assembler. Some environment variables are also used by other tools (e.g., Linker or Compiler), so consult also the respective documentation.

There are three ways to specify an environment:

The current project file with the Environment Variables section. This file may be specified on Tool startup using the -Prod: Specify project file at startup assembler option. This is the recommended method and is also supported by the IDE.
An optional default.env file in the current directory. This file is supported for compatibility reasons with earlier versions. The name of this file may be specified using the ENVIRONMENT: Environment file specification environment variable. Using the default.env file is not recommended.
Setting environment variables on system level (DOS level). This is also not recommended.

Various parameters of the Assembler may be set in an environment using the environment variables. The syntax is always the same as the following listing shows:

Listing: Syntax for setting environment variables

Parameter: KeyName=ParamDef

The following listing shows a typical example of setting an environment variable.

Listing: Setting the GENPATH environment variable

GENPATH=C:\INSTALL\LIB;D:\PROJECTS\TESTS;/usr/local/lib;
/home/me/my_project

These parameters may be defined in several ways:

Using system environment variables supported by your operating system.
Putting the definitions in a file called default.env (.hidefaults for UNIX) in the default directory.
Putting the definitions in a file given by the value of the ENVIRONMENT system environment variable.
Note: The default directory mentioned above can be set via the DEFAULTDIR system environment variable.

When looking for an environment variable, all programs first search the system environment, then the default.env (.hidefaults for UNIX) file and finally the global environment file given by ENVIRONMENT. If no definition can be found, a default value is assumed.

Note: The environment may also be changed using the -Env: Set environment variable assembler option.