Workbench User Guide : 16. Managing and Deploying Applications : Running an Application : How You Can Set Metaflags for the RunDBApp and RunImage Utilities
 
Share this page                  
How You Can Set Metaflags for the RunDBApp and RunImage Utilities
For the RunDBApp and RunImage utilities, you can set metaflags that provide more advanced features. You can specify a metaflag only on the RunDBApp and RunImage command lines.
Metaflags begin with “-/” and they must appear after all other command line parameters because their “value” is terminated by either the next metaflag or by the end of the command.
The available metaflags for RunDBApp and RunImage and their possible values are:
-/dbmsflags dbmsflags
Specifies initial DBMS connection flags for the applications. The string of flags following this metaflag overrides the string of DBMS flags that was specified in the application's Property Inspector.
-/appflags appflags
Passes parameters to your application. These parameters are placed in the AppFlags attribute of the SessionObject of the running application.
Note:  Appflags contains an array of appflag objects. Each appflag object consists of a name, and an array of values.
Application parameters may be of the following kinds:
Positional parameters
A parameter is positional if there is no equal sign (=) in its first 32 characters. All other parameters are keyword parameters.
Keyword parameters
A keyword parameter is assigned the values that come after the equal sign (possibly separated by commas if an array of values is used).
Appflags are subject to the following restrictions:
Values and names must not contain a space, tab, newline, carriage return, quote, apostrophe, comma, or the equal sign.
Names must not exceed 32 characters.
Note:  If these rules are violated, the behavior is undefined.