Contents

Title and Copyright Information

Preface

• Intended Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 What's New in Oracle Forms Services

• 1.1 JavaScript Integration
• 1.2 Enhanced Java Support
• 1.3 Support for Server-Side Events
• 1.4 Proxy User Support
• 1.5 PL/SQL Tracing
• 1.6 Integration with Oracle Diagnostics and Logging (ODL)

2 Introduction to Oracle Forms Services

• 2.1 Oracle Forms
  • 2.1.1 Oracle Forms Developer
  • 2.1.2 Oracle Forms Services
  • 2.1.3 How Oracle Forms Services Launches a Forms Application
• 2.2 Oracle Database
• 2.3 Oracle WebLogic Server
• 2.4 Oracle Fusion Middleware
• 2.5 About Installing or Upgrading Oracle Forms
• 2.6 Oracle Forms Services Architecture
  • 2.6.1 Oracle Forms Services Components

3 Basics of Deploying Oracle Forms Applications

• 3.1 Oracle Forms Services in Action
• 3.2 Configuration Files
  • 3.2.1 Oracle Forms Configuration Files
  • 3.2.2 Forms Java EE Application Deployment Descriptors
  • 3.2.3 Oracle HTTP Listener Configuration File
  • 3.2.4 Standard Fonts and Icons File
  • 3.2.5 baseHTML Files
  • 3.2.6 WebUtil Configuration Files
• 3.3 Application Deployment
  • 3.3.1 Deploying Your Application
  • 3.3.2 Specifying Parameters
  • 3.3.3 Creating Configuration Sections in Fusion Middleware Control
  • 3.3.4 Specifying Special Characters in Values of Runform Parameters
  • 3.3.5 Accessing the Listener Servlet Administration Page
• 3.4 Client Browser Support
  • 3.4.1 How Configuration Parameters and BaseHTML Files are Tied to Client Browsers
  • 3.4.2 Forms Single Sign-On on Mozilla 3.x

4 Configuring and Managing Forms Services

• 4.1 Fusion Middleware Control and Oracle Forms
  • 4.1.1 Accessing Forms Services with Fusion Middleware Control
• 4.2 Configuring Forms Services
  • 4.2.1 Common Tasks in the Web Configuration Page
  • 4.2.2 Configuring Parameters with Fusion Middleware Control
  • 4.2.3 Managing Configuration Sections
  • 4.2.4 Managing Parameters
  • 4.2.5 Forms Configuration Parameters
• 4.3 Managing Environment Variables
  • 4.3.1 Managing Environment Configuration Files
  • 4.3.2 Configuring Environment Variables
  • 4.3.3 Default Environment Variables
• 4.4 Managing User Sessions
• 4.5 Managing URL Security for Applications
  • 4.5.1 Securing the Oracle Forms Test Form
• 4.6 Creating Your Own Template HTML Files
  • 4.6.1 Variable References in Template HTML Files
• 4.7 Deploying Fonts, Icons, and Images Used by Forms Services
  • 4.7.1 Managing Registry.dat with Fusion Middleware Control
  • 4.7.2 Managing Application Fonts
  • 4.7.3 Deploying Application Icons
  • 4.7.4 SplashScreen and Background Images
  • 4.7.5 Custom Jar Files Containing Icons and Images
  • 4.7.6 Search Path for Icons and Images
• 4.8 Enabling Language Detection
  • 4.8.1 Specifying Language Detection
  • 4.8.2 Inline IME Support
  • 4.8.3 How Language Detection Works
• 4.9 Enabling Key Mappings
  • 4.9.1 Customizing fmrweb.res

5 Using Oracle Forms Services with the HTTP Listener and Oracle WebLogic Server

• 5.1 About the Oracle WebLogic Managed Server
• 5.2 Performance/Scalability Tuning
  • 5.2.1 Limit the number of HTTPD processes
  • 5.2.2 Set the MaxClients Directive to a High value
• 5.3 Load Balancing Oracle WebLogic Server
• 5.4 Using HTTPS with the Forms Listener Servlet
• 5.5 Using an Authenticating Proxy to Run Oracle Forms Applications
• 5.6 Oracle Forms Services and SSL
• 5.7 Enabling SSL with a Load Balancing Router

6 Oracle Forms and JavaScript Integration

• 6.1 About Oracle Forms Calling External Events
  • 6.1.1 Why Call Events Outside of Oracle Forms?
• 6.2 About JavaScript Events Calling into Oracle Forms
  • 6.2.1 Why Let Events Call into Oracle Forms?
• 6.3 Configuration of formsweb.cfg
• 6.4 Configuration of Environment Variables

