home *** CD-ROM | disk | FTP | other *** search
/ SDN¹ Plus / SDN1_.cdr / sdn / util1 / bcsmnu10.sdn / BCSMENU.DOC < prev    next >
Text File  |  1990-05-20  |  97KB  |  2,453 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                           BCS MENU PROGRAM
  30.                    --------------------------------
  31.                             USER MANUAL
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.    Bristol Computing Systems, Inc.
  56.    Suite 162
  57.    200 Linden Street
  58.    P.O. Box 9009
  59.    Wellesley, MA 02181
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                          TABLE OF CONTENTS
  66.  
  67.  
  68.    Table of Contents ............................................ i
  69.    License Agreement .......................................... iii
  70.    About This Document .......................................... v
  71.    Chapter 1 - Introduction ..................................... 1
  72.        Features ................................................. 1
  73.        System Requirements ...................................... 3
  74.    Chapter 2 - Installing BCS Menu Program ...................... 4
  75.        1. Read the README file. ................................. 4
  76.        2. Copy the appropriate files to your fixed disk. ........ 4
  77.            A. Using the Install Program. ........................ 4
  78.            B. Copying BCS Menu Program with DOS. ................ 5
  79.        3. Modify AUTOEXEC.BAT. .................................. 5
  80.        4. Customize the menus for your system. .................. 6
  81.        Other Considerations ..................................... 6
  82.        Using a Mouse ............................................ 6
  83.        The Sample Menu Files .................................... 6
  84.    Chapter 3 - Using BCS Menu Program ........................... 7
  85.        A Little Geography ....................................... 7
  86.        Executing a Menu Item .................................... 8
  87.        Getting Help ............................................. 9
  88.        Displaying Item Description Window ....................... 9
  89.        Turn Sound ON or OFF ..................................... 9
  90.        Screen Blank ............................................. 9
  91.        Exit to DOS .............................................. 9
  92.        Changing Colors ......................................... 10
  93.        Saving the Menu Definition File ......................... 10
  94.        Other Keys .............................................. 10
  95.        Key Summary ............................................. 10
  96.    Chapter 4 - Changing the Colors ............................. 11
  97.        To Change a Window's Color .............................. 11
  98.        Using the Mouse to Change Window Colors ................. 12
  99.        Changing Prompt Colors .................................. 12
  100.        To Change the Color of a Prompt ......................... 12
  101.        Using the Mouse to Change Prompt Colors ................. 12
  102.        Changing Window/Prompt Colors ........................... 12
  103.        Changing Colors on an MDA ............................... 13
  104.        To Change Window Attributes on an MDA ................... 13
  105.        Using the Mouse to Change Window Attributes ............. 13
  106.        To Change the Attribute of a Prompt on an MDA ........... 14
  107.        Using the Mouse to Change Prompt Attributes ............. 14
  108.        Changing the Color Palette on EGA/VGA ................... 14
  109.        To Change the Palette ................................... 14
  110.        To Change the Palette Using the Mouse ................... 15
  111.        Restore Colors .......................................... 15
  112.        Editing a Menu File ..................................... 15
  113.        Saving the Menu Definition File ......................... 15
  114.        Key Summary ............................................. 16
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.                         BCSMENU.DOC - Page i
  123.  
  124.  
  125.  
  126.  
  127.    Chapter 5 - Editing A Menu File ............................. 17
  128.        Menu Edit Screen Display ................................ 17
  129.        About Menu Editing ...................................... 18
  130.        Key Usage in an Edit Window ............................. 18
  131.        Reserved Character ...................................... 19
  132.        To Change a Menu Item ................................... 19
  133.        Entering/Changing the Menu Item Password ................ 19
  134.        Entering/Changing the Menu Item Prompt .................. 20
  135.        Entering/Changing the Item Description .................. 20
  136.        Entering/Changing the Menu Item Commands ................ 21
  137.        Loading a New Menu File ................................. 21
  138.        Specifying User Input Variables ......................... 22
  139.        Examples of User Input Variables ........................ 22
  140.        Editing a Menu Item Repeatedly .......................... 23
  141.        Getting Help ............................................ 23
  142.        Restore Menu ............................................ 23
  143.        Delete a Menu Item ...................................... 23
  144.        Inserting a New Menu Item ............................... 23
  145.        Changing the Title/DOS Exit Password .................... 24
  146.        Set Spacing/Number of Columns ........................... 24
  147.        Moving a Prompt ......................................... 25
  148.        Sorting Prompts ......................................... 25
  149.        Saving the Menu Definition File ......................... 26
  150.        Other Keys .............................................. 26
  151.        Key Summary ............................................. 27
  152.    Chapter 6 - BCS Menu Program - Operational Overview ......... 28
  153.        Loading Default and Alternate Menu Files ................ 29
  154.        Menu Definition File Naming Conventions ................. 29
  155.        Location of Menu Definition Files ....................... 29
  156.    Appendix A - About Bristol Computing Systems, Inc. .......... 30
  157.    Appendix B - Error Messages ................................. 31
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.                         BCSMENU.DOC - Page ii
  186.  
  187.  
  188.  
  189.  
  190.  
  191.          Bristol Computing Systems Menu Program Shareware Version
  192.           E V A L U A T I O N   L I C E N S E   A G R E E M E N T
  193.  
  194.    Bristol Computing Systems, Inc. is furnishing you a copy of Bristol
  195.    Computing Systems Menu Program, hereafter referred to as BCS Menu
  196.    Program, as shareware (user-supported software).  The shareware concept
  197.    means that you can evaluate this software on your own machine to
  198.    determine whether you want to purchase it.  BCS Menu Program is
  199.    copyrighted software.  It is not free software, nor is it in the public
  200.    domain.  You are granted a limited license to evaluate a copy of this
  201.    software subject to the terms of this Evaluation License Agreement.
  202.  
  203.    This is a single copy software license granted by Bristol Computing
  204.    Systems, Inc., Suite 162, 200 Linden Street, P.O. Box 9009, Wellesley,
  205.    MA 02181.
  206.  
  207.    BCS Menu Program is licensed to you on a limited basis as outlined
  208.    herein:
  209.    o   Bristol Computing Systems Menu Program is copyrighted software.
  210.        You may use it on a trial basis only for evaluation.  Use of BCS
  211.        Menu Program and/or affiliated files on any other basis or for a
  212.        period longer than 30 days requires that you buy a copy of the
  213.        software (see order form).
  214.    o   You may not sell, rent, lease, sublicense or otherwise provide this
  215.        software to others.  (You may copy or distribute this software for
  216.        the benefit of others provided you distribute or copy the entire
  217.        package as distributed by Bristol Computing Systems, Inc.)
  218.        The complete package is comprised of the following files:
  219.            BCSMENU.COM - BCS Menu program
  220.            BCSMENU.OVL - BCS Menu Program Overlay
  221.            INSTALL.EXE - BCS Menu Installation Program
  222.            MENU.MNU    - BCS Sample menu file.
  223.            DOSMENU.MNU - BCS Sample DOS Utilities menu file.
  224.            GAMES.MNU   - BCS Sample Games menu file.
  225.            MENU.MDA    - BCS Sample menu file for MDA.
  226.            DOSMENU.MDA - BCS Sample DOS Utilities menu file for MDA.
  227.            GAMES.MDA   - BCS Sample Games menu file for MDA.
  228.            BCSMENU.DOC - BCS Menu Program Documentation.
  229.            LICENSE.DOC - This copyright notice
  230.            ORDER.DOC   - BCS Menu Program order form.
  231.            README      - Last Minute Notes and Installation Instructions
  232.    o   You may not copy the software, the documentation, or any of the
  233.        example menu files in any package or on any disk or diskette
  234.        without first receiving written permission from Bristol Computing
  235.        Systems.
  236.    o   You may not modify, change, disassemble, or otherwise reverse
  237.        engineer BCS Menu Program.
  238.    o   You may not modify or change BCS Menu Program documentation.
  239.    o   You are free, and encouraged, to modify the example menu files to
  240.        fit your personal needs.
  241.    o   You agree to accept and use the software "as is."  Bristol
  242.        Computing Systems makes no warranties concerning the BCS Menu
  243.        Program, implied or otherwise.
  244.  
  245.  
  246.  
  247.  
  248.                        BCSMENU.DOC - Page iii
  249.  
  250.  
  251.  
  252.  
  253.    o   Bristol Computing Systems accepts no liability for any damages
  254.        whatsoever.  YOU USE THIS SOFTWARE AT YOUR OWN RISK.
  255.    o   Your use of the software indicates your acceptance of the terms of
  256.        this Agreement.
  257.  
  258.    U.S. Government Restricted Rights
  259.    This program and documentation are provided with Restricted Rights.
  260.    Use, duplication, or disclosure by the government is subject to
  261.    restrictions set forth in subparagraph (c)(1) of the "Rights in
  262.    Technical Data and Computer Software" clause at 52.227-19 of the Federal
  263.    Acquisition Regulations. Contractor/manufacturer is Bristol Computing
  264.    Systems, Inc., Suite 162, 200 Linden Street, P.O. Box 9009, Wellesley,
  265.    MA 02181.
  266.  
  267.  
  268.    Please sign and return to:
  269.        Bristol Computing Systems, Inc.
  270.        Suite 162
  271.        200 Linden Street
  272.        P.O. Box 9009
  273.        Wellesley, MA 02181
  274.  
  275.  
  276.  
  277.  
  278.    __________________________________   ___________________________________
  279.    Print Purchaser's Name               Signature
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.                         BCSMENU.DOC - Page iv
  312.  
  313.  
  314.  
  315.  
  316.    ABOUT THIS DOCUMENT
  317.  
  318.    This document describes the features and use of BCS Menu Program.  The
  319.    program was designed so you don't have to reference a manual to use it.
  320.    On-line help is available to guide you through all functions.
  321.  
  322.    This document does itemize the features included in BCS Menu Program to
  323.    make you aware of them so you can get the most out of the program.
  324.    Detailed installation instructions and explanations for each function
  325.    are included here.  You will need to use this document for certain menu
  326.    item editing functions (such as loading another menu file or User Input
  327.    Variables) or as a reference for more detailed information.
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.    (c) 1990 Bristol Computing Systems, Inc.  All Rights Reserved.
  335.  
  336.    No part of this manual may be reproduced in any manner whatsoever
  337.    without prior written permission of Bristol Computing Systems, Inc.
  338.  
  339.    Information in this manual is subject to change without notice. Bristol
  340.    Computing Systems, Inc. reserves the right to make changes in this
  341.    manual or in the software it describes at any time.
  342.  
  343.  
  344.    IBM, PS/2, Personal Computer AT are registered trademarks of
  345.    International Business Machines Corporation.
  346.    Personal Computer XT is a trademark of International Business Machines
  347.    Corporation.
  348.    Microsoft is a registered trademark of Microsoft Corporation.
  349.    SideKick is a trademark of Borland International.
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.                         BCSMENU.DOC - Page v
  375.  
  376.  
  377.  
  378.  
  379.  
  380.    CHAPTER 1 - INTRODUCTION
  381.  
  382.  
  383.    Bristol Computing Systems, Inc. Menu Program, referred to as BCS Menu
  384.    Program, is a software tool to help you get the most productivity from
  385.    your personal computer.  It is designed to allow you to start
  386.    applications quickly and easily.  BCS Menu Program adds security to your
  387.    system by allowing you to assign passwords to prevent unauthorized use
  388.    of your computer (Control Break and Control C will not exit the
  389.    program).
  390.  
  391.    The built in editing capabilities of BCS Menu Program provide the
  392.    mechanisms to customize screen display and menu content.  The program
  393.    was designed to provide extensive color control, allowing selection from
  394.    64 different colors on EGA and VGA equipped computers.  You can generate
  395.    aesthetically pleasing screens on both monochrome and color displays.
  396.  
  397.  
  398.    FEATURES
  399.  
  400.    Overview of features provided by BCS Menu Program are:
  401.  
  402.    Easy Menu Selection - Menu selection bar may be positioned using the
  403.                        UP/DOWN arrow keys, by typing the  first
  404.                        character of the menu item prompt or with a
  405.                        single click of the mouse.  Executing the
  406.                        selected menu item is accomplished by then
  407.                        pressing the ENTER key or a double click of the
  408.                        mouse.
  409.  
  410.    True Mouse Support -Every function available from the keyboard may
  411.                        be performed using a mouse (except for text
  412.                        entry where keyboard entry is required).
  413.  
  414.    Extensive Item Help - Each menu item may contain up to six lines of
  415.                        descriptive information that you can optionally
  416.                        display.  The item description display is
  417.                        updated dynamically as the selection bar is
  418.                        moved on the screen.
  419.  
  420.    Number of entries - Each menu may have up to 100 selections.
  421.  
  422.    Unlimited menus -   The number of menus possible is virtually
  423.                        unlimited (limited only by available diskspace
  424.                        and DOS file naming conventions).
  425.  
  426.    Date/Time display - Current date and time are continuously displayed
  427.                        on the menu screen.
  428.  
  429.    Video Support -     Support is provided for MDA, CGA, EGA, MCGA and
  430.                        VGA adapters.  Palette modification is supported
  431.                        on EGA and VGA.
  432.  
  433.    Program Help -      Program help provides online descriptive
  434.                        information.  Program help is invoked by
  435.                        pressing the F1 function key.
  436.  
  437.                         BCSMENU.DOC - Page 1
  438.  
  439.  
  440.  
  441.  
  442.  
  443.    No Temporary Files -This program does not create temporary or batch
  444.                        files to execute menu selections.
  445.  
  446.    Memory Consumption -Memory consumption during command execution is
  447.                        less than 2.5K.
  448.  
  449.    Passwords -         Each menu item may have a password assigned to
  450.                        it.  DOS Exit may be password protected.
  451.  
  452.    Screen Blank -      The screen will automatically be blanked after a
  453.                        defined time period has elapsed without any
  454.                        keyboard or mouse activity.  A small window
  455.                        containing a "screen blank message" is then
  456.                        displayed on the screen.  Screen blank time and
  457.                        message are easily modified.  Blank time may be
  458.                        set to any time between 0 and 99 minutes.  A
  459.                        screen blank time of 0 disables screen blanking.
  460.                        The "screen blank message" may contain up to 60
  461.                        characters of text.
  462.  
  463.    Execution Items -   You can execute one or more DOS programs and/or
  464.                        commands (including batch files), or load
  465.                        another menu file from each menu item.
  466.  
  467.    User Input -        Up to twenty items of user input may be prompted
  468.                        for prior to execution of a menu selection.
  469.                        Input is substituted into the commands.
  470.  
  471.    Easy Installation - An easy to use installation program is supplied,
  472.                        or you can manually install BCS Menu Program
  473.                        following the directions that appear in CHAPTER
  474.                        2 - INSTALLING BCS MENU PROGRAM.
  475.  
  476.    Program Control -   BCS Menu Program stays in control until you exit
  477.                        to DOS.  There is no need to add additional
  478.                        commands to restart BCS Menu Program - it
  479.                        automatically restarts on completion of an
  480.                        executed menu selection.
  481.  
  482.    Not a TSR -         BCS Menu Program is not a TSR.  It will not stay
  483.                        resident once it is exited.
  484.  
  485.    Color Editing -     One of the most intuitive color changing
  486.                        (editing) screens available.  Complete color
  487.                        control.  Palette control on EGA/VGA (choose
  488.                        from 64 colors in standard text mode).  Colors
  489.                        are defined in the menu file, not in the
  490.                        program, enabling different color selections for
  491.                        each menu file.
  492.  
  493.    Menu Editing -      Menu text may be edited on line - no need to
  494.                        start a separate application to edit the menu
  495.                        files.  Each of the following items may be
  496.                        edited on a per menu basis: menu title, DOS Exit
  497.                        password, screen blank time, screen blank
  498.                        message.
  499.  
  500.                         BCSMENU.DOC - Page 2
  501.  
  502.  
  503.                        You can add entries (up to 100 entries per
  504.                        menu), delete entries, or modify entries.  The
  505.                        following items may be edited on a per entry
  506.                        basis: menu selection password, menu prompt,
  507.                        item description, DOS/BCS Menu commands, prompts
  508.                        for user input.
  509.                        The menu file may be saved under the existing
  510.                        name or a new name.
  511.  
  512.  
  513.    SYSTEM REQUIREMENTS
  514.  
  515.    IBM Personal Computer PC, XT, AT, PS/2 or 100% Compatible.
  516.  
  517.    DOS 3.0 or Higher.
  518.  
  519.    512K Random Access Memory.
  520.  
  521.    Hard Drive or Network File Server recommended.
  522.  
  523.    Optional Microsoft compatible mouse.
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.                         BCSMENU.DOC - Page 3
  562.  
  563.  
  564.  
  565.    CHAPTER 2 - INSTALLING BCS MENU PROGRAM
  566.  
  567.  
  568.    BCS Menu Program is best utilized on computers that have a fixed disk
  569.    and/or use a network file server.  Although it may be used on a floppy
  570.    disk system, this is not recommended.
  571.  
  572.    Installation should proceed in the following order:
  573.        1.  Read the README file included with the BCS Menu Program files.
  574.        2.  Copy the appropriate files to your fixed disk.
  575.            (fixed disk is used throughout the remainder of this chapter
  576.            to mean fixed disk or network drive.)
  577.        3.  Modify AUTOEXEC.BAT.
  578.        4.  Customize the menus for your system.
  579.  
  580.  
  581.    1.  Read the README file.
  582.    The README file may contain instructions that have been added since this
  583.    manual was prepared.  Directions that appear there supersede directions
  584.    included here.  You can read this file on the screen a page at a time by
  585.    executing the following DOS command: TYPE README | MORE.
  586.  
  587.  
  588.    2.  Copy the appropriate files to your fixed disk.
  589.    An Installation program is supplied to automate this portion of program
  590.    installation.  You can either use the install program or copy the files
  591.    manually using the DOS COPY command.  It is recommended that you use the
  592.    install program.
  593.  
  594.  
  595.    A.  Using the Install Program.
  596.    To start the install program, type INSTALL at the DOS prompt (you might
  597.    have to specify a drive and/or path name if the BCS Menu Files are not
  598.    in the current directory).  For example if the BCS package is on your A
  599.    drive in the root directory you can start the install by typing
  600.    A:\INSTALL.  Answer the questions as they appear on the screen.  The
  601.    install program's final question will ask you for confirmation before it
  602.    copies any files - this gives you the opportunity to abort before any
  603.    files are actually copied.
  604.  
  605.    When the install program is activated the Bristol Computing Systems logo
  606.    screen will be displayed.
  607.    o   Press a key, for example the Enter key to continue.
  608.  
  609.    You are asked "Where To Install BCS Menu Program?".
  610.    o   Enter the drive destination and subdirectory name (eg. C:\BCSMENU).
  611.        The subdirectory does not have to already exist.
  612.  
  613.    You are then asked "Where Are the BCS Menu Files Now?".
  614.    o   If the BCS package is on your A drive in the root directory you
  615.        should type A:.
  616.  
  617.    You are then asked to confirm your answers.
  618.    o   If you want to change any of your answers to the previous questions
  619.        type "N" otherwise type "Y".
  620.  
  621.  
  622.                         BCSMENU.DOC - Page 4
  623.  
  624.  
  625.    If the installation subdirectory does not exist you are asked whether
  626.    the installation program should create it.
  627.    o   Type "N" if you don't want the install program to create the
  628.        directory (you will then be prompted to enter new directory names).
  629.        Type "Y" to have the install program create the subdirectory.
  630.  
  631.    You are then asked "Proceed with Menu Installation?".
  632.    o   Type "Y", the BCS Menu Program files will then be copied to the
  633.        drive/directory specified.
  634.    o   Type "N" to abort the installation.  You will be returned to the
  635.        DOS prompt.
  636.  
  637.  
  638.    B.  Copying BCS Menu Program with DOS.
  639.  
  640.    From the DOS prompt you can issue the following commands, assuming that
  641.    the BCS Menu Program files are on the A drive and that the files are to
  642.    be transferred to the C drive in the subdirectory C:\BCSMENU and that
  643.    the subdirectory exists on the C drive.  If the directory C:\BCSMENU
  644.    does not exist, execute the following DOS command to create it:  MKDIR
  645.    C:\BCSMENU.
  646.  
  647.    COPY A:BCSMENU.* C:\BCSMENU
  648.    COPY A:*.DOC C:\BCSMENU
  649.    COPY A:ADD2AUTO.BAT C:\BCSMENU
  650.  
  651.    If your system has a color monitor or an EGA/MCGA/VGA adapter with a
  652.    monochrome monitor issue the command:
  653.    COPY A:*.MNU C:\BCSMENU
  654.  
  655.    Otherwise, if your system has a monochrome display adapter with a
  656.    monochrome monitor issue the command:
  657.    COPY A:*.MDA C:\BCSMENU\*.MNU
  658.  
  659.  
  660.    3.  Modify AUTOEXEC.BAT.
  661.  
  662.    You should modify the file AUTOEXEC.BAT so that BCS Menu Program is
  663.    started automatically each time you turn on your computer.  (If you're
  664.    not familiar with how to modify AUTOEXEC.BAT, consult your DOS manual.)
  665.    The installation program automatically creates the file ADD2AUTO.BAT
  666.    which contains the appropriate lines for inclusion in AUTOEXEC.BAT.  You
  667.    can copy the lines from this file to the end of AUTOEXEC.BAT, or, you
  668.    can type the lines in manually.   The following lines should be added:
  669.        C:          (drive where BCS Menu Program is installed)
  670.        CD \BCSMENU (directory where BCS Menu Program is installed)
  671.        BCSMENU     (to start BCS Menu Program)
  672.  
  673.    These commands should be the last lines in AUTOEXEC.BAT.  If your
  674.    AUTOEXEC.BAT currently starts another program automatically (such as a
  675.    word processor or a spreadsheet program), you should remove activation
  676.    of that program and make it a selection in a BCS Menu.  Lines in
  677.    AUTOEXEC.BAT that start TSR's (programs that Terminate and Stay
  678.    Resident, such as SideKick) should be placed BEFORE the lines that you
  679.    insert to start BCS Menu Program.
  680.  
  681.  
  682.  
  683.                         BCSMENU.DOC - Page 5
  684.  
  685.  
  686.    4.  Customize the menus for your system.
  687.    Refer to CHAPTER 5 - EDITING A MENU FILE to customize the menu file for
  688.    your system.
  689.  
  690.  
  691.    OTHER CONSIDERATIONS
  692.  
  693.    The menu files (menu program files and menu definition files) normally
  694.    reside in a subdirectory together.  It is possible to separate the menu
  695.    definition files from the program files.  If you decide to separate the
  696.    program and menu definition files, the program files (BCSMENU.COM and
  697.    BCSMENU.OVL) must be in the same directory.  The default drive and
  698.    directory at the time BCS Menu Program is started must be the directory
  699.    where the program files are located.  The menu definition files may be
  700.    on any drive/subdirectory (including a network drive).  If the menu
  701.    definition files are on a different drive/subdirectory the complete path
  702.    name must be specified whenever a menu file is referenced.  These
  703.    references occur at menu start up and within the menu definition file
  704.    itself.  More on this in CHAPTER 5 - EDITING A MENU FILE.
  705.  
  706.  
  707.    USING A MOUSE
  708.  
  709.    BCS Menu Program checks for the presence of a mouse driver during
  710.    initialization.  In order to use a mouse, the mouse driver must be
  711.    started before BCS Menu Program.  (The mouse driver may be loaded in
  712.    CONFIG.SYS or in AUTOEXEC.BAT - consult the documentation that came with
  713.    your mouse.)
  714.  
  715.    It is also recommended that if you use any TSR programs that they be
  716.    loaded from your AUTOEXEC.BAT file before BCS Menu Program or from the
  717.    DOS prompt after exiting BCS Menu Program.  This is to prevent memory
  718.    fragmentation.  TSR's started from BCS Menu Program can trap
  719.    approximately 2.5K of memory that can be released only by uninstalling
  720.    the TSR (if possible) or rebooting.  See CHAPTER 6 - BCS MENU PROGRAM -
  721.    OPERATIONAL OVERVIEW for more details.
  722.  
  723.  
  724.    THE SAMPLE MENU FILES
  725.  
  726.    The sample menu that is initially displayed on your screen when you
  727.    start BCS Menu Program contains a Mini-Tutorial in the "Item
  728.    Description" window (the smaller double lined window in the center of
  729.    the screen).  You can get a good idea how to operate BCS Menu Program by
  730.    reading these windows.  Press the DOWN ARROW one time to read each
  731.    successive window.
  732.  
  733.    There are three sample menu files included with this version of BCS Menu
  734.    Program.  They are provided to act as a basis for the creation of your
  735.    own, real menu files.  Once you've read through these menus you should
  736.    edit them to start applications that you run frequently.  Please refer
  737.    to CHAPTER 5 - EDITING A MENU FILE for complete details on editing the
  738.    menu file.
  739.  
  740.  
  741.  
  742.  
  743.  
  744.                         BCSMENU.DOC - Page 6
  745.  
  746.  
  747.    CHAPTER 3 - USING BCS MENU PROGRAM
  748.  
  749.    If you have not yet installed BCS Menu Program on your system, please do
  750.    so now (see Chapter 2).  It's a good idea to modify AUTOEXEC.BAT to
  751.    automatically start BCS Menu Program as outlined in Chapter 2.  If you
  752.    have modified AUTOEXEC.BAT, you can simply reboot your computer to start
  753.    BCS Menu Program.  You can, however, start BCS Menu Program manually by
  754.    performing the following steps:
  755.    1.  Make the drive and directory where you installed BCS Menu Program
  756.        the default drive and directory.
  757.    2.  Type  BCSMENU.  Press ENTER.  The BCS Menu Program will start.
  758.  
  759.  
  760.    Start BCS Menu Program (by rebooting your computer or starting it
  761.    manually using the steps above).
  762.  
  763.    Once the program starts, you will see the BCS Menu Program logo screen
  764.    while the program is busy initializing menu parameters and reading the
  765.    menu definition file.  When initialization is complete the display will
  766.    change to a shareware notice screen.  (Please send your check to Bristol
  767.    Computing Systems, Inc. today if you've not already done so - we've
  768.    spent a lot of time creating this program - your contribution will
  769.    enable and encourage us to create other great software packages!)  Press
  770.    the SPACEBAR (or some other character generating key) to display the BCS
  771.    Menu screen.
  772.  
  773.  
  774.    A LITTLE GEOGRAPHY
  775.  
  776.    BCS Menu Program's Menu Screen is comprised of windows and a selection
  777.    bar.  A brief description of the items that make up the menu screen:
  778.  
  779.    Menu Window -       This is where all of the menu item prompts are
  780.                        displayed.  If there is a title, it is always
  781.                        displayed centered on the top line of this
  782.                        window (the top line of the screen).  The time,
  783.                        day and date are displayed on the next line in
  784.                        this window.
  785.    Selection Bar -     The selection bar is the reverse video bar that
  786.                        highlights the currently selected menu item's
  787.                        prompt (initially, the first menu item).  This
  788.                        bar can be moved by pressing the UP or DOWN
  789.                        ARROW keys, by typing the first character of the
  790.                        prompt, or by pointing to a prompt with the
  791.                        mouse and clicking once.
  792.    Item Description Window - is the smaller double lined window in the
  793.                        center of the screen.  This window will display
  794.                        up to 6 lines of descriptive information
  795.                        associated with the currently selected prompt.
  796.                        Press the ESC key to remove the item description
  797.                        window from the screen (or point to the ESC
  798.                        message at the bottom of the window with the
  799.                        mouse and click).  Press F2 to display it again.
  800.  
  801.  
  802.  
  803.  
  804.  
  805.                         BCSMENU.DOC - Page 7
  806.  
  807.  
  808.    Key Definition Window - is displayed at the very bottom of the screen.
  809.                        This is used to explain an action that may be
  810.                        performed by various keys.  Whenever there are
  811.                        more action keys than will fit in the window you
  812.                        can press F10 to see what other keys will do.
  813.                        (The action associated with the key does not
  814.                        change when you press F10, only the display in
  815.                        this window changes.)  The description of the
  816.                        keys in this window can also be used by the
  817.                        mouse - point to  any letter of the  key
  818.                        description with the mouse and click to perform
  819.                        the action!
  820.    Program Help Window - this window is not displayed initially.  Press
  821.                        F1 to display the program help window.  The
  822.                        program help window contains a more detailed
  823.                        description of the available action keys. Press
  824.                        ESC (or point at the ESC message at the bottom
  825.                        of the help window with the mouse and click) to
  826.                        remove the Program Help Window.
  827.  
  828.  
  829.    EXECUTING A MENU ITEM
  830.  
  831.    To execute a menu item, position the selection bar on the desired item
  832.    to be executed and press ENTER or double click with the mouse.
  833.  
  834.    You can position the selection bar using the mouse, the UP/DOWN ARROW
  835.    keys, or by pressing the first character of the prompt (if more than one
  836.    prompt starts with the same character, you may have to press the
  837.    character multiple times).
  838.  
  839.    If the item you have selected has a password assigned to it, you will be
  840.    prompted to enter the password.  Type in the password and press ENTER or
  841.    press ESC to abort executing the menu item.  If you make three wrong
  842.    attempts at entering the password, the password entry window will be
  843.    removed from the screen and you will be returned to the menu program.
  844.  
  845.    If a variable has been defined in the commands that will be executed by
  846.    the selected menu item, you will be prompted to enter the data for the
  847.    variable.  Follow the directions on the screen to enter the data.  Press
  848.    ENTER when you have finished entering the data or press ESC to abort
  849.    executing the menu item.  The data that you type is substituted into the
  850.    command sequence that is used to start the application or function that
  851.    you selected.
  852.  
  853.    BCS Menu Program sets a CHANGED flag when certain menu settings are
  854.    changed.  The CHANGED flag is checked whenever you execute a menu item
  855.    or Exit to DOS.  If the flag is set, a window will appear in the center
  856.    of the screen that asks if you want to save the current menu settings.
  857.    Press "N" or ESC if you don't want to save the current settings.  Press
  858.    "Y" if you do want to save the settings.  You will then be prompted for
  859.    a menu filename - see SAVING THE MENU DEFINITION FILE later in this
  860.    chapter for further explanation.
  861.  
  862.    The application or function you have selected will be executed.  Control
  863.    will return to BCS Menu Program when you exit the function or
  864.    application.
  865.  
  866.                         BCSMENU.DOC - Page 8
  867.  
  868.  
  869.  
  870.  
  871.    GETTING HELP
  872.  
  873.    You can display the help window for the Menu Screen by pressing F1.
  874.  
  875.  
  876.    DISPLAYING ITEM DESCRIPTION WINDOW
  877.  
  878.    You can display the Item Description Window by pressing F2.  You can
  879.    remove the Item Description Window by pressing ESC.  The CHANGED flag is
  880.    not affected by displaying or removing the Item Description Window.
  881.    When you save the menu file, the current state of the Item Description
  882.    Window is written to the menu file.  If you saved the file with Item
  883.    Description displayed, it will be displayed whenever you load that menu
  884.    file.
  885.  
  886.  
  887.    TURN SOUND ON OR OFF
  888.  
  889.    BCS Menu Program makes a distinctive sound when windows are initially
  890.    displayed or cleared from the screen.  You can turn the sound off or on
  891.    by pressing F3.  If the sound is ON, press F3 to turn it off.  If the
  892.    sound is OFF, press F3 to turn it on.  (The Key Definition Window will
  893.    always tell you what action F3 will take, it will turn the sound ON when
  894.    the F3-Sound On is shown, or turn sound OFF when F3-Sound Off is shown.)
  895.    Changing the sound setting sets the CHANGED flag that gets checked when
  896.    you execute a menu item or exit to DOS.
  897.  
  898.  
  899.    SCREEN BLANK
  900.  
  901.    BCS Menu Program will automatically blank the screen when a specified
  902.    time has elapsed without keyboard or mouse activity.  You can set the
  903.    time for screen blanking by pressing F4.  An entry window will appear in
  904.    the center of the screen.  Enter the time in minutes for screen blank
  905.    (from 0 to 99 minutes).  If you enter 0 (or 00), you disable the screen
  906.    blank function.  If you press ESC, the screen blank time will remain
  907.    unchanged.  Enter the screen blank time and press ENTER or just press
  908.    ENTER to leave the time unchanged.
  909.  
  910.    The entry window will change to the message that is displayed during
  911.    screen blank.  Type in a new message and press ENTER or just press ENTER
  912.    for no change.  The CHANGED flag is not affected by changing screen
  913.    blank time or the screen blank message.  The blank time and message will
  914.    be written to the menu file if you save the menu file after changing
  915.    these parameters.
  916.  
  917.  
  918.    EXIT TO DOS
  919.  
  920.    If the Program Help Window is displayed, press ESC to remove it.  If the
  921.    Item Description Window is displayed, press ESC to remove it.
  922.  
  923.    Press ESC to Exit to DOS.
  924.  
  925.    If the DOS Exit function has a password, you will be prompted to enter
  926.  
  927.                         BCSMENU.DOC - Page 9
  928.  
  929.  
  930.    it.  Press ESC to abort the Exit to DOS, or, type in the password and
  931.    press ENTER.  If you make three wrong attempts at entering the password,
  932.    the password entry window will be removed from the screen and you will
  933.    be returned to the menu program.  On correct entry of the password, you
  934.    will be returned to the DOS prompt.
  935.  
  936.    If there is not a password assigned, a confirmation window is displayed
  937.    in the center of the screen.  Press the letter "Y" to exit to DOS, press
  938.    "N" or ENTER to return to the menu.
  939.  
  940.  
  941.    CHANGING COLORS
  942.  
  943.    The colors used to display windows on the screen are saved in the menu
  944.    definition file (not in the program).  You can change the color settings
  945.    from the Color Change Screen.  Press F8 to change to the Color Change
  946.    Screen.  See Chapter 4 for a complete description of color changing.
  947.  
  948.  
  949.    SAVING THE MENU DEFINITION FILE
  950.  
  951.    You can save the current menu settings in the menu definition file by
  952.    pressing F9.  An entry window will be displayed asking you to enter the
  953.    name of the file to save the changes to - the name of the current menu
  954.    definition file is already in the entry field.  If you want to save the
  955.    changes to the current file, press ENTER, otherwise, type in a new
  956.    filename (you can include a drive and path name if desired) and press
  957.    ENTER.  The menu file will then be saved.  If an error occurs while
  958.    writing the menu file, you will be prompted for a new name.  Examples of
  959.    errors that can occur are when the menu file has been marked Read Only
  960.    or when your disk is full.  You might try a new filename or storing the
  961.    menu file to a different drive.
  962.  
  963.  
  964.    OTHER KEYS
  965.  
  966.    There are more keys defined for use than can be displayed with a clear
  967.    description in the Key Definition Window at the bottom of the screen.
  968.    To see how other keys are defined, press F10.  Other key definitions
  969.    will be displayed in the Key Definition Window.  Pressing F10 does not
  970.    change the function of keys, it simply shows how other keys are defined.
  971.  
  972.  
  973.    KEY SUMMARY
  974.  
  975.    DOWN ARROW -    Move selection bar down (in circular fashion)
  976.    UP ARROW -      Move selection bar up (in circular fashion)
  977.    ESC -           Remove program Help Window, Item Description Window,
  978.                    Exit to DOS
  979.    F1 -            Display program Help Window
  980.    F2 -            Display Item Description Window
  981.    F3 -            Turn Sound On or Off
  982.    F4 -            Modify Screen Blank Time, Screen Blank Message
  983.    F8 -            Change to Color Editing Screen
  984.    F9 -            Save menu file
  985.    F10 -           Show other key definitions in Key Definition Window
  986.  
  987.  
  988.                         BCSMENU.DOC - Page 10
  989.  
  990.  
  991.    CHAPTER 4 - CHANGING THE COLORS
  992.  
  993.    To change menu colors, display the Color Change Screen.
  994.  
  995.    Press F8 from the Menu Screen to enter the Color Change Screen.
  996.  
  997.    The color change screen displays a miniature of the menu screen.  On the
  998.    right of the screen are two additional windows that show the available
  999.    colors that can be used in each of the windows.  For each window on the
  1000.    menu screen you can specify a foreground color and a background color.
  1001.  
  1002.    If you have an EGA, MCGA or VGA adapter with a monochrome monitor,
  1003.    colors are gray scaled.  EGA/VGA users can modify the color palette
  1004.    using BCS Menu Program (more on this later).  If you have a Monochrome
  1005.    Display Adapter (MDA), colors are shown as BLANK, NORMAL or BOLD blocks.
  1006.  
  1007.    Arrows are used as pointers.  The arrow on the left side of the screen
  1008.    will always point to a model of one of the following windows:
  1009.            Menu Window
  1010.            Selection Bar
  1011.            Item Description Window
  1012.            Program Help Window
  1013.            Key Definition Window
  1014.  
  1015.    There are also arrows in each of the color windows, the foreground color
  1016.    and the background color.  The arrows in the foreground color window and
  1017.    the background color window show what the current setting is for the
  1018.    selected "model" window.
  1019.  
  1020.    Only one of the three arrows is active at any time; the active arrow is
  1021.    the blinking arrow.  The blinking arrow can be moved by using the UP and
  1022.    DOWN ARROW keys.  When the active arrow is on the left side of the
  1023.    screen and is moved between the model windows, the arrows in the
  1024.    foreground color window and in the background color window will also
  1025.    move to show the current color settings.
  1026.  
  1027.    The video mode used by this program allows use of 16 colors at the same
  1028.    time.  The 16 colors are shown in the foreground color window.  (Only
  1029.    eight colors may be used as background colors - the other eight colors
  1030.    cause the text to blink.)
  1031.  
  1032.  
  1033.    TO CHANGE A WINDOW'S COLOR
  1034.  
  1035.        1.  Select the model window you want change. Use the UP/DOWN ARROW
  1036.            keys to move between the model windows.
  1037.        2.  Change the active arrow.  You can move the active arrow to the
  1038.            foreground color window by pressing the TAB key or RIGHT ARROW
  1039.            once.  You can move the active arrow to the background color
  1040.            window by pressing the TAB key or the RIGHT ARROW key twice.
  1041.        3.  Position the active arrow by using the UP/DOWN ARROW keys to
  1042.            the desired color.  The corresponding model window will change
  1043.            color as you move the active arrow in one of the color
  1044.            windows.
  1045.        4.  Repeat the process moving the active arrow back to the model
  1046.            windows.  (You can also change the active arrow by using the
  1047.            SHIFT TAB key and the LEFT ARROW key.)
  1048.  
  1049.                         BCSMENU.DOC - Page 11
  1050.  
  1051.  
  1052.  
  1053.    USING THE MOUSE TO CHANGE WINDOW COLORS
  1054.  
  1055.    The active arrow is automatically updated based on the position of the
  1056.    mouse cursor when the mouse is clicked.
  1057.        1.  Select the model window you want to change by positioning the
  1058.            mouse cursor anywhere in the window and clicking.
  1059.        2.  Position the mouse cursor on the desired foreground or
  1060.            background color and click.  The color of the model window
  1061.            will change accordingly.
  1062.  
  1063.  
  1064.    CHANGING PROMPT COLORS
  1065.  
  1066.    You can select a color for each and every prompt from the Color Change
  1067.    Screen.  To change the color of one or more prompts press F3 - the
  1068.    prompts will now be displayed in the model Menu Window.  The blinking
  1069.    arrow will point to the first prompt.  The color windows will be
  1070.    replaced by a single foreground color window (the prompts are always
  1071.    displayed in the Menu Window on the background selected for that window,
  1072.    therefore, you cannot change the background color for an individual
  1073.    prompt).
  1074.  
  1075.  
  1076.    TO CHANGE THE COLOR OF A PROMPT
  1077.  
  1078.        1.  Select the prompt you want change. Use the UP/DOWN ARROW keys
  1079.            to move between the prompts, scrolling will occur if
  1080.            necessary.
  1081.        2.  Change the active arrow to the foreground color window.  You
  1082.            can change the active arrow by pressing the TAB key or the
  1083.            RIGHT ARROW key.
  1084.        3.  Position the active arrow using the UP/DOWN ARROW keys to the
  1085.            desired color.  The corresponding prompt will change color as
  1086.            you move the active arrow in the foreground color window.
  1087.        4.  Repeat the process moving the active arrow between the prompts
  1088.            and the foreground color window.  The TAB, SHIFT TAB, RIGHT
  1089.            and LEFT ARROW keys may be used to switch between windows.
  1090.  
  1091.  
  1092.    USING THE MOUSE TO CHANGE PROMPT COLORS
  1093.  
  1094.        1.  Select the prompt you want to change by positioning the mouse
  1095.            cursor anywhere on the prompt and clicking.
  1096.        2.  Position the mouse cursor in the foreground color window on
  1097.            the desired color and click.  The color of the prompt will
  1098.            change accordingly.
  1099.  
  1100.  
  1101.    CHANGING WINDOW/PROMPT COLORS
  1102.  
  1103.    The F3 key is used to switch between the change window color screen and
  1104.    the change prompt color screen.  As explained above the window color
  1105.    screen contains the model windows and the foreground and background
  1106.    color selection  windows.  The prompt color screen contains the prompts
  1107.    and the foreground color window.
  1108.  
  1109.  
  1110.                         BCSMENU.DOC - Page 12
  1111.  
  1112.  
  1113.  
  1114.    CHANGING COLORS ON AN MDA
  1115.  
  1116.    Obviously, you can't change colors on a monochrome display adapter
  1117.    (MDA)!  You can, however, change the attributes used for displaying the
  1118.    menu screens.
  1119.  
  1120.    You can select from the following attributes:
  1121.        NORMAL      White text on a black background
  1122.        BOLD        Bright white text on a black background
  1123.        REVERSE     Black text on a white background
  1124.        UNDERLINED  White underlined text on a black background
  1125.  
  1126.    The foreground color and background color windows only display blank,
  1127.    normal or bold blocks.  It is not obvious how to position the color
  1128.    window arrows to achieve a desired attribute on an MDA.  We therefore
  1129.    recommend the following procedure to change attributes:
  1130.  
  1131.  
  1132.    TO CHANGE WINDOW ATTRIBUTES ON AN MDA
  1133.  
  1134.        1.  Position the active arrow on the desired model window.
  1135.        2.  Change the active arrow to the Foreground window by pressing
  1136.            the RIGHT ARROW or TAB key.  Position the arrow on the top
  1137.            most position in the window by pressing the UP ARROW if
  1138.            necessary.  Press the DOWN ARROW the number of times indicated
  1139.            below for the desired attribute:
  1140.                Attribute   Press DOWN ARROW
  1141.                NORMAL           7 times
  1142.                BOLD            15 times (or press UP ARROW 1 time)
  1143.                REVERSE          0 times
  1144.                UNDERLINE        1 time
  1145.        3.  Change the active arrow to the Background window by pressing
  1146.            the RIGHT ARROW or TAB key.  Position the arrow on the top
  1147.            most position in the window by pressing the UP ARROW if
  1148.            necessary.  Press the DOWN ARROW (for each press the blinking
  1149.            arrow will move down two lines) the number of times indicated
  1150.            below for the desired attribute:
  1151.                Attribute   Press DOWN ARROW
  1152.                NORMAL           0 times
  1153.                BOLD             0 times
  1154.                REVERSE          7 times (or press UP ARROW 1 time)
  1155.                UNDERLINE        0 times
  1156.        4.  Repeat the process moving the active arrow between the model
  1157.            windows and the color windows as outlined above.
  1158.  
  1159.  
  1160.    USING THE MOUSE TO CHANGE WINDOW ATTRIBUTES
  1161.  
  1162.    The active arrow is automatically updated based on the position of the
  1163.    mouse cursor when the mouse is clicked.
  1164.        1.  Select the model window you want to change by positioning the
  1165.            mouse cursor anywhere in the window and clicking.
  1166.        2.  Position the mouse cursor on the desired foreground or
  1167.            background line and click.  The attribute of the model window
  1168.            will change accordingly.
  1169.  
  1170.  
  1171.                         BCSMENU.DOC - Page 13
  1172.  
  1173.  
  1174.  
  1175.    TO CHANGE THE ATTRIBUTE OF A PROMPT ON AN MDA
  1176.  
  1177.    You must first display the prompts in the model Menu Window (press F3 if
  1178.    the prompts are not displayed).
  1179.  
  1180.        1.  Select the prompt you want change. Use the UP/DOWN ARROW keys
  1181.            to move between the prompts.
  1182.        2.  Change the active arrow to the foreground color window.  You
  1183.            can change the active arrow by pressing the TAB key or the
  1184.            RIGHT ARROW key.
  1185.        3.  Position the active arrow using the UP/DOWN ARROW keys.  The
  1186.            attributes available for the prompt are dependent on the Menu
  1187.            Window's background color.  Many of the attributes have the
  1188.            same settings so when you press the DOWN ARROW the displayed
  1189.            attribute may not change.
  1190.        4.  Repeat the process moving the active arrow between the prompts
  1191.            and the foreground color window.
  1192.  
  1193.  
  1194.    USING THE MOUSE TO CHANGE PROMPT ATTRIBUTES
  1195.  
  1196.        1.  Select the prompt you want to change by positioning the mouse
  1197.            cursor anywhere on the prompt and clicking.
  1198.        2.  Position the mouse cursor in the foreground color window on
  1199.            the desired line and click.  Watch as the prompt changes in
  1200.            accordance with your selection.
  1201.  
  1202.  
  1203.    CHANGING THE COLOR PALETTE ON EGA/VGA
  1204.  
  1205.    There are 16 colors available in the video mode used by BCS Menu
  1206.    Program.  The 16 colors that are available are defined in a palette.
  1207.    The EGA and VGA hardware allows reprogramming of the palette.  This
  1208.    means that even though you can only use 16 colors at a time, it is
  1209.    possible to select  which colors are used.  There are 64 possible colors
  1210.    that can be used by the palette (numbered from 0 to 63).  BCS Menu
  1211.    Program allows you to define the palette that gets used while it is
  1212.    active.
  1213.  
  1214.    The current palette number is displayed in the palette windows
  1215.    underneath the Foreground Color and Background Color windows.  Palette
  1216.    windows are not displayed on an MDA or CGA.
  1217.  
  1218.  
  1219.    TO CHANGE THE PALETTE
  1220.  
  1221.        1.  Position the blinking arrow at the color to be changed in
  1222.            either the Foreground or the Background color window.
  1223.        2.  Press the '+' key to add to the palette number.  The number
  1224.            displayed in the palette window will change accordingly.
  1225.        3.  Press the '-' key to subtract from the palette number.  The
  1226.            number displayed in  the palette window  will change
  1227.            accordingly.
  1228.  
  1229.  
  1230.  
  1231.  
  1232.                         BCSMENU.DOC - Page 14
  1233.  
  1234.  
  1235.    TO CHANGE THE PALETTE USING THE MOUSE
  1236.        1.  Click on the '+' or '-' sign in the palette window under the
  1237.            color window.  The palette number will increment or decrement
  1238.            with each click of the mouse.
  1239.  
  1240.    As you change the palette definition of a color you will notice that
  1241.    anything on the screen that uses the color you are changing will
  1242.    immediately change to the new palette definition.  Saving the menu will
  1243.    save the new palette settings in the menu definition file so that the
  1244.    colors are used every time you load that menu.
  1245.  
  1246.  
  1247.    RESTORE COLORS
  1248.  
  1249.    You can restore the color definition to the pre-edited state by pressing
  1250.    F2.  Any changes that were entered since the last time the menu file was
  1251.    saved are discarded.
  1252.  
  1253.  
  1254.    EDITING A MENU FILE
  1255.  
  1256.    The text portion of the menu can be changed from the Menu Edit Screen.
  1257.    Press the F8 from the Color Change Screen.  Your screen will change to
  1258.    the Menu Edit Screen.  See Chapter 5 for more information.
  1259.  
  1260.  
  1261.    SAVING THE MENU DEFINITION FILE
  1262.  
  1263.    You can save the color changes and all other changes made to the menu
  1264.    definition file by pressing F9.  An entry window will be displayed
  1265.    asking you to enter the name of the file to save the changes to - the
  1266.    name of the current menu definition file is already in the entry field.
  1267.    If you want to save the changes to the current file, press ENTER,
  1268.    otherwise, type in a new filename (you can include a drive and path name
  1269.    if desired) and press ENTER.  The menu file will then be saved.  If an
  1270.    error occurs while writing the menu file, you will be prompted for a new
  1271.    name.  Examples of errors that can occur are when the menu file has been
  1272.    marked Read Only or when your disk is full.  You might try a new
  1273.    filename or storing the menu file to a different drive.
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.                         BCSMENU.DOC - Page 15
  1294.  
  1295.  
  1296.    KEY SUMMARY
  1297.  
  1298.    DOWN ARROW  Move selection arrow down in circular fashion.
  1299.    UP ARROW    Move selection arrow up in circular fashion.
  1300.    +           When a color window is selected increments the palette
  1301.                number in a circular fashion (Only on EGA/VGA systems).
  1302.    -           When a color window is selected decrements the palette
  1303.                number in a circular fashion (Only on EGA/VGA systems).
  1304.    TAB/RIGHT ARROW     Changes selected window by moving to the right
  1305.                in a circular manner.
  1306.    SHIFT-TAB/LEFT ARROW    Changes selected window by moving to the
  1307.                left in a circular manner.
  1308.    ESC         Exit to Menu Screen.
  1309.    F1          Help.
  1310.    F2          Restore color settings.
  1311.    F3          Change between prompts and window color editing.
  1312.    F8          Activate menu text editor.
  1313.    F9          Save menu.
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.                         BCSMENU.DOC - Page 16
  1355.  
  1356.  
  1357.    CHAPTER 5 - EDITING A MENU FILE
  1358.  
  1359.    BCS Menu Program includes an on-line menu editor.  You can add up to 100
  1360.    entries per menu, delete all but one entry or modify existing entries.
  1361.    All menu settings are stored in a menu definition file.  There is no
  1362.    need to load a separate module or a text editor to create or modify a
  1363.    menu definition file.  This makes it easy to interactively design your
  1364.    menus - you can press ESC two times to return to the Menu Screen to view
  1365.    the current settings.  You can go back and forth between the Menu Edit
  1366.    Screen and the Menu Screen and make changes until you are satisfied.
  1367.  
  1368.    To edit the menu press F8 from the Color Change Screen.  (If you're at
  1369.    the Menu Screen, press F8 two times to enter the Menu Edit Screen.)
  1370.    Your screen will change to the Menu Edit Screen.
  1371.  
  1372.    The term "menu item" is used throughout the remainder of this chapter.
  1373.    The menu item consists of up to five parts.  The parts of a menu item
  1374.    are:
  1375.  
  1376.        o   The password (optional).
  1377.        o   The prompt (the text displayed on the Menu Screen used for
  1378.            selection of the menu item).
  1379.        o   The item description (optional - up to 6 lines of "help" for
  1380.            this menu item; displayed in the item description window of
  1381.            the Menu Screen).
  1382.        o   The commands (up to 12 lines of DOS/BCS Menu commands that are
  1383.            executed when you select the menu item from the Menu Screen).
  1384.        o   User Input Variables/Prompts (optional - you can prompt the
  1385.            user for input prior to executing a menu item - the input is
  1386.            substituted into the commands).
  1387.  
  1388.    The Menu Edit Screen allows you to perform the following actions:
  1389.        o   Edit a menu item (you can edit all five parts).
  1390.        o   Restore the menu (abort all edits).
  1391.        o   Delete a menu item.
  1392.        o   Insert a new menu item.
  1393.        o   Edit the menu title.
  1394.        o   Edit the DOS Exit password.
  1395.        o   Set the spacing for prompt display on the Menu Screen (single,
  1396.            double or triple spaced).
  1397.        o   Set the number of columns for prompt display on the Menu
  1398.            Screen (up to 10 columns).
  1399.        o   Move a menu item.
  1400.        o   Sort the menu items (alphabetically in ascending or descending
  1401.            order).
  1402.        o   Save the menu definition file.
  1403.  
  1404.    You can create an entirely new menu by editing menu items, deleting
  1405.    unwanted items and inserting new ones.  You then save the resulting menu
  1406.    using a different menu filename.
  1407.  
  1408.  
  1409.    MENU EDIT SCREEN DISPLAY
  1410.  
  1411.    The Menu Edit Screen is similar to the Menu Screen.  The differences
  1412.    are; the Menu Edit Screen uses a blinking arrow in place of the
  1413.    selection bar, there is no item description window, there is only one
  1414.  
  1415.                         BCSMENU.DOC - Page 17
  1416.  
  1417.  
  1418.    column of prompts aligned at the left side of the screen, and the Menu
  1419.    Edit Screen title is displayed.
  1420.  
  1421.  
  1422.    ABOUT MENU EDITING
  1423.  
  1424.    All changes (edits) are typed into an "edit window".  An edit window
  1425.    will be displayed to allow you to change each element of the menu item,
  1426.    the menu title and the DOS Exit password.  The windows are displayed
  1427.    sequentially.  You can elect not to make any changes in a particular
  1428.    edit window by pressing ENTER (or by pressing F10 when this key is
  1429.    displayed as an option on the bottom line of the edit window).  You may
  1430.    press ESC while an edit window is displayed to abort the edit.
  1431.  
  1432.  
  1433.    KEY USAGE IN AN EDIT WINDOW
  1434.  
  1435.    The definition of keys used during editing is displayed on the bottom of
  1436.    the screen in the Key Definition Window.  The mouse can be used to
  1437.    perform the function of the keys displayed in the Key Definition Window
  1438.    by positioning the mouse cursor on any letter of the description and
  1439.    clicking once.
  1440.  
  1441.    Each edit window contains a title that tells you which element you are
  1442.    changing.  The bottom line of the edit window always lists keys used to
  1443.    end or abort the edit.  You can position the mouse on any letter of
  1444.    these key descriptions and click once to select it.  The key definitions
  1445.    and the functions they perform are:
  1446.  
  1447.    KEY             ACTION
  1448.    ----------      ------
  1449.    ESC             Abort the edit (all elements revert to their pre-
  1450.                    edit state).  This option is displayed on the bottom
  1451.                    line of the edit window.
  1452.    BACKSPACE       Delete the character to the left of the cursor (if
  1453.                    the cursor is in the first position, no action is
  1454.                    taken).
  1455.    LEFT ARROW      Move the cursor left.
  1456.    RIGHT ARROW     Move the cursor right.
  1457.    ENTER           End the line - the text on the current line is
  1458.                    saved.  If the cursor is on the bottom line (or only
  1459.                    line) of an edit window, the next edit window, if
  1460.                    any, is displayed.  This option is displayed on the
  1461.                    bottom line of the edit window.
  1462.    DEL             Delete the character at the cursored position.
  1463.    END             Move the cursor to the end of the text line.
  1464.    INSERT          Turn Insert Mode On or Off.  Insert mode is ON when
  1465.                    the cursor is full size.  Insert mode is OFF when
  1466.                    the cursor is an underscore.
  1467.    HOME            Position the cursor to the start of the line.
  1468.    F10             The F10 key allows you to end the current edit
  1469.                    window and to switch to the next edit window.  Text
  1470.                    on all lines of the edit window is saved.  The F10
  1471.                    key is shown on the bottom line of the edit window
  1472.                    when it is available.
  1473.  
  1474.  
  1475.  
  1476.                         BCSMENU.DOC - Page 18
  1477.  
  1478.  
  1479.    The following keys are active only if the edit window has multiple lines
  1480.    (item description and commands edit windows).
  1481.  
  1482.    F3              Delete the line at the cursor (moves following lines
  1483.                    up by one line)
  1484.    F4              Insert a blank line at the cursor (if there is any
  1485.                    text on the bottom line of the window it will be
  1486.                    lost - moves following lines down by one line)
  1487.    UP ARROW        Edit the line above the cursored line (no action if
  1488.                    the cursor is on the top line of the edit window)
  1489.    DOWN ARROW      Edit the line below the cursored line (no action if
  1490.                    the cursor is on the bottom line of the edit window)
  1491.  
  1492.  
  1493.    RESERVED CHARACTER
  1494.  
  1495.    The Double Quote character (") is never allowed during text entry in an
  1496.    edit window.  This character is reserved for use by BCS Menu Program as
  1497.    part of the Menu Definition File.  If you need quote characters, use the
  1498.    single quote characters.
  1499.  
  1500.    Certain characters are restricted from entry in particular edit windows.
  1501.    A password, for instance, may only contain alphabetic or numeric
  1502.    characters.  If a character is not allowed in an edit window, it will
  1503.    not be displayed when you type it.  The descriptions below explain which
  1504.    characters are allowed for each item.
  1505.  
  1506.  
  1507.    TO CHANGE A MENU ITEM
  1508.  
  1509.        o   Position the blinking arrow so that it points to the menu item
  1510.            to be changed.  (Use the UP/DOWN ARROW keys or point with the
  1511.            mouse and click once.)
  1512.        o   Press ENTER or double click with the mouse.
  1513.  
  1514.    If the menu item you have selected has a password associated with it,
  1515.    the password must be entered before you can change the menu item.  If
  1516.    there is a password, a password entry window will be displayed.  Enter
  1517.    the password and press ENTER.  (You can press ESC to abort password
  1518.    entry which also aborts the edit.)  If you incorrectly enter the
  1519.    password three times, the password window will be removed from the
  1520.    screen and you will not be permitted to change the entry.
  1521.  
  1522.  
  1523.    ENTERING/CHANGING THE MENU ITEM PASSWORD
  1524.  
  1525.    If you correctly enter the password (above) or if there is no password
  1526.    associated with the entry you are editing, a password edit window will
  1527.    be displayed on the screen.
  1528.  
  1529.    A password may contain up to 15 alphabetic and/or numeric characters.
  1530.  
  1531.    Type in a new password or edit the existing password.  If you don't want
  1532.    a password associated with this entry, delete all characters from the
  1533.    entry field.  Press ENTER or F10 to save the password field and display
  1534.    the next edit window.  You may press ESC to abort the edit.  All menu
  1535.    item fields will revert to their pre-edited state.
  1536.  
  1537.                         BCSMENU.DOC - Page 19
  1538.  
  1539.  
  1540.    If you enter a password, the user will be prompted to enter the password
  1541.    before the menu item may be executed.
  1542.  
  1543.  
  1544.    ENTERING/CHANGING THE MENU ITEM PROMPT
  1545.  
  1546.    The password Entry Window will be removed from the screen and the menu
  1547.    item prompt edit window will then be displayed.  (The menu item prompt
  1548.    is displayed on the Menu Screen - it is this item that is selected by
  1549.    the user with the selection bar.)
  1550.  
  1551.    A menu item prompt may be up to 76 characters long.  Any displayable
  1552.    ASCII character is allowed (those that have an ASCII character value
  1553.    less than or equal to 128).
  1554.  
  1555.    Edit the existing prompt.  A menu item prompt must contain at least one
  1556.    character.  Press ENTER or F10 to save the prompt field and display the
  1557.    next edit window.  If you leave the field blank, an error window will
  1558.    pop-up informing you that you need to have at least one valid character.
  1559.    You may press ESC to abort the edit.  All menu item fields will revert
  1560.    to their pre-edited state.
  1561.  
  1562.    Note:   The display width of the menu item prompt is computed by BCS
  1563.            Menu Program based on the line spacing and number of columns
  1564.            of prompts on the Menu Screen.  (You can select the line
  1565.            spacing or the number of columns; see SET SPACING/NUMBER OF
  1566.            COLUMNS below.)  The width of the edit line in the menu item
  1567.            prompt edit window is this computed width.  If your prompt is
  1568.            longer than the computed width the edit line will scroll
  1569.            horizontally to allow you to edit the entire entry.  If the
  1570.            number of prompt columns changes the display width will be
  1571.            recomputed.
  1572.  
  1573.  
  1574.    ENTERING/CHANGING THE ITEM DESCRIPTION
  1575.  
  1576.    The menu item description edit window will be displayed overlapping the
  1577.    last line of the menu item prompt edit window.  (Text entered here is
  1578.    displayed in the Item Description Window on the Menu Screen when the
  1579.    selection bar is positioned on the menu item prompt.)
  1580.  
  1581.    A menu item description can contain up to 6 lines, each line may be up
  1582.    to 68 characters long.  Any displayable ASCII character is allowed
  1583.    (those that have an ASCII character value less than or equal to 128).
  1584.  
  1585.    Text in this window is optional.  You may leave all lines blank, or you
  1586.    can type any text you wish.  The line you are editing will appear at the
  1587.    left margin of the edit field; all other existing lines in the item
  1588.    description are centered.  When you finish editing a line and press
  1589.    ENTER or the DOWN ARROW to edit the next line, the text in the line just
  1590.    edited is automatically centered.  You can use the UP/DOWN ARROW keys to
  1591.    edit previous or next lines in this edit window.  You can use F3 to
  1592.    delete the line at the cursored position.  You can use F4 to insert a
  1593.    new line at the cursored position.
  1594.  
  1595.    If the cursor is at the last line in the window, press ENTER to save all
  1596.    lines of the Item Description and display the next edit window.  You may
  1597.  
  1598.                         BCSMENU.DOC - Page 20
  1599.  
  1600.  
  1601.    press F10 at any time to save all lines and display the next edit
  1602.    window.  If you leave all lines in the Item Description blank, the
  1603.    message "No further information available for this selection" is
  1604.    displayed in the item description window on the Menu Screen.  You may
  1605.    press ESC to abort the edit.  All menu item fields will revert to their
  1606.    pre-edited state.
  1607.  
  1608.  
  1609.    ENTERING/CHANGING THE MENU ITEM COMMANDS
  1610.  
  1611.    When you have finished editing the Item Description, the window will be
  1612.    removed from the screen and will be replaced by the menu item commands
  1613.    edit window.  (The menu item commands are the commands that get executed
  1614.    when you press ENTER or double click the mouse on a menu item prompt in
  1615.    the Menu Screen.)
  1616.  
  1617.    Menu item commands can contain up to 12 lines, each line may be up to 78
  1618.    characters long.  Any displayable ASCII character is allowed (those that
  1619.    have an ASCII character value less than or equal to 128).
  1620.  
  1621.    Enter a DOS command, the name of a batch file or the name of a program
  1622.    to be executed one command per line.  (You can also load another menu
  1623.    file or specify a user input variable on a command line, more on this
  1624.    later.)  You can use the UP/DOWN ARROWS to move to the next or previous
  1625.    line.  You can use F3 to delete the line at the cursored position.  You
  1626.    can use F4 to insert a new line at the cursored position.  The ENTER key
  1627.    will also move to the next line unless you are on the last line in the
  1628.    window, in which case it will end the commands edit session.  Press F10
  1629.    to save all commands and end commands editing.  You may press ESC to
  1630.    abort the edit.  All menu item fields will revert to their pre-edited
  1631.    state.
  1632.  
  1633.    DO NOT ADD COMMANDS TO RETURN TO THE BCS MENU PROGRAM DIRECTORY AND
  1634.    START BCS MENU PROGRAM AGAIN.  BCS MENU PROGRAM WILL DO THIS
  1635.    AUTOMATICALLY.
  1636.  
  1637.    Each line that contains a command must have at least one character.
  1638.    Blank lines are not allowed.  If you press ENTER or the DOWN ARROW on a
  1639.    blank line, an error window will pop-up informing you that you must have
  1640.    at least one character per command line.
  1641.  
  1642.    It is not recommended that you start TSR (Terminate and Stay Resident)
  1643.    programs from BCS Menu Program.  This may cause memory fragmentation
  1644.    which can only be fixed by rebooting your computer or by unloading the
  1645.    TSR if that is possible.
  1646.  
  1647.  
  1648.    LOADING A NEW MENU FILE
  1649.  
  1650.    You can load and execute a new menu by indicating the name of a menu
  1651.    file preceded by the at sign (@) as the first and only line in the
  1652.    commands edit window.  For instance, to load a menu file called
  1653.    DOSMENU.MNU, the first and only command line should be:
  1654.            @DOSMENU.MNU
  1655.    Other commands inserted after this command will not be executed.  The @
  1656.    character as the first character on the first line in the commands edit
  1657.    window indicates that the name of a menu file follows.  The @ character
  1658.  
  1659.                         BCSMENU.DOC - Page 21
  1660.  
  1661.  
  1662.    may be used freely in any other position on any line of the commands
  1663.    edit window.  A new menu will only be loaded if this command is on the
  1664.    first line in the commands edit window.  If this appears on any other
  1665.    line, DOS will attempt to execute this as a command and will generate an
  1666.    error message.
  1667.  
  1668.  
  1669.    SPECIFYING USER INPUT VARIABLES
  1670.  
  1671.    You can prompt the user for input prior to command execution by
  1672.    inserting one or more User Input Variables on any line in the commands
  1673.    edit window.  The variable may be used as a part of a command line or as
  1674.    the entire command line.
  1675.  
  1676.    The percent sign (%) followed by up to 8 Alphabetic and/or Numeric
  1677.    characters indicates the name of a User Input Variable.  The first non-
  1678.    alphabetic or non-numeric character (or the 9th character) indicates the
  1679.    User Input Variable name has ended.  This character may begin a new User
  1680.    Input Variable name or is a part of the DOS command line.  You can
  1681.    specify up to 20 User Input Variables per menu item (per commands edit
  1682.    window).  Additional variable names will be ignored by BCS Menu Program
  1683.    and will be passed on to DOS as executable commands.
  1684.  
  1685.    The text the user types when executing this menu item is substituted in
  1686.    the command buffer at the location of the variable.
  1687.  
  1688.    When you have finished editing the commands edit window and press F10 to
  1689.    end the edit, the edit buffer is searched for User Input Variables (for
  1690.    the percent sign).  If any variable names are found a window appears,
  1691.    one after another, for each variable name found in the commands buffer.
  1692.    You are requested to enter a prompt that will be displayed when the user
  1693.    executes this menu item.  Enter a prompt suitable for the information
  1694.    you are attempting to obtain from the user.
  1695.  
  1696.    Prompts for User Input Variables may be up to 64 characters long.  Any
  1697.    displayable ASCII character is allowed (those that have an ASCII
  1698.    character value less than or equal to 128).
  1699.  
  1700.  
  1701.    EXAMPLES OF USER INPUT VARIABLES
  1702.  
  1703.    An example of how user input variables might be used is given here.  The
  1704.    The edit window for a menu item that allows the user to run any program
  1705.    on any drive might appear as follows:
  1706.        %DRIVE:
  1707.        CD \%DIRECTRY
  1708.        %PROGRAM
  1709.  
  1710.    You will be requested to enter a prompt for the %DRIVE variable (the
  1711.    colon is not alphabetic or numeric so it ends the variable name).  A
  1712.    suitable prompt might be "Enter the Drive the Program Resides On".  If
  1713.    the user types "C" then the letter "C" replaces %DRIVE resulting in "C:"
  1714.    as the command passed to DOS.
  1715.  
  1716.    You will then be requested to enter a prompt for %DIRECTRY.  (%DIRECTORY
  1717.    is 9 characters long and is therefore not a valid variable name.  If you
  1718.    entered %DIRECTORY, only 8 characters are valid as a variable name so
  1719.  
  1720.                         BCSMENU.DOC - Page 22
  1721.  
  1722.  
  1723.    %DIRECTOR would be the resulting variable name; the letter "Y" would be
  1724.    passed to DOS as part of the command.)  A suitable prompt for this
  1725.    variable might be "Enter the Directory Name of the Program".  If the
  1726.    user types "WORK", the resulting command will be "CD \WORK".
  1727.  
  1728.    You will be requested to enter a prompt for %PROGRAM.  A suitable prompt
  1729.    might be "Enter the Name of the Program to Run".  If the user types "WP"
  1730.    for word processing, the resulting command passed to DOS will be "WP".
  1731.    A program by the name of WP will be started.
  1732.  
  1733.    If the user responds by typing the items indicated above, the resulting
  1734.    commands passed to DOS will be:
  1735.  
  1736.        C:
  1737.        CD \WORK
  1738.        WP
  1739.  
  1740.  
  1741.    EDITING A MENU ITEM REPEATEDLY
  1742.  
  1743.    You may edit each menu item as many times as you like.  You can skip
  1744.    over editing any particular window by pressing F10.  The next edit
  1745.    window will then be displayed.
  1746.  
  1747.  
  1748.    GETTING HELP
  1749.  
  1750.    You can display the help window for the Menu Edit Screen by pressing F1.
  1751.  
  1752.  
  1753.    RESTORE MENU
  1754.  
  1755.    You can restore the menu definition file to it's pre-edited state by
  1756.    pressing F2.  Any editing that has occurred will be replaced with the
  1757.    last saved state.  The state is saved when you first load a menu file
  1758.    and each time you save the menu file.
  1759.  
  1760.  
  1761.    DELETE A MENU ITEM
  1762.  
  1763.    You can delete a menu item (and all of the fields associated with it) by
  1764.    positioning the blinking arrow on the item to be deleted and pressing
  1765.    F3.  If the menu item has a password associated with it, you will be
  1766.    prompted to enter the password before the menu item can be deleted.  If
  1767.    you enter the password correctly, the menu item will be deleted.  You
  1768.    may press ESC during password entry to abort the delete.  You can
  1769.    restore deleted items prior to saving the menu file by pressing F2 -
  1770.    Restore Menu.
  1771.  
  1772.  
  1773.    INSERTING A NEW MENU ITEM
  1774.  
  1775.    You can insert a new menu item by positioning the blinking arrow at the
  1776.    point you want to insert a new item and then press F4.  The new menu
  1777.    item will always be inserted before the menu item pointed to by the
  1778.    blinking arrow.
  1779.  
  1780.  
  1781.                         BCSMENU.DOC - Page 23
  1782.  
  1783.  
  1784.    The maximum number of menu items allowed in a single menu is 100.  There
  1785.    is no limit to the number of menus.  If there are 100 entries, a window
  1786.    will pop-up indicating that this menu already has the maximum number of
  1787.    entries.  Press any character producing key (such as the SPACEBAR or
  1788.    ENTER) to remove the pop-up window.
  1789.  
  1790.    If there are less than 100 entries, a space will open up for the new
  1791.    menu entry and you will be prompted to enter a password for this entry.
  1792.    Editing is exactly the same as editing any other menu item except that
  1793.    all entry windows will be blank.  If you press ESC to abort the edit,
  1794.    the space will close up and no new entry will be inserted.  If you
  1795.    complete the edit successfully, the new menu item will appear at the
  1796.    point of insertion that you specified.
  1797.  
  1798.  
  1799.    CHANGING THE TITLE/DOS EXIT PASSWORD
  1800.  
  1801.    Both the title and the DOS Exit Password are changed by pressing F5.  An
  1802.    edit window will appear with the current title displayed.  Edit the menu
  1803.    title or delete all characters in the edit field for no title.  Press
  1804.    ESC to abort the edit.  Press ENTER or F10 to save the new title.  The
  1805.    title may be up to 78 characters long.  Any displayable ASCII character
  1806.    is allowed (those that have an ASCII character value less than or equal
  1807.    to 128).
  1808.  
  1809.  
  1810.    If a DOS Exit Password exists, a password entry window will appear when
  1811.    you press ENTER or F10 to end the title edit.  You must enter the
  1812.    current password in order to change it.  Press ESC to abort DOS Exit
  1813.    Password editing, or enter the current password and press ENTER.  The
  1814.    password entry window will be removed from the screen and an edit window
  1815.    will be displayed with the current password.  Edit the password.  If you
  1816.    don't want a DOS Exit password, leave the field blank (delete any
  1817.    characters in the field).  Press ENTER to save the current edit field as
  1818.    the new DOS Exit password.  The DOS Exit password may be up to 15
  1819.    alphabetic and/or numeric characters.
  1820.  
  1821.  
  1822.    SET SPACING/NUMBER OF COLUMNS
  1823.  
  1824.    The prompts for each of the menu items are displayed on the Menu Screen.
  1825.    You can select the spacing for prompt display, and the number of columns
  1826.    of prompts for the Menu Screen.  To change the Spacing and/or Number of
  1827.    columns press F6.
  1828.  
  1829.    A window will appear that shows the available choices for spacing.  If
  1830.    there are 70 or fewer menu items, you can select Single, Double or
  1831.    Triple spacing.  If there are more than 70 menu items, you can only
  1832.    select between Single and Double spacing.  Use the UP/DOWN ARROWS to
  1833.    select the desired prompt spacing, or point to the desired spacing
  1834.    option with the mouse and click.  Press ENTER or double click with the
  1835.    mouse on your choice to record your selection.  The spacing will be set
  1836.    to the value you have selected.  If you select triple spacing and later
  1837.    add menu items so that the total becomes greater than 70, the spacing
  1838.    will automatically be adjusted to double spacing.
  1839.  
  1840.    The Spacing window will be removed from the screen and a Columns window
  1841.  
  1842.                         BCSMENU.DOC - Page 24
  1843.  
  1844.  
  1845.    will be displayed.  You may select from one to ten columns or Best Fit.
  1846.    If you select Best Fit, BCS Menu Program will compute the optimum number
  1847.    of columns based on the number of menu items and the line spacing option
  1848.    in effect.  Make your selection by using the UP/DOWN ARROW keys, or by
  1849.    pointing to a selection with the mouse and clicking once.  Record your
  1850.    selection by pressing ENTER or double click with the mouse on your
  1851.    selection.
  1852.  
  1853.  
  1854.    Note:   When you are finished editing and you press ESC to return to
  1855.            the Color Change Screen, or, when you Save the Menu File, BCS
  1856.            Menu Program checks the number of menu items and formats them
  1857.            for display on the Menu Screen using the spacing and column
  1858.            options you have chosen if possible.  Nineteen (19) prompts
  1859.            will fit in each single spaced column; 10 prompts will fit in
  1860.            each double spaced column; 7 prompts will fit in each triple
  1861.            spaced column.  If you have selected 1 column and you have 20
  1862.            menu items, BCS Menu Program will format the entries to be
  1863.            displayed in 2 columns (since only 19 will fit in 1 column).
  1864.            If you have selected triple spacing and have added menu items
  1865.            to bring the total greater than 70, BCS Menu Program will
  1866.            change the spacing to double spacing.  BCS Menu Program will
  1867.            use the settings you have selected unless it cannot fit the
  1868.            prompts in the spacing/column choices designated.
  1869.  
  1870.  
  1871.    MOVING A PROMPT
  1872.  
  1873.    You can move menu item prompts so that they appear in a different order.
  1874.    To move a prompt, select the prompt to be moved by positioning the
  1875.    blinking arrow at the prompt using the UP/DOWN ARROW keys or point at
  1876.    the prompt with the mouse and click once.  Press F7.  The entry will be
  1877.    highlighted and a window will appear with further instructions.
  1878.    Position the blinking arrow to where you want to move the prompt to -
  1879.    press ENTER, or, point to the position to move the prompt to and double
  1880.    click with the mouse.  The prompt will be moved in front of the second
  1881.    prompt selected.
  1882.  
  1883.    Inserting and moving prompts works in a consistent manner.  Prompts are
  1884.    always inserted or moved to the position specified by the blinking
  1885.    arrow.  Therefore, moving a prompt to the last position is a two step
  1886.    process.  Move the desired prompt to the second to the last position and
  1887.    then move the last prompt to someplace in front of it.
  1888.  
  1889.  
  1890.    SORTING PROMPTS
  1891.  
  1892.    You can sort the menu item prompts alphabetically (ASCII character value
  1893.    order without regard to case) in ascending or descending order.  To sort
  1894.    prompts, press F8.  A window will appear with ASCENDING (A to Z) and
  1895.    DESCENDING (Z to A) as choices.  Use the UP/DOWN ARROW keys or point to
  1896.    either choice with the mouse and click.  Press ENTER once you have made
  1897.    your selection or double click with the mouse on your selection.  The
  1898.    entries will be sorted in the order you have chosen.  The new sorted
  1899.    order will appear on the screen.  (This could take a second or two if
  1900.    you have many entries.)
  1901.  
  1902.  
  1903.                         BCSMENU.DOC - Page 25
  1904.  
  1905.  
  1906.  
  1907.    SAVING THE MENU DEFINITION FILE
  1908.  
  1909.    It's a good idea to save the Menu Definition File whenever you've made
  1910.    changes.  The Menu Definition File may be saved from any screen (the
  1911.    Menu Screen, the Color Change Screen and the Menu Edit Screen).  To save
  1912.    the menu definition file, press F9.  An edit window will appear with the
  1913.    name of the current menu file (the filename may include the drive, path
  1914.    and complete filename).  To save the menu file using the current name,
  1915.    press ENTER (or click on ENTER with the mouse).  You can change the name
  1916.    to any valid DOS filename, including a different drive, path and
  1917.    complete filename.  The menu file will be saved using the name in the
  1918.    edit field.  If an error is encountered while writing the menu file, an
  1919.    error message appears on the top line of the edit window and you will be
  1920.    prompted to enter a new name.  Examples of errors that can occur are
  1921.    when the menu file has been marked Read Only or when your disk is full.
  1922.    You might try a new filename or storing the menu file to a different
  1923.    drive.
  1924.  
  1925.  
  1926.    OTHER KEYS
  1927.  
  1928.    There are more keys defined for use than can be displayed with a clear
  1929.    description in the Key Definition Window at the bottom of the screen.
  1930.    To see how other keys are defined, press F10.  Other key definitions
  1931.    will be displayed in the Key Definition Window.  Pressing F10 does not
  1932.    change the function of keys, it simply shows how other keys are defined.
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.                         BCSMENU.DOC - Page 26
  1965.  
  1966.  
  1967.    KEY SUMMARY
  1968.  
  1969.    ESC     Aborts any in process edit, removes the help window, or
  1970.            returns to the Color Change Screen.
  1971.    ENTER   Ends a line during edit, or, selects a menu item to be edited.
  1972.    F1      Display Menu Edit Help Window.
  1973.    F2      Restores menu to last saved menu definition.
  1974.    F3      Deletes a line if editing an item description or commands
  1975.            window; otherwise, deletes the menu item pointed to by the
  1976.            blinking arrow.
  1977.    F4      Inserts a line if editing an item description or commands
  1978.            window; otherwise, inserts a menu item before the menu item
  1979.            pointed to by the blinking arrow.
  1980.    F5      Edit the menu title/DOS Exit Password.
  1981.    F6      Select Prompt Spacing/Number of Columns.
  1982.    F7      Move a menu item's prompt.
  1983.    F8      Sort menu item prompts (in ascending or descending order).
  1984.    F9      Save all current settings in a menu definition file.
  1985.    F10     If editing, save current edit fields and skip to next window;
  1986.            otherwise, show other key definitions in the Key Definition
  1987.            Window.
  1988.    UP/DOWN ARROW   If editing the item description or commands selects
  1989.            the previous/next line for edit; otherwise, move the blinking
  1990.            arrow up or down to select a menu item to edit.
  1991.    INSERT  During edit, toggles between Insert Mode On (full sized
  1992.            cursor) and Insert Mode Off (underline cursor).
  1993.    BACKSPACE   During edit, deletes the character to the left of the
  1994.            cursor.
  1995.    DEL     During edit, deletes the character at the cursored position.
  1996.    LEFT/RIGHT ARROW    During edit, moves the cursor left/right one
  1997.            character position.  Will scroll edit field if necessary.
  1998.    END     During edit, moves the cursor to the end of the text in the
  1999.            current edit line.
  2000.    HOME    During edit, moves the cursor to the start of the edit line.
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.                         BCSMENU.DOC - Page 27
  2026.  
  2027.  
  2028.    CHAPTER 6 - BCS MENU PROGRAM - OPERATIONAL OVERVIEW
  2029.  
  2030.    In order to run BCS Menu Program, you must have at least the two BCS
  2031.    Menu Program executable files (BCSMENU.COM and BCSMENU.OVL) and a
  2032.    minimum of one Menu Definition file.  Additional files including menu
  2033.    definition files and documentation files are also a part of this
  2034.    package.
  2035.  
  2036.    When you start BCS Menu Program, the directory where the program files
  2037.    are located must be the default directory.  You can start BCS Menu
  2038.    Program from this directory by simply typing "BCSMENU" (without the
  2039.    quotes).  This command instructs DOS to start BCSMENU.COM.
  2040.  
  2041.    BCSMENU.COM will load and execute BCSMENU.OVL.  BCSMENU.OVL must be in
  2042.    the same directory as BCSMENU.COM and must be the default directory when
  2043.    the program is started.
  2044.  
  2045.    BCSMENU.OVL contains the heart of the menu program.  It is BCSMENU.OVL
  2046.    that reads and translates the Menu Definition File.  When you select a
  2047.    menu item to execute from the Menu Screen, BCSMENU.OVL will validate the
  2048.    password (if any), prompt the user for input if a User Input Variable is
  2049.    found in the command sequence and format a command buffer for
  2050.    BCSMENU.COM.  BCSMENU.OVL then exits passing control once again to
  2051.    BCSMENU.COM.
  2052.  
  2053.    BCSMENU.COM then executes any commands it finds in the command buffer,
  2054.    or exits to DOS when it finds an empty command buffer.  Since
  2055.    BCSMENU.COM executes each command, it must be in-memory during command
  2056.    execution.  BCSMENU.COM takes up approximately 2 1/2 K of memory while
  2057.    it is executing commands.  (The execution of a command can start an
  2058.    application such as word processing.  When you exit the word processor
  2059.    or other application and return to DOS, the next command in the command
  2060.    buffer will be executed.)  Once all commands have been executed,
  2061.    BCSMENU.COM returns to the drive and directory where it was started from
  2062.    and once again loads and executes BCSMENU.OVL.  This circle of execution
  2063.    is maintained until you perform a DOS Exit from BCS Menu Program.
  2064.  
  2065.    BCS Menu Program does not create batch files to execute commands.
  2066.    Instead, all commands are stored in and executed directly from memory.
  2067.    More than half the size of BCSMENU.COM is devoted to a command buffer
  2068.    used exclusively for this purpose.  Small batch files created and
  2069.    deleted frequently can result in disk fragmentation.  BCS Menu Program
  2070.    does not contribute to this fragmentation by creating temporary batch
  2071.    files.
  2072.  
  2073.    BCSMENU.COM is not a TSR (Terminate and Stay Resident) program.  When
  2074.    you exit to DOS, BCSMENU.COM returns to DOS without leaving itself in
  2075.    memory.
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.                         BCSMENU.DOC - Page 28
  2087.  
  2088.  
  2089.    LOADING DEFAULT AND ALTERNATE MENU FILES
  2090.  
  2091.    When BCS Menu Program is run it will load a menu definition file by the
  2092.    name MENU.MNU.  If this file is not found an error message is displayed
  2093.    and the program exits to DOS.
  2094.  
  2095.    You can alternately type the name of a different menu file on the DOS
  2096.    command line (or in a batch file used to start BCS Menu Program) and
  2097.    that menu file will be loaded instead.  For example:
  2098.        BCSMENU OTHER.MNU
  2099.  
  2100.    This causes BCS Menu Program to load OTHER.MNU.
  2101.  
  2102.  
  2103.    MENU DEFINITION FILE NAMING CONVENTIONS
  2104.  
  2105.    BCS Menu Program does not enforce Menu Definition File naming
  2106.    conventions.  You may name a Menu Definition File using any valid DOS
  2107.    filename.  You can then load the menu file from the DOS command line by
  2108.    specifying the full filename after BCSMENU.COM, or you can load the menu
  2109.    file from another menu file by specifying the full filename in the
  2110.    command sequence.
  2111.  
  2112.    It is recommended that you use the .MNU extension for menu definition
  2113.    files so the human observer can identify them.
  2114.  
  2115.  
  2116.    LOCATION OF MENU DEFINITION FILES
  2117.  
  2118.    Menu Definition Files may be located on any drive in any directory
  2119.    (including a network drive).  If the menu file is not in the same
  2120.    directory as the BCS Menu Program files, you must specify the complete
  2121.    Drive, Path and Filename so that BCS Menu Program can find and load the
  2122.    menu file.  You can also specify the complete Drive, Path and Filename
  2123.    in the Menu Definition File itself so that it can load other menu files
  2124.    located on different drives and/or in different directories.
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.  
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.                         BCSMENU.DOC - Page 29
  2148.  
  2149.  
  2150.    APPENDIX A - ABOUT BRISTOL COMPUTING SYSTEMS, INC.
  2151.  
  2152.    Bristol Computing Systems, Inc. was formed by two computer software
  2153.    professionals who have over thirty years combined experience in the
  2154.    computer industry, much of that time working exclusively with PC's.
  2155.    During the course of that time they have had occasion to train many
  2156.    individuals in different aspects of computer use, from the seasoned
  2157.    professional to the new user.  Their goals include making computers
  2158.    easier for the novice to use and more efficient and less error prone for
  2159.    all users.  This program has been found to be an effective, efficient
  2160.    tool that will help you get more productivity out of your computer.
  2161.    (All of the sample menu files, some of the source code and even the
  2162.    program documentation were generated using BCS Menu Program to start
  2163.    other applications.)
  2164.  
  2165.    They each own a home personal computer and are accustomed to working
  2166.    with top shelf software products.  Top shelf software products can be
  2167.    too expensive a proposition for the typical home computer user.  This
  2168.    helped in shaping their goals to develop top shelf, high quality
  2169.    software at a price that is easily affordable for home as well as office
  2170.    use.  Thus Bristol Computing Systems slogan:
  2171.  
  2172.        "Reliable Software Products at a Reasonable Price"
  2173.  
  2174.    They welcome user comments and suggestions.  Please forward mail to:
  2175.        Bristol Computing Systems, Inc.
  2176.        Suite 162
  2177.        200 Linden Street
  2178.        P.O. Box 9009
  2179.        Wellesley, MA 02181
  2180.  
  2181.    You can also leave comments on CompuServe, address E-Mail to Bristol
  2182.    Systems - 71341,1463, or on Byte Information Exchange (BIX), address
  2183.    mail to ntiedemann.
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.                         BCSMENU.DOC - Page 30
  2209.  
  2210.  
  2211.    APPENDIX B - ERROR MESSAGES
  2212.  
  2213.  
  2214.    The following error messages may appear when using BCS Menu Program.
  2215.  
  2216.    A brief explanation of each message follows.
  2217.  
  2218.    ------------------------------------------------------------
  2219.    ERROR MESSAGE
  2220.    Menu file not found - Exiting to DOS
  2221.  
  2222.    PROBLEM
  2223.    The program tried to read a menu file that it could not find on the
  2224.    disk.  This can occur at startup if the default menu file "MENU.MNU" is
  2225.    not in the same directory as the program, or if the menu file specified
  2226.    on the command line is not found.  This error can also occur when
  2227.    attempting to load a menu file from an existing menu file.
  2228.  
  2229.    SOLUTION
  2230.    This error can occur if the menu file is not in the current menu
  2231.    directory, or, if the menu filename was not typed correctly.  Make sure
  2232.    the file exists in the directory you're attempting to load it from (use
  2233.    the DOS DIR command for this).  If it doesn't exist, try copying the
  2234.    file MENU.MNU (or the menu file you're attempting to load) to the
  2235.    desired directory and restart BCSMENU.  If a menu file filename was
  2236.    specified on the command line, be sure the name is spelled correctly and
  2237.    that the entire name is used.  Minimally the filename and extension are
  2238.    required.  Whenever the menu files are not in the same directory as the
  2239.    program files you should always include the complete DOS filespec for
  2240.    the menu file (drive, path, filename and extension).
  2241.  
  2242.    ------------------------------------------------------------
  2243.    ERROR MESSAGE
  2244.    Error reading menu file
  2245.  
  2246.    PROBLEM
  2247.    A disk read error occurred when the program read the specified menu file
  2248.    (MENU.MNU if no menu file was specified, or the specified menu file).
  2249.  
  2250.    SOLUTION
  2251.    The menu file may have become corrupted.  It is recommended that you
  2252.    backup your menu files once you have edited them.  If you have backed
  2253.    them up, copy the backed up menu files to the appropriate directory.  If
  2254.    a backup copy is not available, copy the menu files from the
  2255.    distribution diskette again and edit them for your system.  This might
  2256.    also be indicative of a hard disk problem.  If this happens repeatedly,
  2257.    have your system serviced.
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.                         BCSMENU.DOC - Page 31
  2270.  
  2271.  
  2272.    ------------------------------------------------------------
  2273.    ERROR MESSAGE
  2274.    Invalid Menu File - Exiting to DOS
  2275.  
  2276.    PROBLEM
  2277.    The menu file is not in a format recognized by BCS Menu Program.
  2278.  
  2279.    SOLUTION
  2280.    The menu file is not a valid BCS Menu Program menu file.  The file may
  2281.    have become corrupted, or the name of the file specified is not a BCS
  2282.    Menu Program menu file.  Start by making sure you know the name of the
  2283.    menu file you're trying to load.  If this error occurred by typing the
  2284.    menu file name from the DOS command line, make sure the name was typed
  2285.    correctly.  If the error occurred as a result of loading from an
  2286.    existing menu file, make sure the name is correct in the commands
  2287.    associated with the selected prompt in the menu file.  If you suspect
  2288.    the menu file may be corrupted, restore a backed up copy of the menu
  2289.    file and try again.  If you don't have a backed up copy of your menu
  2290.    files, copy the menu files from the distribution diskette and edit them
  2291.    for your system (make a backup copy of edited menu files).  This might
  2292.    also be indicative of a hard disk problem.  If this happens repeatedly,
  2293.    have your system serviced.
  2294.  
  2295.    ------------------------------------------------------------
  2296.    ERROR MESSAGE
  2297.    Error Encountered Opening File - Please Enter Another Name
  2298.  
  2299.    PROBLEM
  2300.    A disk error occurred when the program attempted to write an updated
  2301.    version of the menu definition file.
  2302.  
  2303.    SOLUTION
  2304.    There are several possible reasons why this error can occur; the name
  2305.    specified for the menu file is invalid.  Try typing the name again; be
  2306.    sure to use a valid DOS filename.  The menu file is marked read only.
  2307.    Try specifying a different menu file filename.  The disk you are trying
  2308.    to write to is full.  Write the file to an alternate drive.  The drive
  2309.    you are attempting to write to is a network drive.  Check with your
  2310.    system administrator to be sure you have write permission on the
  2311.    specified drive.
  2312.  
  2313.    ------------------------------------------------------------
  2314.    ERROR MESSAGE
  2315.    Fatal error processing menu file - please re-start program
  2316.  
  2317.    PROBLEM
  2318.    Each edit to a menu item consumes additional memory.  When the menu file
  2319.    is saved to the disk the additional memory is released and the menu file
  2320.    is read again.  An error occurred when the menu file was re-read.
  2321.  
  2322.    SOLUTION
  2323.    You can try restarting BCS Menu Program again.  If the symptom persists,
  2324.    the most probable cause is a physical problem with the disk.  You should
  2325.    seek professional advice to solve this problem.
  2326.  
  2327.  
  2328.  
  2329.  
  2330.                         BCSMENU.DOC - Page 32
  2331.  
  2332.  
  2333.    ------------------------------------------------------------
  2334.    ERROR MESSAGE
  2335.    Invalid Password - Please Try Again
  2336.  
  2337.    PROBLEM
  2338.    The specified operation is protected by a password.  You typed the
  2339.    password incorrectly.
  2340.  
  2341.    SOLUTION
  2342.    An exact match, without regard to case, did not occur therefore the
  2343.    entered password is in error.  Enter the correct password.  (Three tries
  2344.    at entering the password are permitted before the operation is aborted.)
  2345.  
  2346.    ------------------------------------------------------------
  2347.    ERROR MESSAGE
  2348.    ERROR - insufficient memory to run program exiting to DOS
  2349.    (or) Insufficient memory to run program
  2350.  
  2351.    PROBLEM
  2352.    BCS Menu Program could not find enough memory to execute and to place
  2353.    the menu file into memory.
  2354.  
  2355.    SOLUTION
  2356.    There must be approximately 384K of FREE memory to run all functions of
  2357.    BCS Menu Program.  Run DOS CHKDSK to see if your system has this amount
  2358.    of memory available.  Try running BCS Menu Program without loading any
  2359.    TSR programs.
  2360.  
  2361.    ------------------------------------------------------------
  2362.    ERROR MESSAGE
  2363.    ERROR - Insufficient memory to edit menu
  2364.    Insufficient Memory to Complete Edit - This Edit Will be Aborted
  2365.  
  2366.    PROBLEM
  2367.    Additional memory is required to edit menu items.  Each menu item edit
  2368.    requires still more memory.  Your system could not provide the memory
  2369.    required to perform the edit operation.
  2370.  
  2371.    SOLUTION
  2372.    If you have been editing entries, save the menu file (press F9).  This
  2373.    will free additional memory being used by edited entries.  If you cannot
  2374.    enter the Menu Edit Screen at all, your system does not have enough free
  2375.    memory to perform the edit operation.  Make sure your system has enough
  2376.    available memory (approximately 384K free memory required - run DOS
  2377.    CHKDSK to see if enough free memory is available).  Try starting BCS
  2378.    Menu Program without loading any TSR programs.
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.  
  2390.  
  2391.                         BCSMENU.DOC - Page 33
  2392.  
  2393.  
  2394.    ------------------------------------------------------------
  2395.    ERROR MESSAGE
  2396.    ERROR - Prompt must contain at least 1 valid character
  2397.  
  2398.    PROBLEM
  2399.    You attempted to edit a menu item prompt and pressed ENTER or F10 with
  2400.    the edit line blank.
  2401.  
  2402.    SOLUTION
  2403.    Each prompt must have one or more characters.  Blank lines are not
  2404.    allowed as prompts.  The Escape key can be used to cancel the edit.  The
  2405.    line spacing option should be used to leave blank lines between prompts.
  2406.  
  2407.    ------------------------------------------------------------
  2408.    ERROR MESSAGE
  2409.    ERROR - Command must contain at least 1 valid character
  2410.  
  2411.    PROBLEM
  2412.    You pressed ENTER or the DOWN ARROW leaving a command line blank.  Blank
  2413.    lines are not allowed between command lines.
  2414.  
  2415.    SOLUTION
  2416.    Press ESC to abort the edit, or press F10 to save all command lines and
  2417.    end the edit.
  2418.  
  2419.    ------------------------------------------------------------
  2420.    ERROR MESSAGE
  2421.    Cannot Insert - this menu has reached the maximum number of entries
  2422.    allowed
  2423.  
  2424.    PROBLEM
  2425.    Each menu may contain up to 100 entries.  You attempted to insert an
  2426.    entry when the menu file already had 100 entries.
  2427.  
  2428.    SOLUTION
  2429.    It is hard to imagine a menu that has more than 100 entries!  Create an
  2430.    additional menu file and move some of the entries to that file.
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.  
  2452.                         BCSMENU.DOC - Page 34
  2453.