home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / menu / sysmnu2.arc / SYSMENU.MAN < prev   
Encoding:
Text File  |  1987-06-16  |  14.8 KB  |  381 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                             SYStem MENU version 2.0
  8.                                reference manual
  9.                 Copyright Rabbit Data Systems, Inc., 1986, 1987
  10.  
  11.         SYStem MENU is a ShareWare program.  You may test this
  12.         program on your system free of charge.  You may distribute
  13.         it in its complete form.  If you find it useful a
  14.         registration fee of $25.00 is requested. Registration will
  15.         entitle you to:
  16.  
  17.            SYStem CLEAN         A program to clean the menu files.
  18.                                 This program will ensure that the
  19.                                 files are in the smallest form
  20.                                 possible.  It will reduce the time
  21.                                 necessary to load a menu on the
  22.                                 RAM drive.
  23.  
  24.            SYStem BREAKin       A program to display the passwords
  25.                                 associated with programs and sub
  26.                                 menus.  This is the only way to
  27.                                 discover lost passwords.
  28.  
  29.            free updates as they become available.
  30.  
  31.         Send fee to:
  32.             Rabbit Data Systems, Inc.
  33.             900 Lincoln, Box 300703
  34.             Denver, Co.  
  35.                        80203
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.                               Table of Contents                               
  43.  
  44. OVERVIEW                                              1
  45. INSTALLATION                                          1
  46. EXECUTION                                             1
  47. NOTES                                                 1
  48.      version 1.B users                                1
  49.      New users                                        1
  50.      Windows                                          2
  51.      Data Path                                        2
  52. MENU SYSTEM KEYS                                      2
  53.      Return to DOS (*)                                2
  54.      DOS Access (Shell) (@)                           2
  55.      Add Key to Menu (+)                              3
  56.      Delete Key from Menu (-)                         3
  57.      Backup SYStem MENU data files (!)                3
  58.      Write A Command File (>)                         3
  59.      Read A Command File (<)                          3
  60.      Display Sub Menu Directory (&&)                  3
  61.      Return to Main Menu (&*)                         4
  62.      Load A Sub Menu (&)                              4
  63.      Create A Sub Menu (&+)                           4
  64.      Delete A Sub Menu (&-)                           4
  65.      Edit A Sub Menu (&$)                             4
  66.      Help (?)                                         4
  67. SUB MENU SYSTEM KEYS                                  5
  68.      Return to Main Menu (*)                          5
  69.      Return to Previous Menu (@)                      5
  70.      Add A Sub Menu (+)                               5
  71.      Delete A Sub Menu (-)                            5
  72.      Backup SYStem MENU data files (!)                5
  73.      Return to Main Menu (&*)                         5
  74.      Load A Sub Menu (&)                              5
  75.      Create A Sub Menu (&+)                           5
  76.      Delete A Sub Menu (&-)                           5
  77.      Edit A Sub Menu (&$)                             5
  78.      Help (?)                                         5
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.      This manual in considered to be an overview of the SYStem MENU system.
  87. All commands and screens are covered, however, the on-line system help menu
  88. will provide a reasonable reference.
  89.  
  90.      To install the program place the distribution disk in drive A and type
  91. install.  The installation program will then ask what drive you want to
  92. install the menu on.  This is the drive that will be used for storage of all
  93. files.  THIS DRIVE MUST BE ACCESSIBLE TO THE PROGRAM AT ALL TIMES.  You will
  94. be asked if a RAM drive should be used for execution.  The execution files are
  95. the menu configuration file (SYSMENU.CFG) and the batch file to execute the
  96. programs (SMUCOMND.BAT).  These files are relatively small, placing them on a
  97. RAM disk will increase the execution time slightly and create a \MMenu
  98. directory on the ram disk.  You will then be asked if the main menu should use
  99. a RAM disk.  if there is space the main menu files (those having the extension
  100. .SMU) will be placed on the ram drive that you select.  If there is not enough
  101. space for all of the files then the menu will execute off of the drive on
  102. which the SYStem MENU was installed.
  103.  
  104.      To execute the program either copy the SYSMENU.BAT file to your root
  105. directory or directory in the path, or add \mmenu to the path.  To start the
  106. program type SYSMENU and press return.  A sub menu may be loaded at start up
  107. by typing "sysmenu XX" where XX is the key for the desired menu.
  108.  
  109.      Notes to version 1.B users:
  110.  
  111.                The files used by SYStem MENU version 2 are of
  112.           the same format as the files used by SYStem MENU
  113.           version 1.B or are new and will be created.
  114.  
  115.                The keys used by version 2 are the same as
  116.           version 1.B except where new functions have been
  117.           added.  You may want to review the submenu keys
  118.           (those begining with '&').
  119.  
  120.                Version 2 will install "on top of' version 1.B,
  121.           that is, you can install version 2 without damage to
  122.           your version 1.B files.  However due to the addition
  123.           of the data path you may be able to shorten some
  124.           command files.
  125.  
  126.      Notes to new users:
  127.  
  128.                When the program starts you will be shown the
  129.           main menu.  This menu will be empty.  You must start
  130.           by adding a key to the program.  For more informatin
  131.           on how this is done please consult the on-line help
  132.           (press "?[Return]") sections on adding a menu entry
  133.           (press "+[Return]"), and, system requests
  134.           ("$[Return]").
  135.  
  136.                Once you understand how to add a program to the
  137.           menu you may wish to examine the reading and writing
  138.                 SYStem MENU version 2 - Users Manual - Page 1                 
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.           of command files.  This makes editing menu entries
  146.           much easier and will facilitate the moving of
  147.           entries from one sub menu to another.
  148.  
  149.                To add a submenu consult the on-line help "&+"
  150.           entry.
  151.  
  152.      A note on windows:  Each main window has the window title on the top
  153. border.  Minor windows will display some information on the bottom border.
  154. Most main windows are stacked so that you can tell at any time what menu is
  155. loaded, if the directory of sub menus is displayed, and whether you are
  156. performing any other main task.
  157.  
  158.      A note on the Data Path:  The data path is the directory from which the
  159. menu will begin executing the command file.  This is the default data location
  160. for all programs in the sub menu.  The default data path for the main menu is
  161. the root directory of the drive on which the menu is installed.
  162.  
  163.      The system keys in use in all menus:
  164.  
  165.                 Symbol                  Result
  166.                 ======                  ======
  167.  
  168.                 *       Return to DOS 
  169.                 @       DOS Access (Shell) 
  170.                 +       Add Key to Menu 
  171.                 -       Delete Key from Menu 
  172.                 !       Backup SYStem MENU data files 
  173.                 >       Write A Command File 
  174.                 <       Read A Command File 
  175.                 &&      Display Sub Menu Directory 
  176.                 &*      Return to Main Menu 
  177.                 &       Load A Sub Menu 
  178.                 &+      Create A Sub Menu 
  179.                 &-      Delete A Sub Menu 
  180.                 &$      Edit A Sub Menu 
  181.                 ?       Help 
  182.  
  183.          Return to DOS (*) 
  184.              To exit the SYStem MENU type "*[Return]" and you
  185.         will be returned to DOS.  This is the method that should
  186.         be used when you are finished with the program.
  187.  
  188.         DOS Access (Shell) (@) 
  189.              Typing "@[Return]" will provide you access to DOS
  190.         without leaving the SYStem MENU.  You will have to type
  191.         "exit" to be returned to the menu.  If you attempt to
  192.         reload the SYStem MENU by typing "sysmenu" the amount of
  193.         memory that you will have available will be reduced by
  194.         approx 130K.
  195.  
  196.  
  197.  
  198.                 SYStem MENU version 2 - Users Manual - Page 2                 
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.         Add Key to Menu (+) 
  207.              If you type "+[Return]" at the menu prompt you will
  208.         be taken to the add menu entry screen.  You must provide
  209.         A key (1 or 2 characters) to load the program with and an
  210.         identification to be displayed with the key on the menu.
  211.         You must then enter the DOS commands used to run the
  212.         program.  This should include any substitution of drives,
  213.         changes of directory, etc.  You can determine what
  214.         commands you will need by reading the batch files that
  215.         you currently use to execute your programs.  Note that
  216.         all programs in a menu will run from the data path.  The
  217.         data path is displayed in the upper left hand corner of
  218.         the screen.  If you need to use a replaceable parameter
  219.         you can use the {$Iprompt} input request.  More
  220.         information on the format of this system function can be
  221.         found in the on-line help program.  If you want to
  222.         password the menu entry you must use the {$P} system
  223.         function.  More information on this function can be found
  224.         in the on-line help program.
  225.  
  226.         Delete Key from Menu (-) 
  227.              Typing "-[Return]" will allow you to delete a key
  228.         from the menu.  You must enter the key that you want to
  229.         delete, the password it applicable, and then verify that
  230.         you really want to delete the entry.  Note:  Once an
  231.         entry is deleted there is no way, short of typing the
  232.         commands back in, of restoring it.
  233.  
  234.         Backup SYStem MENU data files (!) 
  235.              This function will create a DOS backup of your
  236.         system files.  This will backup to the A drive.
  237.  
  238.         Write A Command File (>) 
  239.              This function will allow you to write the command
  240.         file associated with a key on a menu to a disk file
  241.         provided that you know the password if there is one.
  242.         This is used to edit long command files when testing or
  243.         to transfer menu entries from one sub menu to another.
  244.  
  245.         Read A Command File (<) 
  246.              This function will allow you to read an ASCII
  247.         command file.  This file should contain the commands as
  248.         you would type them in at the Add Key to Menu (+)
  249.         function.
  250.  
  251.         Display Sub Menu Directory (&&)
  252.              This function displays the sub menu directory.  You
  253.         may then load any sub menu listed by typing the key.
  254.         WHEN THE SUB MENU DIRECTORY IS BEING DISPLAYED SOME OF
  255.         THE SYSTEM KEYS PERFORM SLIGHTLY DIFFERENT FUNCTIONS OR
  256.         ARE NOT VALID.
  257.  
  258.                 SYStem MENU version 2 - Users Manual - Page 3                 
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.         Return to Main Menu (&*)
  267.              This function will allow you to return to the main
  268.         menu from any sub menu.  Typing "&*" will cause the main
  269.         menu to be loaded.
  270.  
  271.         Load A Sub Menu (&) 
  272.              This is a shortcut to load a sub menu if you know
  273.         the key.  Type "&[Return]" and you will be asked for the
  274.         key for the sub menu that you wish to load.  If the key
  275.         is valid and you know the password, if applicable, the
  276.         selected menu will be loaded.  Otherwise you will be
  277.         returned to the current menu.
  278.  
  279.         Create A Sub Menu (&+) 
  280.              This function will create a new sub menu.  You will
  281.         be asked for the key to use on the directory of sub
  282.         menus, the menu name, the data path, whether the menu
  283.         should use a RAM drive, and a password.  The data path is
  284.         the disk and directory from which all commands in the
  285.         menu will start.  This must be a valid directory at the
  286.         time that the menu is created.  The RAM drive will
  287.         specify a drive to place the menu data files on when the
  288.         menu is loaded.  If there is not room on the RAM drive
  289.         the menu will be run from the disk on which the SYStem
  290.         MENU is installed.  The password is capitalization
  291.         sensitive.  If you do not want a password press
  292.         "[Return]" for the password.  DO NOT FORGET THE PASSWORD.
  293.         THE PASSWORDS ARE ENCODED IN THE FILES.  THERE IS NO WAY
  294.         TO RECOVER A LOST PASSWORD WITHOUT THE SYSBREAK PROGRAM.
  295.  
  296.         Delete A Sub Menu (&-)
  297.              This is similar to the delete key from menu option
  298.         above except that you are deleting an entire menu.  All
  299.         data for that menu will be destroyed!
  300.  
  301.         Edit A Sub Menu (&$) 
  302.              This function will allow you to change any of the
  303.         data found on the create sub menu screen provided you
  304.         know the password, if applicable.
  305.  
  306.         Help (?) 
  307.              This function will display the short help screen.
  308.         If you want the long help screen enter the key for the
  309.         function that you want help with.
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.                 SYStem MENU version 2 - Users Manual - Page 4                 
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326. The system keys when the directory of sub menus is displayed are:
  327.  
  328.                 Symbol                  Result
  329.                 ======                  ======
  330.  
  331.                 *       Return to Main Menu 
  332.                 @       Return to Previous Menu 
  333.                 +       Add Sub Menu 
  334.                 -       Delete Sub Menu 
  335.                 !       Backup SYStem MENU data files 
  336.                 &*      Return to Main Menu 
  337.                 &       Load A Sub Menu 
  338.                 &+      Create A Sub Menu 
  339.                 &-      Delete A Sub Menu 
  340.                 &$      Edit A Sub Menu 
  341.                 ?       Help 
  342.  
  343.         Return to Main Menu (*) 
  344.               See (&*) above.
  345.  
  346.         Return to Previous Menu (@) 
  347.              This function will allow you to return from the
  348.         directory of sub menus to the currently loaded menu.
  349.  
  350.         Add Sub Menu (+) 
  351.              See (&+) above.
  352.  
  353.         Delete Sub Menu (-) 
  354.              See (&-) above.
  355.  
  356.         Backup SYStem MENU data files (!) 
  357.              See (!) above.
  358.  
  359.         Return to Main Menu (&*) 
  360.              See (&*) above.
  361.  
  362.         Load A Sub Menu (&) 
  363.              See (&) above.
  364.  
  365.         Create a Sub Menu (&+) 
  366.              See (&+) above.
  367.  
  368.         Delete a Sub Menu (&-) 
  369.              See (&-) above.
  370.  
  371.         Edit A Sub Menu 
  372.              See (&$) above.
  373.  
  374.         Help (?) 
  375.              See (?) above.
  376.  
  377.  
  378.                 SYStem MENU version 2 - Users Manual - Page 5                 
  379.  
  380.  
  381.