This product is installed using the Software AG Installer, which can be downloaded from the Software AG Empower website.
When installing Adabas Native SQL, you can select a typical development installation. The installer automatically groups and selects the Software AG products and components that make up that installation.
This release of the product supports COBOL only. The generated COBOL files can be compiled by the GnuCOBOL compiler or the Raincode COBOL compiler.
This document covers the following topics:
A minimum of 10 MB disk space is required to install the software.
A minimum of 2 GB system memory is required to run the software.
This product supports Red Hat 8 and above and SUSE 12 and above.
This product requires a permanent license in order to run. Every time you launch the software, the system reads the license key file and checks its validity.
The license key file is provided as an XML document. This document can be viewed, using a
browsing tool or text editor. During the installation, the Software AG Installer validates
the license file and copies it Software AG installation
directory/common/conf. Without a valid license, the installation
fails and the Installer displays an error message.
Note:
Any modification of the license key file will invalidate the digital signature and the
license key check will fail. If the check fails, you will not be able to install or run
the product. In the event of a check failure, contact your Software AG Support
representative.
The following components must be installed and accessible in order to access Adabas data:
Adabas 7.0 SP1 or later
Natural 9.1 SP4 or later
Predict 8.5 SP1 or later
These products can be installed locally with Adabas Native SQL or remotely on a different machine or LUW platform.
The installation of Adabas Native SQL selects its direct dependencies for accessing local Adabas databases and Predict files.
If the Adabas target database or Predict file are located on a remote machine, Entire Net-Work Client is required to be installed locally in the same environment as Adabas Native SQL.
Compiling your COBOL scripts with Adabas Native SQL requires a third-party COBOL compiler installed on your system and accessible to the environment. The following COBOL compilers are supported:
GnuCOBOL 3.1.2 or later
Raincode COBOL Compiler 4.1.332 or later
To install Adabas Native SQL, verify that a valid license key file is present in your
environment and perform the following steps:
In the Software AG Installer wizard, fill the required fields until you reach the panel.
From the product selection tree, select Adabas Native SQL and any other products from the Adabas Family you want to install.
In the panel, read the license agreement and select to agree to the terms of the license agreement.
In the panel, review the list of products and items you have selected for installation. If the list is not correct, click until you reach the product tree and correct your selections. If the list is correct, click to start the installation process.
To uninstall Adabas Native SQL, use the Software AG Installer. For detailed information, see Software AG Installer > Uninstall.
After you install Adabas Native SQL, perform the following configurations:
The Software AG installation
directory/AdabasNativeSQL/errmsgfile directory contains the files
and script necessary to load the error message file for AdabasNativeSQL in an Adabas
database. If errors occur when a program is being compiled, this file is accessed to
display and log details of the error.
The Adabas database containing this file can be on the local system or on a remote
Adabas instance. If loading this file from a remote database, transfer the contents of
the /errmsgfile directory to the local machine where Adabas is installed.
Using the script importSqlErrMsg.sh will invoke the necessary
Adabas utilities to load the new file. The syntax of the command is:
importSqlErrMsg.sh -d DBID -f FNR
Check the contents of the SQLERRMSG file with the
adarep command to make sure the file loaded into Adabas,
e.g.:
adarep db=12 file=255
The ADAGLOB.txt file, located in the /examples
directory, specifies the location of the Predict data dictionary file and the Adabas
Native SQL error messages file.
Edit this file to provide the correct values for the location of the Predict data
dictionary file (FDIC) and the Adabas Native SQL error messages file
(FNAT).
The database containing these files can be local or remote. If remote, you must have Entire Net-Work Client installed to access the remote database.