Contents IndexChapter 35.  Using the Database Tools Interface Using the DBTools interface

User's Guide
   Part V. The SQL Anywhere Programming Interfaces
     Chapter 35. Using the Database Tools Interface
      The DBTools interface

Sybase SQL Anywhere includes Sybase Central and a set of command-line utilities for managing databases. These database management utilities carry out tasks such as backing up databases, creating databases, translating transaction logs to SQL, and so on.

Supported platforms

All SQL Anywhere database management utilities use a shared library called the DBTools library. It is supplied for each of the Windows 3.x, Windows 95, Windows NT, and OS/2 operating systems. The name of this library in your SQL Anywhere installation is operating system-dependent:

Operating system DBTOOLS library name
Windows 95 and NT DBTL50T.DLL
Windows 3.x DBTL50W.DLL
OS/2 DBTL502.DLL

You can develop your own database management utilities, or incorporate database management features into your applications, by calling the DBTools library. This chapter describes the interface to the DBTools library. In this chapter, we assume you are familiar with how to call DLLs from the development environment you are using.

The DBTools library has functions, or entry points, for each of the database management utilities. In addition, there are functions that must be called before use of other DBTools functions and when you have finished using other DBTools functions.

The DBTOOLS.H header file

The DBTOOLS header file included with SQL Anywhere lists the entry points to the DBTOOLS library and also the structures used to pass information to and from the library. The DBTOOLS.H file is installed into the H subdirectory under your SQL Anywhere installation directory. You should consult the DBTOOLS.H file for the latest information about the entry points and structure members.

The DBTOOLS.H header file includes two other files:

Also, the SQLDEF.H header file includes error return values.

Contents IndexChapter 35.  Using the Database Tools Interface Using the DBTools interface