Progress
DataServer
for ORACLE Guide


Setting Environment Variables

After you run the PROBUILD utility to create your link scripts or command procedures, you must set some of the DataServer environment variables or logicals on the host machine before you run the scripts to create the executables. The others you can set after linking the executables. Be sure to set the environment variables in the same environment (UNIX shell) from which you plan to link and run the executables. Table E–2 describes how to set them for the local DataServer and Table E–3 describes how to set them for the remote DataServer.

Table E–2: Environment Variables for the Local DataServer
Variable
How to Set It
DSLOGDIR
The pathname of the log file that Progress uses to keep track of DataServer processes and error messages. By default, Progress writes to $DSLOGDIR/dataserv.lg in the current directory. (Optional)
ORACLE_HOME
The pathname of the directory where you installed ORACLE. (Required before running link scripts)
ORACLE_SID
The identifier for the ORACLE instance you are accessing. (Required before running link scripts)
ORALIB
The identifier for the ORACLE libraries which must be linked into the executable you created with PROBUILD. The buildenv script automatically sets this variable for you if it is not already set. If there are problems running the executables, see the "Setting ORALIB" section for troubleshooting instructions. (Required before running link scripts for some configurations)
PROEXE
The pathname of the Progress client executable you created with PROBUILD. After setting this variable, you can run your customized executable by entering pro at the system prompt. Make sure that you have set DLC to the directory where Progress is installed. (Optional)
LD_LIBRARY_PATH
(Sun Solaris)
or
LIBPATH (AIX)
or
SHLIB_PATH (HP-UX)
Identifies ORACLE shared libraries. Set this variable to include $ORACLE_HOME/lib. On your UNIX system, if the SETUID bit is on, make sure there is a soft link from /usr/lib pointing to the ORACLE shared libraries.
Note that ORACLE does not support shared objects on all UNIX platforms. See your ORACLE documentation for more information.
(Required when running executables that access ORACLE7 or ORACLE8)

Table E–3: Environment Variables for the Remote DataServer
Variable
How to Set It
DSLOGDIR
The pathname of the log file that Progress uses to keep track of DataServer processes and error messages. By default, Progress writes to $DSLOGDIR/dataserv.lg in the current directory. Set this variable on the host machine. (Optional)
ORACLE_HOME
The pathname of the directory where you installed ORACLE. Set this variable on the host machine. (Required before running link scripts)
ORACLE_SID
The identifier for the ORACLE instance you are accessing. Set this variable on the host machine. (Required before running link scripts)
ORALIB
The identifier for the ORACLE libraries which must be linked into the executable you created with PROBUILD on the host machine. The buildenv script automatically sets this variable for you. If there are problems running the executables, see the "Setting ORALIB" section for troubleshooting instructions. Set this variable on the host machine. (Required before running link scripts for some configurations)
ORASRV
The name of the executable (including the path) of the ORACLE DataServer. Set it to the DataServer executable you created with PROBUILD. Set this variable on the host machine. (Optional)
PROBRKR
The pathname to the executable of the broker. Set it to the broker executable for the remote DataServer you created with PROBUILD. Set this variable on the host machine. (Optional)
PROEXE
The pathname of the Progress client executable you created with PROBUILD. After setting this variable, you can run your customized executable by entering pro at the system prompt. Make sure that you have set DLC to the directory where Progress is installed. Set this variable on the client machine. (Optional)
LD_LIBRARY_PATH
(Sun Solaris)
or
LIBPATH (AIX)
or
SHLIB_PATH (HP-UX)
Identifies ORACLE shared libraries. Set this variable on the host machine to include $ORACLE_HOME/lib. On your UNIX system, if the SETUID bit is on, make sure there is a soft link from /usr/lib pointing to the ORACLE shared libraries.
Note that ORACLE does not support shared objects on all UNIX platforms. See your ORACLE documentation for more information.
(Required when running executables that access ORACLE7 or ORACLE8)

Once you set these variables, you can run the link scripts you created with PROBUILD to generate executables. See the "Linking DataServer Executables" section for instructions.


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