7 Enhanced Java Support

• 7.1 Overview
  • 7.1.1 Dispatching Events from Forms Developer
  • 7.1.2 Dispatching Events to Forms Services
• 7.2 About Custom Item Event Triggers
  • 7.2.1 Adding the When-Custom-Item-Event Trigger at Design Time
  • 7.2.2 About the Custom Item Event Trigger at Runtime
  • 7.2.3 Example: A Java class for a Push Button

8 Working with Server Events

• 8.1 About Oracle Forms and Server Events
• 8.2 Creating Events
• 8.3 Subscribing to Events
• 8.4 Event Propagation
  • 8.4.1 About the When-Event-Raised Trigger
  • 8.4.2 About Trigger Definition Level and Scope
• 8.5 Publishing Database Events
• 8.6 About Application Integration Between Forms
  • 8.6.1 About Synchronous Communication
  • 8.6.2 About Asynchronous Communication
  • 8.6.3 Configuring Asynchronous Communication

9 Using Forms Services with Oracle Single Sign-On

• 9.1 Overview
  • 9.1.1 Authentication Flow
• 9.2 Available Features with OracleAS Single Sign-On, Oracle Internet Directory and Forms
  • 9.2.1 Dynamic Resource Creation When A Resource Is Not Found In Oracle Internet Directory
  • 9.2.2 Support for Dynamic Directives With Forms and OracleAS Single Sign-On
  • 9.2.3 Support for Database Password Expiration for Forms Running with OracleAS Single Sign-On
• 9.3 OracleAS Single Sign-On Components Used By Oracle Forms
• 9.4 Enabling OracleAS Single Sign-On for an Application
  • 9.4.1 ssoMode
  • 9.4.2 ssoProxyConnect
  • 9.4.3 ssoDynamicResourceCreate
  • 9.4.4 ssoErrorURL
  • 9.4.5 ssoCancelUrl
  • 9.4.6 Accessing Single Sign-on Information From Forms
  • 9.4.7 Registering Oracle HTTP Server with OracleAS Single Sign-On Server
• 9.5 Integrating Oracle Forms and Reports
  • 9.5.1 Forms and Reports Integration in non-SSO mode
  • 9.5.2 Using Multiple Reports Server Clusters in Oracle Forms Services
  • 9.5.3 Integrating Forms and Reports Installed in Different Instances
• 9.6 Enabling and Configuring Proxy Users
  • 9.6.1 Proxy User Overview
  • 9.6.2 Enabling Proxy User Connections
  • 9.6.3 Enabling SSO in formsweb.cfg
  • 9.6.4 Accessing the Forms Application
  • 9.6.5 Changes in Forms Built-ins
  • 9.6.6 Reports Integration with Proxy Users
• 9.7 Configuring Oracle Internet Directory

10 Configuring and Managing Java Virtual Machines

• 10.1 Why Use Java Virtual Machine Pooling?
  • 10.1.1 JVM Pooling in Forms and Reports Integration
• 10.2 About Child Java Virtual Machine Processes
  • 10.2.1 Child JVM Example
• 10.3 About Multiple JVM Controllers
• 10.4 JVM Pooling Usage Examples
• 10.5 Design-time Considerations
  • 10.5.1 Re-importing Your Java Code
  • 10.5.2 About Sharing Static Variables Across Multiple JVMs
• 10.6 Managing JVM Controllers from the Command Line
  • 10.6.1 JVM Controller Command Examples
  • 10.6.2 Command Restrictions
  • 10.6.3 Start Command Parameters
• 10.7 Managing JVM Pooling from Fusion Middleware Control
  • 10.7.1 Common Tasks in the JVM Configuration Page
  • 10.7.2 Managing JVM Configuration Sections
  • 10.7.3 Managing Parameters
  • 10.7.4 JVM Configuration Parameters and Default Values
  • 10.7.5 Starting and Stopping JVM Controllers with Fusion Middleware Control
  • 10.7.6 Forms Configuration File Settings
  • 10.7.7 Startup Example
• 10.8 JVM Controller Logging
  • 10.8.1 Specifying JVM Default Logging Properties
  • 10.8.2 Specifying the JVM Log Directory Location
  • 10.8.3 Accessing Log Files
  • 10.8.4 Deleting a Log File for a JVM Controller
• 10.9 Integrating Forms and Reports
• 10.10 JVM Pooling Error Messages

11 Forms Services Security Overview

