Programming Interfaces Guide
CHAPTER 3. The Database Tools Interface
Sybase Adaptive Server 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 the database management utilities use a shared library called the database tools 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 is operating system-dependent:
Operating system |
DBTOOLS library name |
|---|---|
Windows 95 and NT |
dbtool6.dll |
Windows 3.x |
dbtool6w.dll |
OS/2 |
dbtool62.dll |
You can develop your own database management utilities, or incorporate database management features into your applications, by calling the database tools library. This chapter describes the interface to the database tools library. In this chapter, we assume you are familiar with how to call DLLs from the development environment you are using.
The database tools library has functions, or entry points, for each of the database management utilities. In addition, functions must be called before use of other database tools functions and when you have finished using other database tools functions.
The DBTOOLS header file included with Adaptive Server 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 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:
sqlca.h This is included for resolution of various macros, not for the SQLCA itself.
dllapi.h Defines preprocessor macros for operating-system dependent and language-dependent macros.
Also, the sqldef.h header file includes error return values.