Environment variables

Environment is a computer system in that the program is compiled or the application is run.

Environment variables are specific configurations that affect the way how programs behave at compilation and applications behave when they are run.

Lycia supports a considerable number of environment variables:

• environment variables influencing runtime appearance and behavior
• database environment variables
• environment variables that specify the location of configuration files
• environment variables that specify the location of resources and libraries
• environment variables used for debugging
• environment variables used for converting classic forms

• environment variables used for KMS server configuration

• informative environment variables

There are many ways to configure your environment.

For example, you can

• configure your environment on the system level,
• your compilation and runtime environments,
• your environment on a project and a program level.

The table below shows where you can configure your environment with Lycia:

	You compile applications with LyciaStudio	You compile applications with cmd line tools	Runtime environment
Environment as a whole	env.properties	environ.bat	inet.env
4gl project	from the project properties in LyciaStudio
4gl program	from the program properties in LyciaStudio		fgl_setenv() fgl_putent()
Current session		set ENV_VAR=value export ENV_VAR=value

To set the environment as a whole, you change the corresponding configuration files – inet.env, env.properties, and environ.bat.

To configure the compilation and deployment environment of a 4gl project or a 4gl program, you specify the necessary variables in the Build environment variables page of the project's or the program's Properties.

To configure the environment for the current command line session, you execute the corresponding command in the command line:

These variables will be applied only until the end of the session. Once you relaunch the command line, all variables will be loaded from environ.bat.

You can also set environment variables in your operation system environment, but we do not recommend this unless you have a considerable experience of such modifications.

 

When setting environment variables, please pay attention to these details.

1. Folder separators depend on the operation system - \(backslash) is used for and /(slash) for :

   LYCIA_DIR=C:\Program Files\Querix\Lycia
   LYCIA_DIR=/opt/Querix/Lycia

2. Variable indications depend on the operation system - % is used for and $ for :

   LYCIA_DRIVER_PATH=%LYCIA_DIR%\lib
   LYCIA_DRIVER_PATH=$LYCIA_DIR/lib

3. Path separators depend on the operation system - ;(semicolon) is used for and :(colon) for :

   CLASSPATH=%CLASSPATH%;$LYCIA_DIR\my_java
   CLASSPATH=$CLASSPATH:$LYCIA_DIR/my_java

4. You can update and extend environment variables by adding new values to the already existing ones:

   PATH=C:\Windows\System32;%PATH% or PATH=%PATH%;C:\Windows\System32
   PATH=C:/Windows/System32:$PATH or PATH=$PATH:C:/Windows/System32

5. A .(full stop) - once added to the path value - indicates the current directory:

   FGLIMAGEPATH=%FGLIMAGEPATH%;.;%LYCIA_DIR%\images