Passing parameters and using flags

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.

 

With 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.

Database flags

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\. 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. 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 this syntax:

<program_name>?params=<parameter>

For example, to run a program against Oracle database, you can use this line address in the URL field of the browser:

http://localhost:9090/LyciaWeb/default-1889/testconn?params=-d%20oracle

When you specify an application name, be careful with its case.

UNIX is case-sensitive, so it will treat applications which names come in different cases as separate files.

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.

Multiple parameters

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".

 

Contact Us

Privacy Policy

Copyright © 2024 Querix, (UK) Ltd.