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.
set QX_VERBOSE_CACHE=1
qrun --aot <my_program>
export QX_VERBOSE_CACHE=1
qrun --aot <my_program>
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:
Runner Version: 7.1
Code Generator Version: 50
Build: 7.1.6672 00ec5b5 (rel)
Hash: 00ec5b538ab9e2fc7f3bf4e988296527c774cea6
-? 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.