*I  BTR HELP! §&  File Integrity è+  Information Transfer P-  Regular Rebuilder ô-  Statistics ­1  Exit Btr Help! !6  Miscellaneous –6 Command Line ¬7 Btrieve Load Parameters )9 Unload Btrieve ¬: Btrieve Version œ;  Pick a File #<  Convert Keys ‘<  Quick Start -=  Debug Btrieve Ë=  Exit Menu >  Reset Btrieve ì>  Clear Owner ù?  Damaged Header File v@  Browse §A  Goto Direct XB  Record Not Found ŸC  Clone a Btrieve File ýC  Abort Editing BE  Edit Ascii -F  Edit Hex “H  Original Btrieve File K  Clone Btrieve File íK  Empty File ßL  Are You Sure GN Estimate ¬N ! Number of Records iO " Page Size úO # Record Length sP $ Duplicate Keys ðP % Unique Keys |Q & Add Records øQ ' Toggle Screen Size µR ( Lists ¹S ) Error Codes fT * Operations ¿U + Auto Keys ^V , File Specification fX - Switches ¶Y . File Errors Integrity `] / File Links Integrity º^ 0 Special Keys êa 1 Quick Rebuilder ,c 2 File Rebuilder Ýh 3 Replace File qj 4 Repair Header Öl 5 Good Header Xq 6 File Options Lr 7 Extended Key Types s 8 No Transaction Processing ôs 9 Fuzzy Search ’t : Increase Buffer Size sy ; Save Settings Œz < Configuration â{ = Data Buffer Size 4} > Browse Mode °~ ? Auto Load G @ BIOS Writes a A Monochrome ³‚ B Clear Background ^ƒ C Space for Btrieve l„ D Brequest Load Parameters Ɇ E Use Log File Cˆ G EMS VROOM Z‰ F EXT VROOM –Š H Allow ESC Key gŒ I Unload Btrieve â J Transactions n K 43/50 Line Mode ê L Shadowed Windows x’ M Owner “ N Load Btrieve ” O Warranty ´” P Search Degree &— R Case Sensitive Ú› S Hold «œ U Auto Keys File ž V File Recovery Ñž W Browse Screen î¨ X Lock ¢¬ Y Editing Keys +­ Z Mass-Store Copy „± [ File Owner êÀ \ Rebuild Timings ¡Á ] Btrieve Long Integer :Æ ^ Browse Keys ¿Ç _ ASCII QÌ ` Shareware zÍ a Technical Support ä b Registration ì c Btrieve dô d Damaged File ìõ e Recovery File dö f Starting Page üö g Ending Page où h Preallocate Pages 'ü i Get Direct Key –ý j Eliminate Blank Records èÿ k Violation a Help Wanted p ‘No Variable Length Records g ’No Records » “Version5.1 ó ”Low Memory R •Not Exclusive É –ASP @ —File Not Found ç ˜Btr 'C' Library E ôOpen ê9 õClose w; öInsert Ñ; ÷Update << øDelete ¥< ùGet Equal = úGet Next ³= ûGet Previous A> üGet Greater Ú> ýGet Greater or Equal ? þGet Less Than Z@ ÿGet Less Than or Equal A Get First ÝA Get Last kB Create õB Statistics bC Extend ^D Set Directory OF Get Directory êF Begin Transaction yG End Transaction ;H Abort Transaction óH Get Position ¬I Get Direct ‹J Step Next WK Stop åK Version lL Unlock óL Reset kM Set Owner 3N Clear Owner ³N Create Supplemental Index NO Drop Supplemental Index P Step First °P Step Last DQ Step Previous ÙQ Get Next Extended €R Get Previous Extended U Step Next Extended ÃW Step Previous Extended ©X Insert Extended Y XSuccess «Z YInvalid Operation "[ ZI/O Error õ[ [File Not Open t] \Key Value Not Found ´^ ]Duplicate Key Value r_ ^Invalid Key Number a _Different Key Number (b `Invalid Positioning ‚c aEnd of File Ïd bModifiable Key Value Error âe cInvalid Filename ªf dFile not Found Lg eExtended File Error ¥h fPre-Image Open Error j gPre-Image I/O Error Ûj hExpansion Error El iClose Error m jDisk Full ¿m kUnrecoverable Error xn lRecord Manager Inactive "o mKey Buffer Too Short Ãp nData Buffer Length Lq oPosition Block Length éq pPage Size Error |r qCreate I/O Error ýs rNumber of Keys Šu sInvalid Key Position Žv tInvalid Record Length yw uInvalid Key Length sx vNot a Btrieve File y wFile Already Extended 9z xExtend I/O Error Éz y???? k{ zInvalid Extension Name Ñ{ {Directory Error n| |Transaction Error _} }Transaction is Active B~ ~Transaction Control File I/O  End/Abort Transaction Error ø €Transaction Max Files Ê€ Operation Not Allowed Ò ‚Incomplete Accelerated Access a‚ ƒInvalid Record Address ¢ƒ „Null Key Path Q„ …Inconsistent Key Flags ð„ †Access to File Denied '† ‡Maximum Open Files C‡ ˆInvalid Alternate Sequence De )ˆ ‰Key Type Error ®‰ ŠOwner Already Set ÇŠ ‹Invalid Owner s‹ ŒError Writing Cache yŒ Invalid Interface ; ŽVariable Page Error ÷ Autoincrement Error  Incomplete Index P ‘Expansion Memory Error _‘ ’Compression Buffer Too Short ’ “File Already Exists “ ”Reject Count Reached ö“ •Work Space Too Small $• –Incorrect Descriptor õ• —Invalid Extended Insert Buffe ¶– ˜Filter Limit Reached Þ— ™Incorrect Field Offset Ę š???  ™ ›??? â™ œ?? #š ?? dš ž?? ¥š Ÿ?? æš  ?? '› ¡?? h› ¢Automatic Transaction Abort › £?? Àœ ¤??  ¥?? B ¦Deadlock Detected ” §?? ñ ¨Conflict 8ž ©Lock Error žŸ ªLost Position   «Read Outside Transaction ¾¡ ¬Record Locked £ ­File Locked t£ ®File Table Full v¥ ¯Handle Table Full 𥠰Incompatable Mode Error 9§ ±Net Share $¨ ²Redirected Device Table Full «¨ ³Server Error _© ´Transaction Table Full Ôª µIncompatible Lock Type ¸« ¶Permission Error -¬ ·Session No Longer Valid Æ­ ¸Communications Environment Er µ® ¹Data Message Too Small ¢¯ ºInternal Transaction Error Ì° »Demo Restriction Error ̱ String Key Type ‰² !Integer Key Type ݳ "Float Key Type ù´ #Date Key Type µ $Time Key Type · %Decimal Key Type ,¸ &Money Key Type ™º 'Logical Key Type » (Numeric Key Type [¼ )Bfloat Key Type ª¿ *Lstring Key Type xÀ +Zstring Key Type æÁ ,Unknown12 Key Type è -Unknown13 Key Type Cà .Unsigned Binary Key Type ¤Ã /Autoincrement Key Type àÄ /Autoincrement Key Type ÿÿÿÿ BTRHELP.HLP Copyright 1991 by Informative Technologies This file contains all the help text used in BTRHELP *B 1,BTR HELP! BTR HELP! (Ver 1.86) BTR HELP! is a file maintenance utility for Btrieve. ^Registration^ is required if you continue to use BTR HELP! after evaluating it for 30 days. Complete your ^registration^ of BTR HELP! for full benefits. Copyright (c) 1991 David Smith Informative Technologies 1718 M Street NW, Suite 292 Washington, DC 20036 Voice(202)675-4528 Fax(202)675-4529 Email 71311,2334 Press [F1] at any time for context-sensitive help. Press [ESC] to exit this screen. *P Some of the features of ^BTR HELP!^ are: - a ^File Rebuilder^ for damaged ^Btrieve^ files. - Tests the integrity of ^Btrieve^ files. - Unloads ^Btrieve^ and shows the version loaded. - Browse, delete, add, edit records. - Displays ^Btrieve^ file statistics - Supports text modes 100x60, 132x43, 80x60, and 80x43. - Clones ^Btrieve^ files. - Displays ^Btrieve^ file ^Operations^ and ^Error Codes^ - Full Mouse Support - Executes functions from batch files. Also See: ^Command Line^ ^Technical Support^ ^Warranty^ ^Editing Keys^ ^Mass-Store Copy^ ^Registration^ ^ASP^ ^Btr 'C' Library^ ^Shareware^ *E *B 2,File Integrity File Integrity ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ These options allow you to check the integrity of the key paths in a ^Btrieve^ file. These options will determine if a ^Btrieve^ file's key paths have been corrupted. If the key paths are corrupted use ^File Rebuilder^ to repair the ^Btrieve^ file. *E *B 3,Information Transfer Information Transfer ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Use this option to transfer files between different file formats. *E *B 4,Regular Rebuilder Regular Rebuilder ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ If you value your ^Btrieve^ file and it is damaged, rebuild a copy of the file. This file rebuilder cannot fix all ^Btrieve^ files. A more robust ^Btrieve^ file rebuilder is in the works for more seriously damaged ^Btrieve^ files. First, this option will create a new file with the same ^Btrieve^ structure as the file you want to rebuild. Then the program copies as many records as it can into the new file starting from the beginning of the old file. Rebuild the file on the same drive as the ^Btrieve^ file. *P If it encounters any problems, it will try to copy records from the end of the file. When the records have been copied to the new file, the old file is deleted and the new file is renamed to the old file's name. Also See: ^Rebuild Timings^ *E *B 5,Statistics Statistics ÄÄÄÄÄÄÄÄÄÄ This option displays the statistics on a ^Btrieve^ file in a scrollable window. Press PgUp or PgDn to view the file information. This option displays the number of records in a file, the number of unique key values stored for each index in the file, and the number of unused pages in the file. The "Space Utilization" shows the amount of space in the ^Btrieve^ file that is actual data. The "Space Per Record" is the average number of bytes needed for each record in the file (including indexes). Also shown is the file path if you ^Extend^ a ^Btrieve^ file. *P Also See: ^String Key Type^ ^Logical Key Type^ ^Integer Key Type^ ^Numeric Key Type^ ^Float Key Type^ ^Bfloat Key Type^ ^Date Key Type^ ^Lstring Key Type^ ^Time Key Type^ ^Zstring Key Type^ ^Money Key Type^ ^Decimal Key Type^ ^Unsigned Binary Key Type^ ^Autoincrement Key Type^ *E *B 7,Exit Btr Help! Exit ^BTR HELP!^ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This option exits from ^BTR HELP!^ *E *B 8,Miscellaneous Miscellaneous ÄÄÄÄÄÄÄÄÄÄÄÄÄ This menu has various options such as: ^Reset Btrieve^ ^Load Btrieve^ ^Unload Btrieve^ ^Btrieve Version^ ^Toggle Screen Size^ ^Save Settings^ ^Configuration^ *E *B 10,Command Line Command Line Arguments ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ All command line arguments are optional. BTRHELP [FILESPEC] [-SWITCHES] [KEYS] [@FILE] [-O] FILESPEC : ^File Specification^ SWITCHES : ^Switches^ -behmstopux KEYS : ^Auto Keys^ FILE : ^Auto Keys File^ OWNER : ^File Owner^ *E *B 11,Btrieve Load Parameters Btrieve Load Parameters ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ These are the options used to load Btrieve from within ^BTR HELP!^. ^BTR HELP!^ attempts to load ^Btrieve^ if it is not loaded when ^BTR HELP!^ is started. If you would like to load ^Btrieve^ with different options you will have to ^unload Btrieve^ first. *E *B 12,Unload Btrieve Unload ^Btrieve^ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This will remove ^Btrieve^ from memory, close all files open at this station, abort any transactions, and release all locks held by the station. *E *B 13,Btrieve Version ^Btrieve^ Version ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This shows the ^Btrieve^ type, version, and revision. *E *B 14,Pick a File Pick a File ÄÄÄÄÄÄÄÄÄÄÄ This option selects a ^Btrieve^ file. *E *B 15,Convert Keys Convert Keys ÄÄÄÄÄÄÄÄÄÄÄÄ Use this option to convert a file from external keys to regular keys and back. *E *B 15,Quick Start Quick Start ÄÄÄÄÄÄÄÄÄÄÄ If you need to rebuild a file start by trying the ^file rebuilder^ option. *E *B 16,Debug Btrieve Debug ^Btrieve^ ÄÄÄÄÄÄÄÄÄÄÄÄÄ Select this option to display ^Btrieve^ information on the screen as you manipulate ^Btrieve Files^. *E *B 17,Exit Menu Exit Menu ÄÄÄÄÄÄÄÄÄ This option will exit the current menu. *E *B 18,Reset Btrieve Reset ^Btrieve^ ÄÄÄÄÄÄÄÄÄÄÄÄÄ This option performs the RESET operation. This operation aborts any transactions the station has pending, releases all locks, and closes any open files for the station. *E *B 19,Clear Owner Clear Owner ÄÄÄÄÄÄÄÄÄÄÄ This option clears the current owner of a file. *E *B 20,Damaged Header File Damaged Header File ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This is the file name of a file that returns a (30) ^Not a Btrieve File^ or (2) ^I/O Error^ status. ^BTR HELP!^ will take a header from an undamaged Btrieve file and replace the damaged files header. *E *B 21,Browse Browse ÄÄÄÄÄÄ This option allows you to: Browse, Edit, Add, and Search for Btrieve records. Also See: ^Browse Keys^ *E *B 22,Goto Direct Goto Direct ÄÄÄÄÄÄÄÄÄÄÄ This uses the ^Get Direct^ function to go directly to a record at a physical location in the file. Enter the decimal number representing the offset of the record into the file. This command also works with the ^Hold^ command. *E *B 23,Record Not Found A record was not found at that position. *E *B 24,Clone a Btrieve File Clone a ^Btrieve^ File ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This option allows you to make an exact duplicate of a ^btrieve^ file. The file you create will not contain any records. The ^Clone Btrieve File^ will have the same file structure as the ^Original Btrieve File^. *E *B 25,Abort Editing Abort Editing ÄÄÄÄÄÄÄÄÄÄÄÄÄ If you answer 'Y' then all the changes to the ^btrieve^ file will be permanent. If you answer 'N' or press the ESC key then the changes are aborted. *E *B 26,Edit Ascii Edit ^ASCII^ ÄÄÄÄÄÄÄÄÄÄ The ^btrieve^ file record can be edited and displayed in ^ASCII^ format. If you would like to ^edit Hex^ values, press the TAB key. When you are through editing the record press Ctrl+Enter or the ESC key. If the entire record does not display in the edit window press PgDn or PgUp to see the rest of the ^Btrieve^ record. The record will be saved as you edit it. If you want to undo the changes that you have made, you are given the chance to after you are through editing a group of records. *E *B 27,Edit Hex Edit Hex ÄÄÄÄÄÄÄÄ The ^Btrieve^ file record can be edited and displayed in the HEX format. If you would like to ^edit ASCII^ values, press the TAB key. When you are through editing the record press Ctrl+Enter or the ESC key. If the entire record does not display in the edit window press PgDn or PgUp to see the rest of the ^Btrieve^ record. The record will be saved as you edit it. If you want to undo the changes that you have made, you are given the chance to after you are through editing a group of records. *E *B 28,Original Btrieve File Original ^Btrieve^ File ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This is the file that you want to clone. This is the file that you selected on the command line or when you picked a file. *E *B 29,Clone Btrieve File Clone ^Btrieve^ File ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This will be a clone of the ^original btrieve file^. The ^Clone Btrieve File^ will have the same file structure as the ^Original Btrieve File^. *E *B 30,Empty File Empty File ÄÄÄÄÄÄÄÄÄÄ This option will remove all records in a ^Btrieve^ file. It removes all the records by creating a ^clone btrieve file^ of the selected original file. Then it deletes the ^original btrieve file^ and renames the ^clone btrieve file^ to the name of the original file. *E *B 31,Are You Sure Are You Sure ÄÄÄÄÄÄÄÄÄÄÄÄ Select 'Y' for YES or 'N' for NO. *E *B 32,Estimate Estimate ÄÄÄÄÄÄÄÄ This option allows you to estimate the size of a ^Btrieve^ file by specifying certain paramaters about it. *E *B 33,Number of Records Number of Records ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Enter the number of records you expect in the btrieve file. *E *B 34,Page Size Page Size ÄÄÄÄÄÄÄÄÄ Enter the page size you will use in the btrieve file. *E *B 35,Record Length Record Length ÄÄÄÄÄÄÄÄÄÄÄÄÄ Enter the record length of the ^Btrieve^ record. *E *B 36,Duplicate Keys Duplicate Keys ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Enter the number of duplicate keys in the ^Btrieve^ file. *E *B 37,Unique Keys Unique Keys ÄÄÄÄÄÄÄÄÄÄÄ Enter the number of unique keys in the ^Btrieve^ file. *E *B 38,Add Records Add Records ÄÄÄÄÄÄÄÄÄÄÄ This option allows you to add records to a ^Btrieve^ file. You are able to edit records up to 64K in size. *E *B 39,Toggle Screen Size Toggle Screen Size ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This option changes the number of lines on the screen from 25 to 43 if you have a EGA adaptor or from 25 to 50 if you have a VGA adaptor. Also See: ^Switches^ *E *B 40,Lists Lists ÄÄÄÄÄ This menu option lets you view lists of ^Error Codes^, ^Btrieve^ file ^Operations^, and ^Extended Key Types^. *E *B 41,Error Codes Error Codes ÄÄÄÄÄÄÄÄÄÄÄ This is a list of all the ^Btrieve^ ^error codes^ and their corresponding numbers. A nonzero status does not always mean that an error occurred. If you get an ^End of File^ error, it may mean you may have just retrieved the last record for a key path. *E *B 42,Operations Operations ÄÄÄÄÄÄÄÄÄÄ This is a list of all the ^Btrieve^ file ^Operations^ and their corresponding numbers. *E *B 43,Auto Keys Auto Keys ÄÄÄÄÄÄÄÄÄ If the -p switch is on the command line, the next group of characters is typed automatically when the program begins. '!' acts as the enter key and '#' is the ESC key. EXAMPLE: BTRHELP DATABASE.DBF -xp RR!### In this example the 'R' key is pressed to rebuild the file DATABASE.DBF. after the file is rebuilt the ESC keys cause the program to end. Also see : ^Command Line^ ^Special Keys^ *E *B 44,File Specification File Specification ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The file specification determines which files are displayed in the browse or which file ^BTR HELP!^ performs its functions on. If the file specification is not given then the default is '*.*' which selects all file names. *E *B 45,Switches Switches ÄÄÄÄÄÄÄÄ -b Uses BIOS for video writes. If your computer has trouble displaying some of the windows on your screen, use this switch. This assists with incompatibility in the display. -e Do not use expanded or extended memory for VROOM overlays. -m Disables color. Runs program in monochrome mode. -p Automatically types keys when the program begins. See: ^Auto Keys^ *P -s Disables clearing of the screen. Does not display the solid background behind the program window. -h Displays files in 43/50 line mode. -u Unload ^Btrieve^ when you quit the program. -t Do not use transaction processing when deleting or editing records. -x Do not allow ESC to be pressed to abort ^File Integrity^ or ^File Rebuilder^. *E *B 46,File Errors Integrity File Errors Integrity ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ All the key paths in the file are traversed from beginning to end and then from the end to the beginning. Checking the integrity will show if any ^Btrieve^ errors occur during the traversal of all of the key paths. *E *B 47,File Links Integrity File Links Integrity ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ All the key paths in the file are traversed. A check is made to make sure that the forward link for each record points to the same record that has a reverse link pointing to it. An example of good links. A -> B -> C -> D -> E "Forward Links" and A <- B <- C <- D <- E "Reverse Links" *P An example of corrupted links. and A -> C -> D -> A -> C -> D -> A -> C -> ... A <- C <- D <- E <- B Sometimes when key paths are corrupted, the pointer to the next record will point to itself or point to some random record. Checking the integrity will show if the key paths have been corrupted. *E *B 48,Special Keys Special Keys ÄÄÄÄÄÄÄÄÄÄÄÄ F1 - ^BTR HELP!^ Help Alt+S - Shell to DOS. Alt+D - Debug ^Btrieve^ window. Alt+X or ESC - Quit ^BTR HELP!^ Alt+F1 - Toggle BIOS screen writes Also See: ^Editing Keys^ *E *B 49,Quick Rebuilder Quick Rebuilder ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This option only works with ^Btrieve^ version 5.1 or higher. It uses the ^Get Next Extended^ and the ^Insert Extended^ to rebuild the file. Try rebuilding a copy of your ^Btrieve^ file if it is damaged. This file rebuilder cannot fix all ^Btrieve^ files. Rebuild the file on the same drive as the ^Btrieve^ file. *P First, this option will create a new file with the same ^Btrieve^ structure as the file you want to rebuild. Then the program copies as many records as it can into the new file starting from the beginning of the old file. When the records have been copied to the new file, the old file is deleted and the new file is renamed to the old file's name. Note: Quick rebuilder will be "quickest" if it is using a server based btrieve. *P To rebuild using server ^Btrieve^ with BREQUEST it will need to be loaded with the settings: BREQUEST /D:54000 Also, the Maximum Record Length on the file server will need to be changed to 54000. After it is changed on the file server you will need to reload ^Btrieve^. 54000 was selected in this example for the maximum rebuild speed. The maximum record size is selectable on the configuration screen. Also See: ^Rebuild Timings^ ^Regular Rebuilder^ *E *B 50,File Rebuilder File Rebuilder ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ These are options to rebuild a damaged ^Btrieve^ files. If you get an (2) ^I/O Error^ status code when you try to access a ^Btrieve^ file, then the file needs to be rebuilt. You have three options; ^Regular Rebuilder^, ^Quick Rebuilder^, or ^File Recovery^. Also See: ^Rebuild Timings^ *E *B 51,Replace File Replace File ÄÄÄÄÄÄÄÄÄÄÄÄ Press 'Y' to replace the original file with the rebuilt file. Press 'N' or ESC to abort the replacement of the original file. If the number of records that were recovered is small, you may want to try a different method to rebuild the file. If the number of records in the file is smaller than the number of records recovered and you have just used ^Repair Header^ on the file, this is normal. ^Repair Header^ only estimates the number of records in the file when repairing the header. *E *B 52,Repair Header W A R N I N G ÄÄÄÄÄÄÄÄÄÄÄÄÄ Rebuilding the header is not trivial. You can just as easily damage a good file using this option as to repair a damaged file. Press ESC twice to abort. This option is used to repair a damaged ^Btrieve^ file header. It should ONLY be used if: (1) You receive a (2) ^I/O Error^ when opening the file. (2) Incorrect or strange values are shown when you display the statistics on the file key structure. *P (3) You receive a (30) ^Not a Btrieve file^ error when opening the file. Rebuilding the header starts by replacing the damaged header in the btrieve file. It then makes modifications to the header based on the number of possible data pages in the file. After repairing the header, rebuild the file before you try to access the file. You should only work with a copy of the damaged file. Even though it is damaged you may want to keep a copy of the original damaged file to try another repair method. *E *B 53,Good Header Clone ^Btrieve^ File ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This is a clone of the damaged ^Btrieve^ file. The clone ^Btrieve^ file MUST have the same file structure as the damaged ^Btrieve^ file once did. *E *B 54,File Options File Options ÄÄÄÄÄÄÄÄÄÄÄÄ This menu has various options such as: ^Empty File^, ^Add Records^, and ^Clone a Btrieve File^ *E *B 55,Extended Key Types Extended Key Types ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This is a list of the extended key type codes for ^Btrieve^'s internal storage formats and their corresponding numbers. *E *B 56,No Transaction Processing Btrieve was not loaded with transaction processing. You will not be able to undo any changes you make to the file. *E *B 57,Fuzzy Search Fuzzy Search ÄÄÄÄÄÄÄÄÄÄÄÄ This searches the ^Btrieve^ file for a text string. The search begins with the highlighted record and continues forward using the current key path. The records are searched in the format they are displayed. EXAMPLE - To find a certain hex string in a file: 1. Switch the browse mode to HEX BROWSE. 2. Enter the hex values as the search text. (FF 43 52 33 - for example) Notice the spaces between each byte. You must enter the values you wish to search for in the same format as they are displayed on the screen. *P To find the text 'SMITH' that could be any place in a record: 1. Switch the browse mode to ASCII BROWSE. 2. Enter 'SMITH' as the search text. To find the text 'SMITH' that could be ONLY a part of key 3 when it is formatted for the display: 1. Switch the browse mode to KEY BROWSE. 2. Set the key path to 3. 3. Enter 'SMITH' as the search text. In all cases, the text you are searching for must be visible for the current KEY and BROWSE MODE. *E *B 58,Increase Buffer Size Increase Buffer Size ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The buffer size is not large enough for the current program settings. Either increase the buffer size or decrease the ^Data Buffer Size^ setting on the configuration screen. *E *B 59,Save Settings Save the Current Settings ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This menu option saves the current program settings. Some settings do not take effect until Btr Help! is reloaded. The settings are saved in a file called BTRHELP.CFG. This file is in the same directory as BTRHELP.EXE. *E *B 60,Configuration Configuration ÄÄÄÄÄÄÄÄÄÄÄÄÄ This menu option allows you to change various program settings. Some settings will take effect as soon as you leave the configuration window. Other settings will not take effect until the settings are saved and the program is reloaded. *E *B 61,Data Buffer Size Data Buffer Size ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This is the maximum data record length that can be passed to or from Btrieve. The Maximum Record Length on the file server should match this value if you are using a server based Btrieve. Also BREQUEST will need to be loaded with the /D: parameter matching this setting. *E *B 62,Browse Mode Browse Mode ÄÄÄÄÄÄÄÄÄÄÄ This is the default browse mode setting. It can be set to ASCII, KEY, or HEX. *E *B 63,Auto Load Btrieve Auto Load ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This option allows you to select how Btrieve is loaded after Btr Help! is loaded. There are four options. BTRIEVE - Loads BTRIEVE.EXE with its command line options. BREQUEST - Loads BREQUEST.EXE with its command line options. BOTH - Attempts to load BTRIEVE.EXE and if that fails it then tries to load BREQUEST.EXE. NONE - Does not try to load BTRIEVE or BREQUEST. *E *B 64,BIOS Writes BIOS Screen Writes ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ If this option is set to 'YES', the text displayed on the screen will use BIOS writes instead of direct writes for greater compatibility. If this option is set to 'NO', the screen updates will be much faster. Also See: ^Switches^ *E *B 65,Monochrome Monochrome Colors ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This option causes the screen to use monochrome colors. Also See: ^Switches^ *E *B 66,Clear Background Clear Background ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ If you select 'YES', the screen background will be cleared using solid block character. If you select 'NO', the background will not be cleared. Also See: ^Switches^ *E *B 67,Space for Btrieve Space for Btrieve ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This is the amount of space need to load BTRIEVE.EXE or BREQUEST.EXE from within ^BTR HELP!^ in bytes. To determine this value: 1. Go to the dos prompt. 2. Run CHKDSK.EXE to determine the amount of free memory. 3. Load BTRIEVE.EXE with the parameters you wish to use. 4. Run CHKDSK.EXE again. 5. Subtract the free memory in step 4 from step 2. 6. Add 10K to the number. This gives you space needed to load btrieve. *E *B 68,Brequest Load Parameters Brequest Load Parameters ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ These are the options used to load BREQUEST.EXE from within ^BTR HELP!^. If ^Btrieve^ is not loaded when ^BTR HELP!^ begins, ^BTR HELP!^ attempts to load it. If you would like to load ^Btrieve^ with different options you will have to ^unload Btrieve^ first. *E *B 69,Use Log File Use Log File ÄÄÄÄÄÄÄÄÄÄÄÄ If this option is set to 'YES', the results of ^File Integrity^ and ^File Rebuilder^ will be written to a file called BTRHELP.LOG. This file is located in the same directory as BTRHELP.EXE. *E *B 71,EMS VROOM EMS VROOM ÄÄÄÄÄÄÄÄÄ If this option is set to 'YES', ^BTR HELP!^ will check for the presence of expanded memory and use it for the overlays needed by the program. If you set this option to 'NO', ^BTR HELP!^ will not use expanded memory for overlays. *E *B 70,EXT VROOM EXT VROOM ÄÄÄÄÄÄÄÄÄ If this option is set to 'YES', ^BTR HELP!^ will check for the presence of extended memory and use it for the overlays needed by the program. If you set this option to 'NO', ^BTR HELP!^ will not use extended memory for overlays. The use of extended memory is not standardized and other programs that use extended memory may conflict with ^BTR HELP!^. *E *B 72,Allow ESC Key Allow ESC Key ÄÄÄÄÄÄÄÄÄÄÄÄÄ If this option is set to 'YES', ^BTR HELP!^ will allow the ESC key to be pressed to abort ^File Integrity^ or ^File Rebuilder^. You may want to set this option to 'NO' if you do not want the file rebuild interrupted or if you are rebuilding files from within a batchfile. *E *B 73,Unload Btrieve Unload Btrieve ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ If this option is set to 'YES', ^BTR HELP!^ will unload ^Btrieve^ when you exit ^BTR HELP!^. ^BTR HELP!^ will always unload ^Btrieve^ if ^BTR HELP!^ loads it. Set this option to 'YES' if you load ^Btrieve^ before you start ^BTR HELP!^ and you want ^Btrieve^ unloaded when ^BTR HELP!^ ends. *E *B 74,Transactions Transactions ÄÄÄÄÄÄÄÄÄÄÄÄ If this option is set to 'YES', ^BTR HELP!^ will allow the use of transaction processing when you edit a file. This allows you to undo changes that you make to the file. If you do not start ^Btrieve^ with transaction processing on, you will want to set this option to 'NO'. *E *B 75,43/50 Line Mode 43/50 Line Mode ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ If this option is set to 'YES' and you are using a EGA or VGA monitor, ^BTR HELP!^ will display more lines on the display. Adapter Lines Columns ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ EGA 43 80 VGA 50 80 Other 25 80 *E *B 76,Shadowed Windows Shadowed Windows ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ If this option is set to 'YES', ^BTR HELP!^ will display shadows on the program windows. *E *B 77,Owner Owner ÄÄÄÄÄ If all of your ^Btrieve^ files use the same owner name you may want to put the owner name here. ^BTR HELP!^ will use it as the default for accessing all ^Btrieve^ files. *E *B 78,Load Btrieve Load Btrieve ÄÄÄÄÄÄÄÄÄÄÄÄ This option loads ^Btrieve^ with the options specified on the configuration screen. *E *B 79,Warranty LIMITED WARRANTY Informative Technologies, Corporation does not warrant that the software operation will be error free or uninterrupted. Informative Technologies, Corporation shall not be liable for any incidental or consequential damages from the use or the user's inability to use this product. Informative Technologies Corporation specifically discaims all other warranties, expressed or implied, including but not limited to implied warranties of fitness for any particular purpose and of merchantability. *E *B 80,Search Degree Search Degree ÄÄÄÄÄÄÄÄÄÄÄÄÄ This selects how exact the match must be when performing a fuzzy text search. A setting of '0' means an exact match is requested. A setting of '1' means there can be a one character difference between the search text and text that matches in a record. Setting the search degree to any number 'N' means there can be a 'N' character difference between the search text and text that matches in a record. Press page down for examples. *P Search Search Btrieve Degree Text Text Result ÄÄÄÄÄÄ ÄÄÄÄÄÄÄÄÄÄÄ ÄÄÄÄÄÄÄÄÄÄÄÄÄ ÄÄÄÄÄÄÄÄ 0 SMITH SMITH Matches 1 WILLIAMS WILIAMS Matches 1 BALLOON BABOON No Match 2 BALLOON BABOON Matches 2 DRIVE ALIVE Matches 8 SUNSHINE MISSILES Matches 1 FF 3E 55 C0 FF 3E 54 C0 Matches 1 FF 3E 55 C0 FF 54 3E C0 No Match 2 01/19/1990 01/22/1990 Match *E *B 82,Case Sensitive Case Sensitive ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ If case sensitive is set to 'YES', ^BTR HELP!^ differentiates between uppercase and lowercase when performing text searches. *E *B 83,Hold Hold ÄÄÄÄ This menu option saves the physical location of the currently highlighted record. After you have saved the currently highlighted record, you can page through the file or change the current key. Selecting ^Goto Direct^ will then take you back to the record. *E *B 85,Auto Keys File Auto Keys File ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The characters in this file are typed when the program begins. The characters typed are treated like ^auto keys^. *E *B 86,File Recovery File Recovery ÄÄÄÄÄÄÄÄÄÄÄÄÄ This option is for the most seriously damaged btrieve files. It calculates every possible position a record could be in a file and tries to extract the record and inserts the records into a new btrieve file. Select to recover the file with the default parameters. Note: This method sometimes recovers more records than were originally in the file. If you browse the recovered file you will be able to see the extra records at the start or end of a key path. This method may not be valid with Btrieve versions greater than 5.1 because the file format may change. *P Start Recovery - Begins the recovery process. Select Files - Selects the files and file paths. Page Options - Allows you to select the starting, ending, and preallocated pages. Recovery Options - Allows you to select file open modes, recovery key, and blank record filtering. TIME Start - Starting time of the rebuild. Current - Current time. Elapsed - The amount of time that has elapsed. Estimate - The projected length of time the recovery process will take. *P RECOVERED - Number of recovered records. RECORDS - Total number of records to recover. DISK SPACE - The amount of remaining disk space on the drive where the new btrieve file is located. PAGE Start - First page to recover records. End - Last page to recover records. Current - The current page being processed. LAST ERROR - Displays the last error that occured while recovering records. *P LEGEND D - Duplicate record. An attempt was made to insert the record but btrieve returned a ^Duplicate Key Value^ error. Û - Data Record. The record was recovered and inserted into the new file. Î - Index/Unused. This is either part of an index page or an unused portion of a data page. X - Bad area. Btr Help! received an error when trying to recover a record from this position. B - A record was recovered and it was filled with all binary 0s. *E *B 87,Browse Screen Browse Screen ÄÄÄÄÄÄÄÄÄÄÄÄÄ Delete - Deletes the currently highlighted record. Exit - Leaves the browse screen. Key - Select the key to browse the file. Edit - Allows you to edit the highlighted record. ^Lock^ - Locks the highlighted record. Undo - Removes the changes you have made. Commit - Records all edits to the database. Search - Does a ^Fuzzy Search^ for text. *P Mode - Changes the way the records are formatted for the display. ^Hold^ - Saves the position of the current highlighted record. ^Add Records^ - Allows you to add a new record. ^Goto Direct^ - Goes directly to a record. Also See: ^Browse Keys^ ^Special Keys^ ^Editing Keys^ *E *B 88,Lock Lock ÄÄÄÄ The highlighted record is locked and is not available to other stations. *E *B 89,Editing Keys Cursor Movement ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Arrow keys - cursor movement Ctrl-Left Arrow - word left Ctrl-Right Arrow - word right Home - beginning of field End - end of line/field Ctrl-Home - beginning of first field Ctrl-End - end of last field Tab - next field Shift-Tab - previous field *P Inserting and Deleting ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Ins - toggle insert mode Del - delete character at cursor Backspace - delete character left Ctrl-Backspace - delete word left Ctrl-T - delete word right Ctrl-U - delete to end of field Ctrl-Y - delete to last field *P Other Editing Keys ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Enter - process current field Ctrl-Enter - process all fields Ctrl-R - restore field ESC - abort data entry Also see: ^BTR HELP!^ ^Special Keys^ *E *B 90,Mass-Store Copy tm MASS-STORE COPY ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ "Make copies of optical disks while using only one optical drive!" "If you don't have two WORM drives, you likely need to have this program." - Jerry Pournelle, BYTE January 1991 MASS-STORE COPY is a practical way to copy optical disks on a system that has only one optical drive. MASS-STORE COPY uses your computer's fixed disk to buffer information as it is copied from one optical disk to another. *P Your computer may have a hard drive and one optical disk drive. You could try to copy your optical disk using the DOS copy command, but why? You could be swapping the original and backup disk hundreds of times. Or, you could copy each file to the hard disk and then copy the files individually to a backup optical disk. But what would you do if one of the files is larger than the hard drive? MASS-STORE COPY eliminates the need to copy each file from an original disk to a buffer drive individually and copying them individually to a backup disk. *P MASS-STORE COPY will copy any size file and any size disk using the available disk space on your computers' hard drive. MASS-STORE COPY works with any DOS compatible drive that has removable disks. All drives that use removable DOS disks work with MASS-STORE COPY, not just optical disks. MASS-STORE COPY is compatible with the following drives: + Bernoulli Box Drives + Erasable Optical Drives + Removable Hard Drives + Portable Hard Drive Packs + WORM Drives + 5.25, 3.5 or "Super" Floppy Drives *P FEATURES ÄÄÄÄÄÄÄÄ + Backups of optical disks are made using one drive. There's no need to buy a second optical drive just to make backup copies of optical disks! + Copies any size removable DOS disk, regardless of available space on the hard disk. + Files are compressed when they are copied to the hard drive and then uncompressed when they are copied to the backup disk. This means you'll do a lot less disk swapping when copying disks. *P + Mouse Compatible with context-sensitive help screens. + Files that are copied can be based on file date, file specification, system flags, hidden flags, and archive bit. + MASS-STORE COPY also copies DOS compatible disks that must be "Mounted" and "Dismounted". + Files that are larger than your hard drive can be copied regardless of available space on the hard drive. *P How to Order MASS-STORE COPY ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Send check, money order, or postal order for $59.95 + $4.00 S&H. If you are from outside the USA please have your bank prepare a check in USA dollars drawn on a USA bank and include an extra $5.00 for postage. Informative Technologies Corp. Voice (202) 675-4528 1718 M Street NW, Suite 292 FAX (202) 675-4529 Washington, DC 20036-4504 You must be satisfied with MASS-STORE COPY or you may return it within 60 days for a full refund! *P Name_____________________________ Title_____________________ Company Name________________________________________________ Address_____________________________________________________ City________________________________State______Zip__________ Phone#_________________________Fax#_________________________ PRESS MASS-STORE COPY @ $59.95 $_59.95_ "Print Screen" DC Residents Add %6 Sales Tax $_______ for Order Form. Shipping and Handling $_______ []MONEY ORDER []POSTAL ORDER []CHECK Total $_______ *E *B 91,File Owner File Owner ÄÄÄÄÄÄÄÄÄÄ Specifies the owner name for the files accessed by ^Btrieve^. Example: BTRHELP -oDEPT1 *E *B 92,Rebuild Timings Rebuild Timings ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The following statistics are the results of timings for rebuilding a ^Btrieve^ file using various methods. The file being rebuilt contained 4943 records of size 82 bytes. There were 7 keys made up of 18 segments. The page size was 1024. The size of the file was about 2M. The file file server was a 25Mhz 386 and the rebuilding programs were run on a 16Mhz 386sx workstation. *P REBUILD TIMINGS BTRHELP! BTRHELP! BUTIL Quick Regular -Recover Rebuild Rebuild -Load ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BTRIEVE/N 5.1 370 641 488 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BTRIEVE VAP 5.1 209 433 283 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BTRIEVE NLM 5.1 222 416 275 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ All values are in seconds. *E *B 93,Btrieve Long Integer Btrieve Long Integer ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Btrieve treats a long integer differently than 'C' does. The bytes of the upper and lower words in a long integer are swapped. Long Integer HIGH [4] [3] [2] [1] LOW BYTE BYTE Btrieve [3] [4] [1] [2] Long Integer *E *B 94,Browse Keys Browse Keys ÄÄÄÄÄÄÄÄÄÄÄ When browsing a Btrieve file, several special keys are available to you. Ctrl+Home - Goes to the start of a file. Ctrl+End - Goes to the end of a file. Esc - Ends the browse. Home - Puts the highlight bar on the first record on the screen. End - Puts the highlight bar on the last record on the screen. Ctrl+Right Arrow - Scrolls forward through the currently displayed records a screen at a time. *P Ctrl+Left Arrow - Scrolls backward through the currently displayed records a screen at a time. Right Arrow - Scrolls the records shown on the screen to the left. Left Arrow - Scrolls the records shown on the screen to the right. Up Arrow - Scroll up one record. Down Arrow - Scroll down one record. *E *B 95,ASCII ASCII ÄÄÄÄÄ ASCII is an acronym for American Standard Code for Information Interchange. ASCII is a standard 7-bit information code that defines 128 standard characters, including control characters, letters, numbers, and symbols. *E *B 96,Shareware W H A T I S S H A R E W A R E ? --------------------------------------- ================= Some Definitions: ================= You've probably heard the terms "public domain", "freeware", "shareware", and others like them. Your favorite BBS or disk vendor probably has many programs described by one or more of these words. There's a lot of confusion about and between these terms, but they actually have specific meanings and implications. Once you understand them, you will have a much easier time navigating the maze of programs *P available to you, and understanding what your obligations are, or aren't, with each type of program. Let's start with some basic definitions. "Public domain" has a very specific legal meaning. It means that the creator of a work (in this case, software), who had legal ownership of that work, has given up ownership and dedicated the work "to the public domain". Once something is in the public domain, anyone can use it in any way they choose, and the author has no control over the use and cannot demand payment for it. *P If you find a program which the author has explicitly put into the public domain, you are free to use it however you see fit without paying for the right to use it. But use care - due to the confusion over the meaning of the words, programs are often described by authors as being "public domain" when, in fact, they are shareware or free, copyrighted software. To be sure a program is public domain, you should look for an explicit statement from the author to that effect. "Copyrighted" is the opposite of public domain. A copyrighted program is one where the author has asserted his or her legal right to control the program's use and distribution by placing the legally required copyright notices in the program and *P documentation. The law gives copyright owners broad rights to restrict how their work is distributed, and provides for penalties for those who violate these restrictions. When you find a program which is copyrighted, you must use it in accordance with the copyright owner's restrictions regarding distribution and payment. Usually, these are clearly stated in the program documentation. Maintaining a copyright does not necessarily imply charging a fee, so it is perfectly possible and legal to have copyrighted programs which are distributed free of charge. The fact that a program is free, however, does not mean it is in the public domain - though this is a common confusion. *P "Shareware" is copyrighted software which is distributed by authors through bulletin boards, on-line services, disk vendors,and copies passed among friends. It is commercial software which you are allowed to try before you pay for it. This makes shareware the ultimate in money back guarantees. ====================== The Shareware Concept: ====================== Most money back guarantees work like this: You pay for the product and then have some period of time to try it out and see whether or not you like it. If you don't like it or find that it doesn't do what you need, you *P return it (undamaged) and at some point - which might take months - you get your money back. Some software companies won't even let you try their product! In order to qualify for a refund, the diskette envelope must have an unbroken seal. With these "licensing" agreements, you only qualify for your money back if you haven't tried the product. How absurd! Shareware is very different. With Shareware you get to try it for a limited time, without spending a penny. You are able to use the software on your own system(s), in your own special work environment, with no sales people looking over your shoulder. If you decide not to continue using it, you throw it away and forget all about it. No paperwork, phone calls, or correspondence *P to waste your valuable time. If you do continue using it, then - and only then - do you pay for it. Shareware is a distribution method, NOT a type of software. Shareware is produced by accomplished programmers, just like retail software. There is good and bad Shareware, just as there is good and bad retail software. The primary difference between Shareware and retail software is that with Shareware you know if it's good or bad BEFORE you pay for it. As a software user, you benefit because you get to use the software to determine whether it meets your needs before you pay for it, and authors benefit because they are able to get their products into your hands without *P the hundreds of thousands of dollars in expenses it takes to launch a traditional retail software product. There are many programs on the market today which would never have become available without the Shareware marketing method. The shareware system and the continued availability of quality shareware products depend on your willingness to register and pay for the shareware you use. It's the registration fees you pay which allow us to support and continue to develop our products. Please show your support for Shareware by registering those programs you actually use and by passing them on to others. *P Shareware is kept alive by YOUR support! Also See: ^Registration^ *E *B 97,Technical Support Technical Support ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ^BTR HELP!^ software support is available. There are several ways to contact the author: 1. Send EMAIL on CompuServe to David Smith #71311,2334 2. Leave a voice mail message at (202) 675-4528 for David Smith. 3. Send a FAX to (202) 675-4529 *P 4. Leave a message at the Programmers Corner BBS for David Smith #1082 BBS# (301) 596-1180 5. Or by mail to: David Smith Informative Technologies Corporation 1718 M Street NW, Suite 292 Washington, DC 20036 Voice mail messages will probably not be answered until the next day. Email responses will usually be the fastest, with a response by the end of the day. If you are outside of the United States and you need pre or post registration support, please include your email *P address when you leave a voice mail message or send a fax. Please include all relevant information regarding your problem including: 1 - A description of the event. 2 - The steps that consistently reproduce the event. 3 - Btrieve version number, type, and command line parameters. (BTRIEVE, BREQUEST, NLM, VAP) 4 - Hardware information. (Machine Type, Video Adapter) 5 - Command line used to load Btr Help!. Feel free to leave comments and suggestions to the attention of David Smith. *P ^ASP^ wants to make sure that the ^shareware^ principle works for you. If you are unable to resolve a ^shareware^- related problem with an ^ASP^ member by contacting the member directly, ^ASP^ may be able to help. The ^ASP^ Ombudsman can help you resolve a dispute or problem with an ^ASP^ member, but does not provide technical support for members' products. Please write to the ^ASP^ Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a Compuserve message via easyplex to ^ASP^ Ombudsman 70007,3536" *E *B 98,Registration R E G I S T R A T I O N ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Registration is required if you continue to use ^BTR HELP!^ after evaluating it for 30 days. This program is produced by a member of the Association of ^Shareware^ Professionals (^ASP^). Registering your copy of ^BTR HELP!^ helps the author provide professional-quality software at reasonable prices. Registration is $40 for a single user plus $4 S&H. Complete your registration of ^BTR HELP!^ for full benefits. Press ESC to exit this screen or Page Down for more... *P The registration benefits you will receive: - A diskette with the latest version of ^BTR HELP!^. - A Printed Manual For ^BTR HELP!^. - ^BTR 'C' Library^ to manipulate Btrieve files using function calls. - Includes full 'C' source code. - Advance notification of updates to ^BTR HELP!^ - Free ^Technical Support^ for 1 Year. - 1 extra disk with 10 shareware, public domain, and demo ^Btrieve^ utilities. *P Please send check, money order, or postal order. If you are from outside the USA please have your bank prepare a check in USA dollars drawn on a USA bank. Registrants outside the USA should send an extra $5.00 for postage. Send registrations to: David Smith Voice (202) 675-4528 Informative Technologies Corp. FAX (202) 675-4529 1718 M Street NW, Suite 292 CompuServe 71311,2334 Washington, DC 20036 OR.... *P You may also register with MC, VISA, AMEX or DISCOVER by contacting the Public (software) Library at: (Phone) 800-2424-PSL or 713-524-6394 (Fax) 713-524-6398 (CIS-email) PsL at 71355,470 These numbers are for credit card orders only. For ^Technical Support^, site licensing, volume or dealer discounts, please contact David Smith at Informative Technologies Corporation. *E *B 99,Btrieve Btrieve ÄÄÄÄÄÄÄ Btrieve is a Trademark of Novell, Inc. Btrieve is a record management system designed to aid PC programmers in the development of applications. Btrieve provides the functions for high performance key-indexed record management while allowing the programmer to concentrate on the application. *E *B 100,Damaged File Damaged File ÄÄÄÄÄÄÄÄÄÄÄÄ This is the damaged file you want to recover. *E *B 101,Recovery File Recovery File ÄÄÄÄÄÄÄÄÄÄÄÄÄ This is the file the records will be placed in from the damaged file. *E *B 102,Starting Page Starting Page ÄÄÄÄÄÄÄÄÄÄÄÄÄ This is the first page to recover records from the damaged file. The default setting is 1. If you would like to break the recovery into two steps you would set this to a value other than 1. EXAMPLE: For a file with 10,000 pages. You could break it into two steps that could be run at night. *P First Night. SET Starting Page = 1 Ending Page = 5,000 Second Night. SET Starting Page = 5,001 Ending Page = 10,000 *E *B 103,Ending Page Ending Page ÄÄÄÄÄÄÄÄÄÄÄ This is the last page to recover records from the damaged file. The default setting is the number of pages in the file. If you would like to break the recovery into two steps you would set this to a value other than the number of pages in the file. EXAMPLE: For a file with 10,000 pages. You could break it into two steps that could be run at night. *P First Night. SET Starting Page = 1 Ending Page = 5,000 Second Night. SET Starting Page = 5,001 Ending Page = 10,000 *E *B 104,Preallocate Pages Preallocate Pages ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This is the number of pages that will be preallocated for the recovered records. If the file exists, this option does not affect the file. The default setting is the number of pages in the original file. Preallocating the pages speeds the recovery process. *E *B 105,Get Direct Key Get Direct Key ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This is the key value used to perform the ^Get Direct^ operation to recover the records. The default setting is -1. Some versions of ^Btrieve^ do not support using -1 as the key for ^Get Direct^ operations. BTR HELP! will determine if your version of ^Btrieve^ supports -1 as the key. If it does not, it will automatically switch to using 0 as the key. If ^Btrieve^ does not support -1 as the key, you may not be able to recover as many of the records. *E *B 106,Eliminate Blank Records Eliminate Blank Records ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ When this option is set to 'YES', ^BTR HELP!^ will not add records that are filled with all binary 0s it recovers from the damaged file. If this option is set to 'NO', blank records will be added if they are found. The default setting for this option is 'YES'. *E *B 107,Violation THE 30 DAY EVALUATION PERIOD HAS EXPIRED! ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ^Registration^ is required if you continue to use BTR HELP! after evaluating it for 30 days. You may register with MC, VISA, AMEX or DISCOVER by contacting the Public (software) Library at: (Phone) 800-2424-PSL or 713-524-6394 (Fax) 713-524-6398 (CIS-email) PsL at 71355,470 These numbers are for credit card orders only. *E *B 400,Help Wanted Hints or Tips Wanted ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ If you have any tips or hints for using btrieve that could be included in this data-base or if you have found a special situation in which an error occurs, please send them to me. OR David Smith David Smith Informative Technologies CompuServe 71311,2334 1718 M Street NW, Suite 292 Washington, DC 20036 *E *B 401,No Variable Length Records Variable length records are not supported. *E *B 402,No Records This file is empty. *E *B 403,Version5.1 Btrieve version 5.1 or greater is needed for quick rebuilder. *E *B 404,Low Memory There is not much memory available. Some functions may not work correctly. *E *B 405,Not Exclusive Unable to open the file in exclusive mode. Another station may still have the file open. *E *B 406,ASP ÚÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÁÄÄÄ¿ ³ (tm) Äij ³o ³ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³ ÚÄÄÄÄÄÁÐÄÄ¿ ³ Association of ³ ³ ³ÄÙ ^Shareware^ ÀÄÄij o ³ Professionals ÄÄÄÄÄij º ³ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÀÄÄÄÄÐÄÄÄÄÙ MEMBER In the early days of Shareware there were no real standards. Independent authors had no efficient way to learn from each other or to work together to improve the overall image of Shareware. There was no system in place to ensure that users were treated fairly and professionally. *P There was no way for users to find an address for an author who had moved. In short, the Shareware community was disorganized and each author did things the way he or she thought was best. It was clear that if Shareware was ever to become a viable and respected marketing alternative, there had to be some standardization. There had to be some guidelines to best serve the users. In 1987 a handful of Shareware authors founded the Association of Shareware Professionals (ASP). In forming this industry association, these Shareware authors had several primary goals in mind, including: *P o To inform users about Shareware programs and about Shareware as a method of distributing and marketing software. o To foster a high degree of professionalism among Shareware authors by setting programming, marketing, and support standards for ASP members to follow. o To encourage broader distribution of Shareware through user groups and disk dealers who agree to identify and explain the nature of Shareware. o To assist members in marketing their software. *P o To provide a forum through which ASP members may communicate, share ideas, and learn from each other. The newly formed Association of Shareware Professionals worked together to draft a code of ethics for all present and future members. This code of ethics included several requirements that soon became very popular among users (customers), including: o A member's program (evaluation version) could not be limited (crippled) in any way. In the true spirit of Try-Before-You-Buy, users must be able to evaluate all the features in a program before paying the registration fee. *P o Members must respond to every registration. At the very least they must send a receipt for the payment. o Members must provide technical support for their products for at least 90 days from the date of registration. A new system was put in place to help ensure that users were treated fairly and professionally. If a user was unable to resolve a problem with a member author then the user could contact the ASP Ombudsman with their complaint. The Ombudsman would then try to help resolve the dispute. *P As of February, 1991, the ASP had over 300 author members and almost 200 vendor members, with new members joining every week. ====================================== Contacting ASP Members Via CompuServe: ====================================== There is an easy and convenient way to speak directly to many ASP Members (both authors and vendors). Visit the Shareware forum on CompuServe. Simply type "GO SHAREWARE" - or "GO SHARE" - from any CompuServe ! prompt. *P Here you will be able to talk to the authors of your favorite Shareware programs, learn about other programs, ask questions, make suggestions, and much more. We'd love to meet you online, please come visit us today! ALSO SEE: ^Registration^ ^Shareware^ *E *B 407,File Not Found Unable to open the file. The file does not exist. *E *B 408,Btr 'C' Library BTR 'C' LIBRARY ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The BTR 'C' LIBRARY is available with the registered version of ^Btr Help!^. All the calls to the BTR 'C' LIBRARY reference btrieve files by a handle (integer). This handle is returned when the file is opened with the iBtrOpen function. The function BtrInitialize should be called at the beginning of your program and iBtrCloseAll should be called at the end of your program. Press PageDown for an example. *P #include #include void main( void ) { int iNews; BtrInitialize(); iNews = iBtrOpen("NWSPAPER.BTR", NULL, B_OPEN); iBtrCall( iNews, B_GET_LOWEST, 1); /* Application Code goes here.. */ iBtrClose( iNews ); iBtrCloseAll(); /* Close all Files still open */ } Press PageDown for a list of library functions. *P char *BtrErrorCode(int iBtrError) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Returns the string for a btrieve error code. INPUTS iBtrError - Error code number RETURNS String for a btrieve error code. EXAMPLE printf("Btrieve Error 10=%s\n", BtrErrorCode( 10 )); *P char *BtrOperationCode(int iBtrOper) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Returns the string for a btrieve Operation code. INPUTS iBtrOper - Btrieve Function code RETURNS String for a btrieve operation code. EXAMPLE printf("Operation 3 is %s\n",BtrOperationCode( 3 )); *P int BtrOpen(char *sFile, void *acRecord, int iOpenType) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Opens a btrieve file. Does a statistics function call on the file. Stores the record size and key information. Returns a handle (integer) to refer to the Btrieve file. INPUTS sFile........Btrieve file path and name acRecord.....Pointer to btrieve record or NULL if you want a record to be automatically allocated for you. iOpenType....Type of open for the btrieve file. *P B_OPEN Regular btrieve open B_OPEN_ACCELERATED Open Accelerated B_OPEN_READ_ONLY Open Read Only B_OPEN_VERIFY Open Verify for local DOS disks B_OPEN_EXCLUSIVE Open Exclusive access to file RETURNS Btrieve file handle or 0 if an error occurs. EXAMPLE iBtr=BtrOpen("MAIL.BTR", &rMail, B_OPEN); *P int BtrClose(int iBtrHandle) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Closes a the file and Deallocates data space used by it. INPUTS iBtrHandle....File handle (integer) that refers to the file. RETURNS The Btrieve result status code of the close. EXAMPLE BtrClose(iBtr); *P void BtrShowError( int iBtrHandle ) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Displays a btrieve error on the screen. You will probably want to modify this routine for your particular user interface. INPUTS iBtrHandle...Btrieve file handle to display last operation result. RETURNS Nothing EXAMPLE BtrShowError( iBtr ); *P int BtrCreate(char *sFile, FILE_SPEC *specs, int iKey) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Creates a btrieve file. INPUTS sFile........The file name supplied. specs........The Btrieve specs to create the file. iKey.........Create Status Key. CHECK_EXISTS - Check if file exists on create. NO_CHECK_EXISTS - Don't check if file exists. RETURNS The btrieve result status code of the create. EXAMPLE BtrCreate("TEMP.BTR",&FileSpecs, 0); *P int BtrCall(int iBtr, int iFuncCode, int iKeyNumber) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Executes a function call on a file specified by iBtr. INPUTS iBtr.........Btrieve file handle iFuncCode....Btrieve function code to execute iKeyNumber...Key path to use RETURNS Btrieve result status of the function. EXAMPLE BtrCall(iBtr, B_GET_NEXT, 0); *P int BtrFillKey(int iBtrHandle, void *sKeyField) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Fills a btrieve key field from a string. INPUTS iBtrHandle...Handle of btrieve file sKeyField....String to load into the key field RETURNS FILE_NOT_OPEN if the handle is invalid, else it returns 0. EXAMPLE BtrFillKey(iBtr, "NEW YORK"); *P int BtrFillKeyN(int iBtr, void *sKeyField, int iLength) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Fills the key field from an array of length iLength. INPUTS iBtr........Handle of btrieve file sKeyField...Address of bytes to load into the key field. iLength.....Number of bytes to load RETURNS FILE_NOT_OPEN if the handle is invalid, else it returns 0 EXAMPLE BtrFillKeyN(iBtr, rKeyStruct, sizeof(rKeyStruct); *P int BtrSetRecordLength(int iBtr, int iRecordLength) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Sets the record length of a btrieve record. INPUTS iBtr.............Handle of btrieve file iRecordLength....Size of the btrieve record. RETURNS FILE_NOT_OPEN if the handle is invalid, else it returns 0. EXAMPLE BtrSetRecordLength(iBtr, sizeof(rMail)); *P int iBtrGetRecordLength(int iBtrHandle) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Returns the record length of the last record read. INPUTS iBtrHandle...Handle of the btrieve file. RETURNS 0 if the handle is invalid, else it returns the record length. EXAMPLE iLength = iBtrGetRecordLength( iBtr ); *P void BtrInitialize(void) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Initializes btrieve and the data structures. INPUTS None RETURNS None EXAMPLE BtrInitialize(); *P long lBtrGetPosition(int iBtrHandle) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Returns a long integer indicating the position of the current record. INPUTS iBtrHandle...Handle of the btrieve file. RETURNS The position of the current btrieve record. EXAMPLE lPosition = lBtrGetPosition( iBtr ); *P int iBtrSetPosition(int iBtr, long lPosition, int iKey) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Sets the position of the current record using a long int. INPUTS iBtr..........Handle of the btrieve file. lPosition.....Position to set in the btrieve file. iKey..........Key path to set the current positioning. RETURNS The btrieve result status for the B_GET_DIRECT call. EXAMPLE iBtrSetPosition(iBtr, lPosition, 0); *P int BtrCloseAll(void) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Closes all btrieve files that may be open. INPUTS None RETURNS 0 EXAMPLE int BtrCloseAll(); *P int BtrKeyInit(int iBtrHandle) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Fills a btrieve key field with nulls. INPUTS iBtrHandle........Handle of the btrieve file. RETURNS 0 or FILE_NOT_OPEN if the handle is invalid. EXAMPLE BtrKeyInit( iBtr ); *P int BtrKeyMax(int iBtrHandle) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Fills a btrieve key field with 0xFF. INPUTS iBtrHandle....Handle of the btrieve file. RETURNS 0 or FILE_NOT_OPEN if the handle is invalid. EXAMPLE BtrKeyMax( iBtr ); *P char *BtrDataRecord(int iBtrHandle) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Returns a pointer to the btrieve data record given the file handle. INPUTS iBtrHandle...Handle of the btrieve file. RETURNS Pointer to the btrieve data record. EXAMPLE prMail = BtrDataRecord( iBtr ); *P long BtrNumberOfRecords( iBtr ) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Returns a long integer containing the number of records in a file when the file was opened. Does not reflect any records added or deleted since the file was open. INPUTS iBtrHandle...Handle of the btrieve file. RETURNS The number of records in a btrieve file. EXAMPLE lRecords = BtrNumberOfRecords( iBtr ); *P void *BtrSpecRecord(int iBtrHandle) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Returns a pointer to the btrieve file specifications for a btrieve file. INPUTS iBtrHandle....Handle of the btrieve file. RETURNS Pointer to the btrieve file specifications for a file. EXAMPLE Specs = BtrSpecRecord( iBtr ); *E *B 500,Open (0) Open ÄÄÄÄÄÄÄÄ This operation opens the file and makes it available to be accessed. Open Mode Description ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ -1 Accelerated -2 Read-Only -3 Verify -4 Exclusive Other Normal *E *B 501,Close (1) Close ÄÄÄÄÄÄÄÄÄ This operation closes a file. *E *B 502,Insert (2) Insert ÄÄÄÄÄÄÄÄÄÄ This operation inserts a record into a file. *E *B 503,Update (3) Update ÄÄÄÄÄÄÄÄÄÄ This operation updates the current record. *E *B 504,Delete (4) Delete ÄÄÄÄÄÄÄÄÄÄ This operation deletes the current record. *E *B 505,Get Equal (5) Get Equal ÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns the record in which the key value equals the current key value. *E *B 506,Get Next (6) Get Next ÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns the next record for the current key path. *E *B 507,Get Previous (7) Get Previous ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns the previous record for the current key path. *E *B 508,Get Greater (8) Get Greater ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns the record who's key value is greater than the current key value. *E *B 509,Get Greater or Equal (9) Get Greater or Equal ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns the record who's key value is greater than or equal to the current key value. *E *B 510,Get Less Than (10) Get Less Than ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns the record who's key value is less than the current key value. *E *B 511,Get Less Than or Equal (11) Get Less Than or Equal ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns the record who's key value is less than or equal to the current key value. *E *B 512,Get First (12) Get First ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns the first or lowest record in a key path. *E *B 513,Get Last (13) Get Last ÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns the last or highest record in a key path. *E *B 514,Create (14) Create ÄÄÄÄÄÄÄÄÄÄÄ This operation creates a ^Btrieve^ file. *E *B 515,Statistics (15) Statistics ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns various statistics on a a ^Btrieve^ file; The number of records, the characteristics of the key paths, and the file flags and specifications. *E *B 516,Extend (16) Extend ÄÄÄÄÄÄÄÄÄÄÄ This operation extends a ^btrieve^ file onto two drive letters. It splits the file into two files. The file is accessed the same way. Use this operation if your file has grown too large to fit on a single drive. DO NOT use it if you plan to use NetWare 386. The NLM ^Btrieve^ does not support extended files. This process is only reversable by rebuilding the ^Btrieve^ file into another file. *E *B 517,Set Directory (17) Set Directory ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation changes the current directory to another directory. *E *B 518,Get Directory (18) Get Directory ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation gets the current working directory. *E *B 519,Begin Transaction (19) Begin Transaction ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation signals the beginning of a group of ^Btrieve^ operations that belong together. *E *B 520,End Transaction (20) End Transaction ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation signals the end of a group of ^Btrieve^ operations that belong together. *E *B 521,Abort Transaction (21) Abort Transaction ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation causes all ^Btrieve^ operations since a ^Begin Transaction^ to be removed. *E *B 522,Get Position (22) Get Position ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns physical location of the current btrieve record in the form of a long integer in ^Btrieve long integer^ format. *E *B 523,Get Direct (23) Get Direct or Set Position ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation sets the current ^Btrieve^ record to a specific physical location in the file. *E *B 524,Step Next (24) Step Next ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns the next physical record in the ^Btrieve^ file. *E *B 525,Stop (25) Stop ÄÄÄÄÄÄÄÄÄ This operation terminates ^Btrieve^ and removes ^Btrieve^ from memory. *E *B 526,Version (26) Version ÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns the ^Btrieve^ type, version, and revision. *E *B 527,Unlock (27) Unlock ÄÄÄÄÄÄÄÄÄÄÄ This operation unlocks a ^Btrieve^ record or records. *E *B 528,Reset (28) Reset ÄÄÄÄÄÄÄÄÄÄ This operation aborts any transactions the station has pending, releases all locks, and closes any open files for the station. *E *B 529,Set Owner (29) Set Owner ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation sets an owner name to a ^Btrieve^ file. *E *B 530,Clear Owner (30) Clear Owner ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation clears an owner name from a ^Btrieve^ file. *E *B 531,Create Supplemental Index (31) Create Supplemental Index ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation creates a new key path for a ^Btrieve^ file. *E *B 532,Drop Supplemental Index (32) Drop Supplemental Index ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation removes a supplemental index from a ^Btrieve^ file. *E *B 533,Step First (33) Step First ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns the first physical record in a ^Btrieve^ file. *E *B 534,Step Last (34) Step Last ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns the last physical record in a ^Btrieve^ file. *E *B 535,Step Previous (35) Step Previous ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns the previous physical record in the ^Btrieve^ file. *E *B 536,Get Next Extended (36) Get Next Extended ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns records following the current record based upon filtering conditions. The first integer in the data buffer for this command is the number of bytes in the outgoing data buffer structure. Make sure you specify the length of the data for this command as the first integer of the data buffer structure and NOT the size of the data buffer structure. Set the data buffer length parameter as normal to specify the size of the larger of the outgoing data buffer structure or incoming data structure. *E *B 537,Get Previous Extended (37) Get Previous Extended ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns records preceding the current record based upon filtering conditions. The first integer in the data buffer for this command is the number of bytes in the outgoing data buffer structure. Make sure you specify the length of the data for this command as the first integer of the data buffer structure and NOT the size of the data buffer structure. Set the data buffer length parameter as normal to specify the size of the larger of the outgoing data buffer structure or incoming data structure. *E *B 538,Step Next Extended (38) Step Next Extended ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns records following the current record's physical position based upon filtering conditions. *E *B 539,Step Previous Extended (39) Step Previous Extended ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation returns records preceding the current record's physical position based upon filtering conditions. *E *B 540,Insert Extended (40) Insert Extended ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation inserts one or more records into a ^Btrieve^ file. The sum of the individual record lengths plus 2 bytes for each record must EQUAL the data buffer length specified. *E *B 600,Success (0) Success ÄÄÄÄÄÄÄÄÄÄÄ This operation was successfully completed. *E *B 601,Invalid Operation (1) Invalid Operation ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation requested was not a valid operation code. The operation code was not in the range from 0 to 40. *E *B 602,I/O Error (2) I/O Error ÄÄÄÄÄÄÄÄÄÄÄÄÄ This is the most dreaded of all status codes. Either the file is not a btrieve file, memory has been corrupted and ^Btrieve^ was passed an invalid position block, or the file has become damaged. If it has become damaged you could try using ^File Rebuilder^ to repair the file. *E *B 603,File Not Open (3) File Not Open ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ A ^Btrieve^ file must first be opened before you can do any other operations on the file. This error could also occur if the position block if corrupted or you are passing the wrong position block to ^Btrieve^. *E *B 604,Key Value Not Found (4) Key Value Not Found ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ A record having the key that you were searching for is not in the ^btrieve^ file. *E *B 605,Duplicate Key Value (5) Duplicate Key Value ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ You were trying to add a record to a ^btrieve^ file that has a duplicate key value of a record that already exists. Either change the field that contains the duplicate value to another value and insert the record again. Or recreate the file to allow duplicate keys for that key path. *E *B 606,Invalid Key Number (6) Invalid Key Number ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The key path that you are trying to access does not exist. If you are using a supplemental index, you may need to do the ^Create Supplemental Index^ operation. *E *B 607,Different Key Number (7) Different Key Number ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The key path that you are using has changed. Use the same key number when you are using ^Get Next^, ^Get Previous^, or ^Delete^ operations. If you want to change key paths, do a ^Get Position^ and then a ^Get Direct^. *E *B 608,Invalid Positioning (8) Invalid Positioning ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This error can occur when you try to ^Update^, ^Delete^, or get the position of a record without first establishing the current position. You can establish the position of a record by doing a get or step operation. *E *B 609,End of File (9) End of File ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The occurs when you try to retrieve a record past the end of the file. You can reach the end of a ^Btrieve^ file traversing it forwards or backwards on a key path. *E *B 610,Modifiable Key Value Error (10) Modifiable Key Value Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ You have attempted to ^Update^ a key field that was defined as unmodifiable. *E *B 611,Invalid Filename (11) Invalid Filename ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The filename must be followed by a space character or a NULL zero. *E *B 612,File not Found (12) File not Found ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ^Btrieve^ could not find the file that you specified. Either the file was specified with the wrong name or the file does not exist in the directory you specified. Make sure the filename is terminated with a space character or a NULL zero. *E *B 613,Extended File Error (13) Extended File Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ^Btrieve^ could not find the extension file for a file that was requested to be opened. If the file is on a network volume, be sure that the current user has access to that drive. The extended file must be at the same location as where it was originally created. *E *B 614,Pre-Image Open Error (14) Pre-Image Open Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The pre-image file could not be created or opened. *E ADD MORE INFO TO THE ABOVE ERROR... *B 615,Pre-Image I/O Error (15) Pre-Image I/O Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ An I/O error occurred while writing the pre-image file. Probably your disk is full or it could be that the pre-image file has become damaged. If the pre-image file has become damaged, you may want to use ^File Rebuilder^ to recover the damaged file. *E *B 616,Expansion Error (16) Expansion Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ There could have possibly been a hardware failure with the disk drive. *E ADD MORE INFO TO THE ABOVE ERROR.... *B 617,Close Error (17) Close Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ There could have possibly been a hardware failure with the disk drive. *E ADD MORE INFO TO THE ABOVE ERROR.... *B 618,Disk Full (18) Disk Full ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The disk drive is full and the ^Btrieve^ file could not be expanded allow more records to be inserted. *E *B 619,Unrecoverable Error (19) Unrecoverable Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ You may need to rebuild your ^Btrieve^ file. ^Help Wanted^ *E *B 620,Record Manager Inactive (20) Record Manager Inactive ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This error could be caused while using BREQUEST.EXE to access a ^Btrieve^ file that is on a local drive. Load BTRIEVE.EXE to access ^Btrieve^ files on local drives. This error will also occur if BREQUEST.EXE is loaded on a workstation and the NLM or VAP is not loaded on the file server. *E *B 621,Key Buffer Too Short (21) Key Buffer Too Short ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The key buffer was not long enough. *E *B 622,Data Buffer Length (22) Data Buffer Length ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The data buffer is not large enough. ^Help Wanted^ *E *B 623,Position Block Length (23) Position Block Length ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The position block length is not equal to 128. *E *B 624,Page Size Error (24) Page Size Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This error indicates there is an error with the page length. The page size is checked first when ^Btrieve^ is called during a ^create^. If it is not multiple of 512 and less than or equal to 4096 then this error will occur. This error may also indicate an invalid data buffer. *E *B 625,Create I/O Error (25) Create I/O Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ^Btrieve^ could not create a file. The disk drive could be full or the file already exists and it is open. There may be a bug in Netware 386 or Btrieve that causes this message when you create a file and specify to that you want the file overwritten if it exists and the file does exist. *E *B 626,Number of Keys (26) Number of Keys ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The number of keys specified was invalid for the page size. A page size of 512 supports from 1 to 8 segments. Any larger page size supports from 1 to 24 segments. *E *B 627,Invalid Key Position (27) Invalid Key Position ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This error occurs during a ^Btrieve^ file create. The key position plus the key length is greater than the record length. *E *B 628,Invalid Record Length (28) Invalid Record Length ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This error occurs during a ^Btrieve^ file create. The record length must be greater than four bytes and less than the pagesize minus six. *E *B 629,Invalid Key Length (29) Invalid Key Length ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The key length must be larger than 0 and less than 255. The length of a binary key must be even. Index pages in the file must be large enough to hold 8 keys. ^Help Wanted^ *E *B 630,Not a Btrieve File (30) Not a Btrieve File ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The file is not a btrieve file or the file header has been corrupted. *E *B 631,File Already Extended (31) File Already Extended ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ^Btrieve^ files can be extended only once. *E *B 632,Extend I/O Error (32) Extended I/O Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The file could not be extended. The disk could be full or write protected. *E *B 633,???? (33) ????? ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ^Help Wanted^ *E *B 634,Invalid Extension Name (34) Invalid Extension Name ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The file name specified for the extension was invalid. *E *B 635,Directory Error (35) Directory Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Either the drive specified in the ^Get Directory^ operation does not exist or the pathname specified in a ^Set Directory^ operation was invalid. *E *B 636,Transaction Error (36) Transaction Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ A ^Begin Transaction^ operation could not be performed because no transactions were specified when ^Btrieve^ was loaded. *E *B 637,Transaction is Active (37) Transaction is Active ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ A transaction was begun while another transaction was still active. *E *B 638,Transaction Control File I/O Error (38) Transaction Control File I/O Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The disk drive could have filled, the disk was write protected, or the transaction file was deleted. *E *B 639,End/Abort Transaction Error (39) End/Abort Transaction Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This error is caused by executing an ^End Transaction^ without a ^Begin Transaction^. *E *B 640,Transaction Max Files (40) Transaction Max Files ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The application tried to update more than the maximum number of files allowed within a transaction. The maximum number is set when ^Btrieve^ is loaded. *E *B 641,Operation Not Allowed (41) Operation Not Allowed ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This operation is not allowed. *E *B 642,Incomplete Accelerated Access (42) Incomplete Accelerated Access ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The application tried to open a file that was previously accessed in accelerated mode and was never successfully closed. The file will need to be rebuilt or restored from the last backup. *E *B 643,Invalid Record Address (43) Invalid Record Address ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The record address specified for a ^Get Direct^ operation was invalid. *E *B 644,Null Key Path (44) Null Key Path ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Btrieve cannot establish positioning based on a null key value. *E *B 645,Inconsistent Key Flags (45) Inconsistent Key Flags ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The key flags specified on a create operation was inconsistent. If a key has multiple segments, the duplicate, modifiable, and null attributes should be the same for each segment in the key. *E *B 646,Access to File Denied (46) Access to File Denied ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The application attempted to make a change to a file that was opened in read-only mode. Or the owner name was not specified correctly and it is needed for file updates. *E *B 647,Maximum Open Files (47) Maximum Open Files ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The number of files opened in accelerated mode exceeded the number of buffers available in ^Btrieve^'s cache. *E *B 648,Invalid Alternate Sequence Definition (48) Invalid Alternate Sequence Definition ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ When defining a alternate collating sequence for a file, the first byte of the definition must be the hexadecimal character 'AC'. This character is the identification byte that makes sure you wanted to define an alternate collating sequence. *E *B 649,Key Type Error (49) Key Type Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The application tried to create a file or a supplemental index with an invalid extended key type, or tried to assign an alternate collating sequence to a binary key or key segment. *E *B 650,Owner Already Set (50) Owner Already Set ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The application tried to assign an owner to a file that already has an owner. *E *B 651,Invalid Owner (51) Invalid Owner ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The correct owner name was not specified for a ^Btrieve^ open or the owner name was not stored in both the key buffer and data buffer during a ^Set Owner^ operation. *E *B 652,Error Writing Cache (52) Error Writing Cache ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ You may want to check your server based ^Btrieve^. It may have crashed. ^Help Wanted^ *E *B 653,Invalid Interface (53) Invalid Interface ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The ^Btrieve^ interface used by this application cannot access variable length records. *E *B 654,Variable Page Error (54) Variable Page Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ During a Step Direct operation, ^Btrieve^ could not read the variable length portion of a record. This indicates the file may have become damaged. You may have to rebuild the file. *E *B 655,Autoincrement Error (55) Autoincrement Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This error occurs during the creation of a ^Btrieve^ file. An Auto-increment key cannot have the duplicate key flags set, it cannot be part of a key that is segmented, and it cannot overlap another key. *E *B 656,Incomplete Index (56) Incomplete Index ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The supplemental index was damaged. This occurs if a create supplemental index or drop supplemental index does not complete. Drop the index to correct the problem. *E *B 657,Expansion Memory Error (57) Expansion Memory Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ^Btrieve^ received an error from the expanded memory manager. *E *B 658,Compression Buffer Too Short (58) Compression Buffer Too Short ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The application tried to read or write a record that is longer than the value specified for the size of the compression buffer. *E *B 659,File Already Exists (59) File Already Exists ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This status code is returned for the ^Create^ operation if you specified -1 in the key number and the file already exists. *E *B 660,Reject Count Reached (60) Reject Count Reached ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ^Btrieve^ rejected the number of records specified by the reject count before an extended Get/Step operation could find the requested number of records that satisfy the filter condition. *E *B 661,Work Space Too Small (61) Work Space Too Small ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The space allocated to the pre-image buffer was not large enough during an extended Get/Step operation. *E *B 662,Incorrect Descriptor (62) Incorrect Descriptor ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The data buffer structure for an extended Get/Step operation was incorrect. *E *B 663,Invalid Extended Insert Buffer (63) Invalid Extended Insert Buffer ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The data buffer structure for an extended insert operation was invalid. The buffer length was less than five bytes, or the number of records specified was zero. *E *B 664,Filter Limit Reached (64) Filter Limit Reached ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ A rejected record was reached during a extended Get/Step operation and no other records satisfy the filter conditions. *E *B 665,Incorrect Field Offset (65) Incorrect Field Offset ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The field offset in the extractor of an extended Get/Step operation is invalid based on the length of the retrieved record. *E *B 666,??? (66) ??? ÄÄÄÄÄÄÄÄ ^Help Wanted^ *E *B 667,??? (67) ??? ÄÄÄÄÄÄÄÄ ^Help Wanted^ *E *B 668,?? (68) ??? ÄÄÄÄÄÄÄÄ ^Help Wanted^ *E *B 669,?? (69) ??? ÄÄÄÄÄÄÄÄ ^Help Wanted^ *E *B 670,?? (70) ??? ÄÄÄÄÄÄÄÄ ^Help Wanted^ *E *B 671,?? (71) ??? ÄÄÄÄÄÄÄÄ ^Help Wanted^ *E *B 672,?? (72) ??? ÄÄÄÄÄÄÄÄ ^Help Wanted^ *E *B 673,?? (73) ??? ÄÄÄÄÄÄÄÄ ^Help Wanted^ *E *B 674,Automatic Transaction Abort (74) Automatic Transaction Abort ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This error occurs when an ^End Transaction^ function is internally changed to an ^Abort Transaction^ due to a previous error within a transaction. *E *B 675,?? (75) ??? ÄÄÄÄÄÄÄÄ ^Help Wanted^ *E *B 676,?? (76) ??? ÄÄÄÄÄÄÄÄ ^Help Wanted^ *E *B 677,?? (77) ??? ÄÄÄÄÄÄÄÄ ^Help Wanted^ *E *B 678,Deadlock Detected (78) Deadlock Detected ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ^Help Wanted^ *E *B 679,?? (79) ??? ÄÄÄÄÄÄÄÄ ^Help Wanted^ *E *B 680,Conflict (80) Conflict ÄÄÄÄÄÄÄÄÄÄÄÄÄ This error can be caused when you do an ^INSERT^, which fails because of a ^duplicate key value^ error, followed by a ^DELETE^ of the same record. This could also occur when a record is changed by another station before an ^INSERT^ or ^DELETE^ of the record completed. *E *B 681,Lock Error (81) Lock Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The ^Btrieve^ lock table could be full. *E *B 682,Lost Position (82) Lost Position ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The record you were trying to retrieve was deleted or the key value was changed by another application. If you are trying to retrieve the data for a key that has a null value in the key field specified, then specify -1 in the key number and you will be able to retrieve the record with a ^Get Direct^ call. *E *B 683,Read Outside Transaction (83) Read Outside Transaction ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The record that you are trying to ^Update^ or ^Delete^ was read before the ^Begin Transaction^. If you want to change this record, do a ^Get Position^ and then a ^Get Direct^ to re-get the record within the transaction. *E *B 684,Record Locked (84) Record Locked ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The record is in use. *E *B 685,File Locked (85) File Locked ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The ^Btrieve^ file could be locked if another version of ^Btrieve^ is accessing the file. This error would occur when ^Btrieve^/N has the file open and the NLM or VAP ^Btrieve^ attempts to open the same file. Try using a wait operation code for the operation by adding 100 or 300 to the operation code. This status also is returned when two or more stations are accessing the first page of a ^Btrieve^ file. *E *B 686,File Table Full (86) File Table Full ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ^Btrieve^'s file table is full. *E *B 687,Handle Table Full (87) Handle Table Full ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ^Btrieve^ could not assign a handle for a file. Increase the FILES=XX parameter in the CONFIG.SYS file. Or reconfigure ^Btrieve^ and specify a higher value for the "Maximum Number of Open Files" option. *E *B 688,Incompatable Mode Error (88) Incompatible Mode Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ An attempt was make to ^open^ a file in a mode that is not compatible with the mode that other stations used to ^open^ the file. *E *B 689,Net Share (89) Net Share ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Name(s) not specified.??? ^Help Wanted^ *E *B 690,Redirected Device Table Full (90) Redirected Device Table Full ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The redirected table is full. Increase the /R option for Bredir. *E *B 691,Server Error (91) Server Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Bredir could not establish a session with the server. Either you have not started Bserver for the device or there are no Btrieve files open on the device. Also, could be cause by the workstation not being able to communicate with NLM btrieve via the NetWare SQL engine. *E *B 692,Transaction Table Full (92) Transaction Table Full ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ You have exceeded the number of active transactions specified for Bserver. Increase the /T option for Bserver. *E *B 693,Incompatible Lock Type (93) Incompatible Lock Type ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ^Help Wanted^ *E *B 694,Permission Error (94) Permission Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This error could be caused by running two different versions of ^Btrieve^ at the same same and accessing the same file. If NLM btrieve has a file open, it locks it from other applications opening it. NLM will treat BTRIEVE/N as another application and prevent BTRIEVE/N from opening the file. *E *B 695,Session No Longer Valid (95) Session No Longer Valid ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This error generally indicates a hardware problem. It could be a problem with the network board or the cabling. *E *B 696,Communications Environment Error (96) Communications Environment Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The SPX connection table is full on a Netware server. Reload SPX and increase the connection table value. *E *B 697,Data Message Too Small (97) Data Message Too Small ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The application tried to read or write a record which was larger than BTRIEVE.EXE or BREQUEST.EXE could handle. Specify a larger value for the maximum record length option. *E *B 698,Internal Transaction Error (98) Internal Transaction Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ An error was detected while executing a operation on a Netware TTS file. ^Abort Transaction^ is the only valid operation after this. *E *B 699,Demo Restriction Error (99) Demo Restriction Error ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ You tried to add more than 24 records to a file using the demo version of Btrieve. *E *B 800,String Key Type (0) String Key Type ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This type is a sequence of characters sorted from left to right, byte for byte, for the length of the key segment. Each character is in ^ASCII^ format with one character in each byte. This key type can be up to 255 characters in length. *E *B 801,Integer Key Type (1) Integer Key Type ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This type is a signed whole number. This key type can be up to 254 bytes in length and must be an even number in length. This type is stored a word at a time in high byte low byte order. *E *B 802,Float Key Type (2) Float Key Type ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This type is stored in the IEEE standard for single precision real numbers. The length is either 4 or 8 bytes. *E *B 803,Date Key Type (3) Date Key Type ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This key is 4 bytes in size. The day is the first byte, the month is the second byte, and the year is stored in the last 2 bytes. The Year is a binary number that represents the entire year value. It is NOT an offset from a certain date. *E *B 804,Time Key Type (4) Time Key Type ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This key is stored as 4 bytes. The hundredths of a second goes in the first byte. The seconds go in the second byte. The minutes go in the third byte and the hour goes in the fourth byte. *E *B 805,Decimal Key Type (5) Decimal Key Type ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This type can be up to 255 characters in length. Two decimals are store in each byte. Each nibble of a byte contains a decimal digit. The sign byte of each decimal number is either F or C for positive numbers or D for negative numbers. byte: 0 1 byte n - 1 _____|_____ _____ | | | | | | | | |__|__|__|__| |__|__| digit: 1 2 |3 4 digit sign 2n -1 byte *E *B 806,Money Key Type (6) Money Key Type ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The money key type is stored the same as the ^Decimal Key Type^. It is preceded by an implied $ with two digits to the right of an implied decimal point. *E *B 807,Logical Key Type (7) Logical Key Type ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The logical key type is either 1 or 2 bytes in length. This type is sorted the same as the ^String Key Type^. *E *B 808,Numeric Key Type (8) Numeric Key Type ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This key type can be up to 255 characters in length. This key is stored as ^ASCII^ strings, right justified with leading zeroes. Each digit is stored in a single byte. The right-most digit contains the embedded sign. This key is for data stored in EBCDIC format. *P DIGIT POSITIVE NEGATIVE -------------------------------- 1 A J 2 B K 3 C L 4 D M 5 E N 6 F O 7 G P 8 H Q 9 I R 0 { } *E *B 809,Bfloat Key Type (9) Bfloat Key Type ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This key is a real number that is 4 bytes in size or a double precision real number that is 8 bytes in size. *E *B 810,Lstring Key Type (10) Lstring Key Type ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The Lstring key type can be up to 255 bytes in size. It is stored the same a ^String Key Type^ except the first byte of the string contains the length of the string. When ^Btrieve^ sorts the string, any characters beyond the length of the string are ignored. *E *B 811,Zstring Key Type (11) Zstring Key Type ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This key type is treated the same a ^String Key Type^ except that it is terminated by a 0. ^Btrieve^ ignores any characters beyond the 0 in the key segment. *E *B 812,Unknown12 Key Type (12) Unknown12 Key Type ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ *E *B 813,Unknown13 Key Type (13) Unknown13 Key Type ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ *E *B 814,Unsigned Binary Key Type (14) Unsigned Binary Key Type ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This key can be up to 254 characters in length and it must be an even number of bytes. This key type is sorted from right to left a word at a time. Each word is stored as an unsigned integer. *E *B 815,Autoincrement Key Type (15) Autoincrement Key Type ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This key is an integer that can be 2 or 4 bytes in size. Autoincrement keys are incremented each time you insert a record into the file. This key type does not allow duplicate values, it cannot be part of a key that is segmented, or it cannot overlap another key. The first record inserted into the file is given a value of 1 as the autoincrement key value. The autoincrement keys are incremented each time a new record is inserted into a file if you specify 0 as the value in the record. If you specify another number, ^Btrieve^ will try to use that number. If it is a duplicate number, ^Btrieve^ will return ^Duplicate Key Value^, and not insert the record. *P When inserting a record with an autoincrement field set to 0, the value that ^Btrieve^ assigns to this field is returned in the key buffer. *E Missing Numbers 6 9 20 22 81 83 84 86 87