To meet your needs, we constantly work to improve Querix products.
This means that Lycia documentation is developing as well.
In case you have found a certain dissonance between the provided information and the actual behavior of Lycia 3 and/or your applications, please, let us know about this via documentation@querix.com so that we can introduce the necessary changes to our documentation.
Thank you for your attention and cooperation.
There are cases when you may need to pass one or more parameters to a program, or run a program with flags. In the case of the desktop clients, the parameters are added after the program name in the connection dialog and are separated by whitespaces. The same goes for flags.
In case of LyciaWeb you cannot include the parameters into the connection dialog fields. You need to add the parameters and flags directly to the end of the program URI.
The most common reason to use flags is to change or specify the database against which the program should be run. Flag -d is used for this purpose followed by the database type keyword (i.e. informix, oracle, sserver, odbc, db2).
LyciaWeb uses the settings in the inet.env file located in C:\ProgramData\Querix\Lycia\etc\. This file is used by all GUI clients. For LyciaWeb to be able to run a program which communicated with a database, this file must include the LYCIA_DB_DRIVER variable with the value of the corresponding database type. This variable is described in details in the Lycia Developers Guide and in Lycia Getting Started document. If the database driver is set in this file, -d flag is necessary only if you want to run the program against a different database type.
If LyciaWeb is launched from within the LyciaStudio, this variable can be absent from the configuration file, because at the moment of launching the database driver is passed from the LyciaStudio. However, to be able to run clients independently from LyciaStudio, this variable must be set, or the -d flag must be used when launching a program.
To set -d flag for LyciaWeb applications and to set the database driver, to the program launching path should include the following syntax:
<program_name>?params=<parameter>
For example, to run a program against Oracle database, you can use the following line address in the URL field of the browser:
http://localhost:9090/LyciaWeb/default-1889/testconn?params=-d%20oracle
Here the parameter is the same as you pass to the programs when running LyciaDesktop or any other desktop client. In our case the parameter is "-d oracle". However, any browser will replace the white spaces with %20 symbols.
To pass several flags or parameters to a program, you should use the same syntax and add the parameters separated by whitespaces or by "%20" symbols. For example:
http://localhost:9090/LyciaWeb/default-1889/my_prog?params=-d%20informix%20John%20500
The example above passes -d flag with the "informix" value to the program together with another two parameters: "John" and "500".
Related articles: