BatMan Documentation


Table of Contents

Shareware Registration

Installing the Files

Configuring Your Browser
  •    Netscape
  •    Spry (CompuServe)
  •    InterAp Web Navigator
  •    Other Browsers and Navigators

    Introduction

    BATMAN is a helper or viewer application for use with Mosaic, Netscape, InterAp, and other WWW browsers. BATMAN is used to to execute a DOS BAT file in a DOS window by selecting a link with a URL containing the BAT file.

    For example, the following statement:

    <A HREF=file:///c:/batman/sample.bat>Click here to run the example</A>
    
    will create a link in a document that can be selected to run the sample.bat program.

    What can BatMan be used for?

    MagicKey is a DOS popup utility which is used to gather URLs from terminal sessions, or while reading mail and news offline under DOS. The utility MK2HTML is used to convert the MagicKey data into browsable HTML. Clicking on the "UPDATE" link on my local home page runs the conversion utility. Then, I can click on the link to MAGIC.HTM knowing that the data I see will be up to date.

    If MAGIC.HTM has already been loaded earlier in the same session, it is necessary to reload the page with the RELOAD button. Further information about MagicKey is available from JCI Shareware.

    What else?

    The access report from our WWW server arrives in text format. I have a custom utility program that scans the report and generates summary information of use to me. Thanks to BATMAN, I can download the raw report with an ftp URL, run the analysis program with a single click, and read the resulting output with one more click.

    More?

    You can run the Register utility directly from this document. What could be more useful than that?


    Obtaining the Latest Version

    The latest version of BatMan can be obtained directly from our WWW site

    Installation

    The following files must be in the same directory when BatMan is run. For the purposes of this documentation and the demo, it is assumed that the files are in c:\BATMAN.

    Other files included in this package are:

    If you have placed the files in a different directory, you may want to create a directory named BATMAN on your c: drive now, and copy the files to that directory in order to run the demo programs in this documentation.


    BatMan Configuration

    The BATMAN.INI file contains the configuration options for BATMAN. BATMAN.INI must be in the same directory as BATMAN.EXE. You may have multiple copies of BATMAN.EXE and BATMAN.INI in different directories with different parameters.

    To configure BatMan, type BATMAN at the DOS prompt. If a BATMAN.INI file is found, the defaults will be read from the file. If not, the file will be created.

    Password=
    

    BatMan runs BAT programs on your computer which may originate locally, or which may have come from an unknown site, we have built password protection into the BAT files that you create. Enter any password that you wish to use at this prompt. The password is case sensitive. The sample program uses password=demo.

    The BAT file must contain a line in the form:

    :Password=demo
    

    The password itself is case sensitive, but the :Password flag is not. Lines beginning with : are ignored by DOS. If the BAT file does not contain the correct password, you will be warned and given the opportunity to abort the program.

    If you omit the password parameter in the INI file, no password will be necessary in the BAT files.

    Warn1=DEL
    
    There are ten optional warning words. These can be any commands or filenames that you wish to be warned about if the BAT file is about to use them. You may omit these if you are running your own BAT files, and you know what you are doing.

    When BATMAN encounters one of these commands in a file, you will be alerted to its presence and given the opportunity of aborting the BAT file or running it. If you abort, no instructions will be executed.


    Setting up your browser to use BatMan

    Netscape 1.2

    1. Select Preferences... from the Options menu.
    2. Select Helper Applications.
    3. Select New Type.
    4. Fill in the MIME type as: application
    5. Fill in the MIME Sub Type as: x-dos-bat
    6. Fill in the Extension as: bat
    7. Select Launch Application as the action to perform.
    8. Fill in the Helper application as: c:\BATMAN\BATMAN.EXE (or browse to it).
    9. Select OK to close the Preferences window and save the new information.

    Spry Mosaic (CompuServe)

    1. Select the Options/Configuration menu item. ( Alt-O C )
    2. Select the Viewers... Button ( Alt-V )
    3. Select Add New Type ( Alt-A )
    4. New Document Type: application/x-dos-bat and press OK
    5. Fill in Extensions: .bat,.BAT (the . is necessary!)
    6. Fill in Viewer: c:\BATMAN\BATMAN.EXE (or use the Browse button)
    7. Select the Close button. ( Alt-C)
    8. Select OK

    InterAp Web Navigator

    1. Select Options from the Configure menu. (Alt C O )
    2. Select the Associations folder tab.
    3. Enter BAT in the File with extension: box.
    4. Enter c:\BATMAN\BATMAN.EXE in the Associate With: box.
    5. Select the Add button to add the association to the list.
    6. Select OK to close the Associations window.

    Other Browsers and Navigators

    Your browser must be configured to assign BATMAN.EXE as a Helper Application, or Viewer Application for files ending in the extension .BAT or .bat.

    All browsers should have this capability. Look at the other applications that are already assigned to get a feel for how your browser wants the configuration entered. Most browsers are not case sensitive, but Spry is. Most browsers do not require the dot with the extension, but Spry does. If your browser is case sensitive, you should be able to list both bat and BAT. Usually, this is done by separating them with a comma and with no spaces on the line.

    In some cases, you may have to edit the INI file associated with your browser. In that case, take care not to accidentally make any other changes, and always make a backup first so you can revert to the original.

    NOTE. Some browsers may require you to exit and restart in order to reconfigure the program with the new helper application.

    Please send us the steps you use for your favorite browser so that we can add it to this documentation.


    BatMan Demonstration

    This is an example of an html document that uses the BATMAN helper application to execute a DOS batch program. The file SAMPLE.BAT contains the following commands:

    
    :Password=demo
    MEM
    PAUSE
    
    

    The :Password line is not executed by DOS, but is checked by BatMan to insure that you know who created this BAT file.

    MEM is a DOS command which shows the amount of memory available.

    PAUSE is a DOS command which allows you to read the screen before the window is closed.

    Press here to run SAMPLE.BAT


    MagicKey Users

    If you are a MagicKey user, you may use BatMan to run the MK2HTML utility which creates an html document from your MagicKey data files. This example assumes that you have just unzipped version 1.20 of MagicKey and have the following files in your c:\MAGIC directory:

    c:\MAGIC\M2H.BAT        The BAT program that BatMan will run.
    c:\MAGIC\SAMPLE.DAT     The MagicKey sample data that came with MagicKey.
    c:\MAGIC\MK2HTML.EXE    The conversion utility.
    

    Update SAMPLE This link will update the SAMPLE.HTM file from the SAMPLE.DAT data.

    View output from the conversion. Remember, you must reload this file if it has been previously loaded to see the latest version of the data.


    Registration

    BatMan is shareware. It is provided to you for a limited time in order for you to decide whether it will be of use to you and to ensure compatibility with other programs on your system. If you wish to use BatMan beyond the 30 day trial period, you must register the program with Jennings Communications, Inc.

    Registration costs only $10.00 (US currency) and may be done by email.

    The DOS program REGISTER.EXE will guide you through a simple form to capture your credit card information. The captured information will be encrypted into a short ascii file that can be inserted into an email message for transmission to us.

    If you are ready to register BatMan, read the

    Fine Print

    The unregistered shareware version of BatMan may be distributed on CD-Rom and diskette, or uploaded to bulletin boards and ftp sites provided that all files in this archive are included in their original unaltered form and that no charge is made for the program beyond a reasonable charge for duplication and distribution.

    BatMan is provided "as is" WITHOUT WARRANTY OF ANY KIND, either express or implied, including, but not limited to the implied warranties of merchantability and fitness for a particular purpose.

    Jennings Communications does not warrant that the program or its functions will meet your requirements or that the operation of the program will be error free. The entire risk as to the use, quality and performance of the program is with you.

    LIMITATION OF LIABILITY: In no event will Jennings Communications or its agents be liable for any damages whatsoever, including loss of data, lost profits, or other pecuniary loss arising out of the use of or inability to use this product, even if Jennings Communications has been advised of the possibility of such damage.

    Registration Information


    BatMan
    © Copyright 1995 Jennings Communications, Inc..
    P O Box 336, Ben Lomond, CA 95005 USA