The ‘Rescue’ tab illustrated above is the most complex tab in the toolkit – we here at Virtual Machinery hope that you will never have to use it since the only reason would be that one of your datasets has been very badly messed up! But data in files can be corrupted and nobody likes to lose data – this utility should allow you to maximise the amount of valuable data that you can retrieve from a corrupt BTree file.
In practice all of your data is held in the data (‘.dat’) file of the dataset. A corrupt index (.ind’) file can be rebuilt from any dataset using the compress/fix utility. In this case we are trying to deal with a situation where the data page file has been damaged therefore the first thing we need is the name of your ‘.dat’ file. Since the initial data at the beginning of your file may be corrupt we also ask for the page size of the file. If you know this well and good – if you don’t you may be able to find it by examing the file using a disk editor and the format of the data file (see the original BTree documentation). At the very worst you may have to guess it and keep running the ‘Rescue’ utility until you get a reasonable result.
You also need to provide the paths for three other vital files that the rescue process will require -
The last thing that you need to provide is the name of the new data set and the sizes of its index and data pages. This dataset will be filled with the recovered data from the process. Note that you just need to provide the path and the base file name – do not append .dat or .ind. If , for example, you enter NEWFILE then a new dataset consisting of the files NEWFILE.DAT and NEWFILE.IND will be created in the path that you have specified or in the current working directory if no path has been specified. A number of rules govern the index and data page sizes – in summary these are –
Index Page size
Data Page size
When you start the process by pressing the ‘Rescue’ button the progress of the process will be displayed on the Progress Bar and in the Status Pane. The sequence of events will then be as follows –
If there were any errors you should look in the log and dump files to see what data may have been lost and to try to retrieve it manually if necessary.
Your new dataset is now ready for use although you may wish to compress it using the ‘Compress’ utility.