qfgl

qfgl is used to compile 4GL source files into intermediate representation modules (stored in .4o files).

Syntax

qfgl [options] file_name.4gl

Possible Options

-? [ --usage ]	displays usage information
-V [ --version ]	shows versions of the compiler and code generator as well as Lycia build number and hash value
-v [ --verbose ]	produces verbose output (detailed compilation information)
-d [ --database-driver ] arg	sets database driver for compilation
-e [ --encoding ] arg	specifies the source file encoding
-o [ --output ] arg	determines the output path
--java-option arg	passes options to the Java Virtual Machine
-N [ --no-implicit-import-compile ]	prevents implicit compilation of the file used in IMPORT FGL statement
--check-help arg	monitors references to .erm help files (OPTIONS HELP FILE <path>) and checks whether help identifiers are present (COMMAND ... HELP <id> for MENU). It accepts such values: error, warning (is default) or ignore.
--check-div-by-zero	switch on the detection of the division by zero and treat it as error
--check-kw	switches on the warnings of the check for the keywords in the variable names
--smart-type-conversions	detects type conversion errors at compile time when possible
--no-warnings	switches off all warnings

Usage and Examples

To compile a source code file a.4gl, invoke:

qfgl a.4gl

This will produce an IR module saved as a.4o to the output folder (by default, $LYCIA_DIR\bin).

If this command is invoked:

qfgl –o b.4o –d sserver a.4gl

the output will be an IR module called b.4o, and the 4GL file will be validated against an SQL Server database.

 

-d is only used for validation purposes: The compiled program can be run against any database server available, either by using qfgl -d, or by setting the LYCIA_DB_DRIVER environment variable.

 

To compile files created with non-default encoding tables, -e must be followed by the specific value:

qfgl a.4gl -e Cp1252

qfgl --check-kw switches on keyword warnings. This warning is displayed when a 4GL source file is built that includes variables which name coincide with a 4GL keyword:

 

-V is used to obtain basic info about Lycia - the version of the compiler, code generator version, Lycia build number, and hash value: