Btrieve must reserve memory and resources when it loads in order to operate correctly. You can customize Btrieve for your system by specifying a set of configuration options. These include the following:
.• The maximum number of open files
• The maximum number of file handles
• The maximum number of record locks
• The number of concurrent transactions
• The maximum size of the compression buffer
• The maximum record length
• The maximum page size
• The maximum number of concurrent sessions
• The console refresh delay count
• Automatic transaction flagging
The sections on the following pages discuss each option, the default values, and the memory required, if any.
3-4 201lRevl.OO
(--MAXIMUM NUMBER OF OPEN FILES Range: 1 - 255
Default: 20
Memory required per file: 115 bytes
Running NetWare Btrieve
The "Maximum Number of Open Files" option allows you to specify the maximum number of unique files that will be open at that file server at any given time. Btrieve uses the value you specify to determine the size of the internal tables it uses to track active files. Each unique Btrieve file on the file server requires one entry.
MAXIMUM NUMBER OF FILE HANDLES Range: 1 -< network limit>
Default: 60
Memory required per handle: 114 bytes
The "Maximum Number of File Handles" option allows you to specify the maximum number of file handles that Btrieve will allow your system to use simultaneously. Iftwo stations open the same file on the file server, they use two file handles. To calculate the maximum number of handles your system requires, multiply the number of stations by the maximum number of files each workstation can open.
2011Reill.OO 3-5
MAXIMUM NUMBER OF RECORD LOCKS Range: 0 -< network limit>
Default: 20
Memory required per lock: 8 bytes
The "Maximum Number of Record Locks" option sets the maximum number of records that can be locked simultaneously at that file server. Specifically, it determines the number of entries for the lock table that Btrieve builds when it loads. The value for this option includes both single and multiple record locks. To calculate the value for this option, determine the maximum number of records that each workstation can have open, and multiply that value by the number of workstations that access Btrieve files.
NUMBER OF CONCURRENT TRANSACTIONS Range: 0 -< maximum number of sessions>
Default: 0
Memory required per transaction: 1,046 bytes
The "Number of Concurrent Transactions" option sets the maximum number of stations that may have concurrent active transactions at the file server. If you specify a value of zero for this option, no workstations may issue a Begin Transaction operation to the file server. If you specify a value greater than zero for this option, Btrieve creates a transaction file, BTRIEVE.TRN, in the
\SYS\SYSTEM directory at the file server, and allows as many active transactions at the file server as you specify.
3-6 2011Revl.OO
(-Running NetWare Btrieve
MAXIMUM COMPRESSED RECORD SIZE Range: 0 -< longest record in a compressed file>
Default: 0
Memory required per transaction: 2
*
number of kilobytes specified The "Maximum Compressed Record Size" option specifies the size (in kilobytes) of the longest record that you will be accessing from a compressed file. Btrieve will allocate twice the number of kilobytes you specify to its compression buffer. Specifying a higher value than you need does not result in improved performance, and may result in a reduction of the memory available for other processes at the file server.If you use compressed files, set the value for this option to the size ofthe longest record in any of your compressed files. Specify the value in kilobytes.
Round any uneven values up to the next higher kilobyte value. For example, ifthe longest record you will be accessing is 1,800 bytes long, specify a value of 2 for this option.
If you do not use compressed files, set the value to O.
MAXIMUM RECORD LENGTH Range: 4 bytes - 32KB
Default: 8,192 bytes
Memory required: (specified value + 269 bytes)
The "Maximum Record Length Allowed" option specifies the length of the longest record that any Btrieve application can access at that file server.
Always specify the length of the record in bytes. Specifying a higher value than you need does not result in improved performance.
2011Revl.OO 3-7
MAXIMUM PAGE SIZE Range: 512 - 4,096 bytes Default: 4,096 bytes Memory required: n/a
The "Maximum Page Size Allowed" option allows Btrieve to calculate the size of the cache buffers it needs. The value you specify here should be the
maximum page size of any Btrieve file you want to access. It must be a multiple of 512 bytes, but no greater than 4,096 bytes.
MAXIMUM NUMBER OF CONCURRENT SESSIONS Range: 1 -< number of workstation tasks>
Default: 15
Memory required per session: 1,296 bytes
The "Maximum Number of Concurrent Sessions" option specifies the maximum number of workstation tasks that can access BSERVER at any given time. A session is defined as one copy of BREQUEST communicating with the BSERVER program. Each session is allocated two packet buffers for Btrieve requests.
Specifying a higher value than you need does not result in improved performance.
CONSOLE REFRESH DELAY COUNT Range: 1 - 60 seconds
Default: 3 seconds Memory required: n/a
The "Console Refresh Delay Count" option controls the number of seconds that B STATUS and B ACTIVE delay before refreshing the screen with new information. The delay allows you to maintain the readability of the
information while observing the effect of database activity in a real time mode.
3-8 2011Revl.OO
(-(
Running NetWare Btrieve AUTOMATIC TRANSACTION FLAGGING
Range: Yes/N 0
Default: No
Memory required: n/a
The "Automatic Transaction Flagging" option controls whether or not Btrieve automatically flags files as transactional at the time you create them on the system. If you answer "Yes" to this option, Btrieve flags newly created files as transactional. If you answer "No," Btrieve does not flag the files as
transactional.
INSTALLATION OPTIONS
The BSETUP program is designed to give you the following installation . options:
• You can install BSERVER and BROUTER directly on a file server. If . this is the case, you must be logged in as SUPERVISOR or have supervisor rights. If you are not logged in as SUPERVISOR, the
"Install" and "Remove" options will not be displayed on the menu.
• You can copy the BSERVER.VAP and BROUTER.VAP files to a
subdirectory or a diskette, run BSETUP to configure the copy, and then either install the copy on the current file server or transport the file to another file server.
201 IR ev 1.00 3-9