Environment

This Chapter describes all the environment variables. Some environment variables are also used by other tools (For example, Linker or Assembler). Consult the respective manual for more information.

Parameters are set in an environment using environment variables. There are three ways to specify your 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 option.
An optional `default.env' file in the current directory. This file is supported for backwards compatibility. The filename is specified using the ENVIRONMENT: Environment File Specification variable. Using the default.env file is not recommended.
Setting environment variables on system level (DOS level). This is not recommended.

The syntax for setting an environment variable is ( Listing: Setting the GENPATH environment variable):

Parameter:

   <KeyName>=<ParamDef>

Note: Normally no white space is allowed in the definition of an environment variable.

Listing: Setting the GENPATH environment variable

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

Parameters may be defined in several ways:

Using system environment variables supported by your operating system.
Putting the definitions into the actual project file in the section named [Environment Variables].
Putting the definitions in a file named default.env in the default directory.
Note: The maximum length of environment variable entries in the default.env file is 4096 characters.
Putting the definitions in a file given by the value of the ENVIRONMENT system environment variable.
Note: The default directory mentioned above is set using the DEFAULTDIR: Default Current Directory system environment variable.

When looking for an environment variable, all programs first search the system environment, then the default.env file, and finally the global environment file defined by ENVIRONMENT. If no definition is found, a default value is assumed.

Note: The environment may also be changed using the -Env: Set Environment Variable option.

Note: Make sure that there are no spaces at the end of any environment variable declaration.

The major sections in this chapter are: