This chapter contains the following sections:
The Fusion Middleware Control is a Web-based tool that you launch from your default browser. The default URL is:
http://<example.com>:7001/em
Use the Web-based Oracle Fusion Middleware Control to:
Monitor metrics for a Forms Services instance. See Section 13.1.1.1, "Monitoring Forms Services Instances" for more information.
Manage user sessions. See Section 4.4, "Managing User Sessions" for more information.
Configure parameters for a Forms Services instance. See Section 4.2.2, "Configuring Parameters with Fusion Middleware Control" for more information.
Configure Forms Trace and monitor trace metrics. See Section 12.2, "Enabling and Configuring Forms Trace" and Section 12.6, "Taking Advantage of Oracle Diagnostics and Logging Tools" for more information.
Configure multiple environment files. See Section 4.3, "Managing Environment Variables" for more information.
Configure and use JVM pooling. See Section 10.8, "Managing JVM Pooling from Fusion Middleware Control" for more information.
To perform most management tasks for a Forms instance using Fusion Middleware Control, you start by navigating to the Forms home page in Fusion Middleware Control.
To navigate to the Forms Home page in Fusion Middleware Control:
Navigate to the home page for the Fusion Middleware Control that contains the Forms instance you want to manage.
For introductory information about using the Fusion Middleware Control, see "Overview of Oracle Fusion Middleware Administration Tools" in the Oracle Fusion Middleware Administrator's Guide.
Expand the navigation side panel and expand the Forms node. Click the link for the Forms instance you want to access.
The Forms Home page provides information on the Forms applications that are deployed on the Forms instance. Table 4-1 describes the information displayed on the Forms Home page.
Table 4-1 Forms Deployment Fields
Field | Description |
---|---|
Forms Application |
Lists the names of the Forms applications that are deployed on the Oracle WebLogic Server instance. Click the name to view the Forms application home page. |
WLS Instance |
Name of Oracle WebLogic Server instance where the application is deployed. |
Status |
Indicates the status of the forms application. A green up arrow indicates the application is running. A red down arrow indicates the application is not started. |
Number of Forms Sessions |
Displays the number of active forms sessions. |
Servlet URL |
Displays the URL for the Forms servlet. |
New Connections |
Indicates whether new connections are enabled or not. |
Web Configuration |
Link to the Web Configuration page. |
Environment Configuration |
Link to the Environment Configuration page. |
Fonts and Icon Mapping |
Link to the Fonts and Icon Mapping page. |
Servlet Logs |
Link to the Servlet Logs. |
Prestart Scheduling |
Link to the Prestart scheduling page. |
To access the Forms Menu in Fusion Middleware Control:
Navigate to the Forms home page in Fusion Middleware Control.
Click Forms on the top left. This displays the Forms Menu. Table 4-2 lists the Menu Selections that are available in the Forms Menu.
Select | To Display |
---|---|
Home |
Forms Home page. This page displays a list of the Forms deployments and their details. This page also displays the Response and Load statistics and a set of useful links in the Resource Center. |
Monitoring - Performance Summary |
Performance Summary page. This page displays a set of default performance charts that show the values of specific performance metrics. For more information, see the Oracle Fusion Middleware Performance Guide. |
Monitoring - Servlet Log |
Log Messages page. Oracle Fusion Middleware components generate log files containing messages that record all types of events. |
JVM Controllers |
JVM Controllers page. This page is used to manage the JVM controller for the Forms instance. |
Schedule Prestart |
Prestart scheduling page. This page is used to manage Forms prestart scheduling. |
User Sessions |
User Sessions page. This page is used to monitor and trace User Sessions within a Forms instance. |
Web Configuration |
Web Configuration page. This page is used to configure deployment of Forms applications and manage configuration sections and parameters in |
Trace Configuration |
Trace Configuration page. This page is used to manage the settings used for tracing of user sessions. |
JVM Configuration |
JVM Configuration page. This page is used to modify the JVM controllers that can be subsequently spawned for the Forms instance. |
Environment Configuration |
Environment Configuration page. This page is used to manage environment variables that define environment settings for Forms run time. |
Fonts and Icons Mapping |
Fonts and Icons Mapping page. This page is used to change, add, or delete parameters in the Registry.dat file. |
Security |
Displays information about the following:
|
General Information |
Displays information about the Target Name, Version, Oracle Home, and Host. |
Note:
For the pages that include a Help icon, click the Help icon to access the page-level help. The page-level help describes each element in the page.Use the Web Configuration page in Fusion Middleware Control to configure deployment of Forms applications by modifying formsweb.cfg
.
To access Web Configuration page:
Access Fusion Middleware Control.
From the Fusion Middleware Control main page, click the Target Navigation link to expose the navigation side panel.
In the tree, expand the Forms node and click on the instance you want to configure.
From the Forms page and in the Forms Deployments table, click on Web Configuration.
The Web Configuration page (Figure 4-2) is displayed.
See Table 4-3 and Table 4-4 for the tasks that you can do.
Note:
As with most Web applications, it is easy to lose unsaved changes by switching pages. Be sure to save any changes you make through Fusion Middleware Control to Forms configuration or environment files before proceeding to other pages.The length of time it takes for changes to be saved is affected by the number of lines you have changed. For example, an additional fifty lines of comments takes longer to save than just the deletion of a single entry.
Table 4-3 describes the common tasks that you can do to edit configuration with the sections of a configuration file and their parameters.
Table 4-3 Common Tasks for Working with Configuration Sections
Task | Description | Comment |
---|---|---|
Create Like |
Creates a copy of a configuration section. |
Use to create a configuration section based on the parameters of an existing configuration section. |
Edit |
Opens the Edit Description dialog. |
Allows editing of the text description of a configuration section. |
Delete |
Opens the Confirmation dialog when deleting a configuration section. |
Irrevocably deletes a configuration section and its contents when you click Delete in the Confirmation dialog. |
Create |
Opens the Create Section dialog. |
Creates a configuration section. You must supply a required name and an optional description for it. |
Table 4-4 describes the tasks that you can do to modify the parameters within a named configuration section:
Table 4-4 Common Tasks for Working with Parameters
Task | Description | Comment |
---|---|---|
Show |
Drop down list for selecting named groups of parameters in a configuration section. |
Use for viewing and editing groups of parameters. The groups of parameters include:
For more information, see Section 4.2.5, "Forms Configuration Parameters". |
Revert |
Enables you to revert all changes made to parameters in a configuration section since the last apply. |
Does not allow you to revert individual changes in a configuration section. |
Apply |
Applies and activates all changes made to parameters in a configuration section. |
Once applied, you cannot revert changes to individual parameters. |
Hide Inherited |
Enables you to hide or display parameters that are inherited from a parent configuration section. |
Use this to view parameters that have been explicitly added to a configuration section or to view all parameters (including those that are inherited from the default section). |
Add |
Displays the Add Parameter dialog. |
Add a parameter to a configuration section based on a mandatory name and an optional value and description. |
Delete |
Deletes a parameter. |
There is no Confirmation dialog. Once applied, you cannot revert changes to individual parameters. |
Override |
Allows overriding and editing of a parameter which is inherited from the default section. |
Click Apply to save and activate your changes. |
For a description and the location of the Forms servlet configuration file (formsweb.cfg
), see Section 3.2.1.2, "formsweb.cfg".
Three configuration parameters specify files. Of these, two baseHTML parameters must point to appropriate .htm
files. Typically, the following values and their parameters should appear in the default configuration section, as shown in Table 4-5.
Table 4-5 Default Configuration Parameters that Specify Files
Parameter | Value | Default location when path not specified |
---|---|---|
baseHTML |
|
|
baseHTMLjpi |
|
|
basejnlp |
|
|
envFile |
|
|
baseSAAfile |
|
|
All of these parameters specify file names. The default path are specified in the table above.
This section describes creating, editing, duplicating, and deleting named configuration sections.
You can create a configuration section in formsweb.cfg
from the Web Configuration page of Fusion Middleware Control. These configurations can be requested in the end-user's query string of the URL that is used to run a form.
To create a configuration section:
Start the Fusion Middleware Control.
From the Fusion Middleware Control main page, click the link to the Forms Services instance that you want to configure.
From the Forms menu list, select the Web Configuration.
From the Change Center menu, select Lock & Edit to start editing the configuration.
Note:
Lock and Edit makes sure that you are not overwriting others changes. Only one person can make changes per transactional unit.In case you dont want to save the changes, you can click on Undo All Changes in the Change Center menu.
Click Create at the top of the Web Configuration region.
The Create Section dialog appears.
Enter a name and description for the configuration section and click Create.
Note:
The name must not contain any special characters such as #, *.The configuration section is added.
To activate the changes, click Activate Changes.
For example, to create a configuration to run Forms in a separate browser window with the Oracle
look and feel, create a section called sepwin and add the following parameters from Table 4-6:
Table 4-6 Sample Parameters to Add to a Configuration Section
Parameter | Value |
---|---|
form |
|
separateFrame |
|
lookandfeel |
|
Your users would type the following URL to launch a form that uses the "sepwin" (or the name you applied) configuration:
http://server:port/forms/frmservlet?config=sepwin
You can edit the description (comments) for a named configuration from the Web Configuration page.
Note:
You can make a backup of the configuration section you are about to edit by duplicating it first. For more information, see Section 4.2.3.3, "Duplicating a Named Configuration"To edit a named configuration description:
In the Web Configuration region, select the row containing the configuration section you want to edit.
Click Edit.
The Edit Description dialog appears.
Enter the text for the comment.
Click Save.
The Edit Description dialog box is dismissed, and your changes are saved.
You can make a copy of a named configuration for backup purposes, or create configuration sections from existing configurations or other duplicates.
To duplicate a named configuration:
In the Web Configuration region, select Create Like.
In the Create Like dialog, from the Section to Duplicate menu list, select the name of an existing configuration section you want to duplicate.
In the New Section Name field, enter a name for the configuration section. The name for the configuration section must be unique.
Click Create.
A section with the same parameters, parameter values and comments of the section you are duplicating is created.
When you delete a named configuration, you delete all the information within it. If you only want to delete specific parameters, see Section 4.2.4, "Managing Parameters".
To delete a named configuration:
From the Web Configuration region, select the row of the configuration section you want to delete.
Click Delete.
The Confirmation dialog appears.
Click Delete.
The configuration section is deleted.
Oracle Enterprise Manager returns to the Web Configuration page and displays the remaining configurations.
Note:
You cannot delete the Default configuration section.Use Fusion Middleware Control to manage parameters within a named configuration. You can add, edit, or delete parameters from the Section pane of Fusion Middleware Control.
To edit a new or overridden parameter in a configuration section:
From the Web Configuration region, select the row of the configuration section that contains the parameter(s) you want to edit.
In the Section region, select the parameter group from the Show menu list. The parameters of the group are displayed.
Select the row of the parameter you want to edit. Enter the Value and Comments.
Note:
You can edit new or overridden parameters. Inherited parameters must first be overridden so they can be edited. In Figure 4-3,test1
is an example of a new parameter and lookandfeel
is an example of an overridden parameter.Click Apply to save the changes or Revert to discard them.
To add a parameter to a configuration:
In Fusion Middleware Control, from the Web Configuration region, select the configuration section row to which you want to add a parameter.
Click Add to add a parameter.
The Add dialog box is displayed.
Enter the Name, Value and Comments for the parameter.
Click Create to add the parameter.
Click Apply to save the changes or Revert to discard them.
To delete a parameter in a configuration:
In Fusion Middleware Control, from the Web Configuration region, select the configuration section row that contains the parameter you want to delete.
In the Sections region, from the Show menu list, select the parameter group that contains the parameter you want to delete.
Select the row that contains the parameter you want to delete.
Click Delete.
Click Apply to save the changes or Revert to discard them.
Note:
You can delete/edit multiple parameters at a time.Note:
You can only delete user-defined parameters. Inherited parameters (such asenableJavascriptEvent
in Figure 4-3) cannot be deleted.Note:
When you delete an overridden parameter, the parameter is not deleted but instead regains its inherited status.The section provide information about Forms configuration parameters. These parameters can be specified in the Forms configuration file (formsweb.cfg
), as described in preceding sections. Many of these parameters can also be specified in the URL. Parameters that cannot be specified in the URL are listed in Section 4.2.5.9. A value in the URL overrides a value from formsweb.cfg
. The following notes apply to all the parameter tables from Section 4.2.5.1 to Section 4.2.5.7:
Required/Optional: A parameter is required if the Forms Services requires a non-null value (from formsweb.cfg
or, where allowed, from the URL) to function correctly.
Default values: For required parameters, the parameter description lists the default value from the default section of the formsweb.cfg
that is shipped with the Forms product (or at least indicates that it specifies an appropriate value).
For optional parameters, the parameter description may show a non-null default value from the default section of the formsweb.cfg
that is shipped with the Forms product. In addition, the parameter description may show the default value that is assumed if no value is specified. (This is the non-null value that produces the same behavior as a null value). When the description for an optional parameter simply shows an unqualified default value, the implication is that this value is both the default value from the default section of the formsweb.cfg
that is shipped with the Forms product, and also the default value that is assumed if no value is specified.When the description for an optional parameter does not explicitly specify a default value, the implication is that the default value is null.
Runform parameters: The descriptions for some parameters indicate that they are runform parameters. They are passed to the frmweb process using the serverArgs applet parameter. For such a parameter, the syntax rules documented in Section 3.3.4 must be adhered to when specifying a value that contains special characters.
Sub-arguments for otherparams: The descriptions for some parameters indicate that they are sub-arguments for otherparams. That means that in order for the parameter to take effect (when specified in formsweb.cfg
or the URL), it must appear in the form "name=%name%
" within the value of the otherparams parameter. So, for example, if you are adding the parameter "array" (with a value of "no") to a configuration section, you must also add "array=%array%
" to the value of the otherparams parameter.
Note that these parameters are all runform parameters (since the otherparams parameter is itself a runform parameter), and so the syntax rules documented in Section 3.3.4 must be adhered to when specifying a value that contains special characters.
This section includes:
These basic parameters control the behavior of the Forms servlet. These parameters are described in Table 4-7:
Table 4-7 Basic Configuration Parameters
Parameter | Required/ Optional |
Parameter Value and Description |
---|---|---|
Required |
Specifies the name of the environment configuration file. Default value from |
|
Required |
Specifies the name of the top level Forms module (fmx file) to run. Default value from |
|
Required |
Specifies the height of the form applet, in pixels. Default value from You can also specify the value of the height in percentage. This value is relative to the sixe of the content area of the browser. The value should not exceed 100% or be less than 1%. To use a percentage value, the numeric value must be followed by a percentage (%) sign as shown in the following example: HEIGHT= 75% This example means that the applet height is 75% of the size of the browser's content area. |
|
Optional |
Login string. For example: |
|
Required |
Specifies the width of the form applet, in pixels. Default value from You can also specify the value of the width in percentage. This value is relative to the sixe of the content area of the browser. The value should not exceed 100% or be less than 1%. To use a percentage value, the numeric value must be followed by a percentage (%) sign as shown in the following example: WIDTH= 75% This example means that the applet width is 75% of the size of the browser's content area. |
Table 4-8 Single Sign-On Configuration Parameters
Parameter | Required / Optional |
Parameter Value and Description |
---|---|---|
|
Optional |
Specifies the parameter to hold the name of query parameter on OAM Logout URL that holds the landing URL Default is |
Optional |
Specifies the Cancel URL for the dynamic resource creation page. |
|
Optional |
Specifies whether dynamic resource creation is enabled if the resource is not yet created in the OID. Default value is |
|
Optional |
Specifies the URL to redirect to if |
|
|
Optional |
Specifies if the session should be logged out while exiting. Default is |
|
Optional |
Specifies the URL which the browser should be redirected to after logout. Default is |
Optional |
Specifies whether the URL is protected in which case, Default value is |
|
Optional |
Specifies whether session should operate in proxy user support or not. Set Default value is |
Table 4-9 Trace Configuration Parameters
Parameter | Required/ Optional |
Parameter Value and Description |
---|---|---|
Optional |
Allows running in debug mode. Default value is |
|
Optional |
Indicates whether End User Monitoring integration is enabled. Default value is |
|
Optional |
Indicates where to record End User Monitoring data. |
|
Optional |
Specifies the host for the debugging session. This parameter should be used for debugging purposes only. It identifies the host on which the forms engine process is started. This parameter is a runform parameter. |
|
Optional |
Supports tracing and logging. The value of this parameter, if set, is the file name of the trace log file. This parameter is a sub-argument for otherparams. |
|
Optional |
Port to use for debugging. This parameter should be used for debugging purposes only. The value of this parameter identifies the port on which the forms engine process is listening. If not specified, the default value is 9000. This parameter is ignored if serverURL has been specified. This parameter is a runform parameter. |
|
Optional |
Supports tracing and logging. This parameter is a sub-argument for otherparams. |
|
Optional |
Supports tracing and logging. This parameter is a sub-argument for otherparams. |
These parameters are for use with Oracle Java Plug-in.
Table 4-10 Oracle Java Plug-in Configuration Parameters
Parameter | Required/ Optional |
Parameter Value and Description |
---|---|---|
Required |
Comma-delimited list of archive files that are used or downloaded to the client. For each file, include the file name if the file is in the codebase directory, or include the virtual path and file name. Default value for |
|
Required |
Virtual directory you define to point to the physical directory Default value from |
|
Optional |
Indicates where icon or image files are stored. Valid values:
Default value from |
|
|
Required |
Indicates which Java version is to be used on the end-user environment. Default value is |
Required |
Oracle Java Plug-in class ID. |
|
Required |
Oracle Java Plug-in codebase setting. |
|
Optional |
Oracle Java Plug-in download page. Default value is |
|
Required |
Parameter related to version of Java Plug-in. Default value is |
|
|
Optional |
Indicates whether or not Web Start should be enabled. |
Table 4-11 HTML Page Configuration Parameters
Parameter | Required/ Optional |
Parameter Value and Description |
---|---|---|
Required |
Used as the base HTML file, if the client browser is not on MS Windows and/or does not support the <OBJECT> tag. Default value from |
|
|
Optional |
If using Web start or embedded JNLP client deployment, value should be |
Required |
Physical path to HTML file that contains Java Plug-in tags. Used as the base HTML file if the client browser is on MS Windows and supports the <OBJECT> tag. Default value from |
|
|
Optional |
If using Forms Standalone Launcher, value should be |
Optional |
HTML content to add to the page below the area where the Forms application is displayed. |
|
Optional |
HTML content to add to the page above the area where the Forms application is displayed. |
|
Optional |
Attributes for the <BODY> tag of the HTML page. |
|
Optional |
HTML page title, attributes for the BODY tag, and HTML to add before and after the form. Default value from |
These parameters are specified in the baseHTML file as values for object or applet parameters. They describe the visual behavior and appearance of the applet.
Table 4-12 Applet or Object Configuration Parameters
Parameter | Required/ Optional |
Parameter Value and Description |
---|---|---|
Optional |
Specifies the image file that should appear in the background. Set to |
|
Optional |
Determines the application's color scheme. Legal values: Note: |
|
Optional |
Specifies the image file that should appear at the Forms menu bar. Set to |
|
Optional |
Determines the applications look-and-feel. Legal values: Default value from |
|
Optional |
Determines whether the applet appears within a separate window. Legal values: |
|
Optional |
Specifies the image file that should appear before the applet appears. Set to To set the parameter include the file name (for example, myfile.gif) or the virtual path and file name (for example, images/myfile.gif). |
|
Optional |
This parameter determines the visibility of the default windows menu bar and the Windows title bar. Possible values: 0,1,2,3. Default value is 0. At the default value, the default Windows menu bar and the Windows title bar are visible. Note: This parameter is applicable for a menubar only when no menu is specified for a form in the Forms Builder; if there is any menu associated with the form, then this parameter is not applicable. In case of window-bars, this parameter is applicable even if there is a menu specified for that form in the Forms Builder. For more information about |
|
|
Optional |
Determines if the Forms separate frame will start centered on the screen. When used in conjunction with This is not supported with Web start. Default value is |
|
Optional |
Determines if the Forms separate frame will remain on top of all other open windows. When used in conjunction with This is not supported with Web start. Default value is |
|
Optional |
Determines if the Forms separate frame resizing ability can be enabled or disabled. When used in conjunction with |
Table 4-13 Advanced Configuration Parameters
Parameter | Required/ Optional |
Parameter Value and Description |
---|---|---|
Optional |
Determines if an alert dialog should be presented if the system clipboard is inaccessible. Setting to Default value is |
|
Optional |
Determines whether new Forms sessions are allowed. This is also used by the Forms Home page in Fusion Middleware Control to show the current Forms status. Default value is |
|
Optional |
Configuration for JavaScript integration. This is name of the Forms applet that can be used to refer to it from a JavaScript code. |
|
Optional |
Set this parameter to Default value if not specified is |
|
Optional |
Set this parameter to Default value if not specified is |
|
Optional |
Specifies the dots per inch (DPI) and overrides the DPI setting returned by the JVM, allowing you to manage varying DPI settings per platform. Oracle recommends that you use an integer between 50 and 200. |
|
Optional |
This is the URL shown in the HTML page that is not allowed to start a session. |
|
|
Optional |
To modify the cursor blink rate, or disable blinking, set the client parameter |
|
Optional |
Set this parameter to indicate the name of the custom colorscheme created in Registry.dat. Setting this will override the colorscheme parameter. |
Optional |
Set this parameter to Default value if not specified is |
|
Optional |
Specifies the character set to be used in servlet requests and responses. Defaults to ISO-8859-1 (also known as Latin-1). Ignored if the servlet request specifies a character set (for example, in the content-type header of a POST). The values of this parameter may be specified either as an IANA character set name (for example, SHIFT_JIS) or as an Oracle character set name (for example, JA16SJIS). It should match the character set specified in the NLS_LANG environment variable, and it should also be a character set that the browser can display. Also, if the browser allows multibyte characters to be entered directly into a URL, for example, using the IME, as opposed to URL escape sequences, and to allow end users to do this, then the value of this parameter should match the character set that the browser uses to convert the entered characters into byte sequences. Note: If your configuration file contains configuration sections with names that contain characters other than 7-bit ASCII characters, then the following rules apply. If a config parameter is specified in a URL or in the body of a POST request with no specified character set, and the value contains non-7-bit ASCII characters, then the value is interpreted using a character set named in the defaultcharset parameter. However, only the language-dependent default section and the language-independent default section of the configuration file is searched for the defaultcharset parameter. No other configuration section is searched because the name is not yet known. |
|
Optional |
Determines the BIDI digitSubstitution. Permissible values are |
|
Optional |
Set this parameter to You can also add this parameter in
In the tag
Default value if not specified is |
|
Optional |
Forms applet parameter. Default value is |
|
Optional |
Configuration for JavaScript integration. Default value is |
|
Optional |
Set this parameter to Default value is |
|
Optional |
Forms applet parameter that specifies the class that the Forms client uses to enable recording of Forms messages for Tool Vendor Interface (TVI) / Intercept Server. |
|
Optional |
Use this parameter to set the frequency at which a client sends a packet to the server to indicate that it is still running. Define this integer value in minutes or in fractions of minutes, for example, 0.5 for 30 seconds. Default value, if not specified, is 2 minutes. If the Note: It is not recommended to set the value of |
|
|
Optional |
Specifies whether or not the Forms activity bar (also known as progress bar) should be hidden. Default value is |
|
Optional |
Determines if Java exceptions should not be displayed to the end-user in both the Java console and error message dialog. Default value is |
Optional |
When |
|
Optional |
This parameter defines the delimiter for parameters in the base HTML files. Default delimiter is |
|
|
Optional |
Indicates how much idle time can elapse before a |
Optional |
Configuration variable that indicates if Default value is |
|
Optional |
Applet parameter for Oracle Java Plug-in. A value of true causes a running applet to be reused when requested. This parameter also affects the contents of the initial page that is generated as the response from the Forms servlet, to ensure the reusability of the applet when Default value is |
|
|
||
|
Optional |
Use this parameter to set the frequency at which a client sends a packet to the server to indicate that it is still running and check for new events that might have occurred. This parameter is similar to HEARTBEAT, however is represented in milliseconds, whereas HEARTBEAT is represented in seconds. Setting this value too low will cause a significant increase in network traffic and therefore should be use cautiously. |
Optional |
This specifies the maximum allowable number of concurrent Forms run-time processes. It should be set a value that reflects the customer's hardware configuration (and the portion that can be used by Forms applications). A value of 0 (the default) indicates that there is no explicit limit. This default is not recommended, because it leaves the system vulnerable to Denial of Service attacks. Default value if not specified is 0. |
|
Optional |
Number of times client should retry if a network failure occurs. Default value is 0. |
|
Optional |
Set this parameter to This network statistics feature is enabled only when this parameter is defined in the baseHTML files. Default value is |
|
Optional |
For internal use only. Default value is no. This parameter is a sub-argument for otherparams. |
|
Optional |
This setting specifies command line parameters to pass to the Forms run-time process in addition to form and userid. This parameter is a runform parameter. Default value from Note: Special syntax rules apply to this parameter when it is specified in a URL: a + may be used to separate multiple name=value pairs (see Section 3.3.4, "Specifying Special Characters in Values of Runform Parameters" for more information). For production environments, to provide better control over which runform parameters, end users can specify in a URL, include the otherparams parameter in the value of the restrictedURLparams parameter. |
|
Optional |
Set the value to This feature is enabled only when this parameter is defined in the baseHTML files. Default value is |
|
Optional |
This parameter indicates the maximum amount of time (in milliseconds) that the pingStats parameter must wait for in order to receive a response from the server. This feature is enabled only when this parameter is defined in the baseHTML files. Default value if not specified is 300. |
|
Optional |
The number of run-time processes to be created when the number of prestarted run-time processes is less than minRuntimes. Default value if not specified is 1. |
|
Optional |
Number of the run-time processes that should be spawned initially. Default value if not specified is 1. |
|
Optional |
Minimum number of run-time processes to exist in the pool. Default value if not specified is 0. |
|
Optional |
Run-time prestarting or pooling is enabled only if true. Default value if not specified is |
|
Optional |
Time in minutes after which all the prestarted processes of this pool (configuration section) is stopped. A run-time process is removed from the prestart pool after the client connection is made and thus is not stopped. Default value if not specified is 0. |
|
Optional |
Set this parameter to Default value if not specified is |
|
Optional |
Set this parameter to Default value if not specified is |
|
Optional |
Forms applet parameter that specifies the name of file (for example, d:\temp\is) that stores the recorded Forms messages. Default value if not specified is |
|
Optional |
Forms applet parameter. Specifies a comma-delimited list of parameters which is rejected if specified in a URL. Default value from |
|
Optional |
Forms applet parameter. Specifies a comma-delimited characters that is restricted for use in the request URL's query string. |
|
Optional |
Set this Forms applet parameter to TRUE in order to prevent Java Beans or PJCs that display modal dialogs/windows from blocking the Forms heartbeat. Default value is |
|
|
Optional |
Required for audio support. Default value is |
Optional |
Forms applet parameter. Default value is |
|
Required |
Determines the URL path to Forms Listener Servlet. Default value is |
|
|
Optional |
Set this Forms applet parameter to an integer value greater than 0 to set the tab stop size for multi-line text fields. It should not be set to a value greater than the total character width of any field in which tabs are expected to be used. Setting this parameter will apply to all multi-line text fields in the application. Default value is |
Optional |
The full path of a custom key binding file (to be used instead of the standard This parameter is a sub-argument for otherparams. |
The guiMode
parameter controls the runtime GUI of a Form application. This parameter can be specified in the URL or a value can be provided in the formsweb.cfg
file (Forms configuration file). The guiMode
parameter affects the visibility of the following GUI components:
The visibility of default Windows menubar provided by the client. When no menubar is specified for a Form in the Forms builder, the client provides a default menubar at runtime. The guiMode
value affects only this default menubar provided by the client.
Note:
TheguiMode
value takes effect for menubars only when the Forms menu module parameter is set to null. If the Form has any other server specified menubar (including the Forms default menu) or toolbar associated with it, then this parameter is not applicable. In case of window-bars, this parameter is applicable even if there is a menu specified for that form in the Forms Builder.The visibility of the title bars of all the windows in a Form. This parameter does not affect title bars in windows like - alert windows, pop-up windows.
Table 4-14 shows the effect of guiMode
values on the default Windows menubar and Windows title bar. The default guiMode
value is 0. Any value other than the four valid values mentioned in the table, will be ignored. In such a case, guiMode
will return to its default value.
Table 4-14 Effect of guiMode Values
guiMode | Default Menubar Visible | Windows Title bar Visible |
---|---|---|
0 |
Yes |
Yes |
1 |
No |
Yes |
2 |
Yes |
No |
3 |
No |
No |
Note:
AtguiMode
= 2 or 3, when windows title bar is not visible, windows cannot be maximized or minimized. Though it is possible to maximize or minimize the window using built-ins, users should not minimize the window. This is because once the window is minimized, it cannot be restored.This section lists the parameters that can be specified only in the servlet configuration file (formsweb.cfg
). If any are specified in the URL, the value is ignored. In addition, any parameter that is listed in the value of the restrictedURLparams parameter is rejected if specified in the URL.
allowNewConnections
baseHTML
baseHTMLjpi
connectionDisallowedURL
defaultCharset
envFile
escapeparams
heartbeat
HTMLdelimiter
idleTimeout
logoutTargetURLParamname
maxeventwait
maxRuntimeProcesses
prestartIncrement
prestartInit
prestartMin
prestartRuntimes
prestartTimeout
restrictedURLparams
restrictedURLchars
serverURL
ssoCancelURL
ssoDynamicResourceCreate
ssoErrorURL
ssoLogout
ssoMode
ssoLogoutRedirect
workingDirectory
Use the Environment Configuration page of Fusion Middleware Control to manage environment variables. From this page, you can add, edit, or delete environment variables as necessary.
The environment variables such as PATH
, ORACLE_HOME
, and FORMS_PATH
for the Forms run-time executable (frmweb.exe
on Windows and frmweb
on UNIX) are defined in default.env
. The Forms listener servlet calls the executable and initializes it with the variable values provided in the environment file, which is found in the $DOMAIN_HOME/config/fmwconfig/servers/WLS_FORMS/applications/formsapp_12.2.1/config
directory by default.
Any environment variable that is not defined in default.env
is inherited from the Oracle WebLogic Managed Server. The environment file must be named in the envFile
parameter in the Default section of the Web Configuration page.
A few things to keep in mind when customizing environment variables are:
Environment variables may also be specified in the Windows registry. Values in the environment file override settings in the registry. If a variable is not set in the environment file, the registry value is used.
You need administrator privileges to alter registry values.
The server does not require restarting for configuration changes to take effect.
Existing Forms processes are not affected by environment variables that were defined after they were started.
Environment variables not set in the environment file or Windows registry are inherited from the environment of the parent process, which is the Oracle WebLogic Managed Server.
Table 4-15, "Default Environment Variables" describes important environment variables that are specified in default.env
.
To access the Environment Configuration page:
Start Fusion Middleware Control.
From the Fusion Middleware Control main page, click the link to the Oracle Forms Services instance that you want to configure.
From the Forms menu list, select Environment Configuration. The Environment Configuration page (Figure 4-4) is displayed.
Figure 4-4 Environment Configuration page
To duplicate an environment configuration file:
From the Environment Configuration page, click Duplicate File.
The Duplicate File dialog is displayed.
Select the file which you want to duplicate and enter a unique name for the file.
Click Duplicate to create the file.
To delete an environment configuration file:
In the Environment Configuration page, from the Show menu list, select the environment configuration file you want to delete.
Click Delete File.
The Confirmation dialog is displayed.
Click Yes to confirm the deletion.
Note:
You cannot deletedefault.env
. You can delete only user-defined environment configuration files.To view an environment configuration file:
In the Environment Configuration page, from the Show menu list, select the environment configuration file that you want to view.
The parameters and their values are displayed.
To edit an environment variable:
In the Environment Configuration page, select the row of the parameter that contains the environment variable you want to edit.
Enter the Value and Comments.
Click Apply to save the changes or Revert to discard them.
To add an environment variable:
From the Show menu list, select the environment configuration file to which you want to add the variable.
Click Add to add a parameter.
The Add dialog box is displayed.
Enter the Name, Value and Comments.
Click Create.
Click Apply to save the changes or Revert to discard them.
To delete an environment variable:
From the Show menu list, select the environment configuration file where you want to delete an environment variable.
Select the rows of the parameters you want to delete. You can delete more than one parameter at a time.
Click Delete.
Click Apply to save the changes or Revert to discard them.
Table 4-15 provides the valid values and a description of some of the environment variables.
Table 4-15 Default Environment Variables
Parameter | Valid Values | Description |
---|---|---|
|
Points to the base installation directory of any Oracle product. |
|
|
Contains all configuration files, repositories, log files, deployed applications, and temporary files. |
|
|
Contains the executables for Oracle products. |
|
|
Specifies the path that Oracle Forms searches when looking for a form, menu, or library to run. For Windows, separate paths with a semi-colon (;). For UNIX, separate paths with a colon (:). |
|
|
Disable or remove this variable for end-users who need access to the query-where functionality which potentially allows them to enter arbitrary SQL statements when in enter-query mode. |
|
|
Specifies the path name to the TNS files such as TNSNAMES.ORA, SQLNET.ORA and so on. |
|
|
Specifies the Java class path, which is required for Forms using imported Java. |
|
Set the
You can reset
or in the C shell by entering:
|
Oracle Forms Developer and Reports Developer products use dynamic, or shared, libraries. Therefore, you must set |
|
|
||
TRUE |
Possible values are |
|
|
Specifies the location of the library Note: If there are multiple environment files, ensure that |
|
To enable the feature, set the To disable the feature, set the environment variable value to false or 0. |
If this variable is set, PL/SQL uses a common SQL parser (that is, the one in RDBMS SQL engine) for compiling SQL code rather than the separate one built in to PL/SQL used for compiling static SQL. |
|
|
A list of paths, separated by colons on UNIX, or seperated by semi-colons on Windows. |
Setting this environment variable to a non-empty value restricts the directories from which Forms applications may be launched. The significant effects are as follows:
|
Note:
On Windows, Oracle Forms Services reads Oracle environment settings from the Windows Registry unless they are set as environment variables.Some enterprise environments separate various servers with proxy servers. Although this helps to improve security, it can make integration across servers more difficult. For Oracle Forms applications that are integrate with Oracle Reports, Oracle BI-Publisher, or use Imported Java, and make calls to a server other than the one where Forms is running, through a proxy server, it will be necessary to configured one or more of the following environment variables.
Table 4-16 Forms Network Proxy Environment Variables
Parameter | Valid Values | Usage Notes |
---|---|---|
FORMS_HTTP_PROXY_HOST |
The HTTP enabled proxy host. example. |
If using JVM Controllers, refer to Section 10.6.1, "Network Proxies and Java Calls Using JVM Controller" and the Java equivalent http.proxyHost |
FORMS_HTTP_PROXY_PORT |
The HTTP enabled proxy host port. |
If using JVM Controllers, refer to Section 10.6.1, "Network Proxies and Java Calls Using JVM Controller" and the Java equivalent http.proxyPort |
FORMS_HTTPS_PROXY_HOST |
The HTTPS enabled proxy host. example. |
If using JVM Controllers, refer to Section 10.6.1, "Network Proxies and Java Calls Using JVM Controller" and the Java equivalent https.proxyHost |
FORMS_HTTPS_PROXY_PORT |
The HTTPS enabled proxy host port. |
If using JVM Controllers, refer to Section 10.6.1, "Network Proxies and Java Calls Using JVM Controller"and the Java equivalent https.proxyPort |
FORMS_PROXY_BYPASS |
A list of hosts that should not be accessed using proxy. Hosts in the list are separated by '|' character and individual host can have wildcard character '*'. For more details please refer to the Java documentation at |
If using JVM Controllers, refer to Section 10.6.1, "Network Proxies and Java Calls Using JVM Controller" and the Java equivalent http.nonProxyHosts |
Administrators can manage user sessions, and related features such as monitoring, debugging and tracing using Fusion Middleware Control.
A user session starts when the frmweb process starts. Use the Forms User Sessions pages to monitor and trace the Forms sessions within a Forms Instance. The Forms User Sessions page is accessed from the Forms menu list by selecting User Sessions.
Start Fusion Middleware Control.
From the Forms menu list, select User Sessions.
The User Sessions page (Figure 4-5) is displayed.
Table 4-17 describes the fields on the User Sessions page.
Field | Description |
---|---|
Process ID |
The process ID of the user session. |
Database |
The database name used by the Forms application for the user session. Click the Database name to view the Database Sessions page. |
CPU Usage |
The percentage of CPU used by the run-time process. |
Private Memory (KB) |
The memory used by the run-time process. On Linux platforms, private memory is not the actual private memory but indicates the Resident Set Size (RSS). |
IP Address |
The IP address of the client computer used to connect to Forms Services. |
Username |
Database user name. |
Connect Time |
The time when the user connected to Forms Services. If the client connection time and client IP are empty, the session is a prestarted session, which is not yet connected to any client. |
Trace Group |
The trace group used for tracing the user session. When tracing is enabled, this column shows the trace group name or the events being traced. The events are displayed if the events of the trace group that was enabled for the session have been later modified in the trace configuration. Note that the Trace group name that is displayed may not be indicate the accurate events being traced if built-ins are used to control the tracing. |
Trace Log |
Displays the trace log if one exists for the user session. |
Configuration Section |
Indicates the configuration section used by the Forms application. |
Form Name |
Indicates the module name of the form application. |
CPU Time |
Indicates total CPU time used by forms sessions since Connect time. |
To enable new Forms user sessions:
By default, new Forms user sessions are enabled. You can disable them by using Fusion Middleware Control to set the allowNewConnections
parameter to false.
Start Fusion Middleware Control.
From the Forms menu, select Web Configuration.
Select the default configuration section. allowNewConnections cannot be overridden in named sections.
In the Sections region, find and edit the value for the allowNewConnections
parameter. A value of true
(default) enables new user sessions, whereas false
disables them.
Click Apply to save the changes.
To disable new Forms user sessions:
Start Fusion Middleware Control.
From the Forms menu, select Web Configuration.
Select the default configuration section. allowNewConnections cannot be overridden in named sections.
In the Sections region, find and edit the value for the allowNewConnections
parameter. A value of true
(default) enables new user sessions, whereas false
disables them.
Click Apply to save the changes.
When new user sessions are disabled, attempted connections are directed to a URL identified by the formsweb.cfg
parameter connectionDisallowedURL
(in the default section). You must specify a complete and valid URL as the value.
If connectionDisallowedURL
is not specified, then the following message is displayed in the browser:
The Forms servlet will not allow new connections. Please contact your System Administrator.
When you disable new user sessions, existing forms sessions are unaffected and the Oracle WebLogic Managed Server instance remains up.
To enable tracing for a Forms user sessions:
Start Fusion Middleware Control.
In the User Sessions page, select the row that has the user session for which you want to enable tracing.
Select Enable Tracing.
From the Select Trace Group list, select an available trace group and click OK.
To disable tracing for a Forms user sessions:
In the User Sessions page, select the row that has the user session for which you want to disable tracing.
Click Disable Tracing.
Click OK. The Disable Tracing dialog is dismissed and tracing is now stopped for the selected Forms user session.
To terminate a Forms user session:
Select the link to the Forms Services instance that has the user session to be terminated.
From the Forms menu, select User Sessions.
Click the row of the user session to be deleted.
Click Stop.
The Confirmation dialog is displayed.
Click Yes.
The user session is deleted and the Runform instance is terminated.
To view trace logs of a Forms user sessions:
From the Forms menu, select User Sessions.
For a user session that is active, click View Trace Log in the Trace Log column. Log in to view the trace file.
To search for a Forms user sessions:
From the Forms menu, select User Sessions.
Select the column name in which you want to search.
Enter the search string.
Click the blue arrow to search. The search results are displayed.
To sort the list of Forms user sessions:
From the Forms menu, select User Sessions.
Move the mouse over the column.
Click the up or down arrow to sort in ascending or descending order. The page is refreshed showing the sorted user sessions. You can sort in order of all columns except Trace Logs.
To customize your view of Forms user sessions:
From the User Sessions page, click View.
From the View menu, you can:
Select Show All to view all columns.
Select specific columns you want displayed.
Select Reorder Columns to organize the order of display of the columns.
Select Show More Columns to hide or display specific columns.
To view database sessions for a Forms user session:
From the Forms menu, select User Sessions.
Click the Database name in the Database column.
Log in to view the Database Sessions page (Figure 4-6). You need Database Administrator privileges to log in to Database Sessions page.
Table 4-18, Table 4-19, and Table 4-20 describe the information displayed in the Database Sessions page.
Table 4-18 Database Sessions Page
Field | Description |
---|---|
Username |
Database username used for connection to the database. |
Session ID |
Database session identifier. |
Logon Time |
Date and time when user logged on to the session. |
Serial # |
Session serial number. Used to uniquely identify a session's objects. Guarantees that session-level commands are applied to the correct session objects if the session ends and another session begins with the same session ID. |
Status |
Indicates whether the session is active or not. |
SQL HASH |
Used to identify the SQL statement executed |
CPU Usage (%) |
CPU Usage (in percentage) on the Database system for the given session. |
Logical Reads |
Number of Logical Reads for the given session. |
Physical Reads |
Number of Physical Reads for the given session. |
PGA (Program Global Area) Memory |
Size of PGA (Program Global Area) Memory after an interval. |
Table 4-19 Details of Selected Database Session
Field | Description |
---|---|
SQL Statement for the selected Database Session |
Displays the most recent SQL statement. |
Table 4-20 Execution Plan for the Selected Database Session
Field | Description |
---|---|
Operation |
Name of the internal operation performed in the execution step (for example, TABLE ACCESS). |
Object |
Name of the table or index. |
Object Type |
Type of the object. |
ID |
A number assigned to each step in the execution plan. |
Parent ID |
ID of the next execution step that operates on the output of the current step. |
Depth |
Depth (or level) of the operation in the tree. It is not necessary to issue a CONNECT BY statement to get the level information, which is generally used to indent the rows from the PLAN_TABLE table. The root operation (statement) is level 0. |
Position |
Order of processing for all operations that have the same PARENT_ID. |
Rows |
Estimate, by the cost-based optimizer, of the number of rows produced by the operation. |
Size (KB) |
Estimate, by the cost-based optimizer, of the number of bytes produced by the operation. |
Cost |
Cost of the operation as estimated by the optimizer's cost-based approach. For statements that use the rule-based approach, this column is null. |
Time (sec) |
Elapsed time (in seconds) of the operation as estimated by the optimizer's cost-based approach. For statements that use the rule-based approach, this column is null. |
CPU Cost |
CPU cost of the operation as estimated by the optimizer's cost-based approach. For statements that use the rule-based approach, this column is null. |
I/O Cost |
I/O cost of the operation as estimated by the optimizer's cost-based approach. For statements that use the rule-based approach, this column is null. |
To send notification messages to Forms user sessions:
Start Fusion Middleware Control.
From the Forms menu select User Sessions.
Select the user sessions required to receive the notifications.
You can select multiple user sessions by using CTRL key and selecting the additional sessions.
Click the Notify button above the table.
In the dialog box, select the Notification Value to be sent to the user.
Click on OK to send the notification.
Oracle Forms applications are web-deployed solutions that users access through a browser. Oracle Forms architecture allows Forms developers two ways to choose and configure how a Forms application runs. One option is to set the parameter and the value in the URL. The second option is to set the parameter and its value(s) in the configuration file, that is, formsweb.cfg
. The parameter that is set in the formsweb.cfg
can be overridden by the parameter set in the URL.
A Forms administrator can override this default behavior, and give the Forms administrator full control over what parameter can be used in the URL.
Here are two scenarios to consider when deciding which parameters to allow or not allow in a URL. The first scenario is when an administrator just wants to restrict the usage of the USERID parameter in the URL that forces the end-user to always log in using the default login window. The second scenario is when an administrator disables all parameters except a few, such as CONFIG=MyApp
in a URL.
The parameter restrictedURLparams
allows flexibility for the Forms administrator to consider any URL-accessible parameter in the formsweb.cfg
file as restricted to a user. An administrator can specify this parameter in a named configuration section to override the one specified in the default configuration section. The restrictedURLparams
parameter itself cannot be set in the URL.
By design, command line arguments passed in a URL always override similar definitions in the formsweb.cfg.
In this example, the userid
is defined as scott/tiger
and debug
is set to false
. An application that is configured to connect to the database as scott/tiger
can connect as a different user with the userid
parameter added as a URL parameter. To prevent this, the userid
parameter is defined in the restrictedURLparams
as shown in Figure 4-7, "Defining the restrictedURLparams Parameter".
Figure 4-7 Defining the restrictedURLparams Parameter
Similarly, an administrator can use the restrictedURLparams
parameter to redirect a user to a page which lists the restricted parameters that were used. In 12c, restrictedURLparams
can be set to 'all
' which will prevent any parameters (other than config section) from being specified in the URL.
The test form runs when you access an Oracle Forms URL but do not specify an application to run. For example, normally you call an Oracle Forms application with the following syntax:
http://<host>:<port>/forms/frmservlet?config=myApp
The Forms servlet locates [myApp]
in the formsweb.cfg file and launches that application. However, when no application is specified, for example:
http://<host>:<port>/forms/frmservlet
The Forms servlet uses the settings in the default section of the formsweb.cfg file. These settings are located under [default]
in the Forms Configuration file (anytime an application does not override any of these settings, the defaults are used). The default section has the following setting:
form=test.fmx
This is the test form which enables you to test your Oracle Forms Services installation and configuration. Thus if you do not specify an application, Forms launches the test.fmx file. You could change this to:
form=
And the form does not run. However, this is not optimal; the Forms servlet still sends the dynamically generated HTML file to the client, from which a curious user could obtain information. The optimally secure solution is to redirect requests to an informational HTML page that is presented to the client instead. Some parameters in the formsweb.cfg
file must be changed.
Here are the parameters to change, along with their default values when you install Oracle Forms Services:
# System parameter: default base HTML file baseHTML=base.htm # System parameter: base HTML file for use with Sun's Java Plug-In baseHTMLjpi=basejpi.htm
These parameters are templates for the HTML information that are sent to the client. Create an informational HTML page and have these variables point to that instead. For example, in the $DOMAIN_HOME/config/fmwconfig/components/FORMS/instances/<Forms Instance Name>/server
directory, create a simple HTML page called forbidden.html
with the following content:
<html> <head> <title>Forbidden</title> </head> <body> <h1>Forbidden!</h1> <h2>You may not access this Forms application.</h2> </body> </html>
Note:
This message page displayed as a result of redirecting of client information is different from the page that the Web server returns when the requested content has restricted permissions on it.Next, modify the formsweb.cfg
parameters by commenting out or modifying the original parameters:
# System parameter: default base HTML file #baseHTML=base.htm baseHTML=forbidden.html # System parameter: base HTML file for use with Sun's Java Plug-In #baseHTMLjpi=basejpi.htm baseHTMLjpi=forbidden.html # System parameter: base HTML file for use with Microsoft Internet Explorer # (when using the native JVM)
When a user enters the URL
http://<host>:<port>/forms/frmservlet
the customized Web page is presented. Of course, you can customize forbidden.html
, including its contents, its filename, and its location if you make the corresponding changes to these parameters in the formsweb.cfg
file. Administrators can put any information, such as warnings, errors, time stamps, IP logging, or contact information in this information Web page with minimal impact on the server configuration.
Note:
Overriding the base HTML template entries in the default section offormsweb.cfg
requires that you add the same entries pointing to the original values (or some other valid HTML file) in your application-specific named configuration:
[myApp] form=myApplication.fmx lookandfeel=oracle baseHTML=base.htm baseHTMLjpi=basejpi.htm
If you do not specify these base HTML values, and when a user runs an application, the forbidden.html
page is displayed because the application-specific configuration section has not overridden the default values.
Consider creating your own HTML file templates (by modifying the templates provided by Oracle). By doing this, you can hard-code standard Forms parameters and parameter values into the template. Your template can include standard text, a browser window title, or images (such as a company logo) that would appear on the first Web page users see when they run Web-enabled forms. Adding standard parameters, values, and additional text or images reduces the amount of work required to customize the template for a specific application. To add text, images, or a window title, you must include the appropriate tags in the template HTML file.
See Chapter 3, "Specifying Special Characters in Values of Runform Parameters" for information about coding the serverArgs
applet parameter.
Any user-added customized configuration files (such as user client registry files or user key binding files or multiple environment files) must be copied to the same directory as the corresponding default configuration file.
For example, if the user has created a French environment configuration file default_fr.env
, then it must be placed in the $DOMAIN_HOME/config/fmwconfig/servers/WLS_FORMS/applications/formsapp_12.2.1/config
directory.
When a variable reference occurs within a string delimited by quotes or apostrophes (for example, the value of an applet parameter), then when the value of the variable is substituted for the variable reference, HTML metacharacters ('&', '<', '>', quote, and apostrophe) are replaced by HTML escape sequences.
This sequence is not done for variable references outside delimited strings. Therefore, such variables should be specified in the restrictedURLparams
system default configuration parameter, for security reasons.
Note:
To modify the cursor blink rate, or disable blinking, set the client parametercursorBlinkRate
as follows. <PARAM NAME="cursorBlinkRate" VALUE="1000">
The default is 600 milliseconds: the cursor completes one full blink every 1.2 seconds (1200 ms). A value of zero disables the blinking and the cursor remains visible all the time.
This section explains how to specify the default location and search paths for fonts, icons, and images in Registry.dat.
Use Fusion Middleware Control to change, add, or delete parameters from Registry.dat.
To access the Fonts and Icon Mapping page:
Start Fusion Middleware Control.
From the Forms menu list, select Font and Icon Mapping.
The Font and Icon Mapping page (Figure 4-8) is displayed.
To edit a Registry.dat parameter value:
Start Fusion Middleware Control.
From the Forms menu list, select Font and Icon Mapping.
Select the row containing the parameter to modify and change the value(s) for it in the Value text field.
Click Apply to save the changes.
To add a Registry.dat parameter and its value:
From the Forms menu list, select Font and Icon Mapping.
Click Add.
The Add dialog appears.
Enter the name, value, and comments for this parameter.
Click Create.
Click Apply to save or Revert to discard the changes.
To delete a Registry.dat parameter and its value:
From the Forms menu list, select Font and Icon Mapping.
Select the row containing the parameter to delete and click Delete.
The parameter is deleted.
Click Apply to save or Revert to discard the changes.
Oracle Forms delivers nine predefined color schemes that are set using the applet parameter colorscheme
. Beginning with Oracle Forms 12c, customized color schemes can be created in lieu of using what is provided. To enable a custom colorscheme, set customcolorscheme=<COLOR SCHEME NAME>
in formsweb.cfg. The customizations are configured in Registry.dat. An example named sample is included in Registry.dat. To use this example, set customcolorscheme=sample in formsweb.cfg.
Note:
All virtual colors in the custom color scheme must have valid values representing the desired color. NULL values are considered invalid. If any entry is invalid the application will use the color scheme set in thecolorscheme
parameter for all colors.Color values can either be hexadecimal (e.g. 0xFFFFFF) or RGB sets (e.g. 255,255,255). For example:
# Sample custom color scheme, where scheme name is "sample". colorScheme.sample.description=Sample custom color scheme colorScheme.sample.lightest=0xFFFF33 colorScheme.sample.lighter=0xFFCC33 colorScheme.sample.light=0xCC3333 colorScheme.sample.dark=0x993333 colorScheme.sample.darker=0x660033 colorScheme.sample.darkest=0x003333 colorScheme.sample.selection=0x4169E1 colorScheme.sample.pinstripe1=0xEE82EE colorScheme.sample.pinstripe2=0xF5DEB3
Using Fusion Middleware Control, you can also change the default font and font settings by the Registry.dat file. All font names are Java Font names. Each of these parameters represents the default property to use when none is specified.
To change the font settings for a deployed application:
Start Fusion Middleware Control.
From the Forms menu list, select Font and Icon Mapping.
Change any of the settings to reflect your desired font setting, based on Table 4-21:
Table 4-21 Default Font Values
Font Name | Default Value |
---|---|
default.fontMap.defaultFontname |
Dialog Represents the default Java fontName. |
default.fontMap.defaultSize |
900 Represents the default fontSize. Note that the size is multiplied by 100 (for example, a 10pt font has a size of 1000). |
default.fontMap.defaultStyle |
PLAIN Represents the default fontStyle, PLAIN or |
default.fontMap.defaultWeight |
PLAIN Represents the default fontWeight, PLAIN or |
default.fontMap.appFontnames |
Courier New,Courier,courier,System,Terminal,Fixedsys,Times,Times New Roman,MS Sans Serif,Arial Default Font Face mapping. Represents a comma delimited list of application font names. The number of entries in the appFontname list should match the number in the javaFontname list. The elements of the list are comma separated and all characters are taken literally; leading and trailing spaces are stripped from Face names. Note that this file uses the Java 1.1 font names to handle the NLS Plane. |
default.fontMap.javaFontnames |
MonoSpaced,MonoSpaced,MonoSpaced,Dialog,MonoSpaced,Dialog,Dialog,Serif,Serif,Dialog,SansSerif Represents a comma delimited list of Java font names. |
For example, to change your default font to Times New Roman, replace Dialog with Times New Roman.
You can change the default font face mappings:
default.fontMap.appFontnames=Courier New,Courier, courier,System,Terminal,Fixed,Fixedsys,Times,Times New Roman, MS Sans Serif,Arial default.fontMap.javaFontnames=MonoSpaced,MonoSpaced,MonoSpaced,Dialog, MonoSpaced,Dialog,Dialog,Serif,Serif,Dialog,SansSerif
Click Apply to save the changes.
Some fonts on Windows are not supported in Java. For this reason you can specify (map) Java-supported fonts that appear when a non-supported font is encountered. In the previous sample, each font in default.fontMap.appFontnames corresponds to a font in default.fontMap.javaFontnames.
When deploying an Oracle Forms application, the icon and image files used must be in a Web-enabled format, such as JPG or GIF (GIF is the default format). The same is true of audio files. For supported Audio files formats, please refer to the Java JFX documentation at https://docs.oracle.com/javafx/2/api/javafx/scene/media/package-summary.html#SupportedMediaTypes
By default, the icons are found relative to the DocumentBase
directory. That is, DocumentBase
looks for images in the directory relative to the base directory of the application start HTML file. As the start HTML file is dynamically rendered by the Forms servlet, the Forms webapp's
directory becomes the document base. The Forms webapp's
directory is located at $DOMAIN_HOME/servers/WLS_FORMS/tmp/_WL_user/formsapp_12.2.1/<random string>/war
.
For example, if an application defines the icon location for a button with myapp/<iconname>
, then the icon is looked up in the directory forms/myapp
.
To change the default location, set the imageBase
parameter to codebase
in the Web Configuration page of Fusion Middleware Control. Alternatively, you can change the default.icons.iconpath
value of the Registry.dat file in the $DOMAIN_HOME/config/fmwconfig/servers/WLS_FORMS/applications/formsapp_12.2.1/config/oracle/forms/registry
directory.
Setting the imageBase parameter to codebase
enables Oracle Forms to search the forms/java
directory for the icon files. Use this setting if your images are stored in a Java archive file. Changing the image location in the Registry.dat configuration file is useful to store images in a central location independent of any application and independent of the Oracle Forms installation.
For audio files the concept is similar to the above, however mediaBase cannot be overridden by entried in Registry.dat. For audio files stored in Jar files, set mediaBase=codeBase in formsweb.cfg.
If an application uses custom icons, images or audio files it is recommended you store them in a Java archive file and set the imageBase
value to codebase
(and mediaBase=codeBase if including audio files). The files can be packaged into a Java archive using the Jar command of any Java Development Kit (Java JDK), so long as its version is the same or older than the version expected to be used on the end-user machine
In order for Oracle Forms to access the icon files stored in this archive, the archive must be stored into the forms/java
directory. Also, the name of the archive file must be part of the archive tag used in the custom application section of the formsweb.cfg
file. Now, when the initial application starts, the Jar file is downloaded and stored in cache on the client until the archive file is changed.
Refer to Section 4.7.6, "Custom Jar Files Containing Icons and Images, and Audio Files" for more information using Jar files.
Note:
Oracle Forms default icons (for example, icons present in the default smart icon bar) do not require deployment, as they are part of thefrmall.jar
file.Use Fusion Middleware Control to add icon changes to the Registry.dat file used by your application.
Start Fusion Middleware Control.
From the Forms menu, select Font and Icon Mapping.
Click Add.
The Add dialog appears.
Enter the name, value, and an optional comment.
Click Create to create the mapping.
The mapping is added to the list.
Click Apply to save the changes.
From the Font and Icon Mapping region, select the mapping you want to modify.
Change the name and value of the mapping. For example,
Modify the iconpath
parameter specifying your icon location:
default.icons.iconpath=/mydir
(for an absolute path)
or
default.icons.iconpath=mydir
(for a relative path, starting from the DocumentBase
Directory)
Modify the iconextension
parameter:
default.icons.iconextension=gif
or
default.icons.iconextension=jpg
Click Apply to save and activate the changes.
From the Font and Icon Mapping region, select the mapping you want to delete.
Click Delete.
The selected icon mapping is deleted.
Click Apply to save or Revert to discard the changes.
To reference the application file:
In a specific named configuration section in the formsweb.cfg
file, modify the value of the serverApp
parameter and set the value to the location and name of your application file.
For example:
[my_app]
ServerApp=http://example.com/appfile/myapp
(for an absolute path)
or
[my_app]
ServerApp=appfile/myapp
(for a relative path, relative to the CodeBase
directory)
Table 4-22 describes the correct locations where to place your application icons:
Table 4-22 Icon Location Guide
Icon Location | When | How |
---|---|---|
DocumentBase |
Default. Applications with few or no custom icons. |
Store icons in forms |
Java Archives |
Applications that use many custom icons. |
Set |
Registry.dat |
Applications with custom icons that are stored in a different location as the Oracle Forms install (can be another server). Useful to make other changes to the Registry.dat file such as font mapping. |
Copy Registry.dat and change ServerApp parameter in |
When you deploy your applications, you have the ability to specify a splash screen image (displayed during the connection) and a background image file.
Those images are defined in the HTML file or you can use the Web Configuration page in Fusion Middleware Control:
<PARAM NAME="splashScreen" VALUE="splash.gif">
<PARAM NAME="background" VALUE="back.gif">
The default location for the splash screen and background image files is in the DocumentBase directory containing the baseHTML file.
Note:
Image formats for splash screens and icons are the standard formats that are supported byjava.awt.Image
. For more information on java.awt.Image
, refer to the Java Advanced Imaging (JAI) API at http://www.oracle.com/technetwork/java/index.html
.Each time you use an icon or an image (for a splash screen or background), an HTTP request is sent to the Web server. To reduce the HTTP round-trips between the client and the server, you have the ability to store these files in a Java archive (Jar) file. Using this technique, only one HTTP round-trip is necessary to download the Jar file.
The Java JDK comes with an executable called jar. This utility enables you to store files inside a Java archive. For more information, see http://www.oracle.com/technetwork/java/index.html
.
For example:
jar -cvf myico.jar Splash.gif Back.gif icon1.gif
This command stores three files (Splash.gif
, Back.gif
, icon1.gif
) in a single Jar file called myico.jar
.
Java Jar files must be signed with a trusted certificate in order to be accessible at runtime without displaying additional security warnings. Please refer to the Java documentation for details at https://docs.oracle.com/javase/tutorial/deployment/jar/signindex.html
The default search path for the icons and images is relative to the documentBase. However, when you want to use a Jar file to store those files, the search path must be relative to the codebase
directory, the directory which contains the Java applet.
To use a Jar file to store files contained within the Jar, you must specify that the search path is relative to codebase
using the imageBase parameter in the formsweb.cfg
file or HTML file.
This parameter accepts two different values:
documentBase The search path is relative to the documentBase
directory. If no value is specified for imageBase, then the value of documentBase is used.
codeBase The search path is relative to the codeBase
directory, which gives the ability to use Jar files.
In this example, we use a JAR file containing the icons and we specify that the search should be relative to codeBase. If the parameter imageBase
is not set, the search is relative to documentBase
and the icons are not retrieved from the Jar file.
For example (formsweb.cfg
):
archive=frmall.jar, icons.jar
imageBase=codeBase
For audio files, set mediaBase=codeBase
Oracle Forms architecture supports deployment in multiple languages. The purpose of this feature is to automatically select the appropriate configuration to match a user's preferred language. In this way, all users can run Oracle Forms applications using the same URL, yet have the application run in their preferred language. As Oracle Forms Services do not provide an integrated translation tool, you must have translated application source files.
For each configuration section in the Web Configuration page, you can create language-specific sections with names like <config_name>.<language-code>
. For example, if you created a configuration section "hr", and wanted to create French and Chinese languages, your configuration section might look like the following:
[hr] lookAndFeel=oracle width=600 height=500 envFile=default.env workingDirectory=/private/apps/hr [hr.fr] envFile=french.env workingDirectory=/private/apps/hr/french [hr.zh] envFile=chinese.env workingDirectory=/private/apps/hr/chinese
Inline IME support enables Forms Web applications to properly display the composing text in which each character may not be directly represented by a single keystroke (for example, Asian characters) near the insertion cursor (so called inline, or on-the-spot). It is enabled by default. To disable, set the applet parameter "inlineIME" to "false" in the baseHTML file:
<HTML> <!-- FILE: base.htm (Oracle Forms) --> <BODY> ... <OBJECT classid=... > <PARAM NAME="inlineIME" VALUE="false"> <EMBED SRC="" ... inlineIME="false" > ... . </BODY> </HTML>
When the Forms servlet receives a request for a particular configuration (for example, http://myserv/servlet/frmservlet?config=hr
) it gets the client language setting from the request header "accept-language"
. This gives a list of languages in order of preference. For example, accept-language: de, fr, en_us means the order of preference is German, French, then US English. The servlet looks for a language-specific configuration section matching the first language. If one is not found, it looks for the next and so on. If no language-specific configuration is found, it uses the base configuration.
When the Forms servlet receives a request with no particular configuration specified (with no "config="
URL parameter, for example, http://myserv/servlet/frmservlet
), it looks for a language-specific section in the default section matching the first language (for example, [.fr]).
For ease of use, to avoid duplication of common values across all language-specific variants of a given base configuration, only parameters which are language-specific to be defined in the language-specific sections are allowed. Four levels of inheritance are now supported:
If a particular configuration is requested, using a URL query parameter like config=myconfig
, the value for each parameter is looked for in the langage-specific configuration section which best matches the user's browser language settings (for example in section [myconfig.fr]),
Then, if not found, the value is looked for in the base configuration section ([myconfig],
Then, failing that, in the language-specific default section (for example, [.fr]),
And finally in the default section.
Typically, the parameters which are most likely to vary from one language to another are "workingDirectory"
and "envFile"
. Using a different envFile
setting for each language lets you have different values of NLS_LANG
(to allow for different character sets, date and number formats) and FORMS_PATH
(to pick up language-specific fmx files). Using different workingDirectory
settings provides another way to pick up language-specific .fmx files.
A key binding connects a key to an application function. When you bind a key to a function, the program performs that function when you type that keystroke. You define key bindings in the fmrweb.res
file in the $DOMAIN_HOME/config/fmwconfig/components/FORMS/instances/<FORMS Instance Name>/admin/resource/<lang
directory in UNIX, for example $DOMAIN_HOME/config/fmwconfig/components/FORMS/forms1/admin/resource/US
. For Windows, the location is $DOMAIN_HOME/config/fmwconfig/components/FORMS/<FORMS Instance Name>
.
By defining key bindings, you can integrate a variety of keyboards to make an application feel similar on each of them. On some platforms not all keys are able to be re-mapped. For example, on Microsoft Windows, because keys are defined in the Windows keyboard device driver, certain keys cannot be re-mapped. Key combinations integral to Windows, such as Alt-F4 (Close Window) and F1 (Help) cannot be re-mapped. As a general rule, keys which are part of the "extended" keyboard also cannot be re-mapped. These keys include the number pad, gray arrow and editing keys, Print Screen, Scroll Lock, and Pause.
Note:
If running with differentNLS_LANG
settings, for example, NLS_LANG
=GERMAN_GERMANY=WE8ISO8859P15,
a different resource file, fmrweb.res
, is used. There is a resource file for each supported language. To override this, pass parameter term=fullpath\filename.res
to the Oracle Forms Runtime process.It is possible to pass this parameter directly within the URL. For example:
http://hostname:port/forms/frmservlet?Form=test.fmx&term=fullpath/filename.res
You can also set this parameter in the formsweb.cfg
file, for example:
otherParams=term=fullpath\filename.res
fmrweb.res
is a text file that can be edited with a text editor such as vi in UNIX or Microsoft Notepad or Wordpad on Windows. Unlike Oracle 6i Forms, Oracle Terminal editor is no longer required. The text file is self-documented.
Note:
The customization is limited, particularly compared to character mode forms. You cannot editfmrweb.res
with Oracle Fusion Middleware Control.In the section marked USER-READABLE STRINGS
, find the entries with
122 : 0 : "F11" : 76 : "Enter Query" 122 : 2 : "Ctrl+F11" : 77 : "Execute Query"
and change them to:
122 : 2 : "Ctrl+F11" : 76 : "Enter Query" 122 : 0 : "F11" : 77 : "Execute Query"
Note:
By defaultfmrweb.res
does not reflect the Microsoft Windows client/server keyboard mappings. It reflects the key mapping if running client/server on UNIX X-Windows/Motif.A file called fmrpcweb.res
has also been provided which gives the Microsoft Windows client/server keyboard mappings. To use this file, rename fmrpcweb.res
to fmrweb_orig.res
, and copy fmrpcweb.res
to fmrweb.res
. Alternatively, use the term parameter as described above.
The following examples show special key mappings:
Section 4.9.1.2.2, "Mapping for ENTER to Fire KEY-ENTER-TRIGGER"
Section 4.9.1.2.4, "Mapping for ESC Key to exit out of a Web Form"
To map F2, change the default entry for F2, "List Tab Pages", to another key. Here is an example of the default entry:
113: 0 : "F2" : 95 : "List Tab Pages"
This must be explicitly changed to another key mapping such as the following:
113: 8 : "F2" : 95 : "List Tab Pages"
To map the F2 function to the F2 key, comment out the lines that begin with "113 : 0" and "113 : 8" with a # symbol and add the following lines to the bottom of the resource file:
113: 0 : "F2" : 84 : "Function 2" 113: 8 : " " : 95 : " "
Since a new function has been added which uses F2 by default, it is necessary to explicitly map this new function to something else to map the F2 key. This function was added to allow for keyboard navigation between the tab canvas pages and it defaults to F2. Even if it is commented out and not assigned to F2, the F2 key cannot be mapped unless this function, Forms Function Number 95, is mapped to another key.
By default, whether deploying client/server or over the Web pressing the ENTER key takes the cursor to the next navigable item in the block. To override this default behavior it is necessary to modify the forms resource file to revise the key mapping details.
Modify fmrweb.res
and change the Forms Function Number (FFN) from 27 to 75 for the Return Key. The line should be changed to the following:
10 : 0 : "Return" : 75 : "Return"
By default, the line is displayed with an FFN of 27 and looks as follows:
10 : 0 : "Return" : 27 : "Return"
This line should NOT fire the Key-Enter trigger since the Return or Enter key is actually returning the Return function represented by the FFN of 27. The FFN of 75 represents the Enter function and fires the Key-Enter trigger.
The objective is to map CTRL+<number> keys in fmrweb.res
for numbers 0 to 9 and there are no Java Function keys mentioned for the numbers in fmrweb.res
. Perform the following steps along with an example that shows the steps needed to map CTRL+1 to 'Next Record':
List the Java function key numbers that could be implemented in fmrweb.res
file for the Key Mapping. For example:
public static final int VK_1 = 0x31;
The hexadecimal values have to be converted to their decimal equivalents before their use in fmrweb.res
.
In step (1), 0x31 is a hexadecimal value that has to be converted to its decimal equivalent. (Note:1019580.6). For example,
SQL> select hextodec('31') from dual; HEXTODEC('31') -------------- 49
Use this decimal value for mapping the number key 1 in fmrweb.res
. For example, CTRL+1 can be mapped to 'Next Record' as:
49 : 2 : "CTRL+1" : 67 : "Next Record"
Make a backup copy of fmrweb.res
.
Open the fmrweb.res
file present in the path ORACLE_HOME/FORMS
and add the following entry in it:
27 : 0 : "Esc" : 32 : "Exit"
Ensure that you comment or delete the old entry
#115 : 0 : "F4" : 32 : "Exit"
The first number (115) might differ on different versions or platforms. When you run the Web Form and press the ESC key, then the Form exits.