qrun

 

qrun command is used to generate and execute native object cache.

 

Syntax:

 

qrun [options] file_name.extension

 

Possible options:

 

-? [--usage]

displays usage information

-V [--version]

shows the runner version, the Lycia build number, and the 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

enables creating object cache

--unl

enables UNL cache

 

Usage and examples:

 

The qrun command is used to generate and execute native object cache.

 

To run a 4GL application, execute the following command (one of the three options is possible):

 

qrun file_name.4o

runs the compiled fgl module

qrun file_name.exe

runs the application in

qrun file_name

runs the application in

 

The following command will run a 4GL application against an Informix database:

 

qrun –d informix file_name.4o

 

By default, 4GL applications will be linked with an appropriate loader for the system on which they were compiled. This means that there is no need to invoke the runner on the platform where the 4GL application was compiled.

For example, on we can run a 4GL application simply as:

 

my_program.exe

 

On , we can run an 4GL application as:

./my_program

 

Even though 4GL applications can be run in this manner, they are still portable between different operating systems. However, when moving a 4GL application between Windows/Unix, you have to run it as follows:

 

qrun my_program

 

To enable verbose output of results for building object cache to command line, 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 can also be enabled using the QX_UNL environment variable. --unl and --aot  can be used together: 

 

qrun --aot --unl <my_program>

 

-? and -V are considered by qrun as final tasks, and other options are ignored.

 

 

Related articles:

Building and Compiling Programs from Command Line

QX_VERBOSE_CACHE

QX_UNL

Stages of compilation