Environment sets

Define sets of environment variables to add to or overwrite the default environment. These environment settings are also usable by each Genero Studio client that adds a remote Genero Studio Server to its list.

Select Tools > Genero Configurations to display the configurations for the currently selected server. Add and modify environment sets as needed.

Note:

If an environment set has the suffix - Imported (for example, DB - SQLite - Imported), this indicates that it was imported from older installations of Genero Studio. For further information, see Import Configuration dialog and Import Preferences dialog.

When you launch any Genero Studio sub-process (run, GDC, compilation, debug, and so on), Genero Studio sets all redefined environment variables according to the current context (the Projects context may differ from the File Browser context).

Select the name of an environment set to view or modify its variables. To add a new set of environment variables, right-click in the Environment Set area and select Add Environment Set.... To add a new variable, right-click in the Environment Variables area and select Add Environment Variable....

This figure is a screenshot of the Genero Configuration Management dialog showing environment set variables for the selected Environment Set: DB - Informix. — Figure: Environment sets

See Add or edit environment variables for more details on using the Environment Variable dialog.

Default environment sets

Some default environment sets are included.

Debug: Contains variables that set the debug level (FGLSQLDEBUG for FGL/SQL, FGLWSDEBUG for Web Services, and GREDEBUG for Report Engine). The values are already set to 9, the highest debug level, but can be changed to any number between 1 and 9. Debug files will be generated in the current directory.
DB - xxxx: Contains some variables required by database clients from the various vendors. The values for the variables must be entered before using these environment sets. See Provide database connection and user information for information about the specific variables for each database.
Important:
This feature is not supported on mobile platforms.
Global Database Schemas: The GSTSCHEMANAMES environment variable defines the schema files (4db, 4dbx, sch) to be loaded by default into the Meta-schema Manager when Genero Studio is launched. Includes setting for GSTSCHEMANAMES and FGLDBPATH. FGLDBPATH must be set according to the file path syntax of the system where files are compiled.
Java SDK: Environment settings for the installed Java SDK. Adds the Java executables path to the PATH environment variable. See Install and configure Java SDK and Android SDK.
Traditional Rendering: Specifies that the Genero client uses traditional rendering. See Configure for a GUI client.
Universal Rendering: Specifies the Genero Browser Client to use. For Genero clients 4.00 or greater, if you use the default GBC, you do not need to select the Universal Rendering environment set. However, if you specify a GBC customization, you must select and modify this environment set.; For Genero clients prior to 4.00, you must select the Universal Rendering environment set if you want to use Universal Rendering.; For more information, see Configure for a GUI client.
Profile: Contains the environment variable FGLPROFILE; for the value, enter the path of the current configuration (FGLPROFILE) file to be used by the system before enabling this environment set; the default location is FGLDIR/etc/fglprofile. If you are using a remote environment, the value should be set to the location on the remote host. See Database access.
Report Writer: Contains the environment variables set by default to the installation directory of Genero Report Engine. This set is automatically enabled, as the environment variables are required when working with reports.
Important:
This feature is not supported on mobile platforms.
Templates: Contains environment variables set by default to the template directory being used for Business Application Modeling. Includes setting for GSTSETUPDIR. See The code generation template set.
Web Components: Defines GSTWCDIR, the directory in which the web component XML files and optional icon files are stored.
Android: For Genero Mobile, environment settings for the installed Android SDK. See Install and configure Java SDK and Android SDK.
iOS: For Genero Mobile, environment settings for iOS. See Configure for iOS.
Mobile Debug Packages: For Genero Mobile, sets the DEBUG_PACKAGE environment variable to TRUE so that packages built will include options for debugging. See Debug a mobile app.
Locale: Sets the LANG environment variable. See Language support (text encoding) and Language and character set settings in the Genero Business Development Language User Guide for more information.
Studio Libraries: Contains the GSTLIBRARYDIR environment variable which specifies the location of the libraries used with the database generation script.
Term: Contains the GSTTERM (Linux, Windows) environment variable which specifies how to open a terminal on the client machine (Genero Workspace Window, for example). For some Linux operating systems which do not have xterm, use this to specify the terminal name and the arguments to launch it. The default is xterm -e (cmd /K).