Product Documentation

FairCom ISAM for C

Previous Topic

Next Topic

Bound Server Model

Bound Server Model

The FairCom Database supports several operational models in addition to the traditional client/server model. The Server DLL model essentially allows you to compile the server into your application. This is the latest generation of the Bound Server model in which your application calls the server as a DLL. In the latest Server DLL moel, it is linked as a static library.

FairCom is pleased to provide you the ability to link your own functionality directly into FairCom’s industry proven database server with the FairCom SDK. This unique level of control sets FairCom apart from other alternatives by offering you the true power and flexibility required by your most demanding database server applications. With additional source code availability, no other database server vendor provides this level of access and control.

The Server DLL (based on the Bound Server Model introduced in earlier releases) provides the advanced engineer a proven database engine in the form of a multi-thread safe library. FairCom’s multi-threaded API and available communication logic give the serious engineer the necessary tools to create custom application-specific Servers.

This model allows you to tightly bind the FairCom Database Engine with your own application to create a powerful multi-threaded package.

Note: This model requires significant initial design efforts on the part of an experienced C programmer. Your application code implements the fundamentals of a multi-threaded FairCom Database Engine, such as threads, security, and any other requirements of your special application.

The FairCom Server DLL Development Program requires a signed distribution license prior to deployment. This model “takes the lid off” FairCom’s advanced database server and gives the developer the opportunity to use FairCom’s sophisticated database engine for custom needs. For additional information, contact your nearest FairCom office to discuss your requirements.

Benefits

  • Linkable library allows you to link your own needs into the multi-thread safe FairCom Database Engine.
  • Great technology to use for your web application servers. Bind web applications directly with the FairCom Database Engine and eliminate the overhead of inter-process communications.
  • Supports all FairCom API functions and offers exceptional performance.

Considerations

  • Requires engineering expertise to design and implement the FairCom Database Engine code.
  • Requires a distribution license for production use.

Server DLL sample makefile in drivers folder

The folder named ctree.srvdll in the drivers folders provides examples of how to link with the Server DLL. This folder contains a makefile for each platform. Include folders have been added for both SQL and ISAM capabilities. The makefiles demonstrate linking to the Server DLL provided in the bin/ace/sql folder. The proper header files are provided to ensure consistency.

Function to pass FairCom DB configuration file contents in buffer

The c-tree Server DLL (shared library on Unix) supports a way of passing c-tree Server configuration options to the database engine rather than requiring a configuration file. To use this feature, before calling cThrdInit() to initialize the database engine, call ctSetConfigurationOptions() (ctSetConfigurationOptions, ctSetConfigurationOptions).

For your convenience, we have implemented this functionality in ctixmg, a c-tree sample application.

Function pass FairCom DB license options in buffer

The c-tree Server DLL (shared library on Unix) supports a way of passing c-tree Server license options to the database engine rather than requiring a license file.To use this feature, before calling cThrdInit() to initialize the database engine, call ctSetLicenseOptions() (ctSetLicenseOptions, ctSetLicenseOptions).

For your convenience we have implemented this functionality in ctixmg, an example application built in the topic titled Bound Server example - ctree.srvdll.

TOCIndex