Difference between revisions of "Command Line Switches"
From Lianjapedia
Yvonne.milne (Talk | contribs) |
Yvonne.milne (Talk | contribs) |
||
| Line 64: | Line 64: | ||
|valign="top"|--runtimedatadir||valign="top"|Runtime data directory||Specify the shared LAN directory where databases reside. You can alternatively set the environment variable LIANJA_RUNTIMEDATADIR. Note that when a "runtimedatadir" is specified then --networkshare is also implied and turned on. Introduced in Lianja v1.3.1. | |valign="top"|--runtimedatadir||valign="top"|Runtime data directory||Specify the shared LAN directory where databases reside. You can alternatively set the environment variable LIANJA_RUNTIMEDATADIR. Note that when a "runtimedatadir" is specified then --networkshare is also implied and turned on. Introduced in Lianja v1.3.1. | ||
|- | |- | ||
| − | |valign="top"|--runtimedir||valign="top"|Runtime directory||Windows: root drive or directory where lianja sub-directory contains runtime path for Apps, Library and Data, e.g. F: (where files are located in F:\lianja\cloudserver\tenants\public\...). Linux: root directory for lianja, e.g. /opt/lianja/. This is the equivalent of setting the LIANJA_RUNTIMEDIR environment variable. | + | |valign="top"|--runtimedir||valign="top"|Runtime directory||Windows: root drive or directory where lianja sub-directory contains runtime path for Apps, Library and Data, e.g. F: (where files are located in F:\lianja\cloudserver\tenants\public\...). Linux: root directory for lianja, e.g. /opt/lianja/. This is the equivalent of setting the LIANJA_RUNTIMEDIR environment variable. Note that from Lianja v1.4.1 onwards, when a "runtimedir" is specified then --networkshare is also implied and turned on. |
|- | |- | ||
|valign="top"|--splashscreen||valign="top"|Path to a custom splashscreen or "None" to disable||Specify an App specific splashscreen at runtime. Note that if --app is specified no splashscreen is displayed unless specified. | |valign="top"|--splashscreen||valign="top"|Path to a custom splashscreen or "None" to disable||Specify an App specific splashscreen at runtime. Note that if --app is specified no splashscreen is displayed unless specified. | ||
Revision as of 14:04, 20 March 2015
When creating a desktop shortcut for running Lianja Apps there are several command line options that can be specified.
The following table provides details of the currently available command line options. These can be combined to customize the running of an App e.g.
lianja --app orderprocessing --maximized lianja myprogram.dbo lianjaruntime --kiosk --fullscreen --runtimecaption "Our company Apps"
Lianja Command Line Options
| Option | Arguments | Description |
|---|---|---|
| --app | -a | App name | Run the specified App. |
| --args | Arguments | If used with a runtime script (see filename below), Arguments is a comma separated list of arguments to be passed to the script. Enclose Arguments in "..." and use single quotes for individual character arguments e.g. --args "'hello','world',2600,{04/04/1953}" If used with --app (see above), Arguments is an 'action'. For supported 'actions', see SHOWDOCUMENT(). |
| --buttonfontsize | Font size | Adjust the button font size for the App if you are using very high resolution displays and the default button font size is too big or too small. |
| --customer | Name | This will be used as the suffix to display a customized login file and a customized appcenter file. You can copy the existing login.rsp and appcenter.rsp in the cloudserver\appcenter directory and customize these with your own login captions and icons. The name is a suffix that will be appended onto the login.rsp and appcenter.rsp filenames e.g. --customer myco will look for login_myco.rsp and appcenter_myco.rsp respectively. |
| --debug | None | Run in debug mode. |
| --debugfile | Debug file name | Send debug logging to the specified file. |
| filename | None | A filename to run. If no file extension is specified. '.dbo' is assumed. |
| --fontsize | Font size | Adjust the base font size of the App if you are using very high resolution displays and the default font size is too big or too small. |
| --fullscreen | None | Run the App fullscreen. |
| --geometry | x,y,width,height | Specify the geometry of the window. |
| --icon | Window icon | Specify an App specific window icon at runtime. |
| --kiosk | None | This will run the Lianja App Center (and login) in full screen kiosk mode with no window frame or title bar. This prevents users from minimizing the window and breaking out of your App in RDP sessions and information kiosks. |
| --locale | Locale | Set the locale for the App. |
| --loginapp | App name | This will load the App immediately after login without displaying the Lianja App Center. This provides you with the ability to replace the Lianja App Center with your own that you have written as a Lianja App or alternatively run an App directly after login bypassing the App Center. |
| --maximized | None | Maximize the window. |
| --networkshare | None | Path inside the database catalog is ignored and the tables are always accessed inside the database directory. This simplifies the sharing of data across a LAN between Windows and Linux. The SET NETWORKSHARE command can also be set ON to provide the same behavior. Note: To share databases between Windows and Linux, lowercase names should always be used for the tables as Linux filenames are case sensitive. |
| --noguests | None | Prevents readonly access to the Apps using the guest/guest login (disables guest login). |
| --nosplashscreen | None | Disable splashscreen at runtime. |
| --parentpid | Parent PID | Specify the parent PID. |
| --password | Password | Specify a password for automatic login. |
| --rdp | None | This will display the login screen with a plain background (no image) and no progress bar when loading an App. |
| --reset | None | Run Lianja App Builder without restoring previous App state. |
| --runtime | None | Runs the Lianja App Center. |
| --runtimecaption | Caption text | Replaces the "Lianja App Center" caption text in the App Center Home workspace with the specified caption text. |
| --runtimedatadir | Runtime data directory | Specify the shared LAN directory where databases reside. You can alternatively set the environment variable LIANJA_RUNTIMEDATADIR. Note that when a "runtimedatadir" is specified then --networkshare is also implied and turned on. Introduced in Lianja v1.3.1. |
| --runtimedir | Runtime directory | Windows: root drive or directory where lianja sub-directory contains runtime path for Apps, Library and Data, e.g. F: (where files are located in F:\lianja\cloudserver\tenants\public\...). Linux: root directory for lianja, e.g. /opt/lianja/. This is the equivalent of setting the LIANJA_RUNTIMEDIR environment variable. Note that from Lianja v1.4.1 onwards, when a "runtimedir" is specified then --networkshare is also implied and turned on. |
| --splashscreen | Path to a custom splashscreen or "None" to disable | Specify an App specific splashscreen at runtime. Note that if --app is specified no splashscreen is displayed unless specified. |
| --title | Window title | Specify an App specific window title at runtime. |
| --username | Username | Specify a username for automatic login. |
To run a custom program specify a file extension of ".dbo". (.dbo files are pre-compiled .prg script files). Remember to add READ EVENTS at the end of the program file otherwise it will just exit and no UI will be displayed.
Note: If you are running some custom program code that is going to take a long time to complete e.g. consolidating inventory, then you can provide feedback to the user via a system tray icon on the desktop e.g.
tray = createObject("SystemTrayIcon") tray.icon = "app:/myapp.png" tray.showMessage("Message", "Consolidating inventory...") // perform some long running operation to consolidate inventory tray.showMessage("Message", "Consolidation completed...")
