isCOBOL uses the c-tree interface in one of the following cases:

The isCOBOL Framework becomes a client process that connects to a listening c-tree Server. To provide this connection, isCOBOL loads the ctree client library (ctree.dll on Windows, libctree.so on Linux) which must be available in the library path and must be the same version of the listening c-tree Server. A copy of this library is provided along with isCOBOL and it’s of the same version as the latest c-tree server available for download at Veryan’t web site. The library is installed in the bin folder on Windows and in the native/lib folder on Linux/Unix). You can replace this library if you need to work with a different version of c-tree.

isCOBOL can create c-tree files directly into the c-tree SQL Server so they are available as database tables for external SQL tools. Consult Creating c-tree files into c-tree SQL Server from the COBOL Program chapter for details.

In order to bring existing c-tree files into the SQL Server, instead, ctutil utility must be used. Consult Registering existing c-tree files in c-tree SQL Server chapter for details.

The c-tree File Connector allows to work on c-tree files managed by c-tree by separating ISAM native access from java process. This solution is suggested when working with third party application servers (e.g. Apache Tomcat).

isCOBOL uses the file connector interface in one of the following cases:

If you need to interface with a previous c-tree version, you can’t rely on the c-tree client library installed along with isCOBOL. You need to replace it with the proper c-tree library taken from the distribution of the c-tree that you wish to interface.

In addition, the file handler class and its alias may be different. The following table lists the file handlers available for the various c-tree versions:

[B] Deprecated since isCOBOL 2016 R1.