User's Guide Part V. The SQL Anywhere Programming Interfaces Chapter 35. Using the Database Tools InterfaceSybase 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.
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 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.