qrun

qrun command is used to generate and execute native object_cache.

Syntax:

qrun [options] file_name.extension

Possible options:

-? [--usage]	displays the usage information for the command (= help)
-V [--version]	shows the runner version, code generator version, Lycia build number, and hash value
-d [--database-driver ] arg	sets the database driver
--anyerr	makes the runner set the status variable after evaluating expressions (overriding the WHENEVER ERROR statement in the code)
--java-option arg	passes arguments to the Java Virtual Machine
-D [--debug ] arg	passes arguments to the debugger
--aot	creates the object_cache
--unl	enables creating the debug cache
--loader	changes the loader
--defloader	changes the loader to the default loader of the operating system currently used
-o	define the output for cross-system deployment (will work only in combination with --loader or --defloader)
--clear	deletes all the outdated cache objects from the object_cache folder

Usage and examples

The qrun command is used to generate and execute native object_cache.

To run a 4GL application, execute one of the three commands:

qrun file_name.4o	runs the compiled 4gl module
qrun file_name.exe	runs the application on
qrun file_name	runs the application on

This command runs a 4GL application against the Informix database:

qrun –d informix file_name.4o

All the applications are loaded by a certain loader.

If you want to load the application by the default loader of the operating system, you do not need any additional options:

However, you can specify the specific loader, if necessary:

qrun --loader <needed_loader.exe>

To switch back to the default loader of the OS, --defloader option is used:

qrun --defloader

Switching between loaders is usually needed only for the cross-system deployment.

If you change the loader, you must define the output with the -o option (you must perform an extra operation of renaming the output file - e.g., from program.exe to program (for deploying on ):

qrun --defloader <output_file> <input_file>

For example, then deploying an application from to , you will execute this command:

qrun --defloader -o test_program test_program.exe

To enable verbose output of results when building object cache to command line, you must set the QX_VERBOSE_CACHE environment variable and use the --aot option.

UNL cache is enabled by using --unl and --aot together (or by setting the QX_UNL environment variable): 

qrun --aot --unl <my_program>

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

-? and -V are considered as final tasks - qrun will ignore all other options.

--clear is used to delete old and outdated versions of an application from the object_cache folder and keep only the latest version.