peppermint fence

BDM Revival Help

Table of Contents

Overview

Don't throw away those old DOS based CD-ROM indexes. With BDM Revival you will be able to run them again in Windows Vista, 7, and 8 (including 64 bit). Not only that, you will be able to export data into BDM Data Viewer...

System Requirements: any Windows XP, Vista, 7 or 8 (32 or 64 bit) PC

With direct support for the following indexes (more to come):

Features


How it works!

BDM Revival works by creating a 'virtual PC' within your real PC. This virtual PC has a hard drive (C:) and a CD-ROM (D:), just like most computers has in the 80s and 90s

To run once of those old DOS applications, BDM Revival needs to create a virtual PC which has a C: drive and optionally a D: drive (i.e. the CD) - these virtual C and D drives actually are just folders on your real PC. Somewhere like:

C:\Users\xxxx\Documents\BDM Revival\PC

The virtual C drive is C:\Users\xxxx\Documents\BDM Revival\PC\HD

The virtual D is less simple: C:\Users\xxxx\Documents\BDM Revival\CDs contains virtual CD images and when BDM Revival starts, one of these CD images will be selected as the D: drive

So, just like a real DOS PC, you have one C: drive where all your programmes are installed to, and changeable CDs. To install a DOS application, you virtually insert its CD-ROM, find the setup programme, run it and then start the application by running the appropriate commands - often this was printed on instructions, and usually involved typing DOS commands to change the current directory and then to run the programme.

BDM Revival simplifies this by allowing you to create 'apps' - these are really just shortcuts with the commands needed to start the DOS programme. Even better, for a bunch of Digger and KAWare DOS indexes, all you need to do is tell BDM Revival where the original index is, and it will do the rest.

Getting Started

IMPORTANT: if you see any errors related to MSVCP100.DLL, please install the following from Microsoft: vcredist_x86

Once you have purchased BDM Revival you should recieve an email containing a link to download it. Once downloaded, run SetupBDMRevival.exe and follow the instructions.

When BDM Revival starts for the first time, you will not have any 'installed' applications to run. Please get your CD-ROM indexes ready and click the Revival PC Manager button on the toolbar:

If you have one of the supported apps, click the Install Supported App button and select an app to install. For example, let's say you have the Digger Edwardian index:

Now select the CD where this index is, or if you already have copied it to your hard drive, locate and select that folder - don't select a file, just the CD or folder where the index app is.

What BDM Revival will do next is create a 'virtual CD' either by pointing to the folder you just selected, or by copying the entire contents to a special BDM Revival folder. The former method is much faster because BDM Revival does not have to copy files. You should use this option if you already have copied the files, or if you are setting up a network installation of BDM Revival.

Please don't check the 'Link to path' option if your index is on CD-ROM, otherwise you will have to remember to insert the CD each time you run the app.

BDM Revival will now start a DOS window and automatically run the appropriate installer for your app. Just follow the on screen instructions but do not change any of the settings on any of the installation screens, including the display and printer settings - printing is not supported at this stage'.

That's it, the Digger EDWARDIAN INDEX. VICTORIA 1902-1913 is now installed and ready to use!

The BDM Revival App Manager should now look something like this:

The top half of the window shows the installed apps. You can right click to edit, duplicate, delete or run them. The bottom half of the window shows the files of your 'virtual PC'

As you can see, BDM Revival has created a 'virtual cd', in this case it is linked to a folder on the hard drive, and install the actual DOS application on the 'virtual hard drive'

If you had a DOS window open, you should be able to run the VICEDW.BAT file to start the app. From time to time, however, you might need to edit a file to fool the orginal application into running of a hard drive folder, as opposed to a real CD.

In fact, one of the features of the BDM Revival supported installers is that these file edits are done automatically. See the 'ALERT!' button on the top right hand corner? Click it now. You should see:

BDM Revival keeps a look out for CDP files - these are Digger files that tell the Digger application where to find the CD rom. In this case the BDM Revival installer has already fixed it

Let's try creating a custom app

Click the Create Custom App button:

In this example we will install the VIC Great War index (even though there is an installer for this):

After giving the app a name and description, we will have to create a virtual cd for it. In this example the index happens to already be on the hard drive at C:\data\Vic_gw, and we will link to it to save time:

Click Create CD - when this window closes, you should notice the the virtual cd you just created is selected for you. At this point, you can click the Run button. BDM Revival will start a DOS window with the D:\ drive being the virtual CD containing the VIC Great War index. Try it now. Click run and then enter the DOS commands as follows:

Now follow this original DOS application installer screen - but don't change any of the settings!

NB: every installer is different - some had installer.exe, some dossetup.exe, and some others were completely different - just type dir as above and see what is there!

When it finishes, you will see the good old DOS prompt. In this example, you can try and start the app as follows:

Oops, it does not start:

This is because Digger apps expect to get their data from a real CD-ROM. In this case, it checks the file (on the virtual hard drive) C:\VICGW.CD\VICGW.CDP for the location of the CD - this file needs to be edited. In fact, if you ran these Digger indexes from your hard drive back in the 90s, you would have had to deal with this problem.

