ABOUT THIS MANUAL This manual contains information on installing, configuring, executing, and monitoring the Btrieve record management system with the NetWare v3.11 operating system. Btrieve is a complete key-indexed record management system designed for high-performance data handling and improved programming productivity. Novell would appreciate your comments and suggestions about this manual. Once you have become familiar with the manual, please complete the User Comments form. You may respond by fax or mail. Who Should Read This Manual This manual provides information for systems administrators who are responsible for maintaining Btrieve databases on a network. This manual is also useful to programmers, systems developers, and systems integrators who are using Btrieve to develop applications and NetWare Loadable Modules (NLMsĒ) for the NetWare operating environment. Organization Chapter 1 Introduction to Btrieve This chapter discusses Btrieve's client-server design, features, and v6.x enhancements. Chapter 2 Btrieve Architecture This chapter describes the components of Btrieve and how Btrieve works with server and workstation applications. It also provides diagrams that illustrate how different applications use different Btrieve components. Chapter 3 Installing and Configuring Btrieve This chapter describes installing, configuring, loading, and unloading Btrieve from the server console and from the workstation. It also discusses rebuilding existing Btrieve files to take advantage of Btrieve v6.x features. The chapter concludes with a discussion of using Btrieve with the NetWare Runtime serialized NetWare operating system. Chapter 4 Configuring and Using the Requesters This chapter provides configuration options and instructions for loading and unloading the Btrieve Requester in the DOS, OS/2, and Windows environments. Chapter 5 Using Btrieve Utilities This chapter describes the utilities available to monitor and maintain your database, either from the server console or from workstations on the network. Appendix A Description Files This appendix explains the rules for creating description files, provides a description file example, and describes the individual description file elements. Appendix B Status Codes and Messages This appendix lists and explains the Btrieve status codes and messages you may encounter while loading or running Btrieve applications. Appendix C Glossary Index Notational Conventions This manual uses the conventions described in the following sections to present information. Icons A Note points out an item that may be of interest but is not vital to the operation of the product. A Suggestion denotes a hint, a tip, or other information that may be helpful but is not critical. An Important denotes important information that you should read. Typography Unless otherwise noted, command syntax, code, and code examples use the following conventions: Case Commands and reserved words typically appear in upper case letters. Unless the manual states otherwise, you can enter these items using uppercase, lowercase, or both. For example, you can type MYPROG, myprog, or MYprog. [ ] Square brackets enclose optional information, as in [logName]. If information is not enclosed in square brackets, it is required | A vertical bar indicates an either-or choice of information to enter, as in [filename | @filename] < > Angle brackets enclose multiple choices for a required item, as in . variable Words appearing in italics are variables that you must replace with appropriate values, as in filename. . . . An ellipsis following information indicates you can repeat the information more than one time, as in [parameter . . . ]. Associated Documents This manual explains how to install Btrieve and use the Btrieve utilities in a NetWare environment. For information about developing Btrieve applications, refer to the Btrieve Programmer's Manual (available only as part of the Btrieve Developer's Kit). Registering Your Product You are important to us, and it's important for us to know who our customers are. Registering your Novell database product enables us to provide you with better service and important notifications about your product. Please take a moment to complete the pre-addressed NetWare Product Registration Card included with this product and return it to us. If you need to contact us by mail, telephone, or fax, refer to "Contacting Novell." Where to Get Help Novell offers support through a wide range of programs. This section lists sources of help that are available for the Novell Database Products line. Telephone Technical Support Novell's telephone technical support program provides helpful information about getting the best results from your Novell product. Refer to "Contacting Novell" for information about contacting Novell for technical support. If you are contacting Novell for a follow-up on a previous technical support issue, please be ready to provide your open call reference number. International Technical Support International customers may find the Direct Connect SM Fax International program useful. This program provides priority handling of fax support, which allows international customers to obtain technical support without worrying about high telephone costs and time zone differences. Novell encourages customers who reside outside the continental United States and Canada to contact their local Novell office or Novell authorized reseller for more information about international support options. The table provides the fax number for international technical support. Education and Training You can contact the Novell Education department for information about specific courses and training available for users of Novell products. Product Information The Developer Relations group at Novell Austin can provide information about Novell Database Products, technical support programs, and the Novell Professional Developers' Program. You can request detailed product information from the automated fax system or speak to a trained technician about product announcements, pricing, compatibility, services, and developer issues. Professional Developers' Program The Novell Professional Developers' Program provides programming tools and development support for developers who wish to take advantage of the features of Novell's software on any of the available platforms (NetWare operating system, communications, or database). By enrolling in this program, developers gain access to the latest programming tools. For information about enrolling, contact Novell Developer Relations. CompuServe Forum You can find information about Novell Database Products under the NetWireSM section on CompuServe. NetWire provides 24-hour-a-day electronic information services. You can obtain the most recent online technical notes, problem reports and fixes, product news, and other helpful information. You can also post technical questions and receive answers from our technical support staff.If you already have a CompuServe account, type go novell to access the NetWire section. For information about subscribing to CompuServe, contact CompuServe, Inc., at 1-800-848-8199 (or 1-614-457-0802 in Ohio or outside the U.S. and Canada). Contacting Novell Novell has established a comprehensive services strategy to support all network users and systems -- small or large, domestic or international. We welcome hearing from you. The mailing address for Novell Austin is as follows: Novell, Inc. 5918 West Courtyard Drive Austin, Texas 78730-5036 To contact us by telephone or fax, refer to the following table for the appropriate number. For Telephone Technical Support, International Technical Support, Developer Relations, or Product Information* 1-800-NETWARE (1-800-638-9273) or 1-801-429-5588 outside the U.S. Fax: 1-512-794-1775 Education Information 1-800-233-EDUC (1-800-233-3382) or 1-801-429-5508 outside the U.S. Fax: 1-801-429-3900 General Inquiries 1-512-346-8380 Fax: 1-512-345-7478 * International customers can contact their local reseller for Novell Database Products information and their local Novell office for information about the Professional Developers' Program.