C API Introduction



Overview

The C API is designed to allow you to customize the application server without requiring knowledge of the TSD Script program language. The components of the C API include a C DLL and the following files that users include in the applications that access the C API:

In addition, you need the following library files for your respective operating system.

Library file Operating system
tsdc110.lib Windows NT/Windows 95/Windows 98
libsdc110.a AIX
libtsdc110.so Solaris
APIErrorDefs.h HP/UX

You can use CAPI functions from any language that supports DLL callouts, such as Java, Visual Basic, C, and C++.


Purpose of the API DLL

The C API acts as a mediator between your application and the application server. The following diagram illustrates this relationship:

Calling Application <----> C API Layer <----> application server


Adding the C API to an application

The listed files must be in an application using the C API. These files must be directly linked to the application source

File Description
tsdcapi.h Definition file for available C API calls
APIStruct.h Definition of the C style structures used in the C API
tsdcapi.lib Library file required for interfacing with the C API
API ErrorDefs.h Error codes returned by C API calls

In addition to the source files listed the following DLL files must be in a directory accessible by the C API.

Note: Several TDT files are required for the C API to operate.

DLL file Description
tsdc110.dll C API DLL (Windows NT, 98, and 95 only)
heap510.dll ASE DLL
net110.dll ASE DLL
nls310.dll ASE DLL
util510.dll ASE DLL