ADABAS requires that some modifications and additions are made to the system environment variables. The ADABAS kernel can only be started when these modifications have been made and put into effect. The installation program "setup" can make these changes automatically, but the system environment variables can also be edited manually.
In this case, one directory must be added to each of the INCLUDE, LIB, and PATH environment variables, and the environment variables DBROOT, SERVERDB, and DBCHARSET should be set in the environment variables. The following description explains how these modifications can be made, if necessary:
Select CONTROL PANEL from MAIN. Then double-click on SYSTEM and you will see a list of the already defined system environment variables. Variables that are only to be extended can be selected and extended in the bottom part of the window. The modification must be confirmed using SET. To generate new variables, simply enter the identifier and the value of the variable in the bottom part of the window and confirm the entries with SET.
All directory names needed by ADABAS are stored in %DBROOT%. When adding directory names specify the complete path name. The Windows NT environment substitution mechanism (e.g. %DBROOT%) must not be used for this purpose. For example, if %DBROOT% is "c:\esd", then specify "c:\esd\dll" instead of "%dbroot%\dll". In the following examples, it is assumed that %DBROOT% is equal to "c:\esd". If another name has been chosen during the installation, use this name in a corresponding manner.
1. Extend the LIB
ADABAS uses different libraries for the precompilers. These libraries are stored in the directory "%dbroot%\lib". This directory name must be added to the "lib" variable. If there is not yet a "lib" variable, it must be created.
If the current value of the LIB variable is, e.g.:
LIB:
C:\MSVC20\LIB
then it must be changed as follows:
LIB:
C:\MSVC20\LIB;C:\ESD\LIB
2. Extend INCLUDE
ADABAS uses different include files for the precompilers. These files are stored in the directory "%dbroot%\incl". This directory name must be added to the "include" variable. If there is not yet an "include" variable, it must be created.
If the current value of the INCLUDE variable is, e.g.:
INCLUDE:
C:\MSVC20\INCLUDE
then it must be changed as follows:
INCLUDE:
C:\MSVC20\INCLUDE;C:\ESD\INCL
3. Extend PATH
The directory "%dbroot%\bin" contains the call files for the ADABAS programs. This directory must be added to the PATH variable. If the current value is, e.g.:
PATH:
%SystemRoot%\..<usw>..;C:\MSVC20\BIN
then it must be changed as follows:
PATH:
%SystemRoot%\..<usw>..;C:\MSVC20\BIN;C:\ESD\BIN;C:\ESD\PGM
4. Setting the Environment Variable DBROOT
The environment variable DBROOT must always be set, before work with ADABAS can be started. For this reason, it is recommended to enter DBROOT with the system environment variables. This is mandatory when the ADABAS program calls are added as program icons to the Windows NT Program Manager.
To set DBROOT, add the following lines to the system environment variables:
DBROOT:
C:\ESD
Use the absolute path name. If another name is to be used for the ADABAS directory, specify this name instead of "c:\esd".
5. Setting the Environment Variable DBCHARSET
DBCHARSET denotes the name of the TERMCHAR SET to be used. A TERMCHAR SET can be used to define national special characters, as, for example, the German umlauts (see Section Mapping National Special Characters).
If the environment variable DBCHARSET is set, national special characters are converted whenever the database is used (e.g., when calling "xquery"). For this conversion, a TERMCHAR SET is used which was defined with CONTROL.
During the installation of ADABAS, the conversion of German umlauts is installed as basic setting. If several TERMCHAR SETs are used, DBCHARSET should contain the name of the TERMCHAR SET used most frequently, for example:
DBCHARSET:
IBM437_GER
6. Setting the Environment Variable SERVERDB
SERVERDB designates the name of the SERVERDB. Setting the environment variable SERVERDB has the advantage that the specification of the SERVERDB name can be omitted in commands of the ADABAS operating system embedding (e.g., "xcontrol") or in ADABAS program calls (e.g., "xquery"), because it will be taken from SERVERDB. If several SERVERDBs are used, SERVERDB should contain the name of the SERVERDB that is used most frequently. SERVERDB can be added to the system environment variables in the following way:
SERVERDB:
TESTDB
7. Rebooting the Computer
The computer must be rebooted in order that the modifications in the system environment variables become effective and the installation can be continued.