Summary of Btrieve API Operations
The Btrieve API provides over 40 operations that you can call from your application program. The following tables summarize these operations. Refer to Chapter 2, Btrieve API Operations, for complete descriptions of the Btrieve API operations. Refer to Appendix A, Quick Reference of Btrieve Operations, for a summary of Btrieve API operations ordered by operation code.
Session-Specific Operations
The following operations allow you to set or retrieve the current directory, shut down a workstation transactional interface, retrieve the transactional interface version number, terminate a client connection with the server transactional interface, and begin, end, or abort a transaction. In applications that handle multiple clients, these operations are specific to the calling client.
File-Specific Operations
The following operations deal with a specific file, and therefore use the position block parameter to identify the file on which to operate. The file-specific operations are of three types:
File access and information. These operations allow you to create a file, open and close a file, retrieve file statistics, set and clear the file’s owner name, start or stop continuous operation mode on a file, unlock a file, and create and drop indexes on a file.
Data retrieval. These operations allow you to retrieve a single record or a set of records given specified criteria. The Btrieve API supports data retrieval either by logical location in an index path or by physical location. For more information, refer to “Accessing Records” in the Pervasive PSQL Programmer's Guide.
In addition, you can apply biases to the operation codes to control file and record locking in multi-client situations. For more information, refer to “Supporting Multiple Clients” in the Pervasive PSQL Programmer's Guide.
Data manipulation. These operations allow you to insert, update, or delete data.
Unsupported Operations
When looking at transactional interface traces or SDK header files, you may see operations that are not listed in the reference for Btrieve API operations. These are for the internal use of Pervasive PSQL and you should not use them in your applications. The following operations are not supported.