Lists the environment variables that you must set on to enable use of
Enterprise Server on UNIX platforms.
Note: If you want to do any database access from within
Enterprise Server you need to add the necessary libraries to the
PATH environment variable and to the
LD_LIBRARY_PATH or
LIBPATH (AIX only) environment variables, depending on your UNIX system. For full information about setting the environment up for
database access see the documentation supplied by your database vendor.
- Specifies the directory where
Enterprise Server is installed. Many system components and utilities require and use this information.
- Syntax
-
COBDIR=path-name
- Parameter
-
- path-name
- The directory that contains the required
Micro Focus COBOL system software.
- Default
- Not set. The default path is
%ProgramFiles(x86)%\Micro Focus\Visual COBOL
(Windows) or
/opt/microfocus/VisualCOBOL
(UNIX).
- Comments
-
On Windows platforms, the
Micro Focus COBOL system is normally installed in the default COBOL system directory and so does not require COBDIR to be set. COBDIR only
needs to be set when your COBOL system has been installed in a different directory such as when more than one version of the
COBOL system is available at the same time.
- Examples
-
Windows platforms:
This example causes the compiler to search the directory
C:\products\cobse20 for the
Micro Focus COBOL system software:
COBDIR=C:\products\cobse20
UNIX platforms:
This example causes the compiler to search the directory
/home/products/cobse20 for the
Micro Focus COBOL system software.
COBDIR=/home/products/cobse20
- Specifies the directories to be searched by all
Windowsand
UNIX programs, including the run-time system, when finding executables to be run.
- Syntax
-
Windows:
PATH=path-name[;[path-name][...]]
UNIX:
PATH=path-name[;[path-name][...]]
- Parameter
-
- path-name
- The full or relative path to a directory to search for executables.
- Default
- None. Set at the system level.
- Comments
-
On Windows platforms, this environment variable is set in the system registry. You can change the values using the SET command, but values you set
are only added to the values already set in the registry.
- Example
-
Windows:
PATH=c:\myprojects\proj\loadlib;%USERNAME%\srclib
UNIX:
PATH=u:/home/mydir/srclib:otherlib
- Specifies the directory or directories for the UNIX system,
cob command, and the run-time system to search for shared libraries and callable shared objects.
Restriction: This environment variable applies to UNIX environments only.
- Syntax
-
LD_LIBRARY_PATH={$COBDIR/lib|path-name}[:path-name[...]]
- Parameter
-
- path-name
- The full path to a directory to search.
- Default
- Not set. Looks in the current working directory only.
- Comments
- This environment variable is a system environment variable; see your UNIX documentation for more information.
If you have installed the product to a directory other than the default, you must set this variable, and include
$COBDIR/lib on all platforms except AIX (which uses LIBPATH). It should also include any directories that contain callable shared objects
used by your application.
If you have installed the product in the default directory (/opt/microfocus/VisualCOBOL), you do not need to set this variable.
- Example
-
LD_LIBRARY_PATH=$COBDIR/lib:/home/mydir/myapp:$LD_LIBRARY_PATH
- On AIX platforms only, specifies the directory or directories for the UNIX system,
cob command, and the run-time system to search for shared libraries and callable shared objects.
Note: This environment variable applies to UNIX environments only.
- Syntax
-
LIBPATH={$COBDIR/lib|path-name}[:path-name[...]]
- Parameter
-
- path-name
- The full path to a directory to search.
- Default
- Not set. Looks in the current working directory only.
- Comments
- If you have installed the product on an AIX platform and to a directory other than the default, you must set this variable,
and include
$COBDIR/lib. It should also include any directories that contain callable shared objects used by your application.
If you have installed the product in the default directory (/opt/microfocus/VisualCOBOL), you do not need to set this variable.
- Example
-
LIBPATH=$COBDIR/lib:/lib:/usr/lib