Btrieve Installation and Operation December 21, 1999 Novell Confidential doc_tpl.fm Rev 99a 28 October 99 Legal Notices Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes. Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes. This product may require export authorization from the U.S. Department of Commerce prior to exporting from the U.S. or Canada. Copyright © 1993-2000 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher. U.S. Patent Nos. 4,555,775; 5,157,663; 5,349,642; 5,455,932; 5,553,139; 5,553,143; 5,594,863; 5,608,903; 5,633,931; 5,652,854; 5,671,414; 5,677,851; 5,692,129; 5,758,069; 5,758,344; 5,761,499; 5,781,724; 5,781,733; 5,784,560; 5,787,439; 5,818,936; 5,828,882; 5,832,275; 5,832,483; 5,832,487; 5,859,978; 5,870,739; 5,873,079; 5,878,415; 5,884,304; 5,893,118; 5,903,650; 5,905,860; 5,913,025; 5,915,253; 5,925,108; 5,933,503; 5,933,826; 5,946,467; 5,956,718; 5,974,474. U.S. and Foreign Patents Pending. Novell, Inc. 122 East 1700 South Provo, UT 84606 U.S.A. www.novell.com Btrieve Installation and Operation January 2000 104-001225-001 Online Documentation: To access the online documentation for this and other Novell products, and to get updates, see www.novell.com/documentation. Btrieve Installation and Operation 104-001225-001 December 21, 1999 Novell Confidential doc_tpl.fm Rev 99a 28 October 99 Novell Trademarks For a list of Novell trademarks, see the final appendix of this book. Third-Party Trademarks All third-party trademarks are the property of their respective owners. Btrieve Installation and Operation 104-001225-001 December 21, 1999 Novell Confidential doc_tpl.fm Rev 99a 28 October 99 Btrieve Installation and Operation 104-001225-001 December 21, 1999 Novell Confidential doc_tpl.fm Rev 99a 28 October 99 Contents About This Manual. 11 Who Should Read This Manual . 11 Organization . 11 Conventions . 12 Notational Comments. 12 Syntax and Code Examples . 13 Associated Documents. 13 Registering Your Product . 14 Introduction to NetWare Btrieve . 15 Client-Server Design . 15 What Is a Client? . 17 NetWare Btrieve Features . 17 Index Maintenance . 18 File Specifications . 18 Memory Management . 18 Data Integrity . 19 Security Controls . 20 Enhancements to NetWare Btrieve . 20 Enhancement to NetWare Btrieve 6.1x. 20 Enhancements to NetWare Btrieve 6.x . 26 NetWare Btrieve Architecture . 37 Components of NetWare Btrieve. 37 Server-Based Record Manager . 38 Communications Programs. 38 Workstation Requesters . 40 NetWare Btrieve Utilities . 40 Novell Directory Services Support Utility . 41 NetWare Btrieve Applications on a Server . 42 Server Application Accessing Local Data . 42 Server Application Accessing Remote Data . 42 Btrieve Applications on a Workstation . 43 Workstation Application Accessing Local Data . 44 Workstation Application Accessing Remote Data . 44 Workstation Application Accessing Local and Remote Data . 45 Examples of Btrieve Architecture . 46 Server Application Using the NetWare Btrieve NLM . 46 Server Application Using the NetWare Btrieve Message Router . 47 Contents Btrieve Installation and Operation 104-001225-001 December 21, 1999 Novell Confidential doc_tpl.fm Rev 99a 28 October 99 Server Application Using the NetWare Btrieve Message Router and BSPXCOM. 48 Workstation Application Using the Requester and Client-Based Btrieve . 49 Server Application Using RSPXSTUB . 50 Server Application Using BSPXSTUB . 51 Server Application Using Scalable SQL . 53 Installing and Configuring NetWare Btrieve . 55 Overview of Installation and Configuration . 55 Preparing for Installation . 57 Checking for and Removing Extraneous Pre-Image Files . 57 Unloading an Earlier Version of NetWare Btrieve . 58 Installing NetWare Btrieve. 58 System Requirements for Installation . 58 NetWare Btrieve 6.1x Program Files. 59 Using the NetWare INSTALL Utility . 63 Detecting and Repairing PAT and File Corruption . 64 Detecting and Repairing PAT Corruption Only . 64 Detecting and Repairing PAT Corruption and Other Types of File Corruption . 66 Configuring NetWare Btrieve . 67 Configuration Options . 68 Running the Setup Utility . 75 Starting and Stopping NetWare Btrieve . 77 Starting NetWare Btrieve 6.x . 77 Stopping NetWare Btrieve 6.1x . 78 Rebuilding Existing NetWare Btrieve Files . 78 Running the Rebuild Utility Interactively . 79 Running the Rebuild Utility from the Command Line . 85 Examples of Running the Rebuild Utility from the Command Line . 88 Deleting Temporary Files . 88 Registering NetWare Btrieve with the Novell Directory Services . 89 Installing or Removing the NDS Support Utility Interactively . 90 Running the NDS Support Utility from the Command Line . 91 Using NetWare Btrieve with a NetWare SFT III Server . 92 Using NetWare Btrieve with NetWare Runtime . 93 Reasons to Use NetWare Runtime . 94 Installing NetWare Runtime . 94 Special Notes on NetWare Runtime . 95 Special Notes on NetWare Btrieve . 95 Configuring and Using the Requesters . 97 DOS Requester . 97 DOS Requester Configuration Options . 97 Loading the DOS Requester. 100 Unloading the DOS Requester . 101 Btrieve Installation and Operation Btrieve Installation and Operation 104-001225-001 December 21, 1999 Novell Confidential doc_tpl.fm Rev 99a 28 October 99 OS/2 Requester . 102 OS/2 Requester Configuration Options. 102 Configuring the OS/2 Requester . 104 Loading the OS/2 Requester . 105 Unloading the OS/2 Requester . 105 MS Windows Requester . 105 MS Windows Requester Configuration Options . 106 Loading the MS Windows Requester. 106 Unloading the MS Windows Requester . 108 Using NetWare Btrieve Utilities . 109 NetWare Btrieve Monitor Utility . 109 System Requirements for the NetWare Btrieve Monitor Utility . 110 Starting the NetWare Btrieve Monitor.