Progress
Installation and Configuration Guide
Version 9
for Windows


Environment Variables

Progress supports some environment variables for graphical user interface (GUI) clients in the [Startup] section of the progress.ini file. Progress supports environment variables for character clients, such as the AppServer and WebSpeed Agents, in the [WinChar Startup] section of the progress.ini file.

Table 5–1 lists the supported environment variables.

Table 5–1: Supported Environment Variables
Variable
progress.ini File Section
Description
Example
DLC1
[Startup]
[WinChar Startup]
The relative pathname of the directory where you installed your Progress system software. By default, the installation utility sets this variable.
set 
DLC=C:\Program 
Files\Progress 
EVTLEVEL
NT and 2000 only. Specifies the level of information that Progress writes to the NT or 2000 Application Event Log. You can specify one of the following cases:
None: No Progress events are written to the Event Log.
Brief: Progress Error and Warning messages are written to the Event Log.
Normal: Progress Error and Warning messages are written to the Event Log along with any Progress message that are normally written to the log file (.lg). This is the default.
Full: Progress Error, Warning, and Informational messages are written to the Event Log along with any messages generated by the Message Statement.
set EVTLEVEL = 
NORMAL 
PATH
A list of directory paths separated by semicolons. When you run a program or batch file, the system searches for it in the current directory. Then it searches in the directory paths defined in PATH in the order they are mentioned.
Your PATH should include any directory pathname that contains a program or batch file you want to run. Also, each directory pathname should include the drive letter of the disk that contains the directory.
PATH is a system environment variable, not a Progress environment variable. Set it in a manner appropriate for the operating system instead of in the registry or in progress.ini.
Different Progress products require different PATH settings. To set up PATH for your Progress product, follow the instructions provided in "The Progress Directory Structure."
set PATH=%PATH%;
%DLC%\BIN;%DLC% 
PROBUILD
[Startup]
The pathname of the directory that contains items referenced in link scripts produced by the PROBUILD utility. By default, the installation utility sets this variable.
set PROBUILD=
C:\Program Files\
Progress\PROBUILD 
PROCFG
[Startup]
[WinChar Startup]
The filename or full pathname of your product’s configuration file. The configuration file is a data file that identifies the Progress products and components that you are licensed to use. Reset PROCFG if you have moved your configuration file from the directory where you installed Progress.
set PROCFG=%DLC%\
PROGRESS.CFG 
PROCONV
The filename (or full pathname) of the Progress convmap.cp file. The convmap.cp file is a binary file that contains all of the conversion tables that are available to Progress. See the Progress Internationalization Guide for more information on the convmap.cp file.
set 
PROCONV=%DLC%\
CONVMAP.CP 
PROMSGS
[Startup]
[WinChar Setup]
The full pathname of your Progress error messages file. The default value is %DLC%\promsgs. Set the PROMSGS environment variable only if you want to use an error messages file different from the default PROMSGS file in the %DLC% directory.
set PROMSGS=
C:\Program Files\
Progress\PROLANG\
GER\PROMSGS.GER 
PROPATH
[Startup]
[WinChar Setup]
A list of directory paths separated by commas. By default, the installation utility sets this variable.
set PROPATH=.,
C:\Program Files\
Progress 
PROSTARTUP
The pathname of the Progress default startup parameter file, startup.pf. This file is read by all Progress modules at startup; it must exist for Progress to execute properly.
set PROSTARTUP=
C:%DLC%\STARTUP.P
F 
JDKHOME
Establishes the top-level directory for the Java Developer’s Kit (JDK).
set 
JDKHOME=%DLC%\jdk 
JREHOME
Establishes the top-level directory for the Java Runtime Environment (JRE).
set 
JREHOME=%DLC%\jre 
JFCHOME
Establishes the top-level directory for the Java Foundation Classes (JFC).
set 
JFCHOME=%DLC%\jfc 
JDKCP
Sets the classpath for class.zip; Java Developer’s Kit (JDK) only.
set JDKCP=
%variable-name%/
lib/class.zip 
JRECP
Sets the classpath for Java Runtime Environment (JRE); if no JRE, then it sets classpath for JDK.
set JRECP=
%variable-name%/
lib/rt.jar 
JFCCP
Sets the classpath for Java Foundation Classes (JFC) only.
set JFCCP=
%variable-name%/
swingall.jar 
PROGRESSCP
Contains a list of paths, jar files, and zip files for running Progress-specific products.
set PROGRESSCP=
%variable-name%/
java/progress.zip 
CLASSPATH
Progress correctly sets the appropriate classpath variable based on the platform in use.
set CLASSPATH=
$JDKCP;$JFCCP;
$PROGRESSCP 
JIT
Sets the just-in-time compiler correctly.
set JIT="-nojit" 
JVMEXE
Sets the Java virtual machine to run correctly.
set JVMEXE=jre 
  1. Note that the DLC variable is set in the various command scripts and in the registry; the variable is not set at the system level.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095