DCI

The DBMaker’s COBOL Interface (DCI) allows isCOBOL to work on the DBMaker RDBMS with a ISAM approach.

DCI is available for Windows and Linux platforms.

In order to associate the DCI file handler to your indexed files, the following setting must appear in the configuration:

iscobol.file.index=dci

It’s possible to associate only specific files to DCI. For example, the following configuration uses JIsam for all indexed files, except for "file1" that is associated to DCI:

iscobol.file.index=jisam iscobol.file.index.file1=dci

Indexed files can be associated to DCI also through the CLASS clause in the SELECT statement. E.g.

SELECT FILE1 ASSIGN TO FILE1-PATH               ORGANIZATION INDEXED               CLASS "com.iscobol.io.DynamicDCI"               ACCESS MODE DYNAMIC               RECORD KEY FILE1-KEY               STATUS FILE-STATUS.

The DCI library (dci.dll on Windows and libdci.so on Linux) is required in the library path (%PATH% on Windows and $LD_LIBRARY_PATH on Linux).

The isCOBOL installation includes a DCI library version 5.3 that is suitable for DBMaker 5.3.x versions. If you wish to interface a different version of DBMaker, then you should replace the installed DCI library with a different library. The DBMaker public FTP repository (ftp://ftp.dbmaker.com/pub/DBMaker/) includes the setups of each DBMaker version. Among the setups there is an archive named "DCI-version-.zip" that includes DCI libraries for various COBOLs. The "iscbl" folder in the zip contains the libraries required by isCOBOL.

DCI requires EFD dictionaries in order to manage COBOL indexed files as DBMaker database tables. The dictionaries are generated by the Compiler if the -efd option is used.

DCI looks for the configuration file pointed by the environment variable DCI_CONFIG. The basic configuration is:

Configuration Entry	Meaning
DCI_DATABASE	Name of the DBMaker database to connect
DCI_LOGIN	User name credential
DCI_PASSWD	Password credential
DCI_EFDPATH	Directory where EFD dictionaries are stored.

Example - the following configuration allows to connect to the default database DBSAMPLE5 with user SYSADM without password having the EFD dictionaries stored in the folder C:\myapp\efd:

DCI_DATABASE DBSAMPLE5 DCI_LOGIN SYSADM DCI_EFDPATH C:\myapp\efd

Refer to the DCI Manual from Casemaker for more information about the usage of DCI, including all the available configuration entries and library routines.