home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / b / burn_in.zip / BURNIN.DOC < prev    next >
Text File  |  1990-08-27  |  51KB  |  1,062 lines

  1.                              Burnin 4.2
  2.        
  3.            The Premium PC Exerciser and Diagnostic Tool
  4.        
  5.                                From:
  6.        
  7.                          George Campbell
  8.                           1472 Sixth St.
  9.                            Los Osos, CA
  10.                  SUPPORT BBS:  (805) 528-3753
  11.        
  12.        INTRODUCTION
  13.        ============
  14.        
  15.        Most of the time our PCs work flawlessly, performing the
  16.        varied tasks we ask of them without a hitch. That's not
  17.        always the case, however.
  18.        
  19.        To protect us from the possibility of hardware failure,
  20.        every manufacturer of IBM-compatible computers offers a
  21.        warranty. Lengths vary from 90 days to a year or more. Like
  22.        most warranties, problems tend to occur two days after the
  23.        warranty expires. How do you protect yourself?
  24.        
  25.        In the case of PCs, the answer is BurnIn. BurnIn is designed
  26.        to do just one thing: give your PC and all its systems a
  27.        tough workout. Here's the idea: If your PC has a hidden
  28.        problem, you'd rather discover it before the warranty runs
  29.        out. Running BurnIn for 24-72 hours is like using it nonstop
  30.        for weeks. If there's a latent problem, it's sure to show up
  31.        while BurnIn runs. If not, then your PC gets a clean bill of
  32.        health and you can rest easy.
  33.        
  34.        Here's what I recommend:
  35.        
  36.        * Run BurnIn for 72 hours when you first buy your PC.
  37.        That'll spot any problems before you commit your valuable
  38.        data permanently.
  39.        
  40.        * Run BurnIn for 72 hours about a week or so before your
  41.        warranty expires. That way, if there's a problem about to
  42.        happen, it will happen before the expiration, allowing you
  43.        to get it fixed.
  44.        
  45.        * Run BurnIn for 24 hours each time you add new hardware to
  46.        your system, then again before the warranty on the new
  47.        upgrades expire.
  48.        
  49.        * Run BurnIn whenever you suspect an intermittent problem is
  50.        developing in your system. The BURNIN.LOG file will pinpoint
  51.        the source of the problem.
  52.        
  53.        Special Note for System Houses and Clone Builders:
  54.        ==================================================
  55.        
  56.        Run BurnIn on every new system before it's sold. A 48 hour
  57.        run is probably adequate. BurnIn, unlike most other burn-in
  58.        techniques, gives your computers a REAL workout, preventing
  59.        comebacks and expensive warranty repairs.
  60.        
  61.        IMPORTANT!!
  62.        ===========
  63.        
  64.        BurnIn cannot damage your computer! It uses normal DOS and
  65.        BIOS routines in all its tests -- no tricks! It makes your
  66.        computer work hard , but can't harm it. If BurnIn causes
  67.        your system to fail, then it's just doing its job, forcing a
  68.        failure which would have happened soon.
  69.        
  70.        
  71.        SYSTEM REQUIREMENTS
  72.        ===================
  73.        
  74.        BurnIn will run on any IBM-compatible computer with 256K of
  75.        RAM. It adjusts itself to all display adapters. BurnIn
  76.        senses the availability of a mouse and uses it if it's
  77.        there. BurnIn requires DOS version 3.0 or later.
  78.        
  79.        NOTE: BurnIn DOES NOT run on Tandy 1000 HX computers or any
  80.        other Tandy computer with MS-DOS in ROM! To use BurnIn with
  81.        these computers, you must boot with DOS 3.0 or later from a
  82.        floppy disk in drive A:.
  83.        
  84.        
  85.        WHAT BURNIN DOES
  86.        ================
  87.        
  88.        When you run BurnIn, you can run tests on one system or all
  89.        systems in a PC, either continuously or on a one-time or for
  90.        a length of time you specify. You select the tests to run,
  91.        or you can run them all sequentially.
  92.        
  93.        BurnIn tests include:
  94.        
  95.        * CPU Test -- This test computes a difficult calculation
  96.        thousands of times, incrementing the calculation as it goes.
  97.        The results of the calculation appear in columns on the
  98.        screen. Double-precision numbers are used. If a math co-
  99.        processor is installed, it is automatically used in the
  100.        calculation.
  101.        
  102.        * Drive Test -- You specify the drives to be tested. BurnIn
  103.        writes, then reads, a 32K text file on each drive specified.
  104.        When the test is finished, the files are deleted
  105.        automatically.
  106.        
  107.        * Text Monitor Test -- This test exercises the monitor and
  108.        display adapter by writing a continuous string of
  109.        characters. Color monitors display the basic 15 colors.
  110.        Following this, a series of boxes appears on the screen.
  111.        
  112.        * Graphics Test -- This routine runs through a series of
  113.        graphics tests, exercising both the monitor, display
  114.        adapter, and system BIOS. BurnIn automatically senses the
  115.        display adapter installed in the PC and adjusts itself.
  116.  
  117.        * Memory Test -- This test finds all free system memory 
  118.        and does a write/read test on it. If there is an error on 
  119.        this test, it's likely that the system will crash. Parity
  120.        errors especially cause a hard system crash. Use a memory
  121.        diagnostic utility to pinpoint the location.
  122.        
  123.        *  Printer Test -- This routine, which is turned off by
  124.        default, prints a page of random ASCII characters, then
  125.        ejects that page. In most cases, you'll want to run this
  126.        test alone. The printer must be attached to LPT1:.
  127.        
  128.        BurnIn maintains a log file which records the starting time,
  129.        ending time, and elapsed time for each test. If errors occur
  130.        during a test, this information is logged as well. This
  131.        information is stored in the file, BURNIN.LOG. The log file
  132.        may be read while in the program. On completion of tests, a
  133.        box will appear, telling you whether any errors occurred.
  134.        
  135.        A special file, readable from within the program, offers
  136.        explanations of any error messages written to the BURNIN.LOG
  137.        file.
  138.        
  139.        INSTALLATION
  140.        ============
  141.        
  142.        Installing BurnIn is easy. Simply copy all the files on the
  143.        BurnIn disk to a directory on your hard disk or to a blank,
  144.        formatted floppy disk. BurnIn files include:
  145.        
  146.        BURNIN.EXE -- The BurnIn program itself.
  147.        BIDOCS.COM -- This manual. You can read it from inside
  148.        BurnIn or from DOS.
  149.        README.COM -- Basic information on BurnIn. (Self-browsing)
  150.        BURNIN.ERR -- Help file for error messages.
  151.        MCOLOR.DAT* -- Configuration file...stores screen colors.
  152.        ????????.RUN* -- Configuration files .. store BurnIn
  153.        configuration settings.
  154.        BURNIN.LOG* -- Stores information on tests run by BurnIn.
  155.        
  156.        * Files created by the program.
  157.        
  158.        RUNNING BURNIN
  159.        ==============
  160.        
  161.        BurnIn is designed to be exceptionally easy to use. Through
  162.        the use of the Interface Plus system, it offers full mouse
  163.        support, drop down menus, and anticipates your next command
  164.        over 90% of the time. Interface Plus is a program shell for
  165.        QuickBASIC 4.5, developed by this author. If you are a
  166.        QuickBASIC programmer, please see the notes on Interface
  167.        Plus at the end of this document.
  168.        
  169.        Run BurnIn by changing to the directory containing the
  170.        BurnIn files, then give the command:
  171.        
  172.        BURNIN <Enter>
  173.        
  174.        After a short setup period, you'll see the program's main
  175.        menu.
  176.        
  177.        USING INTERFACE PLUS PROGRAMS
  178.        =============================
  179.        
  180.        All programs which use the Interface Plus system work the
  181.        same way. They're designed to offer you multiple options and
  182.        ways to work, adapting to your personal style.
  183.        
  184.        On the top line of the menu are several entries. These are
  185.        major functions. You may select one of these by typing the
  186.        first letter of the menu entry, by using the left and right
  187.        cursor keys, or by clicking on an entry with your mouse. Use
  188.        either mouse button.
  189.        
  190.        Below each main menu item is a drop-down submenu. At
  191.        startup, the Files submenu is active. As you move between
  192.        main menu items, the appropriate submenu drops down.
  193.        
  194.        Select entries in submenus by using the up and down cursor
  195.        keys to highlight your selection, then press <Enter>. You
  196.        can also press the number of the menu entry or click on your
  197.        choice with the mouse.
  198.        
  199.        Menu Intelligence
  200.        -----------------
  201.        
  202.        In many cases BurnIn, like all Interface Plus programs, will
  203.        present you with a submenu entry, pre-highlighted. By using
  204.        intelligent menus, you can often bypass several keystrokes.
  205.        The mouse cursor automatically appears in the correct
  206.        position as well.
  207.        
  208.        Inputting Data
  209.        --------------
  210.        
  211.        When BurnIn wants data from you, a box will pop up in the
  212.        middle of the screen. You'll find information there, along
  213.        with a place to type in the data needed. Press <Enter> after
  214.        typing data.
  215.        
  216.        OK and YES/NO Buttons
  217.        ---------------------
  218.        
  219.        In many cases, BurnIn needs to get a confirmation from you,
  220.        or get a YES or NO answer. In those cases, you'll see a
  221.        small box, either free-floating or attached to another box.
  222.        If the button says OK, press any key or click on the button
  223.        to proceed. If the button says YES and NO, press Y or N or
  224.        click on the appropriate word.
  225.        
  226.        SUMMARY
  227.        =======
  228.        
  229.        That's all there is to using any Interface Plus program.
  230.        You'll find the process intuitive, easy and even fun.
  231.        
  232.        
  233.        BURNIN MENUS AND COMMANDS
  234.        =========================
  235.        
  236.        What follows is a list of BurnIn's menus, with a description
  237.        of the functions in each menu. Following this section is a
  238.        tutorial for a typical BurnIn session.
  239.        
  240.        FILE MENU
  241.        ---------
  242.        
  243.        1. Shell to DOS
  244.        
  245.        This command lets you carry out other DOS commands without
  246.        leaving BurnIn. An input box will open, allowing you to
  247.        enter a DOS command. You can also press <Enter> alone to use
  248.        the DOS prompt. Type EXIT, then press <Enter> to abort the
  249.        command.
  250.        
  251.        If you shell out to the DOS prompt, give the command EXIT
  252.        <Enter> to return to BurnIn.
  253.        
  254.        Note: If you enter a DOS command in the input box, a
  255.        floating OK button will appear in the bottom right corner of
  256.        your screen after command execution. Press any key or click
  257.        on the box to return to BurnIn.
  258.        
  259.        2. Quit Program
  260.        
  261.        You'll have an opportunity to confirm this command with a
  262.        YES/NO button. You'll see my shareware request when you
  263.        quit. Please consider registering BurnIn.
  264.        
  265.        CONFIGURE MENU
  266.        ==============
  267.        
  268.        1. Set Screen Colors
  269.        
  270.        This command lets you choose your favorite screen colors for
  271.        BurnIn. Mouse users can simply click on their color choices,
  272.        following the screen prompts. Keyboard users must type in
  273.        the numbers associated with the colors.
  274.        
  275.        After color selection, you can choose the background
  276.        appearance for the program, following the same guidelines.
  277.        
  278.        You can then save these colors in a file, MCOLOR.DAT, if you
  279.        choose. If you save the colors, they become the default
  280.        colors when you start BurnIn.
  281.        
  282.        2. Load a Configuration File  []
  283.        
  284.        BurnIn can save the settings you make for BurnIn in special
  285.        configuration files. If you use BurnIn with several
  286.        computers, this can save you time. Files have the extension
  287.        .RUN and are created with the next command. This command
  288.        lets you choose a file from a list on the screen, either by
  289.        clicking with the mouse, or by typing in the filename, if
  290.        you have no mouse.
  291.        
  292.        If a file is currently active, its name will appear in the
  293.        brackets.
  294.        
  295.        3. Save Configuration
  296.        
  297.        This command lets you save the current status of BurnIn in a
  298.        file which can be loaded with the command above. As you look
  299.        at the following menus, you'll see that some settings are
  300.        preceded by an asterisk (*). These settings are saved in
  301.        configuration files. Use this command to help you automate
  302.        BurnIn.
  303.        
  304.        4. Delete a Configuration File
  305.        
  306.        This command lets you delete configuration files from your
  307.        disk drive. As with the Load Configuration command, you
  308.        select files from a list, one-at-a-time.
  309.        
  310.        5. Restore Defaults
  311.        
  312.        If you have loaded a configuration file, then wish to return
  313.        BurnIn to its normal startup settings, just give this
  314.        command.
  315.        
  316.        OPTIONS MENU
  317.        ------------
  318.        
  319.        The options in this menu are basic configuration options
  320.        used by BurnIn. All are saved in configuration files, if you
  321.        use them.
  322.        
  323.        
  324.        1. *Mouse Drive On? [YES/NO]
  325.        
  326.        This is a toggle command. Use it to turn your mouse off or
  327.        on. The current status will display in the brackets.
  328.        
  329.        2. *Toggle Elapsed Time Display [ON/OFF]
  330.        
  331.        During BurnIn's tests, the elapsed time can appear on the
  332.        screen. Normally this is set ON, but you can toggle it on
  333.        and off with this command. The elapsed time is written to
  334.        the BURNIN.LOG file, regardless of the state of this
  335.        command.
  336.        
  337.        3. *Set Path for BurnIn Data [path]
  338.        
  339.        This command allow you to run BurnIn from other directories,
  340.        as long as the BURNIN.EXE file can be found in a directory
  341.        in your PATH statement. Enter the directory where BurnIn's
  342.        data files can be found here. The trailing backslash (\) is
  343.        optional. The current path displays in the brackets, and is
  344.        normally the path where BurnIn is started.
  345.        
  346.        NOTE: You can also set this path with the DOS SET command,
  347.        storing the path in the environment area. BurnIn checks for
  348.        the BURNIN variable in the DOS environment as soon as it
  349.        starts. Use this if you commonly start BurnIn from another
  350.        directory. Here's a sample:
  351.        
  352.        SET BURNIN=C:\BURNIN
  353.        
  354.        4. *Toggle Log File Creation [ON/OFF]
  355.        
  356.        You may wish to cancel BurnIn's logging of tests. If so,
  357.        toggle this command. The default setting is ON.
  358.        
  359.        TESTS MENU
  360.        ==========
  361.        
  362.        Items under this menu are toggles for the "Run All Selected
  363.        Tests" command in the "Run" menu. You can turn any of the
  364.        tests on or off by giving the appropriate command. These
  365.        toggles are saved in configuration files.
  366.        
  367.        1. *Disk Tests [ON/OFF]
  368.        
  369.        This toggles disk testing on or off. Default is ON. Tests
  370.        are done on the disks specified in the "Drives" menu.
  371.        
  372.        2. *Text Monitor Tests [ON/OFF]
  373.        
  374.        Toggles the text monitor tests. Default is ON.
  375.        
  376.        3. *Math and CPU Tests [ON/OFF]
  377.        
  378.        Toggles the math and CPU tests. Default is ON.
  379.        
  380.        4. *Printer Test [ON/OFF]
  381.        
  382.        Toggles printer testing. Default is OFF.
  383.        
  384.        5. *Graphics Tests [ON/OFF]
  385.        
  386.        Toggles graphics monitor testing. Default is ON.
  387.  
  388.        6. *Memory Tests [ON/OFF]
  389.  
  390.        Toggles memory testing. Default is ON.
  391.        
  392.        RUN MENU
  393.        ========
  394.        
  395.        1. Run All Selected Tests
  396.        
  397.        This command runs all the tests you marked as ON in the
  398.        previous menu. Depending on the settings of menu items 7 and
  399.        8 in this menu, the tests run continuously or for a time you
  400.        specify. Tests run sequentially, and can be aborted at any
  401.        time if you press ANY key.
  402.        
  403.        NOTE:  BurnIn traps most errors and continues to run the
  404.        tests!  You need to read the error log by using the command
  405.        in the "UTILITIES" menu to discover errors. Some errors,
  406.        however, are fatal. These errors will cause BurnIn to exit
  407.        and a DOS error message will appear on the screen.
  408.  
  409.        When the tests are finished, you'll see a box with a count
  410.        of errors, if any occurred during the tests. 
  411.        
  412.        2. Run Disk Tests
  413.        
  414.        This command runs only the disk tests, using the disks set
  415.        to ON in the "Drives" menu. The tests run only once.
  416.        
  417.        3. Run Text Monitor Tests
  418.        
  419.        Runs the two text monitor tests one time.
  420.        
  421.        4. Run Math and CPU Tests
  422.        
  423.        Runs the calculation test one time.
  424.        
  425.        5. Run Printer Test
  426.        
  427.        Runs the printer test one time.
  428.        
  429.        6. Run Graphics Tests
  430.        
  431.        Runs the graphics test series one time. This command makes a
  432.        nice demo of your graphics capabilities. If you use it for
  433.        this purpose, you may want to turn the elapsed time display
  434.        off in the "Options" menu.
  435.  
  436.        7. Run Memory Tests
  437.  
  438.        Runs the memory tests one time.
  439.        
  440.        8. *Continuous Run [ON/OFF]
  441.        
  442.        This command toggles BurnIn to run tests continuously.
  443.        Default is ON. If you set it to OFF, you must provide a run
  444.        time in the next command.
  445.        
  446.        9. *Set Run Time [time] Hours
  447.        
  448.        This command lets you set a specific running time for your
  449.        BurnIn test series. Enter the time in hours and decimal
  450.        fractions of hours. e.g. 5, 6.5, etc. If you use this
  451.        command, Continuous Run is automatically set to OFF.
  452.        
  453.        NOTE: Routines will not automatically end at the set time.
  454.        The time is checked only at the ends of routines, so time
  455.        may exceed your setting by a few minutes.
  456.        
  457.        UTILITIES MENU
  458.        ==============
  459.        
  460.        1. Format Drive A:
  461.        
  462.        Formats a floppy disk in drive A:  The DOS FORMAT command
  463.        must be available.
  464.        
  465.        2. Format Drive B:
  466.        
  467.        As above, but for drive B:
  468.        
  469.        3. Read Log File
  470.        
  471.        Displays the BURNIN.LOG file created during a run of tests.
  472.        The file is displayed one screen at a time. Press any key to
  473.        see the next screen, or <Esc> to return to BurnIn. If no 
  474.        errors occurred, a box will tell you so, and there's no need
  475.        to read the log, unless you just want to see a record.
  476.        
  477.        4. Delete Log File
  478.        
  479.        Deletes the BURNIN.LOG file from disk. Since BurnIn always
  480.        adds to the end of the existing file, so use this command to
  481.        remove old version of the log.
  482.        
  483.        DRIVES MENU
  484.        ===========
  485.        
  486.        Use this menu to select drives for use in BurnIn's drive
  487.        tests. Each menu entry toggles one drive on or off. As a
  488.        default, only Drive C: is toggled on. All drive settings are
  489.        saved in configuration files, if you use them.
  490.        
  491.        NOTE:  Do not toggle LOGICAL drives ON!  This will cause
  492.        BurnIn to stop operation. What's a logical drive? It's a
  493.        drive which doesn't really exist, but which DOS substitutes.
  494.        
  495.        An example is Drive B: on single floppy drive systems. It's
  496.        there, but don't use it with BurnIn. Similarly, drives
  497.        created with DRIVER.SYS cause the same problem. Toggle on
  498.        only physical drives!
  499.        
  500.        CAUTION: BurnIn is designed to test HARDWARE. Before running
  501.        it, turn off any disk caching software and disable any
  502.        ASSIGN commands. They won't hurt anything, but what's the
  503.        point?
  504.        
  505.        1. *Drive A: [ON/OFF]
  506.        
  507.        I'm only going to show one of these. Give this command to
  508.        either use Drive A: in testing or not. The current state
  509.        appears in brackets. All drive settings are similar.
  510.        
  511.        HELP MENU
  512.        =========
  513.        
  514.        1. Read Manual
  515.        
  516.        Does just what it says....lets you read this file. You can
  517.        move up and down within the file by using normal cursor
  518.        keys. If you want to print the file, press T, then type PRN
  519.        and press <Enter>. Make sure your printer is on and has
  520.        paper. You can also create an ASCII file of the manual for
  521.        loading into your word processor with the same command.
  522.        Instead of typing PRN, type your desired filename.
  523.        
  524.        2. Shareware Information
  525.        
  526.        VERY IMPORTANT! You'll see this anyway, but I wanted to give
  527.        you another opportunity. When you decide to register, see
  528.        the REGISTRATION INFORMATION below.
  529.        
  530.        3. Common Error Messages
  531.        
  532.        This command displays a list of error numbers you may see in
  533.        the BURNIN.LOG file, along with their descriptions.
  534.        
  535.        NOTE: BurnIn is not a diagnostic program. It's designed to
  536.        be a system exerciser. If you experience an error not
  537.        described here, see your dealer or use a diagnostic program.
  538.        
  539.        4. Dos Environment Info
  540.        
  541.        This command will remind you how to use the DOS SET command
  542.        to help you use BurnIn from other directories.
  543.        
  544.        
  545.        
  546.        BURNIN TUTORIAL
  547.        ===============
  548.        
  549.        Here are the steps for a typical BurnIn session.
  550.        
  551.        1. Start BurnIn
  552.        
  553.        2. Select the Options Menu
  554.        Check each toggle in this menu to make sure it's set the way
  555.        you want it.
  556.        
  557.        3. Select the Test Menu
  558.        If you're going to run a set of tests, rather than
  559.        individual tests, toggle the tests you want to use to the ON
  560.        setting.
  561.        
  562.        4. Select the Drives Menu
  563.        
  564.        If you'll be running drive tests, toggle on the drives you
  565.        want to test.
  566.        
  567.        5. Select the Run Menu
  568.        
  569.        Choose the "Run All Selected Tests" command. Testing begins
  570.        immediately and will run until you press a key. If you want
  571.        a specific run time, use option 8 to specify the time.
  572.        
  573.        6. Check the BURNIN.LOG file.
  574.        
  575.        When your tests are complete, the "Read Log File" command is
  576.        pre-highlighted. Just click or press <Enter> to review the
  577.        results of the tests.  If no errors occurred, you won't need
  578.        to do this step.
  579.        
  580.        7. Read the "Common Error Messages" documentation.
  581.        
  582.        Do this only if you encountered error messages in the
  583.        BURNIN.LOG file.
  584.        
  585.        8. Select the Files Menu
  586.        
  587.        Choose entry 2 to quit the program.
  588.        
  589.        It's easy!  Naturally, you can use any of the other
  590.        commands, as you choose.
  591.        
  592.        REGISTRATION INFORMATION
  593.        ========================
  594.        
  595.        BurnIn is a Shareware Program, copyright 1990 by George
  596.        Campbell. It is NOT in the public domain. If you use BurnIn,
  597.        and are satisfied with it, please become a registered user.
  598.        Remember, the peace of mind of knowing your system is OK is
  599.        worth something. If BurnIn finds a problem while your system
  600.        is under warranty, it's worth even more.
  601.        
  602.        Registration costs only $15, and entitles you to use the
  603.        program on as many PCs as you like. Registered users receive
  604.        the latest version of the program, a version which does not
  605.        have any shareware registration screens. Registered users
  606.        are also entitled to notification of updates to BurnIn, and
  607.        can receive updated versions for a low $5 fee to cover disk
  608.        mailing. Registered users also receive unlimited support,
  609.        which means you get my telephone number!
  610.        
  611.        NOTE TO SYSTEM HOUSES AND CLONE BUILDERS
  612.        ----------------------------------------
  613.        
  614.        Registration is REQUIRED for commercial use of BurnIn. You
  615.        need only to register ONE copy, which you can use on as many
  616.        systems as you like. It's cheap insurance for bad systems,
  617.        and if you register, you may ship a copy of the BURNIN.LOG
  618.        file for that system with the system. If you use BurnIn
  619.        commercially, I expect you to register!
  620.        
  621.        Send $15 registration fees to:
  622.        
  623.        George Campbell
  624.        1472 Sixth St.
  625.        Los Osos, CA  93402
  626.        
  627.        Specify 5.25 or 3.5 inch disks.
  628.  
  629. ==========================================================================
  630.  
  631.  
  632.  
  633.                         WELCOME TO INTERFACE PLUS!
  634.                                Version 2.1
  635.    
  636.               The Solution For Your QuickBASIC 4.5 Problems
  637.               =============================================
  638.    
  639.                                      by
  640.  
  641.                                George Campbell
  642.                                 1472 Sixth St.
  643.                              Los Osos, CA  93402
  644.                                 CIS: 71571,222
  645.                                GEnie: G.CAMPBELL
  646.                              BBS - (805) 528-3753
  647.    
  648.    
  649.          INTRODUCTION                                   
  650.          ============                                   
  651.                                                         
  652.          After writing dozens of shareware and public domain programs
  653.          in QuickBASIC, I finally figured out that I was re-inventing
  654.          the interface wheel for each program. As I developed my
  655.          skills, my interfaces became more and more sophisticated.
  656.          BUT -- I was still rewriting the things for each program.
  657.                                                         
  658.          Finally, I came up with an answer. Why not create a
  659.          universal interface for all my software....one which was
  660.          flexible enough to handle a single menu, and complex enough
  661.          to work for a complex program with dozens of choices?  Out
  662.          of that need comes Interface Plus, the program you're
  663.          looking at today.                              
  664.                                                         
  665.          The interface itself became an obsession: Every time I
  666.          turned around, I found another thing it needed. Mouse
  667.          support?  Of course!  Built-in routines for common needs?
  668.          Certainly!  Drop-down menus?  What else?       
  669.                                                         
  670.          In any case, I finally brought the program to a point where
  671.          I felt it was good enough for my programs. Now, I'm offering
  672.          it as a shareware program to aid other QuickBASIC
  673.          programmers. Can it work for you?              
  674.                                                         
  675.                                                         
  676.          WHY YOU NEED INTERFACE PLUS                    
  677.          ===========================                    
  678.                                                         
  679.          If you write shareware software, you already know that
  680.          registration checks from users depend on your program. If
  681.          it's complete and easy to use, you get checks. It's that
  682.          simple.                                        
  683.                                                         
  684.          By writing your program within Interface Plus, you assure
  685.          better registration response. Your program, no matter what
  686.          it does, has a state-of-the-art interface.     
  687.                                                         
  688.          You save time, too. Since you don't have to re-invent the
  689.          interface wheel each time you create a new program, you can
  690.          focus on YOUR routines.                        
  691.                                                         
  692.          Finally, since your programs will be in a flexible
  693.          interface, adding new functions as you upgrade is a walk in
  694.          the park. You can add new menu items just by writing three
  695.          lines of code.                                 
  696.                                                         
  697.                                                         
  698.          SYSTEM REQUIREMENTS                            
  699.          ===================                            
  700.                                                         
  701.          Interface Plus will run on any IBM-compatible PC. It needs
  702.          256K of memory, DOS 3.0 or a later version, but will work on
  703.          any monitor. The mouse is optional. Its mouse-handling
  704.          routines are designed to support ALL mice, including the IBM
  705.          PS/2 mouse.                                    
  706.                                                         
  707.          The program automatically determines what's available in any
  708.          PC, then adjusts itself accordingly.           
  709.                                                         
  710.          As a programmer, working with Interface Plus, you'll need
  711.          640K, QuickBASIC 4.5 or later, and DOS 3.1 or a later
  712.          version. A mouse is a good idea for testing.   
  713.                                                         
  714.          FEATURES                                       
  715.          ========                                       
  716.                                                         
  717.                                                         
  718.          Interface Plus has an extensive features list, with handles
  719.          you can build on to make all your programs more powerful.
  720.          Here's a fairly complete list:                 
  721.                                                         
  722.          USER FUNCTIONS                                 
  723.                                                         
  724.          Windows-like text interface                    
  725.          Drop-Down Menus                                
  726.          Mouse Support                                  
  727.          Automatic Configuration                        
  728.          All menu functions can be accessed by:         
  729.               1. Mouse click                            
  730.               2. First letter keypress                  
  731.               3. Cursor keys plus <Enter>               
  732.          Intelligent Menus (jumps to next logical choice)
  733.          Screen Color Selection built-in. (point and click)
  734.          Screen background choices                      
  735.          File selection from screen list                
  736.          File Viewer                                    
  737.          Shell to DOS with command or just to prompt    
  738.          Pop-up windows and input boxes                 
  739.          OK and YES/NO buttons for mouse or keyboard    
  740.          Configuration file automatically saves YOUR setup
  741.          Environment variables for power users          
  742.          Automatic return to original directory         
  743.          Totally intuitive operation                    
  744.                                                         
  745.                                                         
  746.          PROGRAMMER FUNCTIONS                           
  747.          ====================                           
  748.                                                         
  749.          MENUS                                          
  750.                                                         
  751.          Full drop-down, with mouse, keyboard, or cursor-key control
  752.          Up to 240 separate menu items                  
  753.          Easy menu setup, with all menu variables in one place
  754.          Automatic sizing and positioning of menus      
  755.          Total menu flexibility                         
  756.                                                         
  757.          MENU INTELLIGENCE                              
  758.                                                         
  759.          By adding two simple variables, you can make your Interface
  760.          Plus applications intelligent. After executing one function,
  761.          your user finds him or herself looking at the next logical
  762.          menu -- already highlighted. You control this easily.
  763.                                                         
  764.          MOUSE SUPPORT                                  
  765.                                                         
  766.          By keeping mouse functions simple, this program is
  767.          completely independent of type of mouse. It works with ALL
  768.          mice, automatically.                           
  769.                                                         
  770.          Mouse Cursor Control -- YOU decide where you want the mouse
  771.          cursor to be. Combined with intelligent menus, you can
  772.          always place the cursor in the next logical spot.
  773.                                                         
  774.          Detect clicks                                  
  775.          Find mouse location                            
  776.          Turn mouse on or off with a command            
  777.                                                         
  778.                                                         
  779.          WINDOWS and BOXES                              
  780.                                                         
  781.          Built-in input or information box with:        
  782.                                                         
  783.               Fixed location for instant user recognition.
  784.               Room for three 60-character lines of text 
  785.               OK button or YES/NO button optional       
  786.                                                         
  787.          Custom Screen Windows with:                    
  788.                                                         
  789.               Flexible sizing                           
  790.               Total color control                       
  791.               5 Border types                            
  792.               One-line call to create box on screen     
  793.               Multiple boxes on screen at once.         
  794.                                                         
  795.          OK and YES/NO buttons:                         
  796.                                                         
  797.               Can be positioned anywhere on screen      
  798.               One line call to create button            
  799.               Accept mouse click or keystroke           
  800.               Optional defaults                         
  801.               Mouse cursor is automatically on button!  
  802.                                                         
  803.          Program Intelligence                           
  804.                                                         
  805.          Interface Plus checks the user's system and knows these
  806.          things:                                        
  807.                                                         
  808.               Memory Size                               
  809.               DOS Version                               
  810.               Monitor Type                              
  811.               Mouse status                              
  812.               Available Drives (A: to H:)               
  813.               (NOTE: The drive check is currently REMmed out in
  814.               this version. It occasionally leaves a temporary file
  815.               behind on LOGICAL drives. You can decide for yourself
  816.               whether to use the DriveTest routine)     
  817.               Original Directory                        
  818.               Current Directory                         
  819.               Environment path setting for your data files
  820.               File choice - if file is selected         
  821.               Command line parameters                   
  822.               MORE!                                     
  823.                                                         
  824.          Programmer-accessible routines include:        
  825.                                                         
  826.               Directory Display                         
  827.               File Selection                            
  828.               Change Directory                          
  829.               Display ASCII file                        
  830.               Mouse cursor position - set or read       
  831.               Mouse cursor on or off                    
  832.               Programmable delay                        
  833.               Print Screen                              
  834.               Send Formfeed                             
  835.               Change File Mask for directory search     
  836.               Shell to DOS                              
  837.               Input box -- described above              
  838.               OK and YES/NO buttons -- described above  
  839.               Sizable and movable windows               
  840.               Read in Color data from file.             
  841.               Write and read configuration file.        
  842.               Keystroke filter -- tells you what key has been
  843.               pressed, including all function keys, plain or shifted,
  844.               and cursor keys. Easy string-type identifiers. FAST!
  845.               MORE!                                     
  846.                                                         
  847.                                                         
  848.          PROGRAM LAYOUT                                 
  849.                                                         
  850.          Interface Plus is written TOTALLY in QuickBASIC 4.5. There
  851.          are no hidden routines or libraries. All routines are
  852.          included and may be altered to suit your needs.
  853.                                                         
  854.          You get COMPLETE source code!                  
  855.                                                         
  856.          All variables and routines have long, readable names. You
  857.          won't have to remember cryptic variable and routine names
  858.          when you insert your own code.                 
  859.                                                         
  860.          Interface Plus is clean and well-designed. It uses the
  861.          appropriate QB tools in the appropriate places. CALLed
  862.          subroutines and GOSUBs are use throughout, depending on the
  863.          need for global or local variables. NOTICE:  There are three
  864.          places where GOTOs are used, but they never leave a routine,
  865.          so cause zero problems.                        
  866.                                                         
  867.          Where appropriate, Interface Plus uses INTERRUPT-driven
  868.          routines. Mouse control, file lists, and others are
  869.          included. Since these are fundamental to the program, you
  870.          don't need to know how to use interrupts to use them. There
  871.          here for speed and to add support for functions not
  872.          supported by QuickBASIC.                       
  873.                                                         
  874.          The Interface Plus source code is in three sections.
  875.                                                         
  876.          1. The main menu section.                      
  877.          All menu design tools are right up-front and easy to use.
  878.          The QB SELECT CASE function is used throughout.
  879.                                                         
  880.          1. GOSUB subroutines                           
  881.                                                         
  882.          These routines use global variables. Every precaution has
  883.          been taken to clear variables when needed. Here's where you
  884.          add your own stuff.                            
  885.                                                         
  886.          2. Called subroutines                          
  887.                                                         
  888.          Most of these are integral to the interface itself. Calling
  889.          each of these means that you must pass variables to the
  890.          routine. Since variable names are clear and understandable,
  891.          it's easy.                                     
  892.                                                         
  893.          Individual routines are separated by comment lines, clearly
  894.          identifying them. The full documentation package even
  895.          includes keywords for jumping to any routine while in the QB
  896.          environment.                                   
  897.                                                         
  898.                                                         
  899.          LICENSING INFORMATION                          
  900.          =====================                          
  901.                                                         
  902.          Interface Plus is shareware, and has a four-tiered licensing
  903.          structure, along with several registration methods. First
  904.          and foremost:  YOU NEVER PAY ROYALTIES WHEN YOU USE
  905.          INTERFACE PLUS!                                
  906.                                                         
  907.          Overall Licensing                              
  908.                                                         
  909.          Interface Plus contains code which will identify it,
  910.          regardless of how you use it. In addition, a copyright
  911.          notice is included as a string constant in the program. This
  912.          notice will NEVER appear to your customers, but MUST remain
  913.          in the source code, without changes. It will appear in the
  914.          .EXE file, if a hex editor is used. No licence granted
  915.          allows removal of that code or copyright notice.
  916.                                                         
  917.          Regardless of the license type, users may alter any portion
  918.          of the Interface Plus source code to suit their needs.
  919.                                                         
  920.          Here's a rundown on licensing and registration options:
  921.                                                         
  922.          Public Domain and Personal Use license:        
  923.                                                         
  924.          You may use Interface Plus to create personal programs and
  925.          programs you place in the public domain at no charge
  926.          whatsoever. I want to encourage the development of free
  927.          programs. By public domain, I mean programs which are
  928.          offered to the public with no registration fee whatsoever.
  929.          You may, of course, want to take advantage of the $10
  930.          registration offer, which brings a clean version of the
  931.          source code, and more documentation.           
  932.                                                         
  933.                                                         
  934.          Shareware Licence:                             
  935.                                                         
  936.          If you use Interface Plus to create shareware software,
  937.          wherein you request a registration fee from users, the
  938.          licence fee is $60. That's just three $20 registrations, so
  939.          it's not all that expensive. See the Registration
  940.          Information below to see what you get for your $60
  941.          registration fee!                              
  942.                                                         
  943.                                                         
  944.          Corporate In-House License:                    
  945.                                                         
  946.          If you use Interface Plus to create applications which will
  947.          be used internally WITHIN a corporation, the license fee is
  948.          $125. This fee entitles you to distribute unlimited copies
  949.          of a program using Interface Plus WITHIN a single
  950.          corporation. Under this fee, you MAY NOT sell or otherwise
  951.          distribute a program outside your corporation or to clients
  952.          of your corporation.                           
  953.                                                         
  954.                                                         
  955.          Commercial License:                            
  956.                                                         
  957.          If you use Interface Plus to create software which you will
  958.          sell outright to customers, whether corporate or individual,
  959.          the license fee is $1000. It's simple:  If a program using
  960.          Interface Plus has a price tag and is not distributed as
  961.          shareware, you must buy a Commercial License.  
  962.                                                         
  963.                                                         
  964.          REGISTRATION INFORMATION                       
  965.          ========================                       
  966.                                                         
  967.          Here's what you get for each of the license formats:
  968.                                                         
  969.                                                         
  970.          Public Domain and Personal Use License:        
  971.                                                         
  972.          COST: $10                                      
  973.                                                         
  974.          INCLUDES:                                      
  975.                                                         
  976.          1. Full source code, both for the demo version and for the
  977.          cleaned-up version with no built-in menu functions.
  978.                                                         
  979.          2. 5.25" or 3.5" diskettes.                    
  980.                                                         
  981.          3. Basic documentation, on-disk, which includes all
  982.          information needed to use functions in Interface Plus.
  983.                                                         
  984.          4. TXT2COM -- a shareware text-to-COM file utility for
  985.          creating self-browsing text files.             
  986.                                                         
  987.          5. Limited support on CompuServe, GEnie, or the author's
  988.          BBS. No telephone support is included with this license.
  989.                                                         
  990.                                                         
  991.          All other Licenses:                            
  992.                                                         
  993.          COST: Varies                                   
  994.                                                         
  995.          INCLUDES:                                      
  996.                                                         
  997.          1. Full source code, both for the demonstration version and
  998.          the empty version.                             
  999.                                                         
  1000.          2. 5.25" AND 3.5" Diskettes                    
  1001.                                                         
  1002.          3. Laser-printed manual in three-ring binder. Manual
  1003.          includes:                                      
  1004.                                                         
  1005.          a. Detailed source code comments               
  1006.          b. Full variable list, with calls and functions
  1007.          c. Full subroutine details, with parameters and syntax.
  1008.          d. Menu-design tips and parameters.            
  1009.          e. Printed copy of both source code sets for study.
  1010.          f. Hints and tips for making Interface Plus work for you.
  1011.                                                         
  1012.          4. Telephone support, along with the other support tools.
  1013.                                                         
  1014.          5. Notification of upgrades. Upgrades will cost $15, and
  1015.          will include new disks, and manual pages for quick
  1016.          insertion.                                     
  1017.                                                         
  1018.                                                         
  1019.          ORDER FORM                                     
  1020.                                                         
  1021.          INTERFACE PLUS                                 
  1022.          George Campbell                                
  1023.          1472 Sixth Street                              
  1024.          Los Osos, CA  93402                            
  1025.                                                         
  1026.          YES! I want to order a Registered Version of Interface Plus!
  1027.          Please send the version checked below. I'm enclosing a check
  1028.          or money order.                                
  1029.                                                         
  1030.          ___  Personal Use License  ($15)    ____ 5.25"   ___ 3.5"
  1031.                                                         
  1032.          ___ Shareware License ($60)                    
  1033.                                                         
  1034.          ___ Corporate In-house License ($125)          
  1035.                                                         
  1036.          ___ Commercial License ($1000)                 
  1037.                                                         
  1038.          (See section above for what's included)        
  1039.                                                         
  1040.          AMOUNT ENCLOSED: $____________ (Includes shipping)
  1041.                                                         
  1042.                                                         
  1043.          SEND TO:                                       
  1044.                                                         
  1045.          NAME:_______________________________________________________
  1046.                                                         
  1047.          STREET:_____________________________________________________
  1048.                                                         
  1049.          ____________________________________________________________
  1050.                                                         
  1051.          CITY:____________________________STATE:_____ZIP_____________
  1052.                                                         
  1053.                                                         
  1054.                                                         
  1055.                                                         
  1056.                                                         
  1057.          FINAL NOTE:                                    
  1058.                                                         
  1059.          If you're reading this, but haven't yet seen a copy of
  1060.          Interface Plus, be sure and download your copy of NRFACE.ZIP
  1061.          soon. You'll wonder why nobody did this before!
  1062.