Skip Headers
Oracle® Application Server Forms Services Deployment Guide
10
g
Release 2 (10.1.2)
B14032-03
Library
Product
Index
Next
Contents
Title and Copyright Information
Preface
Intended Audience
Documentation Accessibility
Related Documents
Conventions
1
Introduction
1.1
The Oracle Internet Platform
1.1.1
Oracle Application Server
1.1.2
Oracle Developer Suite
1.1.3
Oracle Database 10
g
1.2
Oracle Application Server Forms Services
1.2.1
What's New in Forms Services
1.3
OracleAS Forms Services Architecture
1.4
OracleAS Forms Services Components
1.4.1
Forms Listener Servlet
1.4.2
Forms Runtime Process
1.5
Forms Listener Servlet
2
Forms Services Security Overview
2.1
About OracleAS Forms Services Security
2.1.1
OracleAS Forms Services Single Sign-On
2.1.2
Classes of Users and Their Privileges
2.1.3
Resources That Are Protected
2.1.3.1
Dynamic Directives
2.1.3.2
Dynamic Resource Creation in Oracle Internet Directory
2.1.3.3
Database Password Expiration when Using Single Sign-On
2.1.4
Authorization and Access Enforcement
2.1.5
Leveraging Oracle Identity Management Infrastructure
2.2
Configuring OracleAS Forms Services Security
2.2.1
Configuring Oracle Identity Management Options for Oracle Forms
2.2.2
Configuring Oracle Forms Options for OracleAS Security Framework
3
Basics of Deploying Oracle Forms Applications
3.1
OracleAS Forms Services in Action
3.2
Configuration Files
3.2.1
Oracle Forms Configuration Files
3.2.1.1
default.env
3.2.1.2
formsweb.cfg
3.2.1.3
base.htm, basejini.htm, and basejpi.htm
3.2.1.4
ftrace.cfg
3.2.2
Oracle Application Server Containers for J2EE (OC4J) Configuration Files
3.2.2.1
web.xml
3.2.2.2
Directory structure for Oracle Forms OC4J files
3.2.3
Oracle HTTP Listener Configuration Files
3.2.3.1
forms.conf
3.2.4
Standard Fonts and Icons File
3.2.4.1
Registry.dat
3.2.5
WebUtil Configuration Files
3.2.5.1
Default webutil.cfg
3.2.5.2
Default webutilbase.htm
3.2.5.3
Default webutiljini.htm
3.2.5.4
Default webutiljpi.htm
3.3
Application Deployment
3.3.1
Deploying Your Application
3.3.2
Specifying Parameters
3.3.3
Creating Configuration Sections in Enterprise Manager
3.3.3.1
Editing the URL to Access Oracle Application Server Forms Services Applications
3.3.4
Specifying Special Characters in Values of Runform Parameters
3.3.4.1
Default Behavior in the Current Release
3.3.4.2
Behavior in Previous Releases
3.3.4.3
Obtaining the Behavior of Prior Releases in the Current Release
3.3.4.4
Considerations for Template HTML Files
3.3.4.5
Considerations for Static HTML Pages
3.4
Client Browser Support
3.4.1
Oracle JInitiator
3.4.2
How Configuration Parameters and BaseHTML Files are Tied to Client Browsers
4
Configuring Forms Services
4.1
How Oracle Application Server Forms Services Launches a Forms Application
4.2
Enterprise Manager and Oracle Forms
4.2.1
Using Enterprise Manager Application Server Control to Manage Forms Sessions
4.2.2
Configuring Enterprise Manager Grid Control to Manage Forms Services
4.2.3
Accessing Forms Services with Application Server Control Console
4.3
Configuring Forms Services
4.3.1
Configuring Parameters with Application Server Control Console
4.3.1.1
Parameters that Specify Files
4.3.2
Managing Configuration Sections
4.3.2.1
Duplicating a Named Configuration
4.3.2.2
Deleting Named Configurations
4.3.3
Managing Parameters
4.3.4
Default Forms Configuration Parameters
4.3.4.1
System Default Configuration Parameters
4.3.4.2
Runform parameters (serverArgs parameters)
4.3.4.3
HTML page title, attributes for the BODY tag and HTML to add before and after the form
4.3.4.4
Applet or Object Parameters
4.3.4.5
Parameters for JInitiator
4.3.4.6
Parameters for the Sun Java Plug-in
4.3.4.7
Enterprise Manager Configuration Parameters
4.3.4.8
Oracle Internet Directory Configuration Parameters
4.4
Configuring Environment Variables with Enterprise Manager
4.5
Managing User Sessions
4.5.1
Allowing New Users Sessions
4.5.2
Disabling New User Sessions
4.5.3
Terminating a User Session on a Forms Services Instance
4.6
Managing URL Security for Applications
4.6.1
Securing the Oracle Forms Test Form
4.7
Creating Your Own Template HTML Files
4.8
Including Graphics in Your Oracle Forms Application
4.8.1
Oracle Graphics 6
i
and Oracle Database 9.0.1.4.0 (64bit)
4.8.2
Configuring Graphics 6
i
for use by Reports Server
4.9
Deploying Icons and Images Used by Forms Services
4.9.1
Managing Registry.dat with Application Server Control
4.9.2
Deploying Application Icons
4.9.2.1
Storing Icons in a Java Archive File
4.9.2.2
Adding Icon Changes to Registry.dat
4.9.3
SplashScreen and Background Images
4.9.4
Custom Jar Files Containing Icons and Images
4.9.4.1
Creating a Jar File for Images
4.9.4.2
Using Files Within the Jar File
4.9.5
Search Path for Icons and Images
4.9.5.1
DocumentBase
4.9.5.2
CodeBase
4.10
Enabling Language Detection
4.10.1
Specifying Language Detection
4.10.2
Inline IME Support
4.10.3
How Language Detection Works
4.10.3.1
Multi-Level Inheritance
4.11
Enabling Key Mappings
4.11.1
Customizing fmrweb.res
4.11.1.1
Example change: Swapping Enter and Execute Mappings
4.11.1.2
Exceptions/ Special Key Mappings
5
Using Forms Services with Oracle Application Server Single Sign-On
5.1
Overview
5.2
Available Features with OracleAS Single Sign-On, Oracle Internet Directory and Forms
5.2.1
Dynamic Resource Creation When A Resource Is Not Found In Oracle Internet Directory
5.2.2
Support for Default Preferences in Oracle Internet Directory to Define Forms Resources
5.2.3
Support for Dynamic Directives With Forms and OracleAS Single Sign-On
5.2.4
Support for Database Password Expiration for Forms Running with OracleAS Single Sign-On
5.3
OracleAS Single Sign-On Components Used By Oracle Forms
5.4
Enabling OracleAS Single Sign-On for an Application
5.4.1
ssoMode
5.4.2
ssoDynamicResourceCreate
5.4.3
ssoErrorURL
5.4.4
ssoCancelUrl
5.4.5
Accessing Single Sign-on Information From Forms
5.5
Integrating Oracle Forms and Reports
5.6
Authentication Flow
6
Using OracleAS Forms Services with the HTTP Listener and OC4J
6.1
OC4J Server Process
6.2
Performance/Scalability Tuning
6.3
Limit the number of HTTPD processes
6.4
Set the MaxClients Directive to a High value
6.5
Load Balancing OC4J
6.6
Using HTTPS with the Forms Listener Servlet
6.7
Server Requirements
6.8
Client Requirements: Using HTTPS with Oracle JInitiator
6.9
Using the Hide User ID/Password Feature
6.10
Using an Authenticating Proxy to Run Oracle Forms Applications
6.11
Oracle Forms Services and SSL
6.11.1
Configuring Oracle HTTP Server to use SSL
6.11.2
Configuring Oracle Web Cache to use SSL
6.11.3
Running a Form with SSL
6.11.4
Configuring SSL with a Load Balancing Router
7
JVM Pooling
7.1
Overview
7.2
JVM Pooling Examples
7.3
Design-time Considerations
7.3.1
About Previous Versions of the Java Importer
7.3.2
Re-importing Your Java Code
7.3.3
About Sharing Static Variables Across Multiple JVMs
7.4
About The JVM Controller
7.5
JVM Pooling Management
7.5.1
About Managing JVM Controllers from Enterprise Manager Application Server Control
7.5.2
About Managing JVM Controllers from the Command Line
7.5.3
Creating a New JVM Controller
7.5.4
Deleting a JVM Controller
7.5.5
Editing JVM Controller Properties with Enterprise Manager Application Server Control
7.5.6
Specifying Default JVM Controller Properties
7.5.7
Starting and Stopping JVM Controllers with Enterprise Manager Application Server Control
7.5.7.1
Starting or Restarting a JVM Controller
7.5.8
JVM Controller Usage Commands
7.5.8.1
Command Restrictions
7.5.8.2
Starting a JVM Controller at the Command Line
7.5.8.3
Stopping a JVM Controller
7.5.9
The JVM Controller Configuration File
7.5.9.1
Priority of Startup Options
7.5.10
JVM Controller Command Examples
7.5.11
Forms Configuration File Settings
7.5.12
Startup Example
7.5.13
About Multiple JVM Controllers
7.5.14
About Child JVMs
7.5.14.1
Child JVM Example
7.6
JVM Controller Logging Management
7.6.1
Enabling and Disabling Logging
7.6.1.1
Specifying Default Logging Properties
7.6.1.2
Specifiying the Log File Directory Location
7.6.1.3
Accessing Log Files
7.6.1.4
Deleting a Log File for a JVM Controller
7.7
JVM Pooling Error Messages
8
Tracing and Diagnostics
8.1
About Forms Trace
8.2
Configuring Forms Trace
8.2.1
Specifying URL Parameter Options
8.3
Starting Forms Trace
8.4
Viewing Forms Trace Output
8.4.1
Running the Translate Utility
8.5
List of Traceable Events
8.5.1
List of Event Details
8.5.1.1
User Action Events
8.5.1.2
Forms Services Events
8.5.1.3
Detailed Events
8.5.1.4
Three-Tier Events
8.5.1.5
Miscellaneous Events
8.6
Monitoring Forms Services Trace Metrics
8.7
Servlet Logging Tools
8.7.1
Enabling Logging
8.7.1.1
Specifying Logging in the URL
8.7.1.2
Specifying Logging through Enterprise Manager
8.7.1.3
Specifying Full Diagnostics in the URL that Invokes the Forms Servlet
8.7.2
Location of Log Files
8.7.3
Example Output for Each Level of Servlet Logging
8.7.3.1
(none)
8.7.3.2
/session
8.7.3.3
/sessionperf
8.7.3.4
/perf
8.7.3.5
/debug
9
Configuring End User Monitoring
9.1
About End User Monitoring
9.2
Configuring End User Monitoring
9.2.1
Requirements for Using End User Monitoring
9.2.2
Configuring Web Cache to Use End User Monitoring
9.2.3
Specifying a Web Cache Instance to Monitor with Enterprise Manager Grid Control
9.2.4
Modifying the Default Minimum Hits Threshold
9.2.5
Modifying the Exclusion of All Unreasonable Response Times
9.3
Enabling End User Monitoring
9.3.1
Modifying formsweb.cfg
9.4
Additional Sources of Information
10
Performance Tuning Considerations
10.1
Built-in Optimization Features of Forms Services
10.1.1
Monitoring Forms Services
10.1.1.1
Monitoring Forms Services Instances
10.1.1.2
Monitoring Forms Events
10.1.1.3
Monitoring Metrics for User Sessions
10.1.1.4
Sorting Metric Information
10.1.1.5
Searching
10.1.2
Forms Services Web Runtime Pooling
10.1.2.1
Configuring Prestart Parameters
10.1.2.2
Starting Runtime Pooling
10.1.3
Forms Services Utilities
10.1.3.1
To use the Forms Services Utility:
10.1.4
Minimizing Client Resource Requirements
10.1.5
Minimizing Forms Services Resource Requirements
10.1.6
Minimizing Network Usage
10.1.7
Maximizing the Efficiency of Packets Sent Over the Network
10.1.8
Rendering Application Displays Efficiently on the Client
10.2
Tuning OracleAS Forms Services Applications
10.2.1
Location of the Oracle Application Server Forms Services with Respect to the Data Server
10.2.2
Minimizing the Application Startup Time
10.2.2.1
Using Java Files
10.2.2.2
Using Caching
10.2.3
Reducing the Required Network Bandwidth
10.2.4
Other Techniques to Improve Performance
10.3
Web Cache and Forms Integration
11
Upgrading to OracleAS Forms Services
11.1
OracleAS Forms Services Upgrade Items
11.2
Components Related to OracleAS Forms Services
11.3
OracleAS Forms Services Upgrade Tasks
11.3.1
Upgrade Recommendations and Troubleshooting Tips
11.3.2
Upgrading OracleAS Forms Services Application Modules
11.3.3
Upgrading Common Gateway Interface (CGI) to the Oracle Forms Servlet
11.3.4
Upgrading Static HTML Start Files to Generic Application HTML Start Files
11.3.4.1
Using Static HTML Files with OracleAS Forms Services
11.3.5
Upgrading the Forms 6
i
Listener to the Forms Listener Servlet
11.3.6
Upgrading the Forms Listener Servlet Architecture to OracleAS Forms Services
11.3.7
Upgrading Load Balancing
11.3.8
Usage Notes
11.3.8.1
Deploying Icon Images with the Forms Servlet
11.3.8.2
Upgrading Integrated Calls to Oracle Reports to use Oracle Reports
11.3.8.3
Creating Forms Listener Servlet Alias Names in OC4J
11.3.8.4
Accessing the Listener Servlet Administration Page
11.4
Validating the OracleAS Forms Services Upgrade
A
Troubleshooting Oracle Forms Services
A.1
Verifying The Installation
A.1.1
Use The Web Form Tester
A.1.2
Find Port Information
A.2
Diagnosing FRM-XXXXX Errors
A.2.1
The Oracle Forms Applet
A.2.2
The JInitiator Java Console
A.2.3
FRM-92XXX Error Messages
A.2.3.1
FRM-92010
A.2.3.2
FRM-92050
A.2.3.3
FRM-92100
A.2.3.4
FRM-92101
A.2.3.5
FRM-92102
A.2.3.6
FRM-92120
A.2.3.7
FRM-92150/FRM-92160
A.3
Diagnosing Server Crashes with Stack Traces
A.3.1
About Stack Traces
A.3.2
Configuring and Using Stack Traces
A.3.2.1
Verifying the Environment
A.3.2.2
Understanding Solaris Stack Traces
A.3.2.3
Understanding Windows Stack Traces
A.4
Diagnosing Client Crashes
A.4.1
About Diagnosing Client Crashes
A.4.2
Diagnosing Hanging Applications
A.4.2.1
Causes of Hanging Applications
A.4.2.2
Creating Java Thread Dumps
A.5
Forms Trace and Servlet Logging Tools
A.6
Resolving Memory Problems
A.6.1
How Java Uses Memory
A.6.2
Setting the Initial Java Heap
A.6.3
About Memory Leaks
A.6.3.1
Memory Leaks in Java
A.6.3.2
Identifying Memory Leaks
A.6.4
Improving Performance with Caching
A.6.5
Performance Improvements in OJDK
A.7
Troubleshooting Tips
A.8
Need More Help?
B
JInitiator
B.1
Why Use Oracle JInitiator?
B.2
Benefits of Oracle JInitiator
B.3
Using Oracle JInitiator
B.4
Supported Configurations
B.4.1
Windows 98, NT, 2000, XP
B.5
System Requirements
B.6
Using Oracle JInitiator with Netscape Navigator
B.7
Using Oracle JInitiator with Microsoft Internet Explorer
B.8
Setting up the Oracle JInitator Plug-in
B.8.1
Adding Oracle JInitiator Markup to Your Base HTML File
B.8.2
Customizing the Oracle JInitiator Download File
B.8.3
Making Oracle JInitiator Available for Download
B.9
Modifying the Oracle JInitiator Plug-in
B.9.1
Modifying the Cache Size for Oracle JInitiator
B.9.2
Modifying the Heap Size for Oracle JInitiator
B.9.3
Checking and Modifying the Proxy Server Setting for Oracle JInitiator
B.9.4
Viewing Oracle JInitiator Output
B.10
Modifying the baseHTML file
C
Sample Configuration Files
C.1
Default formsweb.cfg File
C.2
Platform Specific default.env Files
C.2.1
Default default.env File for Windows
C.2.2
Default default.env File for Solaris
C.3
base.htm, basejini.htm, and basejpi.htm Files
C.3.1
Parameters and variables in the baseHTML file
C.3.1.1
Usage Notes
C.3.2
Default base.htm File
C.3.3
Default basejini.htm File
C.3.4
Default basejpi.htm File
C.4
web.xml
C.4.1
Default web.xml File
C.5
forms.conf
C.5.1
Default forms.conf
C.6
Registry.dat
C.6.1
Default Registry.dat
C.7
Default jvmcontroller.cfg
C.8
Default webutil.cfg
C.9
Default webutilbase.htm
C.10
Default webutiljini.htm
C.11
Default webutiljpi.htm
Index
