Document-ID:        18028.1
Subject:            (V4,4.5/V2,2.5) ENVIRONMENT VARIABLES FOR FORMS AND REPORTS
Author:             BPATEL
Last Modified:      28 August    1995


            Environment Variables for Oracle Forms V4.0, V4.5
                     and Oracle Reports V2.0, V2.5

This bulletin lists environment variables used for Oracle Forms V4.0, V4.5 and
Oracle Reports V2.0, V2.5 on UNIX, Windows and Macintosh.

Oracle Forms
============

Versions Earlier than V4.0.13
-----------------------------

Purpose       UNIX          Windows             Macintosh
---------------------------------------------------------------------
source files  ORACLE_PATH   FORMS40_PATH        FORMS40_PATH
(fmb,fmx,etc)
editor        FORMS_EDITOR  FORMS40_EDITOR      N/A
temp files    TMPDIR        TMP
default font  *             FORM40_DEFAULTFONT  FORMS40_DEFAULTFONT
icon files    TK2_ICON      TK20_ICON           **
              ORACLE_ICON
terminal      TERM          N/A          N/A
              ORACLE_TERM

 * Default font can be changed with Tk2Motif on UNIX. See Oracle CDE Release
   Update or bulletin 103381.962 for more information.
** A folder named ICON is used to locate icon files. See bug 209510.
   Macintosh puts the temporary files in the Forms folder. See bug 195464.

Note that some of the above variables are not available before V4.0.12.
FORMS40_DEFAULTFONT is one of them.

Version 4.0.13
--------------

In V4.0.13 all variables remain the same except the "PATH" variable for
source files. The following algorithms shows the order of directories in which
Oracle Forms looks for source files (fmx, mmx, lib, etc).

For UNIX and Macintosh, the following algorithm is used:

1, If Full Pathname Specified, use that and no other.
2, If No Pathname Specified, search for the file in the following order:
   a, The Working/Current Directory
   b, Sequentially in each of the directories named by the value of the
      environment variable FORMS_PATH
   c, Sequentially in each of the directories named by the value of the
      environment variable ORACLE_PATH

For Windows, the following is used:

1, If Full Pathname Specified, use that and no other.
2, If No Pathname Specified, search for the file in the following order:
   a, The Working/Current Directory set in the icon property for the
      application (Microsoft Windows specific).
   b, Sequentially in each of the directories named by the value of the
      environment variable FORMS_PATH
   c, Sequentially in each of the directories named by the value of the
      environment variable ORACLE_PATH

One important note in using environment variables for libraries. If you do not
specify the path when you attach a library to a form, the pll file must be
in current/working directory. However, once you attach it, you can move the
library files (pll, pla, and lib files) to any directories in FORMS40_PATH
or FORMS_PATH and the form will find them during run time.

Note: Forms 4.0.13 can also use ORACLE_PATH for external reference.  So
      directories are searched in following order:
               current directory, FORMS_PATH, ORACLE_PATH

Version 4.5.5.3.5
-----------------

Purpose          Windows           Examples
--------------------------------------------------------------------------
source file   FORMS45_PATH         *.fmx (form), *.mmx(menu),
                                   *.pll (pl/sql libraries),
                                   *.tif (image files)
editor        FORMS45_EDITOR       defines the editor that can be invoked
                                   by multi-line items in designer
                                   eg. FORMS45_EDITOR=C:\windows\notepad.exe
default font  FORMS45_DEFAULTFONT  font used for boilerplate in
                                   the Layout Editor
icon files    TK21_ICON            *.ico files

Note: FORMS45_PATH can specify multiple directories, as long as they are
      separated by a semi-colon.  For example:
      FORMS45_PATH=C:\Oracle\apps\forms;C:\forms45

Oracle Reports
==============

Here are the environment variables for Oracle Reports. External
references refer to external queries, external boilerplate and reports in
RUN_REPORT.

Version 2.0.12
--------------

Purpose          Motif        Windows                Macintosh
--------------------------------------------------------------
External Ref     REP_PATH     RW20_PATH              REP_PATH
TEMP files       REP_TMP      SET TMP=<valid dir>    REP_TMP
                              (in AUTOEXEC.BAT)

Version 2.0.13
--------------

Purpose          Motif        Windows                Macintosh
--------------------------------------------------------------
External Ref     REP_PATH     RW20_PATH                   N/A
TEMP files       REP_TMP      SET TMP=<valid dir>         N/A
                              %TMP%=<valid dir>
                                 (in oracle.ini)

Version 2.0.14
--------------

Purpose          Motif        Windows                 Macintosh
---------------------------------------------------------------
External Ref*     N/A         REPORTS_PATH                N/A
TEMP files  **    N/A         SET TMP=<valid dir>         N/A
                              REPORTS_TMP=<valid dir>

* Search in the order of Current directory, REPORTS_PATH and then ORACLE_PATH.
**Use REPORTS_TMP if set, otherwise current directory.

Note: As in case of Forms 4.0.13, Oracle Reports 2.0.14 can also use
      ORACLE_PATH for external reference.  So directories are searched
      in this order: Working Dir, REPORTS_PATH, ORACLE_PATH

Version 2.5
-----------

Purpose          Motif        Windows                  Macintosh
----------------------------------------------------------------
External Ref      N/A         REPORTS25_PATH                N/A
TEMP files        N/A         SET TMP=<valid dir>           N/A
                              REPORTS25_TMP=<valid dir>

Note:  As in case of FORMS45_PATH, you can specify multiple directories
       for both, REPORTS25_PATH and REPORTS_TMP, as long as they are
       separated by semicolons.