In this Topic Hide
A run configuration defines how an application is launched and contains settings such as the graphical client, the GUI server, program arguments, and other launch conditions. An application can have more than one run configuration.
When an application is created or imported into LyciaStudio, it has no run configuration. A run configuration is typically created when an applicaton is run for the first time.
To manage run configurations, open the Run Configurations window in one of the following ways:
click the drop-down menu of the Run button on the launch toolbar and select Run Configurations
right-click an application in the 4GL Project view, select Run As, and click Run Configurations
Component |
Description |
Creates a new run configuration. |
|
Copies selected run configuration. |
|
Deletes selected launch configuration(s). |
|
Collapses all expanded launch configurations. |
|
Opens Launch configurations filtering preferences. The drop down menu allows to quickly select which launch configurations to filter out. |
|
Apply |
Applies the changes made to the configuration. |
Revert |
Reverts the configuration to previously saved condition. |
The "Main" tab contains general information about the run configuration. It allows to select the project and the application to which the configuration will apply, and also specify execution arguments for the application.
Component |
Description |
Project |
Specifies the name of the project. |
Program |
Specifies the name of the program. |
Arguments |
Specifies the execution arguments for an application that are passed on the command line. The arguments must be separated by white spaces. For passing arguments to qrun, use Lycia Command Line. |
The "Graphical Clients" tab allows to choose a graphical client (LyciaDesktop or LyciaWeb) for the run configuration. You can use workspace settings, or specify custom options for LyciaWeb graphical client.
Component |
Description |
Client
|
Specifies the graphical client for the configuration: LyciaDesktop LyciaWeb Use workspace settings check box Defines whether workspace settings or configuration-specific settings are used for LyciaWeb client. Is selected by default. Scheme Specifies the URI scheme. Host Specifies the host to connect to when launching LyciaWeb. Port Specifies the port. Servlet Root Specifies the servlet root. URL Preview Shows the URL with the parameters used to launch an application. |
The "GUI Servers" tab allows to choose the GUI server and the deployment path, used in the configuration.
Component |
Description |
GUI server |
Allows to choose the default server or other server from the installed ones. |
Deployment path |
Allows to choose the deployment path. The folder must be within the $LYCIA_DIR\progs directory. |
Deploy program to GUI server before launch |
Defines if the program is deployed to GUI server before launch. |
The "Common" tab lets you specify the location in which to store your run configuration and how you access it, how standard input and output is handled, and if background launches are enabled or not.
Component |
Description |
Local file |
Saves the launch configuration locally. |
Shared file |
Specifies a path in a workspace to store the launch configuration file, and be able to commit it to CVS. |
Display in favorites menu |
Defines if the configuration is shown in Run or Debug drop down menus for easy selection. |
Encoding |
Specifies the encoding scheme to use for console output. |
Allocate Console (necessary for input) |
Select to assign a console view to receive the output. |
File |
Specify file name to save output. |
Browse Workspace |
Specifies the path in a workspace to store the output file. |
Browse File System |
Specifies the path in a file system to store the output file. |
Variables |
Select variables by name to include in the output file. |
Append |
Select to append output. Clear to recreate file each time. |
Launch in background |
Select to launch configuration in background mode. |
Changing the GUI Server
Running an application
The Run/Debug Preferences