• 11.1 Forms Services Single Sign-On
  • 11.1.1 Classes of Users and Their Privileges
  • 11.1.2 Resources That Are Protected
  • 11.1.3 Authentication and Access Enforcement
  • 11.1.4 Leveraging Oracle Identity Management Infrastructure
• 11.2 Configuring Oracle Forms Services Security
  • 11.2.1 Configuring Oracle Identity Management Options for Oracle Forms
  • 11.2.2 Configuring Oracle Forms Options for Oracle Fusion Middleware Security Framework

12 Tracing and Diagnostics

• 12.1 About Forms Trace
  • 12.1.1 What Is the Difference between Tracing and Debugging?
• 12.2 Enabling and Configuring Forms Trace
  • 12.2.1 Configuring Forms Trace
  • 12.2.2 Specifying URL Parameter Options
• 12.3 Starting and Stopping Forms Trace
• 12.4 Viewing Forms Trace Output
  • 12.4.1 Running the Translate Utility
• 12.5 List of Traceable Events
  • 12.5.1 List of Event Details
• 12.6 Taking Advantage of Oracle Diagnostics and Logging Tools
  • 12.6.1 Enabling Oracle Diagnostics and Logging
  • 12.6.2 Viewing Diagnostics Logs
  • 12.6.3 Using the Servlet Page
  • 12.6.4 Location of Log Files
  • 12.6.5 Example Output for Each Level of Servlet Logging

13 Upgrading to Oracle Forms Services 11g

• 13.1 Oracle Forms Services Upgrade Items
• 13.2 Oracle Forms Services Upgrade Tasks
  • 13.2.1 Upgrade Recommendations and Troubleshooting Tips
  • 13.2.2 Upgrading Oracle Forms Services Application Modules
  • 13.2.3 Upgrading Common Gateway Interface (CGI) to the Oracle Forms Servlet
  • 13.2.4 Upgrading Static HTML Start Files to Generic Application HTML Start Files
  • 13.2.5 Upgrading the Forms 6i Listener to the Forms Listener Servlet
  • 13.2.6 Upgrading the Forms Listener Servlet Architecture to Oracle Forms Services
  • 13.2.7 Upgrading Load Balancing
  • 13.2.8 Usage Notes
• 13.3 Validating the Oracle Forms Services Upgrade

14 Performance Tuning Considerations

• 14.1 Built-in Optimization Features of Forms Services
  • 14.1.1 Monitoring Forms Services
  • 14.1.2 Forms Services Web Runtime Pooling
  • 14.1.3 Minimizing Client Resource Requirements
  • 14.1.4 Minimizing Forms Services Resource Requirements
  • 14.1.5 Minimizing Network Usage
  • 14.1.6 Maximizing the Efficiency of Packets Sent Over the Network
  • 14.1.7 Rendering Application Displays Efficiently on the Client
• 14.2 Tuning Oracle Forms Services Applications
  • 14.2.1 Location of the Oracle Forms Services with Respect to the Data Server
  • 14.2.2 Minimizing the Application Startup Time
  • 14.2.3 Reducing the Required Network Bandwidth
  • 14.2.4 Other Techniques to Improve Performance
• 14.3 Web Cache and Forms Integration

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.3 Diagnosing Server Crashes with Stack Traces
  • A.3.1 About Stack Traces
  • A.3.2 Configuring and Using Stack Traces
• A.4 Diagnosing Client Crashes
  • A.4.1 About Diagnosing Client Crashes
  • A.4.2 Diagnosing Hanging Applications
• 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.4 Improving Performance with Caching
• A.7 Troubleshooting Tips
• A.8 Need More Help?

B Configuring Java Plug-ins

• B.1 Supported Configurations
• B.2 Legacy Lifecycle Behavior And Configuration Requirements
  • B.2.1 Configuration Requirements

C Locations and Samples of Configuration Files

• C.1 Locations of Forms Configuration Files
• C.2 Default formsweb.cfg
• C.3 Platform Specific default.env Files
  • C.3.1 Default default.env File for Windows
  • C.3.2 Default default.env File for UNIX and Linux
• C.4 base.htm and basejpi.htm Files
  • C.4.1 Parameters and variables in the baseHTML file
  • C.4.2 Default base.htm File
  • C.4.3 Default basejpi.htm File
• C.5 web.xml
  • C.5.1 Default web.xml File
• C.6 weblogic.xml
• C.7 forms.conf
  • C.7.1 Default forms.conf
• C.8 Registry.dat
  • C.8.1 Registry.dat
• C.9 Default jvmcontroller.cfg
• C.10 Default webutil.cfg
• C.11 Default webutilbase.htm
• C.12 Default webutiljpi.htm

Index