variable

description

possible values and their meaning

related articles

DBCENTURY

specifies how to expand DATE and DATETIME values which were abbreviated to one or two digits:

DBCENTURY=R (default)

{R, C, F, P}

CENTURY attribute

century

DBDATE

specifies how dates are displayed on the client side:

DBDATE=MDY4/ (default)

D and M for day and month

Y2 and Y4 for year and year precision

- . /0  for separators

Date and time settings

DATE

DATETIME

DBDELIMITER

specifies the symbol that separates loaded and unloaded files in the LOAD and UNLOAD statements:

DBDELIMITER=| (default)

any character

except for {0-9, a-f, A-F, \}

LOAD
UNLOAD

DBPATH

determines paths to search for the resource files:

DBPATH=C:\Users\Lycia\workspace\Lycia\test\output

DBPATH=/opt/Lycia/workspace/Lycia/test/output

There are no predefined search paths. The paths given above are mere examples. The current working directory is searched as well as the defined paths.

<path to folder>

DBPRINT

specifies the printing device/software to be used in classic 4gl reports:

DBPRINT=printer_name

{any string}

Classic 4gl reports

PRINTER keyword

DBTEMP

defines the folder to store temporary files created by the runtime system:

DBTEMP=C:\Users\my_user\mytemp

DBTEMP=/usr/my_user/mytemp

<path to folder>

LOCATE

IN FILE clause

FGLIMAGEPATH

specifies the paths to search for images, Lycia theme files, styles, and scripts used by front end functions:

FGLIMAGEPATH=%FGLIMAGEPATH%;.;C:\Program Files\Querix\Lycia 3 Development Suite 7.1\Lycia\images  (default)

FGLIMAGEPATH=$FGLIMAGEPATH:.:/opt/Querix/Lycia/images  (default)

<path to folder>

Compiling requirements

ui.Interface.loadStyles()

FGLLDPATH

specifies the paths to search for C extensions and 4gl libraries:

FGLLDPATH=%LYCIA_DIR%\my_4gl_libs;%LYCIA_DIR%\my_4gl_libs

FGLLDPATH=$LYCIA_DIR/my_4gl_libs;$LYCIA_DIR/my_4gl_libs

<path to folder>

IMPORT

Algorithms used by IMPORT FGL

qlink

FGLPROFILE

specifies the full path to the fglprofile.std file:

FGLPROFILE=%LYCIA_DIR%\etc\fglprofile.std

FGLPROFILE=$LYCIA_DIR/etc/fglprofile.std

<path to file>

fglprofile.std

LINES and COLUMNS

specify the default size of the 4gl screen window:

LINES=24 (default)

COLUMNS=80 (default)

{any integer}

LISTENERXML

specifies the full path to the listener.xml file:

LISTENERXML=C:\ProgramFiles\Querix\AppServer\listener.xml

LISTENERXML=/usr/local/AppServer/listener.xml

<path to file>

listener.xml

LYCIA_DB_DRIVER

specifies the default database driver that will be used at runtime:

LYCIA_DB_DRIVER=informix (default)

{informix, odbc, oracle}

CONNECT TO

Connecting to multiple databases

Precedence of parameters

LYCIA_DIR

specifies the path to the Lycia installation directory:

LYCIA_DIR=C:\Program Files\Querix\Lycia 3 Development Suite 7.1\Lycia (default)

LYCIA_DIR=/opt/Querix/Lycia (default)

<path to folder>

LYCIA_DRIVER_PATH

specifies the path to search for Lycia libraries:

LYCIA_DRIVER_PATH=%LYCIA_DIR%\lib (default)

LYCIA_DRIVER_PATH=$LYCIA_DIR/lib (default)

<path to folder>

LYCIA_MSGPATH

specifies the path to search for 4gl message files:

LYCIA_MSGPATH=%LYCIA_DIR%\msg (default)

LYCIA_MSGPATH=$LYCIA_DIR/msg (default)

<path to folder>

qmsg

HELP clause for DISPLAY ARRAY

HELP clause for CONSTRUCT

showhelp()

LYCIA_POST_MORTEM_LENGTH

specifies how many last log messages are written to the application log file when an application crashes:

LYCIA_POST_MORTEM_LENGTH=5

{any integer}

inet.env

Logging configurations

LYCIA_SEVERITY

specifies the logging level for the application log file:

LYCIA_SEVERITY=error (default)

{error, warn, info, trace}

inet.env

Logging configurations

LYCIA_SYSTEM_ACTION_DEFAULTS

specifies the location of the file containing system action defaults:

LYCIA_SYSTEM_ACTION_DEFAULTS=%LYCIA_DIR%\etc\

SystemActionDefaults.fm2 (default)

LYCIA_SYSTEM_ACTION_DEFAULTS=$LYCIA_DIR/etc/

SystemActionDefaults.fm2 (default)

<path to file>

SystemActionDefaults.fm2

LYCIA_SYSTEM_RESOURCES

specifies the location of the system resources file:

LYCIA_SYSTEM_RESOURCES=%LYCIA_DIR%\etc\SystemResources.tr2 (default)

