A script-enabled browser is required for this page to function properly.

Starting Oracle Forms Components from the Command Line

To start any Oracle Forms component from the command line, enter this statement at the system prompt:

component_name [module_name] [userid/password] [parameters]

where:

component_name Specifies the Oracle Forms component you want to use:

Starting Oracle Forms Components Examples

To indicate that foreign functions accessible through the user exit interface have been linked into the executable, add an x to component_name.

module_name Specifies the module you want to load: a form, menu, or library name. If you omit the module name, Oracle Forms displays a dialog allowing you to choose the module to open.

userid/password Specifies your ORACLE username and password.

parameters Specifies any optional command line parameters you want to activate for this session. Optional parameters are entered in this format: keyword1=value1 keyword2=value2...

Keyword Usage

There are three categories of parameters in Oracle Forms:

The first two parameters, MODULE and USERID, are unique because you can use either positional or keyword notation to enter them. Use keyword notation to enter optional parameters, on the command line. (Many optional parameters can also be set using dialogs.) Form parameters are optional input variables that are defined at design time for a specific form.

MODULE and USERID

If you enter the first two parameters, MODULE and USERID, in the specified order, you may omit the keywords and enter only values, as shown in the following example:

frmweb custform scott/tiger

Invalid Example:

frmweb scott/tiger

This sequence is invalid because the value for username/password is out of sequence, so it must be preceded by the USERID keyword. To use positional notation instead of keywords would require inserting the value of the MODULE parameter immediately after the component name, as in the previous example.

Valid Examples:

frmweb module=custform userid=scott/tiger
frmweb userid=scott/tiger
frmweb

If you indicate only the module name, Forms Developer will prompt you for module name and username/password.

 

Options

Use keyword notation for setting options on the command line. For information on options, see:

Setting Forms Runtime Options

Setting Form Compiler Options

Setting Oracle Forms Options

The following syntax rules apply to all keyword parameters, including options and form parameters:

Form Parameters

Form parameters are variables that you define at design time. Form parameters provide a simple mechanism for defining and setting the value of inputs that are required by a form at startup. Operators can specify values for form parameters by entering them on the command line using standard command line syntax.

The default value for a form parameter is taken from the Default Value field of the Properties window. The operator can override the default value when starting Forms Runtime by specifying a new value for the form parameter on the command line.

In the following example, myname_param is a user-defined form parameter that was defined in Oracle Forms.

Note: If a form parameter value includes a space or punctuation, enclose the value in double quotes.

Displaying Hint Text on Command Line Options

To receive help on syntax and parameters, type the component name followed by help=yes at the system prompt.