Timing out Oracle Forms sessions in Oracle Application Server
To configure your Forms sessions to time out after a specified period of user inactivity. This document refers to Oracle Application Server (OAS) 10g R2 (10.0.1.2), but the following instructions will also work on OAS 9i and OAS 10g R1 (9.0.4) with some modifications.
Oracle Forms relies on 3 settings to control inactivity timeout. Where $ORACLE_HOME is specified it refers to the Oracle Home location of the Application Server middle-tier.
FORMS_TIMEOUT environment variable:
Location: Stored in the default.env file (this can be overriden in formsweb.cfg to use custom .env files in which case these must be modified instead of default.env)
$ORACLE_HOME/forms/server/default.env
FORMS_TIMEOUT Default: 15
Valid Values: 3 – 1440 (1 day)
This parameter specifies the amount of time in elapsed minutes before the Form Services process is terminated when there is no client communication with the Form Services.
Client communication can come from the user doing some work, or from the Forms Client heartbeat if the user is not actively using the form.
heartBeat applet parameter:
Location: Stored in the formsweb.cfg file
$ORACLE_HOME/forms/server/formsweb.cfg
heartBeat Default: 2
Valid Values: 1 – 1440 (1 day)
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. The default is two minutes. If the heartbeat is less than FORMS_TIMEOUT, the user's session will be kept alive, even if they are not actively using the form.
web.xml configuration file for Forms servlet:
Location:
$ORACLE_HOME/j2ee/OC4J_BI_Forms/applications/formsapp/formsweb/WEB-INF/web.xml
This file defines the OC4J forms & listener servlet definitions, including servlet parameters and session configuration.
The value of session-timeout refers to the maximum amount of inactivity that a single session can have before it is automatically invalidated by the server.
In OAS 10g R2, the following lines in italics must be added to web.xml. The value of <session-timeout> should be the same as FORMS_TIMEOUT.
<web-app>
......
......
<session-config>
<!-- Session timeout in minutes -->
<session-timeout>60</session-timeout>
</session-config>
</web-app>
NOTE: The Forms environment variable FORMS_TIMEOUT has changed names between versions - for OAS 9i and 10g R1 (9.0.4) it is FORMS90_TIMEOUT, and in OAS 10g R2 (10.0.1.2) it is FORMS_TIMEOUT).
Also, directory locations have changed for the configuration files.
In 9i and 10g R1, the directory names are slightly different to 10g R2.
default.env:
$ORACLE_HOME/forms90/server/default.env
formsweb.cfg:
$ORACLE_HOME/forms90/server/formsweb.cfg
web.xml file :
$ORACLE_HOME/j2ee/OC4J_BI_Forms/applications/forms90app/forms90web/WEB-INF/web.xml
posted by Andrew Hateley @ 5:53 PM
1 comments
