Skip Headers

Oracle® Application Server Forms Services Deployment Guide 10g Release 2 (10.1.2) B14032-03 |
| Library | Product | Contents | Index

Previous | Next |

# 4.4 Configuring Environment Variables with Enterprise Manager

Use the Environment tab of the Enterprise Manager Application Server Control Console page 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 runtime executable (`frmweb.exe` on Windows and `frmweb` on Solaris) are defined in the Environment tab. The Listener Servlet calls the executable and initializes it with the variable values provided in the environment file, which is `ORACLE_HOME/forms/server/default.env` by default.

Any environment variable that is not defined in that page is inherited from the servlet engine (OC4J). The environment file must be named in the `envFile` parameter in the Default section of the Forms 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 will need administrator privileges to alter registry values.

- You do not need to restart the server for configuration changes to take effect.

- Environment variables not set in the environment file or Windows registry are inherited from the environment of the parent process, which is the servlet engine (OC4J).

  Note: You cannot create or delete environment files through Enterprise Manager Application Server Control Console. Environment files must be created manually in `ORACLE_HOME/forms/server` with a `.env` extension. Likewise, environment files cannot be deleted from Application Server Control. For a new environment file to be picked up by Application Server Control Console and for a deleted one to disappear you will need to restart the Enterprise Manager processes: `emctl stop em` `emctl start em`

Table 4-11, "Default Environment Variables" describes important environment variables that are specified in default.env:

Table 4-11 Default Environment Variables

Environment Variable | Valid Values | Purpose
--- | --- | ---
`ORACLE_HOME` | `ORACLE_HOME` (default) | Points to the base installation directory of any Oracle product.
`PATH` | `ORACLE_HOME\bin` (default) | Contains the executables of Oracle products.
`FORM_PATH` | `ORACLE_HOME\forms` (default) | 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 Solaris, separate paths with a colon (:).
`FORMS_TIMEOUT` | Default: 15 Valid Values: 3 – 1440 (1 day) Example: `FORMS_TIMEOUT=1440` | 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.
`TNS_ADMIN` | `ORACLE_HOME/network/admin` | Specifies the path name to the TNS files such as TNSNAMES.ORA, SQLNET.ORA etc.
`CLASSPATH` | `ORACLE_HOME/jdk/bin/java` | Specifies the Java class path, which is required for the Forms debugger.
`REPORTS_CLASSPATH` | `ORACLE_HOME/jlib/zrclient.jar:ORACLE_HOME/reports/jlib/rwrun.jar` | This setting is only needed if Reports applications are called from Forms applications
`REPORTS_SERVERMAP` | `cluster:repserver` Where: `cluster` is the Reports Server cluster name; `repserver` is the Reports Server name. | This setting is needed if Forms applications are calling Reports applications from a Reports cluster instead of a Reports server. This setting is also needed when a Forms application calls a Reportss application using `web.show_document`. See Oracle Application Server Reports Services Publishing Reports to the Web for additional Reports configuration information.
`ORACLE_GRAPHICS6I_HOM` | `<GRAPHICS6I_HOME>` | These settings are only needed if Graphics applications are called from Forms applications Use Enterprise Manager to set the `ORACLE_HOME` value to use Graphics applications.
`LD_LIBRARY_PATH` | Set the `LD_LIBRARY_PATH` environment variable for the first time to `ORACLE_HOME/lib`. You can reset `LD_LIBRARY_PATH` in the Bourne shell by entering: `$ set LD_LIBRARY_PATH=ORACLE_HOME/lib:${LD_LIBRARY_PATH}` `$ export LD_LIBRARY_PATH` or in the C shell by entering: `% setenv LD_LIBRARY_PATH ORACLE_HOME/lib:${LD_LIBRARY_PATH}` | Oracle Forms Developer and Reports Developer products use dynamic, or shared, libraries. Therefore, you must set `LD_LIBRARY_PATH` so that the dynamic linker can find the libraries.

Note: On Windows, Oracle Application Server Forms Services reads Oracle environment settings from the Windows Registry unless they are set as environment variables.