LYCIA_SYSTEM_RESOURCES=$LYCIA_DIR/etc/SystemResources.tr2 (default)

<path to file>

SystemResources.tr2

LYCIA_SYSTEM_THEME_CSS

specifies the location of the system css file:

LYCIA_SYSTEM_THEME_CSS=%LYCIA_DIR%\etc\SystemTheme.css (default)

LYCIA_SYSTEM_THEME_CSS=$LYCIA_DIR/etc/SystemTheme.css (default)

<path to file>

SystemTheme.css

LYCIA_SYSTEM_THEME_QX

specifies the location of the system theme file:

LYCIA_SYSTEM_THEME_QX=%LYCIA_DIR%\etc\SystemTheme.qxtheme (default)

LYCIA_SYSTEM_THEME_QX=$LYCIA_DIR/etc/SystemTheme.qxtheme (default)

<path to file>

SystemTheme.qxtheme

QXBREAKCH_END

specifies the character after that string is split in the Informix® compatibility mode:

QXBREAKCH_END=":" (default)

fglprofile.std

Converting classic Lycia forms

Compatibility mode

QXBREAKCH_START

specifies the character starting with which string is split in the Informix® compatibility mode:

QXBREAKCH_START="*=+-" (default)

fglprofile.std

Converting classic Lycia forms

Compatibility mode

QXDEBUG

returns debugging results to the application log file:

QXDEBUG=UuBbSsEedPptLlCcmGOzAzKzQv (full value)

{set of characters}

Logging configurations

QXREP_SPACES

specifies the maximum number of spaces any string can have (in a row) not to be split in the Informix® compatibility mode:

QXREP_SPACES=1 (default)

{any integer}

fglprofile.std

Converting classic Lycia forms

Compatibility mode

QXBREAKCH_START

QXBREAKCH_END

QX_CHILD

shows whether the application was run as a child application in the MDI mode or not

MDI mode

QX_CLIENT_HOST

holds the hostname of the client device that currently is in the interaction session with the application

{hostname of the client device}

QX_CLIENT_IP

holds the IP address of the client device that currently is in the interaction session with the application

{IP address of the client device}

QX_COMPAT

switches on the compatibility mode for 4gl applications at runtime:

QX_COMPAT=Informix4GL

{Informix4GL, Lycia, GBDS}

Compatibility mode

QX_HEADLESS_MODE

switches on the compatibility mode for 4gl applications at runtime:

QX_HEADLESS_MODE=1

{any non-empty value}

WebAPI

QX_INSECURE_PASSWORD_ALLOWED

enables setting QX_PASSWORD:

QX_INSECURE_PASSWORD_ALLOWED=false (default)

{true, false}

QX_LOGNATIVESQLERRORS

specifies which and how database errors are written to the application log file:

QX_LOGNATIVESQLERRORS=2

{1, 2, 3, 4, 5, 6, 7}

fgl_driver_error()

fgl_native_code()

fgl_native_error()

QX_MENU_WINDOW

adds an new item to the top menu - Window - that shows all the child applications currently running in the MDI mode:

QX_MENU_WINDOW=1

{any non-empty value}

MDI mode

ui.Interface.setType()

QX_MENU_WINDOW_NEW_CHILD

adds an new item to the Window menu group - New application - that opens a LyciaDesktop connection dialog to launch other applications in the MDI mode:

QX_MENU_WINDOW_NEW_CHILD=1

{any non-empty value}

MDI mode

LyciaDesktop

QX_MDI

switches on the MDI mode:

QX_MDI=1

{any non-empty value}

MDI mode

QX_NATIVE_LINKER

specifies what linker is used for creating object cache on :

QX_NATIVE_LINKER=MINGW

{MSVC, MINGW, MINGW_MSVC}

Understanding compilation basics

QX_OPT_LEVEL

specifies the level of general bitcode optimization:

QX_OPT_LEVEL=2

{0, 1, 2, 3}

QX_PASSWORD

holds the user password used for authentication:

QX_PASSWORD={your password}

{your password}

QX_QRUN_DUMP

enables creating qrun crash dumps:

QX_QRUN_DUMP=1

{any non-empty value}

qrun

QX_SERVER_HOST

holds the hostname of the server that currently is in the interaction session with the application

{hostname of the server}

QX_SERVER_IP

holds the IP address of the server that currently is in the interaction session with the application

{IP address of the server}

QX_SESSION_ID

holds the identifier on the current interaction session

{session ID}

QX_TRACE

enables the logging of function calls:

QX_TRACE=1

{any non-empty value}

QX_TRACE_ARG_DUMP

enables the logging of both function calls and their arguments:

QX_TRACE_ARG_DUMP=1

{any non-empty value}

QX_UNL

enables the building of UNL cache:

QX_UNL=1

{any non-empty value}

QX_USER

holds the user name used for authentication:

QX_USER={your user name}

{your user name}

QX_VERBOSE_CACHE

enables verbose output of results for building the object cache:

QX_VERBOSE_CACHE=1

{any non-empty value}

Compilation tools

QX_WRAPPER

enables calling 4gl functions directly from C static libraries:

QX_WRAPPER=1

{any non-empty value}

Using C API in Lycia

Compilation tools