BTRIEVE Configuration Guide

Overview

The following is a guide to setting up BTRIEVE to work properly with Unoverica Products.

Background

Unfortunately, BTRIEVE does not have a mechanism which an application can use to register or otherwise specify its particular resource requirements. This means that the way in which BTRIEVE is first loaded will determine the resources available to all applications that use it. In particular, loading BTRIEVE without any parameters DOES NOT provide adequate BTRIEVE resources for most applications.

BTRIEVE does provide a mechanism for specifying these parameters in a standard place, called BSTART. Unfortunately, most applications do not use this mechanism. Unoverica strongly recommends the use of BSTART to load BTRIEVE and specify the BTRIEVE parameters.

Procedure

1. Use BTRMON to determine the current BTRIEVE parameters:

At the console prompt, type:

:LOAD BTRMON

From the Available Options menu, select Resource Usage. Record the values in the Maximum column in the Btrieve Resource Usage screen.

Press <ESCAPE> twice, and select Yes to exit BTRMON.

2. Use BSETUP to set the BTRIEVE parameters:

At the console prompt, type:

:LOAD BSETUP

From the Available Options menu, select Set Btrieve Configuration. Use the values recorded in the previous step to update the corresponding values in the Current Btrieve Configuration screen. To each value, add the following value for Unoverica products:

Number of Open Files: add between 80 and 160

Number of Handles: add between 240 and 480

Number of Locks: add between 80 and 160

Number of Transactions: add between 60 and 120

Cache Allocation: at least 1024

Please record these changes for future reference.

Press <ESCAPE> twice, and select Yes to exit BSETUP.

3. Put BSTOP and BSTART in the AUTOEXEC.NCF file:

Edit the active AUTOEXEC.NCF file. Find the position in the file before the first program that uses BTRIEVE is loaded. At that position, insert the following lines:

BSTOP

BSTART

4. Test the configuration:

Down and restart the server. After the server restarts, verify that the parameters were set correctly by using BTRMON as above.

You are now ready to successfully install and use Unoverica Products.