Luckily, even if you are not using one of the supported installers, BDM Revival will detect these pesky files and try to fix them for you. Notice the ALERT! button is back in the bottom left corner of the Editing window? First close the Digger DOS app window, and then click the ALERT! button. BDM Revival has attempted to fix the file for you:

Click the Save button (the ALERT! button comes back, but only because the act of saving the file trigger it - but, if you click the Alert button again, you'll notice now BDM Revival says it seems to have been fixed - use the 'Don't ask me again' check box on the message box that pops up to ignore these prompts in the future.

Now click Run again and tpye VICGW.BAT and press enter. The index should now start (in this example, the password is 'digger') - try it now.

But we're not done yet! Where are we? We have just created a virtual CD and manually ran the Digger installer. Now we have to finish creating the BDM Revial app (remember this is really just a shortcut to a real DOS application)

So in the start commands window, type the following:

Click Run to try it..once you are happy, check the app name, description and categoty and click OK to save your app. That's all there is to it!

Creating shortcuts

In the App Manager, right click on an app and select Create Desktop Shorcut

Now you should see a BDM Revival shortcut on the desktop, and this will start your DOS application directly without showing the list of applications

NB: if you re-install the DOS application, the shortcut will nolonger work...

Videos

Basic DOS Commands

Command Description
DIR Directory View.
CHDIR Displays/changes the current directory.
ATTRIB Does nothing. Provided for compatibility.
CALL Start a batch file from within another batch file.
CD Displays/changes the current directory.
CHOICE Waits for a keypress and sets ERRORLEVEL.
CLS Clear screen.
COPY Copy files.
DEL Removes one or more files.
DELETE Removes one or more files.
ERASE Removes one or more files.
ECHO Display messages and enable/disable command echoing.
EXIT Exit from the shell.
GOTO Jump to a labeled line in a batch script.
HELP Show help.
IF Performs conditional processing in batch programs.
LOADHIGHLoads a program into upper memory (requires xms=true,umb=true).
LH Loads a program into upper memory (requires xms=true,umb=true).
MKDIR Make Directory.
MD Make Directory.
PATH Provided for compatibility.
PAUSE Waits for 1 keystroke to continue.
RMDIR Remove Directory.
RD Remove Directory.
REM Add comments in a batch file.
RENAME Renames one or more files.
REN Renames one or more files.
SET Change environment variables.
SHIFT Leftshift commandline parameters in a batch script.
SUBST Assign an internal directory to a drive.
TYPE Display the contents of a text-file.
VER View and set the reported DOS version.

Various Notes

Run DOS menu - use this to start a DOS window with (optionally) a virtual CD:

DOS Windows - shows the currently running DOS applications:

Settings:

In the BDM Revival Options window, you can change the application theme, reset 'don't ask me again' prompts, and various BDM Revival specific settings:

Don't ask me again!! Many message boxes will have an option to set so that you won't be bothered again, for example:

NB: You might also need this: vcredist_x86 - if you get errors regarding MSVCP100.DLL

NB: .NET Framework 4 - you *might* need this, depending on how old your computer is (free)

Library Version - setup notes

This section applies to the BDM Revival Library version

Please carefully read the following instructions:

  1. Install BDM Revial Library Version by running SetupBDMRevivalAdmin.exe on your library admin computer (not the public computers)
  2. Using the App Manager, install your DOS applications (see above for how to do this)
  3. It is highly recommended that you DO NOT LINK to existing paths as these paths may not be available from the client computer:

    Also, it is impossible to know if your DOS applications will be able to share files.
  4. Keep in mind that the public will be the end user of the application, so take time to set the various options for each application (e.g. turbo mode)
  5. Also turn off the 'don't ask/show me again" message boxes as these settings will be copied to the client computer as you go.
  6. Once you have installed all your applications on the admin computer, you are now ready to create a 'client installer pack'
  7. You will use this 'client installer pack' to install BDM Revival on each of your public computers. It is easy: from the App Manager select 'Create Client Pack' from the 'Advanced' menu:
  8. Click past the prompts and select a folder for the pack - it is highly recommend that you choose a large USB device which you can carry about to the public computers, or a network location that is available to each public computer.
    Once this is complete (it could take a while if you have a lot of applications) your client pack should look like:
  9. NB: if you do have linked virtual CDs, then you will need to manually ensure each public computer has access to these paths (again, NOT linking is better)
  10. The pack contains the prompt and general settings files, as well as the virtual HD and virtual CDs. It also has the client setup programme (SetupBDMRevivalClient.exe)
  11. Now, to install BDM Revival onto your public computers, simply take the USB key around to each computer (or if your pack was put onto a network drive, connect to it from each computer) and run SetupBDMRevivalClient.exe.
    This will install BDM Revival - IMPORTANT - on the last step of the installer, make sure you live the 'Start BDM Revival and install from client pack' checked:

  12. This will cause BDM Revival to automatically install the client pack once it starts.
  13. Now your BDM Revival public client version is ready - but do test it first.
    You should notice that the public client version does NOT have access to the App Manager or settings - this is by design!
  14. Also, did you notice the shortcuts folder? This is packed with shortcuts that allow the DOS applications to be started directly without showing the BDM Revival application list. You can also copy these to your public client computer if that is your preference.

Links

EZITREE | CoraWeb