home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / util1 / msi14.lzh / MSI.DOC < prev    next >
Text File  |  1991-04-25  |  33KB  |  752 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                 MSI Menu System
  7.  
  8.                   Copyright (C) 1991 by Micris Softworks, Inc
  9.  
  10.                               All Rights Reserved
  11.                             Except as Granted Herein
  12.  
  13.  
  14.         The MSI Menu System is distributed as Shareware.  Unaltered 
  15.         copies of this program may be freely distributed on diskette or 
  16.         through Electronic means so long as no charge is made, other than 
  17.         a cost of diskette charge, without the prior written permission 
  18.         of Micris Softworks, Inc.  Permission is hereby granted for 
  19.         recipients of this program to evaluate without charge the MSI 
  20.         Menu System for a period not to exceed 30 days.  The software 
  21.         must be registered for use beyond that time. 
  22.         
  23.         The following Registration fees are effective with the release 
  24.         of Version 1.3:  (All amounts in U.S. Dollars)
  25.  
  26.            $45.00 - Full Registration.  This includes:
  27.                     
  28.                  *  The latest version of MSI.
  29.                  *  Printed & bound User's Manual.
  30.                  *  Unlimited Technical Support.
  31.                  *  Unlimited FREE upgrades (as available)
  32.                  *  New Product Notices
  33.  
  34.            $25.00 - Technical Support Registration.  You will receive a 
  35.                     Registration number giving you access to UNLIMITED 
  36.                     technical support, including support by telephone, 
  37.                     plus notification of upgrades and new products. 
  38.  
  39.            $15.00 - Simple Registration of software and inclusion in our 
  40.                     notification list of upgrades and new products. 
  41.  
  42.                      On all correspondence and Registrations 
  43.            PLEASE INCLUDE YOUR FULL NAME AND COMPLETE MAILING ADDRESS.
  44.  
  45.                              Micris Softworks, Inc.
  46.                     2907 St. Tropez Dr.  Ontario, CA  91761
  47.  
  48.  
  49.         Remember, Shareware is supported SOLELY by voluntary 
  50.         registration of the software.  The registration fees allow us 
  51.         to continue developing MSI and to provide quality documentation 
  52.         and technical support.  If you like MSI, are using it but don't 
  53.         really require the support and other benefits, you can now 
  54.         register for just $15.00.  
  55.  
  56.         Help keep Shareware alive.  REGISTER TODAY!!
  57.  
  58.  
  59.                                  - DISCLAIMER -
  60.         The MSI Menu System is distributed 'as is'.  Micris Softworks, 
  61.         Inc. makes no warrants, either express or implied, as to 
  62.         appropriateness or suitability for any particular use of this 
  63.         product, or to the accuracy of this or other related 
  64.         documentation, nor to the error-free operation of the software.  
  65.         Except as may be provided by law, Micris Softworks, Inc. and 
  66.         its duly authorized representatives may not be held liable for 
  67.         any damages or loss resulting from the use of, or the inability 
  68.         to use, this product.
  69.         
  70.  
  71.  
  72.  
  73.         'C' Programmers Note:
  74.  
  75.         MSI utilizes a simple text window driver compatible with Turbo 
  76.         C.  TextWin, is also available as a shareware product.  If you 
  77.         can't find a copy of it on your favorite BBS contact Micris at 
  78.         the address given at the beginning of this document to receive 
  79.         an evaluation copy. 
  80.         
  81.  
  82.         
  83.                            Using this Documentation.
  84.         
  85.         To help you find the information you need, this document 
  86.         contains special locators that you can use with the search 
  87.         feature of your editor or word processor to quickly find 
  88.         certain command or feature descriptions.  Use your search 
  89.         command to locate any of the following words or phrases, using 
  90.         upper and lower case as shown.  Do not type in the quotation 
  91.         marks.  They are only there to identify the individual search 
  92.         strings. 
  93.  
  94.  
  95.         "What is MSI?"   "Who can use it?"   "How do I get started?"
  96.  
  97.         "PROGRAM FILES:"  "TERMS:"  "INSTALLING MSI:"
  98.  
  99.  
  100.         "NAME:"                   "CURSOR BAR:"         "EDIT:"     
  101.                               
  102.         "PROMPT:"                 "PROMPT LINE:"        "MOVE:"  
  103.         
  104.         "HELP:"                 "FOR THIS OPTION:"      "DEFINE:" 
  105.         
  106.         "SELECTION OPTIONS:"      "SELECTS:"            "DELETE:"
  107.         
  108.         "PASSWORD:"               "MENU:"
  109.         
  110.         "STEPPED:"                "ACTION:"
  111.         
  112.         "SHADOWED:"               "DUAL:"
  113.         
  114.         "BORDER:"                 "TYPE:"  
  115.         
  116.         "BACK:"                   "NORMAL:"  
  117.         
  118.         "FORE:"                   "TEXT ONLY:"
  119.         
  120.         "QUIT:"
  121.  
  122.  
  123.  
  124.         
  125.                                   What is MSI?  
  126.  
  127.         Basically, MSI provides Dealers, Consultants and individual 
  128.         computer owners an easy-to-define set of windowed menus which 
  129.         tie together and provide easy access to the various programs on 
  130.         a computer system.  Dealers and Consultants will find this an 
  131.         invaluable tool for easing new users past DOS and into the 
  132.         applications for which they purchased the computer in the first 
  133.         place.  Individual users will find that the menus will 'clean 
  134.         up the workspace' while still providing fast and easy access to 
  135.         DOS when it is absolutely necessary.
  136.  
  137.  
  138.                                 Who can use it?
  139.  
  140.         Primarily MSI was designed as a Consultant's and Dealer tool.  
  141.         This suggests some familiarity with DOS, in particular Batch 
  142.         File commands, but no special hardware or programming 
  143.         expertise.  Of course the more you understand about DOS, the 
  144.         more involved and powerful your menus can become.  
  145.  
  146.         However, if all you know is that "I type this to get into the 
  147.         program..." you can still make efficient use of MSI.  Each menu 
  148.         option can be assigned to an 'Action'.  When the option is 
  149.         selected the Action is performed.  "I type this..." becomes the 
  150.         Action you define for a menu option.  Now, instead of typing 
  151.         'this...' you simply select the option from the menu.  With MSI 
  152.         you can gather all of your hard-to-remember 'thises...' into 
  153.         one or more easy-to-use menus.  Almost all of the commands you 
  154.         will need to create your menus will be there on screen while 
  155.         you work. 
  156.  
  157.  
  158.                              How do I get started?
  159.  
  160.         Unlike some systems, MSI is nearly all self-contained.  That 
  161.         means that there are only three files to the whole system, and 
  162.         you will only be working with one of them, ever.
  163.  
  164.         PROGRAM FILES:
  165.  
  166.         First, check to make sure that you received the following 
  167.         files: 
  168.  
  169.             MSI.EXE - This is the program file.
  170.             MSI.DAT - Menu definitions are stored here.  The original 
  171.                       MSI.DAT contains some sample menus for you to 
  172.                       explore.  When you are ready to define your own 
  173.                       menus rename this file to MSI.SAV.
  174.             M.Bat   - This is the DOS batch file used to start MSI and 
  175.                       control 'Actions'.
  176.             README.DOC - Contains important information on each release 
  177.                       of MSI plus installation instructions. 
  178.             MSI.DOC - This file, which you obviously have received...
  179.          
  180.  
  181.         If you did not receive a .DAT file then you still have the 
  182.         complete program; MSI will create a new .DAT file when you 
  183.         make your own menus.
  184.  
  185.    -->> When MSI is first run it will check the CURRENT directory for 
  186.         MSI.DAT.  If the data file is not present then MSI will create 
  187.         a new one containing a single menu and help screen.
  188.  
  189.  
  190.         INSTALLING MSI:
  191.  
  192.         IMPORTANT: Read the sections marked '-->>'.
  193.  
  194.         If you have downloaded or received the MSIxx.ZIP file, where 
  195.         'xx' is the version number, then you will need to 'unzip' this 
  196.         file first.  Use PKUNZIP.EXE for this.  If you don't have 
  197.         PKUNZIP you will need to dial up your favorite local BBS and 
  198.         download it. 
  199.         
  200.         You may want to make a sub-directory on your hard disk to hold 
  201.         your MSI files.  Type: 
  202.  
  203.               md msi (RETURN)
  204.               cd msi (RETURN)
  205.  
  206.         then IF YOUR FILE(S) ARE ON FLOPPY DISK USE:
  207.               copy A:MSIxx.ZIP
  208.           or
  209.               copy A:*.*
  210.           if the unzipped files are on the floppy.
  211.  
  212.         IF THE FILE(S) ARE ALREADY ON YOUR HARD DISK:
  213.           either
  214.              copy [path]\MSIxx.ZIP  (to move it to the MSI directory)
  215.           or 
  216.              pkunzip [path]\MSIxx.ZIP 
  217.           to just put the unzipped files in the new directory.
  218.  
  219.  
  220.    -->> IMPORTANT:
  221.           
  222.         There are two VERY important steps you should take once you 
  223.         have the files unzipped.
  224.  
  225.  
  226.    -->> FIRST:   Check M.BAT...
  227.  
  228.         It has been assumed that MSI would be installed on the root 
  229.         directory of your primary disk drive, typically the 'C' drive 
  230.         on many hard drive equipped computers. If this is not the case 
  231.         you will need to make a minor adjustment to M.BAT.  Use your 
  232.         word processor or editor to open M.BAT and make the following 
  233.         changes: 
  234.  
  235.             1. Locate the following at the bottom of the file;
  236.  
  237.                                :getback
  238.                                c:
  239.                                cd c:\
  240.                                goto menu
  241.  
  242.             These commands let MSI find its way back to the 
  243.             installation disk and directory after returning from the DOS 
  244.             Shell.
  245.             
  246.             2. Make the following modifications:
  247.             
  248.                                :getback
  249.                           ->   Disk Drive:
  250.                           ->   cd Path
  251.                                goto menu
  252.  
  253.             where Disk Drive is the installation drive, i.e. A:, B:, 
  254.             C:, etc., and Path is the FULL path to the disk AND drive 
  255.             where MSI.EXE and MSI.DAT reside.
  256.  
  257.  
  258.             FOR EXAMPLE:
  259.  
  260.             Many users may want to use MSI.EXE from an F, G, (W, Z, 
  261.             etc.) drive, such as on a network.  To do this change M.BAT 
  262.             to read:
  263.  
  264.                                :getback
  265.                           ->   F:
  266.                           ->   cd F:\MSI
  267.                                goto menu
  268.  
  269.             Doing this will allow MSI to return properly to the menus 
  270.             regardless of which drive or directory you are in when you 
  271.             type EXIT from DOS or return from an application.
  272.  
  273.  
  274.         SECOND:   Make a copy of MSI.DAT...
  275.             
  276.            copy MSI.DAT MSI.SAV (or SAVE.DAT or other filename)
  277.          
  278.           This way you can experiment with the sample menus, but still 
  279.           have a fresh, unmodified copy to return to;
  280.  
  281.            copy MSI.SAV MSI.DAT  (restores the file to mint condition!)
  282.         
  283.  
  284.         TERMS:
  285.  
  286.         Most of the terms you encounter here will probably already be 
  287.         familiar to you.  If you are not familiar with Batch File 
  288.         commands you should consult your DOS manual for more 
  289.         information.  There are a number of these at your disposal and 
  290.         it is beyond the scope of this document to detail them all.  
  291.  
  292.         Three important terms are used extensively here; Menu, Action 
  293.         and Options.
  294.  
  295.         Menu - The Menu is the largest bordered window area just 
  296.         slightly off-center in the middle of your screen.  The Menu 
  297.         contains an optional Name at the top, an optional Prompt at the 
  298.         bottom and the selection Options lying between them.  Menus can 
  299.         have up to 9 Selections if you define a Prompt line or 11 if 
  300.         you don't. 
  301.  
  302.         Each Option you define on a Menu will have associated with its 
  303.         selection either an Action that is to be taken or another Menu 
  304.         that is to be displayed, or both.  There are two types of 
  305.         Actions which are used.  The first is used ONLY when an option 
  306.         selects an Action alone.  This is nothing more than a DOS batch 
  307.         file that is created from the commands you will enter on the 
  308.         Action definition window.  There are only two batch files used 
  309.         by MSI, M.BAT which controls entry into and out of MSI and 
  310.         ACT.BAT which is created from your commands each time an Action 
  311.         option is selected.  For the technically inclined, MSI will 
  312.         terminate after creating ACT.BAT, passing control to it through 
  313.         M.BAT and returning again on termination of the commands to the 
  314.         Main entry menu.  During execution of the ACT.BAT commands no 
  315.         other programs are in memory, at least not any associated with 
  316.         MSI.
  317.         
  318.         The other type of Action is used when a option Select is set to 
  319.         DUAL.  This allows you to define TWO Actions, one prior to the 
  320.         display of a new menu and a second when the ESC key is pressed 
  321.         leaving the menu.  (You will be defining the menu also.)  This 
  322.         type of Action is issued as direct commands to the system with 
  323.         MSI still resident.  This is useful for loading and unloading 
  324.         TSR's while the user is presented with program instructions or 
  325.         further use options.  If the TSR or other program sends 
  326.         messages to the screen you may want to redirect them to a file 
  327.         instead ( >NULL or >>NULL to send to a file call null).  With a 
  328.         DUAL setting you have the option of defining either a pre-menu 
  329.         Action or a post-menu Action or both.  (And of course the menu 
  330.         itself can have other options each selecting menus, Actions or 
  331.         both.)
  332.         
  333.         An important aspect of the DUAL selection is that MSI remains 
  334.         resident when the action command is issued.  The amount of 
  335.         memory used by MSI at the time will depend on the number of 
  336.         menus and Actions you have defined.  It is also important to 
  337.         realize that loading a TSR in this fashion locks MSI into 
  338.         memory until the TSR is unloaded again.   
  339.         
  340.         
  341.         DEFINING A MENU: The Menus Editor
  342.         
  343.         When you first enter MSI you should see a small window on the 
  344.         middle-left of your screen displaying "F5 - Menu".  If instead 
  345.         of this window you see a magenta window displaying "ESC -" then 
  346.         your current menu definitions have been 'Locked'.  Locked menus 
  347.         cannot be accidentally changed.  To unlock the menus press 
  348.         CTRL-F10 and verify unlocking by pressing 'Y'. 
  349.  
  350.         IMPORTANT NOTE: Your menu definitions are saved on disk in a 
  351.         file called MSI.DAT.  MSI will automatically update this file 
  352.         when you Lock or Unlock the menus or leave the Menus Editor 
  353.         after changes have been made.  Normally this is desirable but 
  354.         if you want to preserve a current .DAT file you should rename 
  355.         it to MSI.SAV or other extension other than .DAT.  To restore 
  356.         the data copy the contents of MSI.SAV back to MSI.DAT.
  357.  
  358.         ALSO, if you are defining an extensive set of menus you may 
  359.         want to save your definitions without leaving the Menus Editor.  
  360.         The ALT-S command is available any time in the editor to do 
  361.         this.  Saving is a very fast operation, much faster than 
  362.         redefining the menus if the power goes out...
  363.  
  364.  
  365.         Press the F5 key to enter the Menus Editor.  Two things should 
  366.         happen.  First, a green window containing various Menu Options 
  367.         will appear on the left of your screen.  Second, the Copyright 
  368.         line at the bottom of the screen will be replaced with some 
  369.         command aids.  The commands shown on this line will change as 
  370.         you enter or perform various functions. 
  371.  
  372.         The Menu Options on the left allow you to define the 'look' for 
  373.         each menu, and how it operates.  Each option description 
  374.         contains one red letter.  Press these letters to access and 
  375.         modify the matching option.
  376.  
  377.         Before going into the options in detail, you will need to know 
  378.         how to get around to your various menus while in the Menus 
  379.         Editor.  Basically this is the same as in normal operation with 
  380.         two important differences: pressing the first character of the 
  381.         selection will NOT work (you may define a key used to access an 
  382.         option in which case you wouldn't be able to change it).  
  383.         Secondly, any Actions defined WILL NOT be executed.  You will 
  384.         need to test your Actions outside of the Editor.
  385.  
  386.         Inside the Editor you will always have the Cursor Bar.  Use 
  387.         this to highlight a selection and press the ENTER key to access 
  388.         a sub-menu, if there is one.  Press the ESC key to return to a 
  389.         previous menu.
  390.  
  391.  
  392.                                 The Menu Options
  393.  
  394.         SELECTION OPTIONS: - S -
  395.  
  396.         This command allows you to define the 'look' and operation of 
  397.         the menu selections themselves.  These include defining 
  398.         background and text colors for the selection strings, whether 
  399.         or not the Cursor bar will be used with these selections, and 
  400.         the Type and function of each selection.  There are several 
  401.         options available to you here which will be discussed in detail 
  402.         later. 
  403.  
  404.  
  405.         NAME: - N -
  406.         
  407.         This is the name to print at the top of the menu.  When you 
  408.         press N the cursor will move to the first line in the menu 
  409.         window.  A command aid of the editor commands available to you 
  410.         will appear at the bottom of the screen.  Use the left and 
  411.         right cursor keys, Home and End to position the cursor on the 
  412.         line and begin typing.  The Insert, Delete and Back Space keys 
  413.         may also be used.  See "Editor Commands" for more information. 
  414.  
  415.  
  416.         PROMPT: - P -
  417.  
  418.         Use of a prompt line at the bottom of your menu is optional.  
  419.         If you define one, by pressing P and typing in a prompt string, 
  420.         MSI will display the line and place a cursor immediately 
  421.         following it.  The prompt has no functional job other than to 
  422.         indicate to the user that MSI is waiting for input.  If you do 
  423.         define a prompt line you will lose two potential menu 
  424.         selections.  MSI will leave a blank line above any prompt 
  425.         defined to make it stand out more on the menu.  This line, and 
  426.         the prompt line itself, may be used for Menu Options if a 
  427.         prompt is not used. 
  428.  
  429.  
  430.         HELP: - H -
  431.  
  432.         When you first entered MSI you may have noticed the "F1 - Help" 
  433.         window on the left of the screen.  Each menu you define can 
  434.         have its own help screen associated with it which the user can 
  435.         view by pressing F1.  Pressing H allows you to create this help 
  436.         window.  See "Editor Commands" for more information.
  437.  
  438.  
  439.         STEPPED: - T - 
  440.  
  441.         This is a special feature that allows you to arrange your menus 
  442.         and sub-menus so that they are slightly offset from each other.  
  443.         Stepped menus give the viewer a 'depth perspective' as they 
  444.         move further into sub-menus.  This gives a very important 
  445.         visual reference as to location within your menus and helps to 
  446.         avoid the feeling of panic new (and some not so new) users 
  447.         often experience when they aren't sure how to get back out. 
  448.  
  449.         After pressing T, use the right and left cursor keys to change 
  450.         the value and press ENTER to accept it.  The change will be 
  451.         made immediately so that you can view the result. 
  452.  
  453.  
  454.         SHADOWED: - D -
  455.  
  456.         Using shadows underneath your menus gives the screen a 3-D 
  457.         appearance.  This option allows you to use or not use a shadow 
  458.         for each menu you define.
  459.  
  460.         After pressing D, use the right and left cursor keys to change 
  461.         the value and press ENTER to accept it.  The change will be 
  462.         made immediately so that you can view the result. 
  463.  
  464.  
  465.         BORDER: - R -
  466.  
  467.         There are a number of different borders which you can use to 
  468.         give each menu a different look.  After pressing R, use the 
  469.         right and left cursor keys to change the value and press ENTER 
  470.         to accept it.  The change will be made immediately so that you 
  471.         can view the result.              
  472.  
  473.         
  474.         BACK: - B -
  475.  
  476.         This allows you to set the background color for each menu.  
  477.         After pressing B, use the right and left cursor keys to change 
  478.         the value and press ENTER to accept it.  The change will be 
  479.         made immediately so that you can view the result.
  480.         
  481.  
  482.         FORE: - F -
  483.  
  484.         This allows you to set the color used for printing the menu 
  485.         border, Name and Prompt line.  The Menu Options can have their 
  486.         own colors defined from the Selection Options window.  After 
  487.         pressing F, use the right and left cursor keys to change the 
  488.         value and press ENTER to accept it.  The change will be made 
  489.         immediately so that you can view the result. 
  490.  
  491.  
  492.         At the bottom of the screen you will find additional commands 
  493.         available to you.  These will change as you perform various 
  494.         functions.  When you first enter the Menus Editor the following 
  495.         is shown:
  496.  
  497.     Press ALT-Q to Quit   Select  F2 Edit  F3 Move  F4 Define  F10 Delete
  498.         
  499.         QUIT:
  500.         Use the ESC key to leave the Menus Editor.  When you do, and if 
  501.         you have made any unsaved changes, MSI.DAT will be updated.
  502.  
  503.         The other commands allow you to define the options your menu 
  504.         will have.  Use the cursor up and down keys to move the cursor 
  505.         bar to an option line.  There are 11 lines available to you for  
  506.         options if you are not using a prompt line: 9 available if you 
  507.         are.
  508.  
  509.         You do not need to use all of the lines, or use the lines one 
  510.         after another.  In fact, if you have only a few options your 
  511.         menu will look better if you space them over the length of the 
  512.         menu rather than grouping them at the top or in the middle.  
  513.         MSI keeps track of which lines are being used and handles them 
  514.         appropriately for the user.
  515.  
  516.         EDIT:
  517.         Pressing F2 will allow you to edit the line currently 
  518.         highlighted by the cursor bar.  All of the Editor Commands are 
  519.         available for this (the help line at the bottom of the screen 
  520.         will show these to you).  When the lines reads the way you want 
  521.         it to press ENTER.  Two important things occur when you do 
  522.         this.  First, MSI looks for the FIRST non-space character on 
  523.         the line and SETS IT UP AS THE SELECTION KEY THAT THE USER CAN 
  524.         PRESS to select this option from the menu.  For this reason you 
  525.         will want to be careful to use different first characters for 
  526.         each option.  Numbering your options is one choice, though it 
  527.         is not required.  (If you have enabled the cursor bar for this 
  528.         menu BOTH methods will work: the user can make selections 
  529.         either by pressing the first character on the line or by 
  530.         highlighting the option with the cursor bar and pressing 
  531.         RETURN.  Note that you can use duplicate first characters.  MSI 
  532.         will always go to the first option using the character.  This 
  533.         might be useful in some applications.) 
  534.  
  535.         MOVE:
  536.         Pressing F3 allows you to move the highlighted option to a 
  537.         different line on the menu.  This is the same as swapping the 
  538.         option with the option immediately above or below it.  This is 
  539.         a more complex operation that might at first be evident.  Each 
  540.         option consists of more than just the string descriptor and the 
  541.         selection character.  Each option may have a sub-menu attached 
  542.         (defined) for it or an Action or both.  Moving the option 
  543.         involves moving all of its characteristics and associated 
  544.         Actions or menus.  While you could do this by hand the Move 
  545.         command is faster and more economical. 
  546.  
  547.         DEFINE:
  548.         The F4 key allows you to define an Action, sub-menu or both for 
  549.         the highlighted option.  What you define is determined by the 
  550.         'Selects:' setting from the Selection Option window, covered in 
  551.         detail later on.  If this is the first time an Action or menu 
  552.         is defined for the option a warning window will appear.  MSI 
  553.         allocates memory only as needed in order to keep memory use and 
  554.         the data file size to a minimum.  Defining a menu uses the 
  555.         least amount of memory, followed by an Action and, obviously, 
  556.         defining both uses the most memory per option.
  557.  
  558.         If a menu or Action has already been defined or allocated, no 
  559.         warning window will appear.  Instead, the appropriate Action 
  560.         window or menu will appear ready for editing.  A special Select 
  561.         setting is 'DUAL', allowing you to define a menu for which an 
  562.         Action will occur prior to the showing of the menu AND a 
  563.         second Action when the user leaves the menu.  In this instance 
  564.         Define will first display the pre-menu Action, then the post-
  565.         menu Action followed by the menu itself.  Watch the help line 
  566.         at the bottom of the screen for the commands available to you 
  567.         as you define Actions and menus.
  568.  
  569.  
  570.         DELETE:
  571.         Like Move, Deleting an option is more than just removing the 
  572.         string defining the option.  If an Action, single or Dual, is 
  573.         defined for the option then the Action(s) will be deleted and 
  574.         reserved memory restored.  Sub-Menus, however, will be left 
  575.         alone.
  576.  
  577.  
  578.         SELECTION OPTIONS:
  579.         
  580.         As mentioned earlier, at the top of the Menu Options window is 
  581.         a Selection Options command.  Pressing S will open two windows; 
  582.         one for general options (the top window) and the other for 
  583.         options specific to the Selection highlighted on the menu.
  584.  
  585.  
  586.         General Options 
  587.  
  588.         The General Options apply to all of the options defined for the 
  589.         current menu.  These are:
  590.  
  591.         MENU OPTIONS: - M -
  592.  
  593.         Takes you back to the Menu Options Window.
  594.  
  595.  
  596.         CURSOR BAR: - C -
  597.  
  598.         If set to Yes then the user can use the cursor up and down keys 
  599.         to move a highlighting bar through the menu's options, pressing 
  600.         the ENTER key to select the highlighted option.  If set to No 
  601.         then the user must press the first character of the option 
  602.         string to select it.
  603.  
  604.  
  605.         PROMPT LINE: - P -
  606.  
  607.         If you have defined a prompt string for the bottom of the menu 
  608.         and this is set to Yes then the string will be displayed and a 
  609.         standard flashing cursor positioned immediately following it.  
  610.         You may use BOTH a Prompt Line and Cursor Bar on a menu, if 
  611.         you really think you need to.
  612.  
  613.  
  614.         BACK: - B -
  615.  
  616.         The selection strings on the menu can be printed using a 
  617.         background color different from the menu background color.  
  618.         Careful designers can create some striking menus in this way.
  619.  
  620.  
  621.         FORE: - F -
  622.  
  623.         The selection string characters can also have a color different 
  624.         from the color used for the menu's Name, Prompt and Border.
  625.  
  626.  
  627.         FOR THIS OPTION:
  628.  
  629.         These apply ONLY to the currently highlighted option on the 
  630.         menu.
  631.  
  632.  
  633.         PASSWORD: - W -
  634.  
  635.         Each menu option may have a separate password attached to it.  
  636.         If a password is defined then the user will be presented with a 
  637.         window requesting the password before the Action occurs or the 
  638.         sub-menu is displayed.  Passwords may be up to seven characters 
  639.         long.  As additional protection the password will only be 
  640.         displayed when it is being edited.  At all other times this 
  641.         option will show "None" if no password is defined for the 
  642.         option, or "*******" if one has been defined. 
  643.  
  644.  
  645.         SELECTS: - S -
  646.  
  647.         This defines what happens next when the user selects the 
  648.         highlighted option.  These are:
  649.  
  650.            MENU: This allows you to define a sub-menu and another set 
  651.            of options for the user to select from.  
  652.  
  653.            ACTION: This allows you to define series of Batch File 
  654.            commands to be used in the creation of, and during the 
  655.            execution of ACT.BAT.  MSI will terminate and these commands 
  656.            will be issued to DOS.  At the completion of all of the 
  657.            Batch File commands, M.BAT will direct that MSI is reloaded 
  658.            and the starting menu displayed. 
  659.  
  660.            DUAL: This allows you to define a menu and two Actions; one 
  661.            executed prior to the display of the menu and the other when 
  662.            the user leaves the menu by pressing the ESC key.  The 
  663.            series of Action commands defined here are NOT issued 
  664.            through a Batch File, but as individual system commands.  
  665.            MSI will remain resident.  If the command causes a new 
  666.            program to execute, MSI will suspend itself until the 
  667.            program is terminated.
  668.         
  669.            
  670.         TYPE: - T -
  671.  
  672.         A menu option may be one of two types:
  673.  
  674.            NORMAL: This is a standard option that when selected will 
  675.            perform as defined by 'Selects:'.
  676.  
  677.            TEXT ONLY: An option of this type MAY NOT BE SELECTED.  The 
  678.            Cursor Bar will not highlight it nor will pressing the first 
  679.            character cause any action to occur.  Text Only options can 
  680.            have several uses.  They can be used to further describe an 
  681.            option immediately above or below.  They can be used to 
  682.            define a menu that is a pre-action warning screen, giving 
  683.            the user fair warning, for instance, that the next selected 
  684.            option will thoroughly clean-up the Hard Disk (Format C:...) 
  685.            or, more likely, clean out the contents of a scratch 
  686.            directory:
  687.  
  688.               cd \scratch
  689.               del *.*
  690.               cd \
  691.  
  692.  
  693.         EDITOR COMMANDS:
  694.  
  695.         MSI has been specially designed so that you will always be 
  696.         using the same set of editing features whether you are defining 
  697.         the Name for a menu, a Password, a Help screen or a set of 
  698.         Action commands. 
  699.  
  700.         The cursor keys are used to position the cursor as you would 
  701.         expect.  If you are editing a single line, such as a menu 
  702.         Option, menu Name or Password, there is nowhere to cursor up or 
  703.         down to, so these have no effect.  Otherwise the cursor keys 
  704.         will move the cursor within the limits of the item being 
  705.         edited.
  706.  
  707.         Press the End key to move the cursor to the end of the line and 
  708.         the Home key to move to the beginning of the line.
  709.  
  710.         If the cursor is positioned on the first character of ANY 
  711.         editable line, and this is the first character entered since 
  712.         the line was last edited, then the entire line will be CLEARED, 
  713.         then the typed character entered.  Otherwise characters will be 
  714.         entered in an overstrike mode at the cursor position. 
  715.  
  716.         Pressing the Insert key will cause spaces to be inserted into 
  717.         the line beginning at the cursor position.  Characters at the 
  718.         end of the line will be lost as they are pushed beyond the line 
  719.         limit.
  720.  
  721.         Pressing the Delete key will delete the character under the 
  722.         cursor, moving all characters to the right of the cursor one 
  723.         character left.
  724.  
  725.         The Back Space key will delete the character immediately to the 
  726.         left of the cursor by moving the character under the cursor, and 
  727.         those to the right, one character left.
  728.  
  729.         ALT-D is used to Delete the current line.  If you are editing a 
  730.         Help screen or Action commands the lines below the current line 
  731.         will all be moved up one line.
  732.  
  733.         ALT-I is used to Insert a blank line at the cursor location, 
  734.         moving the cursor line and all lines below it down one line in 
  735.         the window.  If you are editing a single line item, like a 
  736.         Prompt or Password, this command will have no effect.
  737.  
  738.  
  739.         The commands in MSI are not overly complicated but they do 
  740.         grant you a great deal of flexibility in defining your menus.
  741.  
  742.  
  743.  
  744.                                   END OF FILE
  745.  
  746.  
  747.         
  748.  
  749.  
  750.  
  751.  
  752.