home *** CD-ROM | disk | FTP | other *** search
/ Best Objectech Shareware Selections / UNTITLED.iso / boss / util / menu / 003 / max-menu.doc < prev    next >
Encoding:
Text File  |  1989-03-03  |  125.5 KB  |  2,702 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                            M a x - M e n u
  16.  
  17.  
  18.                              Version 1.2
  19.  
  20.                                                      
  21.                Copyright (C) 1988,1989 by Don Cappaert
  22.                         All rights reserved.
  23.  
  24.  
  25.  
  26.                      Don Cappaert                  
  27.                      P.O. Box 249
  28.                      Andalusia, IL 61232-0249 
  29.                      CompuServe user ID: 71170,740
  30.                                                                         Page  i
  31.  
  32. Table of Contents
  33. =================
  34.  
  35.  
  36. Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  37.          System Requirements  . . . . . . . . . . . . . . . . . .    2
  38.          Reporting Problems . . . . . . . . . . . . . . . . . . .    2
  39.          Files on the Distribution Disk . . . . . . . . . . . . .    2
  40.          Installation . . . . . . . . . . . . . . . . . . . . . .    3
  41.          Sample Menus . . . . . . . . . . . . . . . . . . . . . .    4
  42.  
  43.  
  44. Chapter 1: Using the Menus  . . . . . . . . . . . . . . . . . . .    5
  45.          Invoking Max-Menu  . . . . . . . . . . . . . . . . . . .    5
  46.          Menu Anatomy . . . . . . . . . . . . . . . . . . . . . .    5
  47.          Menu Cursor Movement Keys  . . . . . . . . . . . . . . .    7
  48.          Getting Help . . . . . . . . . . . . . . . . . . . . . .    7
  49.          Choosing a Selection . . . . . . . . . . . . . . . . . .    8
  50.          Menu Navigation  . . . . . . . . . . . . . . . . . . . .    8
  51.          Input Prompts  . . . . . . . . . . . . . . . . . . . . .    9
  52.          System Menu  . . . . . . . . . . . . . . . . . . . . . .   10
  53.          Programmable Keys  . . . . . . . . . . . . . . . . . . .   11
  54.          Run Programs, Commands and Batch Files . . . . . . . . .   12
  55.          Quitting Max-Menu  . . . . . . . . . . . . . . . . . . .   13
  56.  
  57.  
  58. Chapter 2: Modifying Menus  . . . . . . . . . . . . . . . . . . .   14
  59.          Modify Menu Characteristics  . . . . . . . . . . . . . .   14
  60.             Title . . . . . . . . . . . . . . . . . . . . . . . .   15
  61.             Password  . . . . . . . . . . . . . . . . . . . . . .   15
  62.             ID Type . . . . . . . . . . . . . . . . . . . . . . .   15
  63.          Add a Selection / Sub-Menu . . . . . . . . . . . . . . .   16
  64.             Description   . . . . . . . . . . . . . . . . . . . .   17
  65.             Password  . . . . . . . . . . . . . . . . . . . . . .   17
  66.             Sub-menu  . . . . . . . . . . . . . . . . . . . . . .   17
  67.             Batch commands  . . . . . . . . . . . . . . . . . . .   17
  68.          Update a Selection . . . . . . . . . . . . . . . . . . .   19
  69.          Copy or Transfer a Selection . . . . . . . . . . . . . .   21
  70.          Delete a Selection / Sub-Menu  . . . . . . . . . . . . .   22
  71.          Advanced Topics  . . . . . . . . . . . . . . . . . . . .   23
  72.             Wild Cards in Sub-Menu Name . . . . . . . . . . . . .   23
  73.             Input Prompt and Initial Input  . . . . . . . . . . .   25
  74.             Batch Commands Execution Mode . . . . . . . . . . . .   26
  75.             Variables . . . . . . . . . . . . . . . . . . . . . .   26
  76.             Copy or Transfer a Sub-Menu . . . . . . . . . . . . .   28
  77.  
  78.  
  79. Chapter 3: Customizing Max-Menu . . . . . . . . . . . . . . . . .   29
  80.          Directories  . . . . . . . . . . . . . . . . . . . . . .   29
  81.          Colors . . . . . . . . . . . . . . . . . . . . . . . . .   31
  82.          RamCopy  . . . . . . . . . . . . . . . . . . . . . . . .   34
  83.          Main Menu Name . . . . . . . . . . . . . . . . . . . . .   34
  84.          ScreenSave . . . . . . . . . . . . . . . . . . . . . . .   34
  85.          Entry Mode for Input . . . . . . . . . . . . . . . . . .   34
  86.          Password Protecting System Functions . . . . . . . . . .   35
  87.          Files  . . . . . . . . . . . . . . . . . . . . . . . . .   36
  88.                                                                         Page ii
  89.  
  90. Appendix A: Hints . . . . . . . . . . . . . . . . . . . . . . . .   37
  91.          Invoke Max-Menu Without Directory Change . . . . . . . .   37
  92.          Invoke Max-Menu Automatically  . . . . . . . . . . . . .   37
  93.          Keep Max-Menu from Changing Directory  . . . . . . . . .   37
  94.          Removing ECHO OFF  . . . . . . . . . . . . . . . . . . .   38
  95.          Renaming MENU.BAT file . . . . . . . . . . . . . . . . .   38
  96.          Forgotten Passwords  . . . . . . . . . . . . . . . . . .   38
  97.          Selection Password Annoying  . . . . . . . . . . . . . .   39
  98.          Providing Help for Menus and Selections  . . . . . . . .   39
  99.          Maximizing Performance . . . . . . . . . . . . . . . . .   39
  100.  
  101.  
  102. Appendix B: Networks and shared PCs . . . . . . . . . . . . . . .   41
  103.  
  104.  
  105. Appendix C: Messages  . . . . . . . . . . . . . . . . . . . . . .   43
  106.  
  107.  
  108. Appendix D: Registering Max-Menu  . . . . . . . . . . . . . . . .   47
  109.  
  110.  
  111. Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   48
  112.                                                                         Page  1
  113.  
  114. Introduction
  115. ============
  116.  
  117.   Max-Menu is the flexible menu system that allows you to define your
  118. menus as you wish.  This menu system was designed for both the
  119. beginner and the advanced computer user.  It provides the simplicity
  120. of choosing selections from menus, unparalleled flexibility in
  121. menu/selection definition and power through the use of programmable
  122. "hot" keys.           
  123.  
  124.   The menus you define provide an easy and friendly interface to the
  125. programs on your hard-disk.  Like an index for floppy disks, it keeps
  126. track of where these programs are and how to invoke them.  Thus, for
  127. often used programs, you need not continually enter the commands
  128. required to run them.  Max-Menu also frees you from remembering the
  129. location of seldom used programs and how to invoke them.  Also, batch
  130. files that invoke your programs can be replaced by selections.  
  131.  
  132.   Max-Menu provides flexibility beyond other menus, such as:
  133.  
  134.  +  User can fully customize menus, selections, colors and directories.
  135.  +  Simplified selection entry/update with on-board editor.
  136.  +  Single keystroke or point-and-press selection.
  137.  +  Three types of selection IDs.  Selections may be chosen by an
  138.     alpha-numeric ID, a numeric ID or by the first character of the
  139.     selection's description.
  140.  +  Each menu may have up to 99 selections.
  141.  +  Menus may have sub-menus: up to 10 menus deep.
  142.  +  A selection may run up to 99 lines of DOS commands, programs or
  143.     batch files.  These conform to standard batch file conventions. 
  144.  +  A selection's commands may be received from or sent to, a batch
  145.     file.  
  146.  +  Commands for a selection may be executed directly for speed or by
  147.     temporarily exiting to provide more memory.
  148.  +  Selections may prompt user for input.
  149.  +  Full use of variables: Environment, global, input and special
  150.     (which give the date, time, drive, directory and DOS version
  151.     information).
  152.  +  Programmable "hot" keys can be defined just as selections are. 
  153.     These keys can be used from any user menu.
  154.  +  Extensive password protection (6 levels of security) and
  155.     encryption.
  156.  +  Ram Drive options for performance.
  157.  +  Screen save feature provided to clear screen after a defined
  158.     period of inactivity.
  159.  +  Complete Local Area Network (LAN) and shared PC support.
  160.  +  Extensive on-line help.
  161.  
  162.   Max-Menu is the simple, powerful and flexible menu system.
  163.  
  164.  
  165.  
  166.                                                                         Page  2
  167.  
  168. System Requirements
  169. ===================
  170.  
  171.   Max-Menu requires MS-DOS / PC-DOS 2.0 or above.  It is designed to
  172. work on the IBM PC, XT, or AT models, or a fully compatible machine. 
  173. A minimum of 256K of memory is also required.  While Max-Menu can run
  174. from a floppy-based system, it is highly recommended that it be ran
  175. from a hard-disk system.
  176.  
  177.  
  178.  
  179. Reporting Problems
  180. ==================
  181.  
  182.   To report problems, first print the registration form as outlined in
  183. appendix C.  Then fill in your name, address, phone and registration
  184. number (on distribution disk label).  Use the comment section to
  185. explain your problem and then send to the address shown.       
  186.  
  187.   You may also send a message on CompuServe to user ID 71170,740.
  188.  
  189.  
  190.  
  191. Files on the Distribution Disk
  192. ==============================
  193.  
  194.   The files contained on the distribution disk are:
  195.  
  196.     INSTALL.BAT installs or reinstalls Max-Menu.
  197.  
  198.     MENU.BAT starts Max-Menu.  
  199.  
  200.     MAX-MENU.EXE is the program invoked by MENU.BAT. 
  201.  
  202.     MAX-MNUX.BAT is the batch file created from selection.  
  203.  
  204.     MAX-MENU.HLP is the on-line help file.
  205.  
  206.     MAX-MENU.KYS is the sample programmable "hot" keys.
  207.  
  208.     MAX-MENU.FRM is the registration form.
  209.  
  210.     *.MNU are sample menus (all menus have .MNU extension).
  211.  
  212.     README contains information more current than the manual.  To view
  213.     this file, insert the distribution disk into drive A.  Then enter
  214.     "TYPE A:\README || MORE" at the DOS prompt.
  215.  
  216.     MAX-MENU.DOC is the manual in ASCII text form.
  217.  
  218.     PRINTDOC.BAT prints the documentation file(s).
  219.  
  220.  
  221.                                                                         Page  3
  222.  
  223. Installation
  224. ============
  225.  
  226. To install/reinstall Max-Menu perform the following steps:
  227.   
  228. 1.  Insert the distribution disk into your diskette drive (ex. A).
  229.  
  230. 2.  Then, assuming the distribution disk is in drive A, enter the
  231.     following at the DOS prompt: 
  232.  
  233.             C>A:INSTALL  A:
  234.  
  235.     If the distribution disk is not in drive A, substitute the proper
  236.     drive letter.  This will install/reinstall Max-Menu, by copying
  237.     the appropriate files from the distribution disk to the directory
  238.     of C:\MAX-MENU.     
  239.  
  240.                                - OR -
  241.  
  242.     If you prefer to use a directory other than C:\MAX-MENU, you must
  243.     first create the directory (using DOS MKDIR command), make this
  244.     drive and directory the current one (using DOS CHDIR command) and
  245.     type A:INSTALL A: /C at the DOS prompt.  The /C switch causes the
  246.     installation to be done to the current drive and directory instead
  247.     of C:\MAX-MENU.  For example, the commands required to install
  248.     into a new directory called C:\MYDIR are:
  249.  
  250.          C>MKDIR  \MYDIR
  251.          C>CHDIR  \MYDIR
  252.          C>A:INSTALL  A:  /C
  253.  
  254. 3.  Remove the distribution disk and store it in a safe place. 
  255.  
  256. 4.  Next, verify the installation by invoking Max-Menu.  Since the
  257.     Max-Menu directory is the current directory, simply enter MENU at
  258.     the DOS prompt as follows:
  259.  
  260.          C>MENU
  261.  
  262.     The main menu will be displayed on the screen.  
  263.  
  264. 5.  If you are reinstalling Max-Menu (ie. a prior version is being
  265.     replaced), redo setup changes made to prior version. 
  266.  
  267. Congratulations, you have now completed the installation.
  268.  
  269.  
  270.                                                                         Page  4
  271.  
  272. Sample Menus
  273. ============
  274.  
  275.   Max-Menu comes complete with a set of sample menus.  These menus are
  276. designed to give you ideas on how to structure your menus and also how
  277. to create selections.  The structure of the sample menus is depicted
  278. in the following "tree" diagram that shows each of the menu names:
  279.  
  280.   MAIN -+- SAMPLES -+- SAMPDIR
  281.         |           +- SAMPDRVE
  282.         |           +- SAMPATTR
  283.         +- DBMS
  284.         +- GAMES
  285.         +- LANGUAGE
  286.         +- MISC
  287.         +- GRAPHICS
  288.         +- UTILITY --- FLOPPY 
  289.  
  290.     NOTE:   SAMPDRVE is a sub-menu of SAMPLES which is a    sub-menu
  291.             of MAIN. 
  292.  
  293.   The selections on these sample menus can be broken into three
  294. categories:
  295.   
  296.  +  Selections that display a sub-menu.  The description for these
  297.     types of selections include the word "menu".  For example,
  298.     choosing the "Max-Menu samples menu" selection on the MAIN menu
  299.     causes the SAMPLES menu to be displayed. 
  300.  
  301.  +  Selections that will perform the indicated task using DOS
  302.     commands.  These selections exist only in the SAMPLES menu and its
  303.     sub-menus.  Thus, choosing the "DOS version" selection on the
  304.     SAMPLES menu will display the version of DOS running on your
  305.     computer.  These functional selections are intended to show the
  306.     various ways selections may be coded.    
  307.  
  308.  +  All remaining selections, such as "Word processing" on the MAIN
  309.     menu, do not invoke any program.  Instead, these selections "ECHO"
  310.     statements to your screen indicating how you might change them to
  311.     actually invoke your programs.  
  312.  
  313.   You are encouraged to modify these menus and selections to suit your
  314. tastes and needs.  Please keep in mind that the SAMPLES menu and its
  315. sub-menus will be referenced in this manual and should therefore be
  316. kept for future reference (you may want to move them off the MAIN
  317. menu).  
  318.                                                                         Page  5
  319.  
  320. Chapter 1: Using the Menus
  321. ==========================
  322.  
  323.  
  324. Invoking Max-Menu
  325. =================
  326.  
  327.   To invoke Max-Menu, you must first change to the directory
  328. containing Max-Menu (unless this directory is in your PATH) and then
  329. type MENU at the DOS prompt.  Thus, if you installed into C:\MAX-MENU,
  330. the commands are:
  331.  
  332.     C>CHDIR  \MAX-MENU
  333.     C>MENU
  334.  
  335. This will display the main menu.  If you would like to start at a menu
  336. other than the main menu, follow MENU with the menu name to start at. 
  337. The following switches can also be used:
  338.  
  339.     /I   re-initialize the setup (except passwords) to its original
  340.          values.  
  341.  
  342.     /K   will pass to Max-Menu keys to be entered after it starts (as
  343.          if they were entered from the keyboard).  This allows
  344.          selections to be invoked when starting Max-Menu (especially
  345.          from a AUTOEXEC.BAT file).  Programmable keys are represented
  346.          by the @ sign followed by the desired key (ex. @A is Alt-A). 
  347.          Use @@ to represent a single @ sign. 
  348.  
  349. For example, to reset the setup, display the SAMPLES menu and then
  350. cause the keys "A", "Alt-B" and "@" to be entered: 
  351.  
  352.     C>CHDIR  \MAX-MENU
  353.     C>MENU  SAMPLES  /I  /KA@B@@
  354.  
  355.  
  356.  
  357. Menu Anatomy
  358. ============
  359.  
  360.   After invoking Max-Menu, the main menu will be displayed.  Pictured
  361. below is the sample main menu (this may have been altered) showing
  362. each of the components of a menu:  
  363.                                                                         Page  6
  364.  
  365. Border-+    Selection IDs-+  Title-+  Selection Description-+  Selection Bar-+
  366.        |                  |        |                        |                |
  367.        v                  |        v                        |                |
  368. +-------------------------+------- Main Menu ---------------+----------------+-+
  369. |                         |                                 |                | |
  370. |                         |                                 |                | |
  371. |                         +--+                              |                | |
  372. |                            |                              |                | |
  373. |                            |                              |                | |
  374. |                            v                              |                | |
  375. |                            Max-Menu samples menu <--------+                | |
  376. |                            Data management menu                            | |
  377. |                           _Games_menu <------------------------------------+ |
  378. |                            Languages menu                                    |
  379. |                            Miscellaneous menu                                |
  380. |                            Picture graphics menu                             |
  381. |                            Utilities menu                                    |
  382. |                            Word processing                                   |
  383. |                            Shutdown                                          |
  384. |                            Help                                              |
  385. |                                                                              |
  386. |                                                                              |
  387. |                                                                              |
  388. |                                                                              |
  389. |                                                                              |
  390. |                                                                              |
  391. +------------------------------------------------------------------------------+
  392. 11:26:53 AM  Friday  May 06, 1988                              F1=Help  Max-Menu
  393.                          ^
  394.                          |
  395.          Bottom line ----+
  396.  
  397.  
  398.  
  399.     Border is the double line drawn around the menu.
  400.   
  401.     Title is the name given to the menu.  For instance, a menu
  402.     containing games might be titled "Games".
  403.  
  404.     Selection Description is a short description of what the selection
  405.     will do.  For example, the "Help" selection provides additional
  406.     help specific to this menu.
  407.  
  408.     Selection IDs is the highlighted identifier at the left of each
  409.     selection.  This selection ID may be the first character of the
  410.     description as shown above, a number (from 1 to 99) or alpha-
  411.     numeric (the letters A to Z, followed by numbers 0 to 9).
  412.  
  413.     Selection Bar highlights the current selection.  In the sample
  414.     main menu above, "Games menu" is the current selection.
  415.  
  416.     Bottom line will always be displayed at the bottom of the screen
  417.     showing the current date and time.  It also indicates to press the
  418.     F1 key for help.  In addition to this the status of the Alt, Ctrl,
  419.     Caps Lock / Shift, Num Lock and Scroll Lock keys is displayed. 
  420.     Try pressing these keys to see how each is displayed.
  421.  
  422.                                                                         Page  7
  423.  
  424. Menu Cursor Movement Keys
  425. =========================
  426.                                                       
  427.   Max-Menu uses the same keys in all menus to move the selection bar. 
  428. These keys are:                                                       
  429.      
  430.     Up arrow . . . . : Up one selection.                    
  431.     Down arrow . . . : Down one selection.                  
  432.     Left arrow . . . : Left one column.                     
  433.     Right arrow  . . : Right one column.                    
  434.     Home . . . . . . : First selection.                     
  435.     End  . . . . . . : Last selection.                      
  436.     PgUp . . . . . . : Page up / top of current column.     
  437.     PgDn . . . . . . : Page down / bottom of current column.
  438.     Ctrl-left arrow  : Start of current row.
  439.     Ctrl-right arrow : End of current row.                   
  440.  
  441.   Try each of these keys.  Notice the selection bar "wraps" around
  442. when the arrow keys are held down.  If you press the down arrow key
  443. when positioned on the last item, the selection bar will be placed on
  444. the first item.  The Ctrl-left arrow and Ctrl-right arrow keys have no
  445. effect when the menu contains only one column of selections. 
  446.  
  447.                       
  448.           
  449. Getting Help
  450. ============
  451.  
  452.   Press the F1 key to get help.  This will display the help screen
  453. which consists of two windows.  The left window contains a menu of
  454. topics, and the right window has an explanation of the highlighted
  455. topic.  The sequence of topics allows new users to read all about Max-
  456. Menu by pressing the down arrow key to read the next topic.  To view
  457. the explanation for a topic, enter the first character of the topic. 
  458. For example, press F1 and then Y to get the following help:
  459.                                                                         Page  8
  460.  
  461. +----------------------++----------------- User menu window -------------------+
  462. | Help explained       ||                                                      |
  463. | Notice of copyright  || User menu windows are the main menu and all of its   |
  464. |_Your_menu_window     || sub-menus.  Their selections are defined by you.     |
  465. | List of menu keys    || Selections may be added, updated, deleted, copied or |
  466. | Pop-up system menus  || transferred.  The addition and deletion of menus is  |
  467. | Input prompt window  || accomplished by adding, deleting or updating         |
  468. | Warning messages     || selections.  Also, menu characteristics (ex. title)  |
  469. | Add selection        || may be modified.                                     |
  470. | Update selection     ||                                                      |
  471. | Batch commands       || You may choose a selection by using the arrow keys   |
  472. | Variables            || to highlight the selection and then hit enter.  See  |
  473. | Delete selection     || the List of menu keys help topic for all the keys    |
  474. | Copy selection       || available and ways to choose selections.             |
  475. | Transfer selection   ||                                                      |
  476. | Menu modification    || The following keys are also valid:                   |
  477. | Keys - programmable  ||                                                      |
  478. | Setup                ||     Esc  . . . . . .: Return to prior menu.  If in   |
  479. | - Setup directories  ||                       main menu, will quit Max-Menu. |
  480. | Run DOS commands     ||     Back-slash (\) .: Return to main menu.           |
  481. | Exit - shell to DOS  ||     Slash (/)  . . .: Invoke system menu options.    |
  482. | Quit Max-Menu        ||     Alt-?  . . . . .: Invoke programmable key. Where |
  483. | Form to register     ||                       ? is "A" through "Z".          |
  484. +----------------------++------------------------------------------------------+
  485.  3:41:15 PM  Friday  May 13, 1988                              F1=Help  Max-Menu
  486.  
  487.   To leave Max-Menu's help, enter the Esc key.
  488.  
  489.  
  490.  
  491. Choosing a Selection
  492. ====================
  493.  
  494.   To choose a selection, type the highlighted ID at the left of the
  495. selection or move the selection bar to the desired item and press the
  496. Enter key.  Try choosing the "Help" selection on the sample main menu
  497. by pressing H.  
  498.  
  499.  
  500.  
  501. Menu Navigation
  502. ===============
  503.  
  504.   Navigating to a lower level (sub) menu is done by choosing the
  505. appropriate selection.  For example, choosing the "Max-Menu samples
  506. menu" selection on the sample main menu will display the following
  507. sub-menu:
  508.                                                                         Page  9
  509.  
  510. +------------------------------ Max-Menu Samples ------------------------------+
  511. |                                                                              |
  512. |                                                                              |
  513. |                                                                              |
  514. |                                                                              |
  515. |                                                                              |
  516. |    _A_Execute_a_DOS_command               M Date change                      |
  517. |     B Dynamic PATHing example             N Time change                      |
  518. |     C Change DOS PATH                     O Read-only attribute menu         |
  519. |     D Display directory menu              P Type a file                      |
  520. |     E Copy floppy on A: to B:             Q Print a file                     |
  521. |     F Format floppy menu                  R Copy a file                      |
  522. |     G Format floppy with DOS menu         S Rename a file                    |
  523. |     H Check disk drive menu               Y Delete a file                    |
  524. |     I Display volume label menu           U Find text in file                |
  525. |     J Set volume label menu               V Blank selection                  |
  526. |     K DOS version = 3.10                  W Log events menu                  |
  527. |     L Display information                 X Help                             |
  528. |                                                                              |
  529. |                                                                              |
  530. |                                                                              |
  531. |                                                                              |
  532. |                                                                              |
  533. +------------------------------------------------------------------------------+
  534.  2:24:15 PM  Saturday  May 14, 1988                            F1=Help  Max-Menu
  535.  
  536.   To return to the prior menu enter the Esc key.  To return to the
  537. main menu from any sub-menu, enter the back-slash (\) key.        
  538.  
  539.  
  540.  
  541.  
  542. Input Prompts
  543. =============
  544.                                                      
  545.   The Input prompt window is displayed when prompting for a single
  546. line of input.  It is used for all selection and most system input
  547. requests.  The window will appear at the bottom of your screen.  The
  548. top line of the window will contain a message indicating the desired
  549. input.  The input line may be blank or contain a default value.  You
  550. may then enter or change the input using the following editing keys: 
  551.                                                       
  552.     Enter .......: Enter input in response to prompt.     
  553.     Esc .........: Abort input prompt request.            
  554.     Left arrow ..: Move cursor left one character.        
  555.     Right arrow .: Move cursor right one character.       
  556.     Home ........: Move cursor to start of input.         
  557.     End .........: Move cursor to end of input.           
  558.     Insert ......: Toggle between insert/overwrite mode.  
  559.     Delete ......: Delete character at cursor.            
  560.     Backspace ...: Delete character before cursor.        
  561.     Ctrl-Home ...: Clear input.                           
  562.     Ctrl-End ....: Clear input from cursor to end.        
  563.     Up arrow ....: Get previous input in buffer.          
  564.     Down arrow ..: Get next input in buffer.              
  565.     PgUp  .......: Get oldest input in buffer.            
  566.     PgDn  .......: Get newest input in buffer.            
  567.                                                                         Page 10
  568.  
  569.   Each time you enter input into this window, it is saved into a
  570. buffer.  Once the buffer becomes full, the oldest input(s) is removed
  571. as new input is entered.  By using the up arrow, down arrow, PgUp and
  572. PgDn keys, you can scroll through prior inputs.  Once you have located
  573. the desired input, you may modify it if need be and then hit enter. 
  574.  
  575.   The bottom line of the screen will show whether you are in insert or
  576. overwrite mode.  When in insert mode the characters you type are
  577. inserted at the cursor position.  When in overwrite mode the character
  578. you type replaces the character at the cursor position.  
  579.  
  580.   For example, select "Execute a DOS command" on the Max-Menu Samples
  581. menu.  The input prompt window will pop-up at the bottom of your
  582. screen:
  583.  
  584. +------------------------------ Max-Menu Samples ------------------------------+
  585. |                                                                              |
  586. |                                                                              |
  587. |                                                                              |
  588. |                                                                              |
  589. |                                                                              |
  590. |    _A_Execute_a_DOS_command               M Date change                      |
  591. |     B Dynamic PATHing example             N Time change                      |
  592. |     C Change DOS PATH                     O Read-only attribute menu         |
  593. |     D Display directory menu              P Type a file                      |
  594. |     E Copy floppy on A: to B:             Q Print a file                     |
  595. |     F Format floppy menu                  R Copy a file                      |
  596. |     G Format floppy with DOS menu         S Rename a file                    |
  597. |     H Check disk drive menu               Y Delete a file                    |
  598. |     I Display volume label menu           U Find text in file                |
  599. |     J Set volume label menu               V Blank selection                  |
  600. |     K DOS version = 3.10                  W Log events menu                  |
  601. |     L Display information                 X Help                             |
  602. |                                                                              |
  603. |                                                                              |
  604. |                                                                              |
  605. +- Enter DOS command, program or batch file to execute: -----------------------+
  606. |                                                                              |
  607. +------------------------------------------------------------------------------+
  608.  4:09:35 PM  Saturday  May 14, 1988   Ins                      F1=Help  Max-Menu
  609.  
  610.   Then enter a DOS command such as DIR /W.  Choose this selection
  611. several times, each time entering a different DOS command, such as,
  612. VER and CHKDSK.  Be sure to try each of the editing keys listed
  613. previously. 
  614.  
  615.  
  616. System Menu
  617. ===========
  618.  
  619.   The system menu contains selections that allow you to modify the
  620. current menu being displayed.  You can also choose to display the
  621. programmable keys, change the setup (configuration), print the
  622. registration form, or quit Max-Menu.  Finally, you can run DOS
  623. commands, batch files and programs, or temporarily exit to DOS.  Each
  624. of these will be discussed in detail later in the manual.  To display
  625. the system menu type a slash (/):
  626.                                                                         Page 11
  627.  
  628. +------------------------------------------------------------------------------+
  629. |_Add  Update  Delete  Copy  Transfer  Menu  Keys  Setup  Run  Exit  Quit  Form|
  630. | Add a selection before or after current selection                            |
  631. +------------------------------------------------------------------------------+
  632. |                                                                              |
  633. |                                                                              |
  634. |    _A_Execute_a_DOS_command               M Date change                      |
  635. |     B Dynamic PATHing example             N Time change                      |
  636. |     C Change DOS PATH                     O Read-only attribute menu         |
  637. |     D Display directory menu              P Type a file                      |
  638. |     E Copy floppy on A: to B:             Q Print a file                     |
  639. |     F Format floppy menu                  R Copy a file                      |
  640. |     G Format floppy with DOS menu         S Rename a file                    |
  641. |     H Check disk drive menu               Y Delete a file                    |
  642. |     I Display volume label menu           U Find text in file                |
  643. |     J Set volume label menu               V Blank selection                  |
  644. |     K DOS version = 3.10                  W Log events menu                  |
  645. |     L Display information                 X Help                             |
  646. |                                                                              |
  647. |                                                                              |
  648. |                                                                              |
  649. |                                                                              |
  650. |                                                                              |
  651. +------------------------------------------------------------------------------+
  652.  2:24:15 PM  Saturday  May 14, 1988                            F1=Help  Max-Menu
  653.  
  654.   The second line of the system menu is a description of the item that
  655. the selection bar is positioned on (in this case Add).  Using the
  656. right arrow key, position the selection bar on each item and read its
  657. description.  To leave this system menu, enter the Esc key. 
  658.  
  659.  
  660.  
  661. Programmable Keys
  662. =================
  663.  
  664.   Programmable keys allow you to invoke often used functions without
  665. having to navigate to a menu to choose the desired selection.  To view
  666. the menu of programmable keys enter K from the system menu.  The
  667. following is the sample programmable keys:
  668.                                                                         Page 12
  669.  
  670. +----------------------------- Programmable Keys ------------------------------+
  671. |                                                                              |
  672. |                                                                              |
  673. |                                                                              |
  674. |                                                                              |
  675. |          _Alt-A_Alter_PATH                      Alt-N                        |
  676. |           Alt-B                                 Alt-O                        |
  677. |           Alt-C DOS command                     Alt-P                        |
  678. |           Alt-D Disk manager                    Alt-Q                        |
  679. |           Alt-E Edit file                       Alt-R                        |
  680. |           Alt-F                                 Alt-S                        |
  681. |           Alt-G                                 Alt-T                        |
  682. |           Alt-H                                 Alt-U Change user ID         |
  683. |           Alt-I                                 Alt-V                        |
  684. |           Alt-J                                 Alt-W                        |
  685. |           Alt-K                                 Alt-X                        |
  686. |           Alt-L                                 Alt-Y                        |
  687. |           Alt-M Display a menu                  Alt-Z                        |
  688. |                                                                              |
  689. |                                                                              |
  690. |                                                                              |
  691. |                                                                              |
  692. |                                                                              |
  693. +------------------------------------------------------------------------------+
  694.  5:36:29 PM  Saturday  May 14, 1988                            F1=Help  Max-Menu
  695.  
  696.   The programmable key selection IDs are Alt-? (where ? is A through
  697. Z).  To choose a programmable key simply hold down the Alt key while
  698. pressing the desired letter (ex. E for edit).  This can be done even
  699. when the programmable key menu is not displayed!  If you define your
  700. editor as Alt-E, it can easily be invoke by pressing Alt-E even when
  701. the programmable keys are not displayed.    
  702.  
  703.   If a programmable key has no description (as Alt-B above), it has
  704. not been defined and has no action.  To leave the programmable keys
  705. menu enter Esc.  
  706.  
  707.   Try using the programmable keys while they are NOT displayed.  First
  708. enter Alt-C and then enter a DOS command to execute (such as DIR /W)
  709. in the input prompt window.
  710.  
  711.  
  712.  
  713. Run Programs, Commands and Batch Files
  714. ======================================
  715.  
  716.   To run a DOS command, program or batch file enter R from the system
  717. menu.  Then enter the DOS command, program or batch file to run in
  718. response to the input prompt (such as DIR /W).
  719.  
  720.   If you want to enter several commands, enter E from the system menu. 
  721. This will temporarily exit you to the DOS command processor - the DOS
  722. prompt will be displayed.  You may then enter commands, programs,
  723. and/or batch files.  Enter Exit at the DOS prompt to return to Max-
  724. Menu.   
  725.  
  726.                      
  727.                                                                         Page 13
  728.  
  729. Quitting Max-Menu
  730. =================
  731.  
  732.   To leave Max-Menu enter Q from the system menu.  You may also leave
  733. Max-Menu by entering Esc twice from the main menu.
  734.                                                                         Page 14
  735.  
  736. Chapter 2: Modifying Menus
  737. ==========================
  738.  
  739.   This chapter discusses the modification of "user" menus and the
  740. selections on them.  These user menus include the main menu and any
  741. sub-menus below it.  The modification of programmable keys should be
  742. treated the same as selections.  Differences, if any, will be noted.  
  743.  
  744.  
  745.   Menu modification can be split into two categories:  modifying
  746. characteristics of the menu and modifying selections.  The former
  747. refers to items specific to the menu and all of its selections, such
  748. as the menu title, password and type of selection ID.  The later
  749. refers to adding, deleting, updating and other modifications to a
  750. specific selection.  Notice, there is no mention of adding or deleting
  751. a sub-menu.  This is done through the adding/deleting of a selection. 
  752. For example, to add a sub-menu to an existing menu, simply add a
  753. selection and enter the name of the new/existing sub-menu.  To delete
  754. a sub-menu, simply delete the selection that displays it.
  755.  
  756.  
  757.  
  758. Modify Menu Characteristics
  759. ===========================
  760.  
  761.   Menu characteristics are those items which pertain to the menu and
  762. all of its selections as a group.  These items are the title of the
  763. menu, the type of selection ID, and the password to protect the menu. 
  764. Items specific to a selection are not included.  Menu characteristics
  765. may not be modified for the programmable keys menu.  To modify a menu
  766. follow these five steps: 
  767.                                 
  768. 1.  Display the menu to be modified.
  769.                       
  770. 2.  Enter a slash (/) and the system menu will appear at the top of
  771.     your screen.
  772.  
  773. 3.  Press M for menu modification.  The menu modification window will
  774.     pop-up on the screen:
  775.                                                                         Page 15
  776.  
  777. +------------------------------------------------------------------------------+
  778. | Add  Update  Delete  Copy  Transfer _Menu  Keys  Setup  Run  Exit  Quit  Form|
  779. | Update current menu's title, password and selection ID type                  |
  780. +------------------------------------------------------------------------------+
  781. |                                                                              |
  782. |                                                                              |
  783. |    _A_Execute_a_DOS_command               M Date change                      |
  784. |     B Dynamic PATHing example             N Time change                      |
  785. | +------------------------------ Samples menu ------------------------------+ |
  786. | | Title: Max-Menu Samples                                                  | |
  787. | |                                                                          | |
  788. | | Password:                                                                | |
  789. | |                                                                          | |
  790. | | ID type:_Alpha-numeric     First character     Numeric                   | |
  791. | |                                                                          | |
  792. | +-- Use Tab, Enter and arrow keys to move cursor.  F3=Accept  F10=Abort ---+ |
  793. |     K DOS version = 3.10                  W Log events menu                  |
  794. |     L Display information                 X Help                             |
  795. |                                                                              |
  796. |                                                                              |
  797. |                                                                              |
  798. |                                                                              |
  799. |                                                                              |
  800. +------------------------------------------------------------------------------+
  801.  2:24:15 PM  Saturday  May 14, 1988   Ins                      F1=Help  Max-Menu
  802.  
  803.  
  804.     The title line of the menu modification window contains the menu
  805.     name (in the example above it is Samples).  The window contains
  806.     three fields: 
  807.   
  808.     Title is a description of the contents of the menu.  For example,
  809.     "Games" might be the title of a menu containing selections that
  810.     invoke games.  This title is displayed in the middle of the menu's
  811.     top border line.  If this field is blank, the menu will have no
  812.     title.
  813.  
  814.     Password protects the menu and all of its selections. Before the
  815.     menu is displayed, the password will be asked for and must be
  816.     entered.  This protects the menu and its selections from being
  817.     altered since the menu must first be displayed before it can be
  818.     altered.  The menu file stored on disk will also be encoded when
  819.     password protected.  If this field is blank, the menu will not be
  820.     protected. 
  821.    
  822.     ID Type determines the identifier shown to the left of each
  823.     selection and the key stroke(s) used to choose a selection.  
  824.     Choose the desired type:
  825.  
  826.          Alpha-numeric (A through Z then 0 to 9).  This limits a menu
  827.          to 36 selections.           
  828.  
  829.          First character of selection's description.
  830.   
  831.          Numeric (1 through 99).                          
  832.                                                                         Page 16
  833.  
  834. 4.  Modify or fill in the desired fields.  Use the Tab, Shift-Tab,
  835.     Enter and arrow keys to move between and within the fields.  The
  836.     current field will be highlighted (in the above example Title is
  837.     the current field).  The same editing keys provided with the input
  838.     prompt window are used when entering the title and password. 
  839.  
  840. 5.  Press F3 to accept the modifications or F10 to abort.
  841.  
  842.  
  843.  
  844. Menu Modification Exercise
  845. ==========================
  846.  
  847.   Now, use one of the sample menus and change the title.  Then change
  848. the ID type to each of the three selections - each time viewing the
  849. result of this change to the menu.  While doing this, try each of the
  850. keys for moving between and around the fields.  
  851.  
  852.  
  853. Add a Selection / Sub-Menu
  854. ==========================
  855.  
  856.   The main purpose of a selection is to invoke a program (through
  857. batch commands) and/or display a sub-menu.  If the sub-menu to be
  858. displayed is new, then it will be added.
  859.  
  860.   You may add a selection to a menu, as long as the maximum number of
  861. selections has not been used.  The maximum is 99 for all menus, except
  862. those with alpha-numeric type ID's which allows for 36 selections. 
  863. Remember, selections cannot be added to the programmable keys menu. 
  864. To add a selection follow these seven steps:          
  865.  
  866. 1.  Display the menu where the selection is to be added.       
  867.  
  868. 2.  If the menu contains selections, move the selection bar to where
  869.     the new selection is to be added.          
  870.                                                       
  871. 3.  Enter a slash (/) and the system menu will appear at the top of
  872.     your screen. 
  873.  
  874. 4.  Press A for add selection. 
  875.                                                        
  876. 5.  If the menu contains selections, you will be given a choice on
  877.     whether to add after or before the current selection.  Reply A or
  878.     B.
  879.               
  880.     The selection window will pop-up below the system menu:
  881.                                                                         Page 17
  882.  
  883. +------------------------------------------------------------------------------+
  884. |_After     Before                                                             |
  885. | Add after current selection                                                  |
  886. +------------------------------------------------------------------------------+
  887. +------------------------------------------------------------------------------+
  888. | Description:                                                                 |
  889. | Password:                                                                    |
  890. | Sub-menu:                                                                    |
  891. | Input prompt:                                                                |
  892. | Initial input:                                                               |
  893. | Execution mode: _Exiting_temporarily_(more_memory)    Shelling (faster)      |
  894. | Batch commands:                                                              |
  895. |                                                                              |
  896. |                                                                              |
  897. |                                                                              |
  898. |                                                                              |
  899. |                                                                              |
  900. |                                                                              |
  901. |                                                                              |
  902. |                                                                              |
  903. |                                                                              |
  904. |                                                                              |
  905. |                                                                              |
  906. +---- Use Tab, Enter and arrow keys to move cursor.  F3=Accept  F10=Abort -----+
  907.  2:24:15 PM  Saturday  May 14, 1988   Ins                      F1=Help  Max-Menu
  908.  
  909.  
  910.     The following is an explanation of some of these fields.  The
  911.     remaining ones will be covered in the advance topics section. 
  912.  
  913.     Description is shown on the menu and describes what the selection
  914.     does.  If the menu uses the first character of the description for
  915.     the selection ID, be sure that it is unique for this menu.  The
  916.     description cannot be blank.
  917.  
  918.     Password protects the selection.  Before the selection can be
  919.     executed or altered the password will be asked for and must be
  920.     entered.  Also, the selection will be encoded in the menu file
  921.     stored on disk when password protected.  If this field is blank,
  922.     the selection will not be protected.  NOTE: This password will NOT
  923.     protect a sub-menu displayed by the selection!  Instead, use the
  924.     menu password to protect the sub-menu.
  925.    
  926.     Sub-menu is the next menu to be displayed by the selection.  This
  927.     sub-menu display is the last thing done during the execution of
  928.     the selection.  It must conform to the standard DOS file name
  929.     convention and may be an existing, new or wild card menu name.  If
  930.     the sub-menu is blank, then no sub-menu will be displayed. 
  931.  
  932.     When a new menu name is entered, the menu modification window will
  933.     pop-up in the middle of the screen.  Follow the instructions for
  934.     modifying menu characteristics. 
  935.  
  936.     Batch commands are the DOS commands, programs or batch files to be
  937.     executed.  In most cases, these are the same as those entered at
  938.     the DOS prompt to invoke a program.  You may enter up to 99 lines. 
  939.     They must conform to the normal batch file conventions except the
  940.                                                                         Page 18
  941.  
  942.     SHIFT command will not work.  Also, batch files executed must
  943.     include the .BAT extension or be preceded by a ~ sign.  Unless you
  944.     want to use the current drive and directory, be sure to change
  945.     them both.  For example, C: will change to the C drive and CHDIR
  946.     \NEWDIR will change to the \NEWDIR directory.     
  947.  
  948. 6.  Fill in the desired fields.  Use the Tab, Shift-Tab, Enter and
  949.     arrow keys to move between and within the fields. The current
  950.     field will be highlighted (in the above example Description is the
  951.     current field).  When Batch commands is the current field, only
  952.     the Tab and Shift-Tab keys will move to the next/prior field.  All
  953.     input fields use the same editing keys provided with the input
  954.     prompt window.
  955.  
  956.     Batch commands have the following additional editing keys:
  957.  
  958.          Enter     inserts a new line after the current line when in
  959.                    insert mode.  If in overwrite mode, the cursor is
  960.                    positioned on the next line.
  961.          Delete    will delete the character above the cursor or the
  962.                    entire line if it is blank.
  963.          Ctrl-A    adds a line prior to line the cursor is positioned
  964.                    on.
  965.          Ctrl-D    deletes line cursor is positioned on.    
  966.          Ctrl-R    receives commands from a (batch) file.  Lines from
  967.                    the specified file will replace the current
  968.                    commands.  If the file specified includes wild
  969.                    cards, a menu of matching files will be displayed
  970.                    to choose from.
  971.          Ctrl-S    sends commands to a (batch) file.  The current
  972.                    commands will be placed in the file specified.  If
  973.                    the file specified includes wild cards, a menu of
  974.                    matching files will be displayed to choose from.
  975.  
  976. 7.  Press F3 when selection is complete or F10 to abort.
  977.  
  978.  
  979. Add a Selection Exercises
  980. =========================
  981.  
  982.   Let's add a selection at the bottom of the main menu.  Follow these
  983. steps: 
  984.  
  985. 1.  Display the last selection on the main menu by typing \ and then
  986.     the End key.  Type /AA for add after current selection.  The
  987.     selection window will be displayed as shown previously.
  988.  
  989. 2.  Enter a description of "Add selection exercise".
  990.  
  991. 3.  Using the down arrow key, position the cursor in Sub-menu.  Enter
  992.     a sub-menu name of "sampadd". 
  993.  
  994. 4.  Hit enter and the menu modification window will appear.  Enter a
  995.     title of "Add selection exercise". 
  996.  
  997. 5.  Press the F3 key twice (once to accept the menu modification and
  998.     again to accept the selection).
  999.                                                                         Page 19
  1000.  
  1001. 6.  A selection and sub-menu have been added to the main menu.  Choose
  1002.     this new selection.  The "sampadd" menu will be displayed, with no
  1003.     selections.
  1004.  
  1005.   Let's add one more selection, this time to the "sampadd" menu just
  1006. added above.
  1007.  
  1008. 1.  Since this menu is already displayed and has no selections, enter
  1009.     /A to add a selection.
  1010.  
  1011. 2.  Enter a Description of "Directory display". 
  1012.  
  1013. 3.  Press the Enter key until the cursor is positioned on the first
  1014.     line of the batch commands.  Enter three batch commands:
  1015.  
  1016.          ECHO ON
  1017.          DIR /W
  1018.          PAUSE
  1019.   
  1020. 4.  Hit the F3 key to accept the selection. 
  1021.  
  1022. 5.  You have now added a selection that will display the contents of
  1023.     the current directory.  Choose this selection.  Notice that the
  1024.     commands are displayed on the screen as they are executed.  This
  1025.     is due to the ECHO ON command.  Also, after the directory is
  1026.     displayed, the computer pauses until you've entered a key.  This
  1027.     pause is due to the PAUSE command.
  1028.  
  1029.  
  1030.  
  1031. Update a Selection
  1032. ==================
  1033.  
  1034.   All fields of a selection may be updated.  This allows for the
  1035. correction or improvement of a selection added previously.  Undefined
  1036. programmable keys (those that have no description) may be defined
  1037. through the update process.  To update a selection follow these six
  1038. steps:
  1039.  
  1040. 1.  Display the menu containing the selection to be updated or display
  1041.     the programmable keys.     
  1042.  
  1043. 2.  Position the selection bar on the selection to be updated.
  1044.                                                       
  1045. 3.  Enter a slash (/) and the system menu will appear at the top of
  1046.     your screen.
  1047.  
  1048. 4.  Press U for update selection.  The selection window will pop-up
  1049.     below the system menu:
  1050.                                                                         Page 20
  1051.  
  1052. +------------------------------------------------------------------------------+
  1053. | Add _Update  Delete  Copy  Transfer  Menu  Keys  Setup  Run  Exit  Quit  Form|
  1054. | Update current selection                                                     |
  1055. +------------------------------------------------------------------------------+
  1056. +------------------------------------------------------------------------------+
  1057. | Description: Directory display                                               |
  1058. | Password:                                                                    |
  1059. | Sub-menu:                                                                    |
  1060. | Input prompt:                                                                |
  1061. | Initial input:                                                               |
  1062. | Execution mode: _Exiting_temporarily_(more_memory)    Shelling (faster)      |
  1063. | Batch commands:                                                              |
  1064. |   ECHO ON                                                                    |
  1065. |   DIR /W                                                                     |
  1066. |   PAUSE                                                                      |
  1067. |                                                                              |
  1068. |                                                                              |
  1069. |                                                                              |
  1070. |                                                                              |
  1071. |                                                                              |
  1072. |                                                                              |
  1073. |                                                                              |
  1074. |                                                                              |
  1075. +---- Use Tab, Enter and arrow keys to move cursor.  F3=Accept  F10=Abort -----+
  1076.  2:24:15 PM  Saturday  May 14, 1988   Ins                      F1=Help  Max-Menu
  1077.  
  1078.  
  1079.     This is the same window used to add a selection, except the fields
  1080.     are not blank.  A description of this window and the fields within
  1081.     it can be found under the add selection section.
  1082.  
  1083. 5.  Modify the desired fields as described in the add selection
  1084.     section. 
  1085.  
  1086. 6.  Press Esc when selection is complete or F10 to abort. 
  1087.  
  1088.  
  1089.  
  1090. Update Selection Exercise
  1091. =========================
  1092.  
  1093.   Let's update the directory display selection added previously in the
  1094. add selection section.  Follow these steps: 
  1095.  
  1096. 1.  Display the "sampadd" menu and position the selection bar on the
  1097.     "Directory display" selection.  Then type /U to update the
  1098.     selection.
  1099.  
  1100. 2.  Using the down arrow key, position the cursor on the batch
  1101.     commands line containing ECHO ON.  Then press CTRL-D to delete
  1102.     this line.
  1103.  
  1104. 3.  Hit the Esc key to accept the change.
  1105.  
  1106. 4.  Choose the updated selection.  You will notice that the DIR and
  1107.     PAUSE commands are no longer displayed.
  1108.   
  1109.                                                                         Page 21
  1110.  
  1111. Copy or Transfer a Selection
  1112. ============================
  1113.  
  1114.   Copying a selection results in a duplicate selection in another
  1115. location.  Transferring a selection results in the selection being
  1116. moved to a new location.  To copy/transfer a selection follow these
  1117. steps:            
  1118.  
  1119. 1.  Display the menu containing the desired selection or display the
  1120.     programmable keys.     
  1121.  
  1122. 2.  Position the selection bar on the selection to be copied or
  1123.     transferred.
  1124.                                                       
  1125. 3.  Enter a slash (/) and the system menu will appear at the top of
  1126.     your screen. 
  1127.  
  1128. 4.  Press C for copy or T to transfer the selection. 
  1129.  
  1130. 5.  Display the menu to receive the selection. To locate a
  1131.     programmable key just enter it (ex. Alt-A).  While in this locate
  1132.     mode, batch commands and input prompts for a selection will be
  1133.     ignored.  Also, Esc returns prior menu and F10 aborts the
  1134.     copy/transfer. 
  1135.  
  1136. 6.  If the menu has selections, place selection bar where selection
  1137.     should be inserted or on selection to be replaced. 
  1138.  
  1139. 7.  Press slash (/). 
  1140.  
  1141. 8.  If the menu already had selections, you may choose to insert the
  1142.     selection before or after the current selection or to replace it. 
  1143.     NOTE: When copying or transferring to the programmable keys, be
  1144.     sure to select replace, since selections cannot be insert into
  1145.     them.
  1146.  
  1147. 9.  If you choose to replace a selection that displays a sub-menu, you
  1148.     will then have to specify whether to delete this sub-menu. 
  1149.  
  1150.  
  1151.  
  1152. Copy/Transfer a Selection Exercises 
  1153. ====================================
  1154.  
  1155.   Copy the first selection from the main menu to the "sampadd" menu
  1156. (added previously in add selection section).  Follow these steps:
  1157.  
  1158. 1.  Display the first selection on the main menu by typing \ and then
  1159.     the Home key.  Press /C to copy the selection.
  1160.  
  1161. 2.  Choose "Add selection exercise" to display the "sampadd" menu.
  1162.  
  1163. 3.  Type /B to copy the selection before the first selection.   
  1164.  
  1165.  
  1166.   Copy from the programmable keys menu to the "sampadd" menu.  Follow
  1167. these steps:
  1168.                                                                         Page 22
  1169.  
  1170. 1.  Display the programmable keys menu by typing /K.  Position the
  1171.     selection bar on the programmable key to be copied (for example,
  1172.     Alt-C).  Press /C to copy the selection.
  1173.  
  1174. 2.  Display the "sampadd" menu by typing \ and then choosing "Add
  1175.     selection exercise".
  1176.  
  1177. 3.  Position the selection bar on the first selection (copied
  1178.     previously from the main menu).  Then press /R to replace the
  1179.     first selection with the programmable key being copied. 
  1180.  
  1181. 4.  The selection being replaced may display a sub-menu.  If so, you
  1182.     will need to select "Leave" so this sub-menu is not deleted.
  1183.  
  1184.  Transfer first selection from the "sampadd" menu to a programmable
  1185. key.  Follow these steps:
  1186.  
  1187. 1.  The selection bar should be positioned on the first selection of
  1188.     the "sampadd" menu.  Enter /T to transfer the selection.
  1189.  
  1190. 2.  Press the programmable key to be replaced (for example, Alt-Z). 
  1191.     The programmable key chosen should not have a description.
  1192.  
  1193. 3.  Type /R to replace the programmable key with the selection being
  1194.     transferred.  Note: the selection has been moved from the
  1195.     "sampadd" menu to the programmable key.
  1196.  
  1197.  
  1198.   
  1199. Delete a Selection / Sub-Menu
  1200. =============================
  1201.  
  1202.   Deleting a selection removes it from the menu.  Deleting a
  1203. programmable key causes the selection to be cleared but not removed. 
  1204. When the selection displays a sub-menu, you may also choose to delete
  1205. the sub-menu.  To delete, follow these steps:
  1206.  
  1207. 1.  Display the menu containing the selection to be deleted or display
  1208.     the programmable keys.                                            
  1209.                    
  1210. 2.  Position the selection bar on the selection to be deleted.
  1211.  
  1212. 3.  Enter a slash (/) and the system menu will appear at the top of
  1213.     your screen.
  1214.  
  1215. 4.  Press D for delete selection. 
  1216.                                                        
  1217. 5.  Select the desired option from the confirmation menu that appears
  1218.     at the top of the screen.  The options are:
  1219.  
  1220.          Sub-Menu and current selection deleted.  This choice only
  1221.          appears if the selection displays an existing sub-menu.
  1222.  
  1223.          Delete current selection (if the selection displays a
  1224.          sub-menu, the sub-menu will NOT be deleted).
  1225.  
  1226.          Abort deletion of selection.         
  1227.                                                                         Page 23
  1228.                                                       
  1229.     CAUTION: When the selection displays an existing sub-menu, the
  1230.     confirmation menu will contain the Sub-Menu option.  If you choose
  1231.     to delete the sub-menu, be sure that no other selection also
  1232.     displays this same sub-menu!  Also, sub-menus below the sub-menu
  1233.     being deleted are not deleted and will become orphans if no
  1234.     remaining selections display them.  If you delete only the
  1235.     selection, the sub-menu will become an orphan should no other
  1236.     selection display it.  NOTE: An orphan menu is defined as having
  1237.     no selection that displays it.
  1238.  
  1239.  
  1240.  
  1241. Delete Selection/Menu Exercises
  1242. ===============================
  1243.  
  1244.   Let's delete a selection on the "sampadd"  menu (added previously in
  1245. add selection section).  Follow these steps:
  1246.  
  1247. 1.  Display the "sampadd" menu by typing \ and then choosing "Add
  1248.     selection exercise".
  1249.  
  1250. 2.  Position the selection bar on the first selection and press /D to
  1251.     delete the selection.
  1252.  
  1253. 3.  Confirm the deletion by pressing D.
  1254.  
  1255.  
  1256.   Then delete the selection on the main menu which displays the
  1257. "sampadd" menu.  Follow these steps:
  1258.  
  1259. 1.  Display the main menu by pressing \.
  1260.  
  1261. 2.  Then position the selection bar on "Add selection exercise" and
  1262.     press /D to delete the selection.
  1263.  
  1264. 3.  Confirm the deletion by pressing S.  This will delete the
  1265.     selection and the "sampadd" menu.
  1266.  
  1267.  
  1268.  
  1269. Advanced Topics
  1270. ===============
  1271.  
  1272.   This section covers the more advanced topics relating to selections. 
  1273. You should be comfortable with modifying the menus and selections
  1274. before continuing.  
  1275.  
  1276.  
  1277.  
  1278. Using Wild Cards in Sub-Menu Name
  1279. =================================
  1280.  
  1281.   As mentioned earlier, sub-menu is the next menu to be displayed by a
  1282. selection.  It may be entered whenever adding or updating a selection. 
  1283. The name must conform to the standard DOS file name convention and may
  1284. be an existing, new or wild card menu name.  
  1285.                                                                         Page 24
  1286.  
  1287.   A wild card menu name contains question marks (?) or asterisks (*). 
  1288. The question mark indicates that any character can occupy that
  1289. position.  For example, M??N will match with any menu name starting in
  1290. M, ending in N and four characters long (like main and moon).  The
  1291. asterisks indicates that any character can occupy that or any of the
  1292. remaining positions in the menu name.  Thus, * will return all menu
  1293. names and G* will return all menu names starting with the letter G.   
  1294.    
  1295.  
  1296.   Wild cards cause a menu to pop-up in the middle of the selection
  1297. window containing existing menu names that match the wild card name:
  1298.  
  1299. +------------------------------------------------------------------------------+
  1300. |_After     Before                                                             |
  1301. | Add after current selection                                                  |
  1302. +------------------------------------------------------------------------------+
  1303. +------------------------------------------------------------------------------+
  1304. | Description: Wild card menu name                                             |
  1305. | Password:                                                                    |
  1306. |_Sub-menu: *                                                                  |
  1307. | Input p+---------------------- Choose Menu: ----------------------+          |
  1308. | Initial|_DBMS       FLOPPY     GAMES      GRAPHICS   LANGUAGE     |          |
  1309. | Executi| MAIN       MISC       SAMPATTR   SAMPDIR    SAMPDRVE     |ter)      |
  1310. | Batch c| SAMPLES    UTILITY                                       |          |
  1311. |        |                                                          |          |
  1312. |        |                                                          |          |
  1313. |        |                                                          |          |
  1314. |        |                                                          |          |
  1315. |        |                                                          |          |
  1316. |        +----------------------------------------------------------+          |
  1317. |                                                                              |
  1318. |                                                                              |
  1319. |                                                                              |
  1320. |                                                                              |
  1321. |                                                                              |
  1322. +--- Use Tab, Enter and arrow keys to move cursor.  Esc=Continue  F10=Abort ---+
  1323.  2:24:15 PM  Saturday  May 14, 1988                            F1=Help  Max-Menu
  1324.  
  1325.   You may choose a menu name by positioning the selection bar on it
  1326. and pressing enter.  To leave this menu without choosing a menu name,
  1327. press Esc.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332. Wild Card Menu Exercise
  1333. =======================
  1334.  
  1335.   Let's add a selection to the main menu as follows:
  1336.  
  1337. 1.  Press \ and then End to position selection bar at bottom of main
  1338.     menu.  Then press /AA for add after current selection.
  1339.  
  1340. 2.  Enter a description of "Wild card menu". 
  1341.  
  1342. 3.  Hit Enter until the cursor is positioned in sub-menu.  Enter a
  1343.     sub-menu of "*" and hit enter.
  1344.                                                                         Page 25
  1345.  
  1346. 4.  A list of all of your menus will be displayed.  Position the
  1347.     selection bar on one of the menus and hit Enter.
  1348.  
  1349. 5.  Press Esc to accept the selection. 
  1350.  
  1351. 6.  A selection has been added that will display the sub-menu chosen
  1352.     in step number 4.
  1353.  
  1354. 7.  Delete the "wild card menu" selection by positioning the selection
  1355.     bar on it and typing /DD.
  1356.  
  1357.  
  1358. Input Prompt and Initial Input 
  1359. ===============================
  1360.  
  1361.   When adding or updating a selection, you may specify an input prompt
  1362. and the initial input.  The input prompt is a message requesting input
  1363. for the selection.  It will be placed at the top of the input prompt
  1364. window.  Initial input is the text to be placed in the input prompt
  1365. window.  The first phase of selection execution is to display the
  1366. input prompt window using this message and the initial input.  The
  1367. user may then enter/modify the input with the result being placed in
  1368. variable %#.  This variable (and others) can then be used in the batch
  1369. commands.  If the input prompt is blank, then there will be no prompt
  1370. for input.
  1371.  
  1372.  
  1373. Input Prompt Exercise
  1374. =====================
  1375.  
  1376.   For example, add a selection as follows:
  1377.  
  1378. 1.  Display the main menu by typing back-slash (\).  Position
  1379.     selection bar at end by pressing End.  Then type /AA.
  1380.  
  1381. 2.  Enter a description of "Prompt exercise".
  1382.  
  1383. 3.  Enter an input prompt of "Enter the directory to display".
  1384.  
  1385. 4.  Enter an initial input of "C:\".
  1386.  
  1387. 5.  Enter the following batch commands:
  1388.  
  1389.          ECHO ON
  1390.          DIR %# /W
  1391.          PAUSE
  1392.  
  1393. 6.  Press Esc to accept the selection. 
  1394.  
  1395. 7.  Choose the selection.  You will be requested for the directory to
  1396.     display.  Hit enter to accept the default of C:\ or enter a
  1397.     different directory and press enter.  The directory will then be
  1398.     displayed.  Notice that the %# in the DIR command has been replace
  1399.     with the text entered on the input prompt window. 
  1400.  
  1401. 8.  Delete the "Prompt exercise" selection by positioning the
  1402.     selection bar on it and entering /DD.
  1403.                                                                         Page 26
  1404.  
  1405. Batch Commands Execution Mode
  1406. =============================
  1407.  
  1408.   When adding or updating a selection you may choose from the
  1409. following Execution modes:
  1410.  
  1411.     Exiting temporarily (more memory) - Max-Menu will temporarily
  1412.     exit, invoke the batch commands and then reinvoke itself.  This
  1413.     option provides maximum memory since Max-Menu is not in memory.
  1414.  
  1415.     Shelling (faster) - Max-Menu will invoke the batch commands by
  1416.     shelling directly to them.  This option is faster since Max-Menu
  1417.     does not have to temporarily exit and then reinvoke itself.
  1418.  
  1419.   Be sure to choose Shelling where possible (memory permitting).  If
  1420. there is not enough memory, DOS will display message "Program too big
  1421. to fit in memory" on your screen.  You should then change to Exiting
  1422. temporarily.
  1423.  
  1424.   To see the difference in speed, create a selection with a
  1425. description of "more memory" and a batch command of "CD \".  Then
  1426. create another selection with a description of "faster", specify
  1427. "Shelling (faster)" for execution mode, and a batch command of "CD \". 
  1428. Now choose each selection and compare the difference in speed.  When
  1429. done, delete both selections.
  1430.  
  1431.  
  1432. Variables
  1433. =========
  1434.  
  1435.   Variables make it possible to pass information within a selection
  1436. and between selections (even when these selections are on different
  1437. menus).  They are also used to provide information, such as the
  1438. current directory, to a selection/menu.  When a variable is used (not
  1439. set), the value the variable holds (was last set to) replaces the
  1440. variable.  The four types of variables are global, input, environment,
  1441. and special.    
  1442.                                                       
  1443. +   Global variables start with an ampersand (&) followed by the
  1444.     numbers 0 through 9 (&0 to &9). They retain their value until you
  1445.     quit Max-Menu.  Thus, they can be used to pass information from
  1446.     one menu selection to another selection (in perhaps different
  1447.     menus).   For example, MENU1 has a list of actions - each
  1448.     selection places its action in variable &0 and then displays
  1449.     MENU2.  MENU2 has a list of items - each selection invokes the
  1450.     same batch file passing the action (in &0) and its item.  The
  1451.     batch file then does the action on the item.  In this example, &0
  1452.     is used to pass the action from a selection on MENU1 to the
  1453.     selection chosen on MENU2.                            
  1454.  
  1455. +   Input variables start with a percent (%) sign followed by the
  1456.     pound (#) sign or the numbers 0 through 9 (%# or %0 to %9).  They
  1457.     retain their value only while the selection is executing.  Each
  1458.     time %# is set, %0 to %9 are set to the first ten parameters of %#
  1459.     (where parameters are separated by blanks).  Thus, if %# is set to
  1460.     "my  dataset", %0 will be "my", %1 will be "dataset", and %2
  1461.     through %9 will be null.  Each time a selection is chosen, %#
  1462.                                                                         Page 27
  1463.  
  1464.     is set to the initial input string (even if it is null).  Then, if
  1465.     there is an input prompt, %# is set to the input string entered. 
  1466.     Through the use of the input variables, a selection may prompt for
  1467.     input and act on the individual parameters.  The selection may
  1468.     also set the %# variable (for example from a global variable) and
  1469.     then act on the individual parameters. 
  1470.  
  1471. +   Environment variables are provided by DOS.  When used (not set),
  1472.     enclose the variable in percent (%) signs.  For example, %PATH% is
  1473.     the DOS PATH variable.  They retain their values as long as your
  1474.     computer is powered up.  However, if your selection has an
  1475.     execution mode of Shelling, any environment variables set in the
  1476.     batch commands section will last only for the duration of that
  1477.     selection.  This can be very useful at times and confusing at
  1478.     other times.  Environment variables are nice since they can be set
  1479.     outside of Max-Menu (like in the AUTOEXEC.BAT file) and will not
  1480.     be lost when Max-Menu quits.  Use the DOS SET command within the
  1481.     Batch commands section of a selection to set environment
  1482.     variables.  For example, SET PATH=C:\;%PATH%, will add the "C:\"
  1483.     directory to the front of your path.
  1484.  
  1485. +   Special variables cannot be set and are replaced with the desired
  1486.     information.  The following are each of the special variables and
  1487.     the information they contain:
  1488.  
  1489.          &DATE&    - Current date as MM-DD-YYYY.
  1490.          &DATEM&   - Current date as MM-DD-YYYY.
  1491.          &DATED&   - Current date as DD-MM-YYYY.
  1492.          &DATEY&   - Current date as YYYY-MM-DD.
  1493.          &TIME&    - Current time as HH:MM:SS.
  1494.          &DRIVE&   - Current drive letter.  
  1495.          &DIR&     - Current directory.
  1496.          &DIR?&    - Current directory for drive ? (? is A to Z).
  1497.          &VER&     - DOS version number (ex. 3.30).
  1498.  
  1499.   Variables may be used (not set) in all the fields of a selection or
  1500. menu, except password.  Again, the current value of the variable will
  1501. replace the variable where it is used.  Thus, if %# has been set to
  1502. "/W" and your batch command line was "DIR %#", the result would be
  1503. "DIR /W".  
  1504.  
  1505.   As mentioned earlier, the input variables are automatically set each
  1506. time you choose a selection.  However, you may also set the input
  1507. variables along with the global and environment variables.
  1508.  
  1509.   To set a global or input variable in the batch commands section,
  1510. enter the variable as the first thing on a line and follow it
  1511. immediately (no intervening blanks) by an equal sign.  The variable
  1512. will be assigned the value to the right of the equal sign.  For
  1513. example, %#= DIR /W, will result in variable %# being set to the value
  1514. " DIR /W".  Variables may also be set to  other variables.  For
  1515. instance, if %1=DIR and %0=/W, then &0=%1 %2 will result in &0 being
  1516. set to "DIR /W". 
  1517.  
  1518.   The use and setting of non-environment variables in the batch
  1519. commands is done prior to the execution of them.  If a line sets a
  1520. variable, this line will not be part of the commands later executed by
  1521.                                                                         Page 28
  1522.  
  1523. DOS.  The processing of variables is done starting with the first line
  1524. proceeding till the last line of the batch commands.  For example,
  1525. suppose you had the following batch commands:
  1526.  
  1527.     &0=%PATH%
  1528.     PATH=C:\NEWPATH;%PATH%
  1529.     %1=%PATH%
  1530.     MYPROG
  1531.     PATH=&0   
  1532.  
  1533. The result of these commands is:
  1534.  
  1535.  .  &0=%PATH% sets &0 to the path prior to the commands being ran.
  1536.  .  PATH=C:\NEWPATH;%PATH% adds C:\NEWPATH to the front of your
  1537.     current path.
  1538.  .  &1=%PATH% sets &1 to the path prior to the commands being ran. 
  1539.     Thus, &1 contains the same path as &0.  
  1540.  .  MYPROG runs the program by this name.  It is assumed in this
  1541.     example that MYPROG can be found in C:\NEWPATH.
  1542.  .  PATH=&0 resets the path to its setting prior to the commands being
  1543.     ran.
  1544.  
  1545. This example not only shows that variables are filled in prior to the
  1546. batch commands execution, it also shows how environment variables can
  1547. be saved into a variable and later restored.  Thus, in the example
  1548. above, the PATH can be dynamically changed before running a program
  1549. and then restored. 
  1550.  
  1551.   The samples menu (select the Max-Menu samples menu from the main
  1552. menu) contains a number of selections that exploit variables.  This
  1553. includes using global variables to pass information from one selection
  1554. to another and the use of the input variable parameters.  Try these
  1555. selections and then  carefully study them and their sub-menus.
  1556.  
  1557.  
  1558.  
  1559. Copy or Transfer a Sub-Menu
  1560. ===========================
  1561.  
  1562.   The copying (duplicating) of entire menus is accomplished through
  1563. the DOS copy command.  The file name for a menu is the menu name and
  1564. the extension is .MNU.  The file name for the programmable keys is
  1565. MAX-MENU.KYS.  You may copy these files to other computers to
  1566. distribute your menus and programmable keys.  Also, an entire menu can
  1567. be duplicated by copying the menu's file to the new (duplicated) file. 
  1568. For instance, assuming the current directory contains menus, the DOS
  1569. copy command COPY EXISTING.MNU DUPLICAT.MNU will create a duplicate of
  1570. the "existing" menu and call it "duplicat".  You can then add a
  1571. selection and specify "duplicat" as the sub-menu.  To transfer a menu
  1572. to another location within the menu system, simply transfer the
  1573. selection that displays that sub-menu.  
  1574.                                                                         Page 29
  1575.  
  1576. Chapter 3: Customizing Max-Menu
  1577. ===============================
  1578.  
  1579.   Max-Menu has a number of options that allow you to customize it to
  1580. your liking.  These options include directories, colors, performance
  1581. enhancements, passwords and more.  To inspect or change Max-Menu's
  1582. configuration:
  1583.  
  1584. 1.  Enter a slash (/) from any user or programmable keys menu.  This
  1585.     will display the system menu. 
  1586.  
  1587. 2.  Press S for setup.  The setup menu will be displayed at the top of
  1588.     your screen:
  1589.  
  1590. +----------------------------------- Setup ------------------------------------+
  1591. |_Directories Colors RamCopy=OFF MainMenu ScreenSave Entry=INS Passwords Files |
  1592. | Change Batch, User menus, RAM menus, System and Commands directories         |
  1593. +------------------------------------------------------------------------------+
  1594. |                                                                              |
  1595. |                                                                              |
  1596. |                                                                              |
  1597. |                           _Max-Menu_samples_menu                             |
  1598. |                            Data management menu                              |
  1599. |                            Games menu                                        |
  1600. |                            Languages menu                                    |
  1601. |                            Miscellaneous menu                                |
  1602. |                            Picture graphics menu                             |
  1603. |                            Utilities menu                                    |
  1604. |                            Word processing                                   |
  1605. |                            Shutdown                                          |
  1606. |                            Help                                              |
  1607. |                                                                              |
  1608. |                                                                              |
  1609. |                                                                              |
  1610. |                                                                              |
  1611. |                                                                              |
  1612. |                                                                              |
  1613. +------------------------------------------------------------------------------+
  1614. 10:53:14 PM  Monday  May 16, 1988                              F1=Help  Max-Menu
  1615.  
  1616. 3.  Choose any of the items shown on the setup menu.  For an
  1617.     explanation of each item and instructions on how to inspect/change
  1618.     it, see sections below. 
  1619.  
  1620. 4.  Enter Esc after inspecting/changing the setup.
  1621.  
  1622. 5.  If you have changed the setup, you will be requested to save or
  1623.     abort the changes.  Enter Y to save the new configuration and N or
  1624.     Esc to abort it.      
  1625.  
  1626.  
  1627.  
  1628. Directories
  1629. ===========
  1630.  
  1631.   All of the directories used by Max-Menu are modifiable.  To inspect
  1632. or change these:
  1633.                                                                         Page 30
  1634.  
  1635. 1.  Press D while viewing the setup menu.  The directory menu will
  1636.     pop-up below the setup menu: 
  1637.  
  1638. +----------------------------------- Setup ------------------------------------+
  1639. |_Directories Colors RamCopy=OFF MainMenu ScreenSave Entry=INS Passwords Files |
  1640. | Change Batch, User menus, RAM menus, System and Commands directories         |
  1641. +-+-------------------------+--------------------------------------------------+
  1642. | |_Batch_and_restart_files |                                                  |
  1643. | | User menus and keys     |                                                  |
  1644. | | RAM menus and keys      |                                                  |
  1645. | | System files            |Max-Menu_samples_menu                             |
  1646. | | Commands - send/receive |Data management menu                              |
  1647. | +-------------------------+Games menu                                        |
  1648. |                            Languages menu                                    |
  1649. |                            Miscellaneous menu                                |
  1650. |                            Picture graphics menu                             |
  1651. |                            Utilities menu                                    |
  1652. |                            Word processing                                   |
  1653. |                            Shutdown                                          |
  1654. |                            Help                                              |
  1655. |                                                                              |
  1656. |                                                                              |
  1657. |                                                                              |
  1658. |                                                                              |
  1659. |                                                                              |
  1660. |                                                                              |
  1661. +------------------------------------------------------------------------------+
  1662. 10:53:14 PM  Monday  May 16, 1988                              F1=Help  Max-Menu
  1663.   
  1664. 2.  Choose the directory to inspect/modify:
  1665.  
  1666.     Batch and restart files directory contains the batch file (MAX-
  1667.     MNUX.BAT) built from a selection's commands and then executed.  It
  1668.     also contains the restart information file (MAX-MNUX.RST).        
  1669.       
  1670.     User menus and keys directory contains the permanent copy of your
  1671.     user menus (.MNU extension) and programmable keys (MAX-MENU.KYS). 
  1672.     Multiple directories may be specified separated by semi-colons
  1673.     (;).  Menus are read from the first directory they are found in. 
  1674.     A new menu is saved in the first directory and an updated menu in
  1675.     the same directory it was read from.
  1676.  
  1677.     RAM menu and keys directory is provided to improve performance. 
  1678.     Always specify a directory on a RAM drive.  This directory will be
  1679.     searched before the user menus and keys directory.  User menus and
  1680.     keys files should then be copied into this directory by your
  1681.     AUTOEXEC.BAT file or by setting RamCopy=ON in the setup.
  1682.  
  1683.     System files directory contains Max-Menu's system files (ex. MAX-
  1684.     MENU.EXE, MAX-MENU.HLP and MAX-MENU.FRM).  
  1685.      
  1686.     Commands - send/receive directory contains (batch) files to export
  1687.     from or import into a selection.   
  1688.   
  1689. 3.  The directory chosen will be displayed in the input prompt window. 
  1690.     Inspect/change the directory.  Then press Enter to accept or Esc
  1691.     to abort change. 
  1692.                                                                         Page 31
  1693.  
  1694. 4.  Press the Esc key from the directory menu to return to the setup
  1695.     menu.
  1696.  
  1697.  
  1698. Colors
  1699. ======
  1700.  
  1701.   To change any of Max-Menu's colors:
  1702.  
  1703. 1.  Press C from the setup menu.  The color menu will pop-up below the
  1704.     setup menu: 
  1705.  
  1706. +----------------------------------- Setup ------------------------------------+
  1707. | Directories_Colors RamCopy=OFF MainMenu ScreenSave Entry=INS Passwords Files |
  1708. | Change colors of menus and windows                                           |
  1709. ++-------------------------------------------------+---------------------------+
  1710. ||_User_defined_menus      Help menu / window      |                           |
  1711. || Pop-up system menus     Input prompt window     |                           |
  1712. || Selection update window Warning message window  |                           |
  1713. || Menu update window      Bottom line             |                           |
  1714. |+-------------------------------------------------+                           |
  1715. |                            Games menu                                        |
  1716. |                            Languages menu                                    |
  1717. |                            Miscellaneous menu                                |
  1718. |                            Picture graphics menu                             |
  1719. |                            Utilities menu                                    |
  1720. |                            Word processing                                   |
  1721. |                            Shutdown                                          |
  1722. |                            Help                                              |
  1723. |                                                                              |
  1724. |                                                                              |
  1725. |                                                                              |
  1726. |                                                                              |
  1727. |                                                                              |
  1728. |                                                                              |
  1729. +------------------------------------------------------------------------------+
  1730.  2:34:48 AM  Tuesday  May 17, 1988                             F1=Help  Max-Menu
  1731.  
  1732.  
  1733. 2.  Choose the item to inspect/change:
  1734.  
  1735.     User defined menus are those menus which you create and modify. 
  1736.     This includes the programmable keys display.  
  1737.  
  1738.     Pop-up system menus are the menu and sub-menus displayed by
  1739.     entering a slash (/) from the user defined menus.
  1740.  
  1741.     Selection update window is the window displayed when adding or
  1742.     updating a selection.  Information about a selection is then
  1743.     entered or changed in this window.
  1744.  
  1745.     Menu update window is the window displayed when creating or
  1746.     modifying a menu.  Information pertaining to the menu is then
  1747.     entered or changed in this window.
  1748.  
  1749.     Help menu / window is the menu and window displayed when the help
  1750.     key (F1) is pressed.  
  1751.                                                                         Page 32
  1752.  
  1753.     Input prompt window is the window that is displayed at the bottom
  1754.     of the screen requesting input.  
  1755.  
  1756.     Warning message window is the window that is displayed at the
  1757.     bottom of the screen when a warning, error or informational
  1758.     message is displayed.
  1759.  
  1760.     Bottom line is the bottom line of the screen.  Among other things,
  1761.     it contains the date, time and status of certain keys (such as Num
  1762.     Lock).
  1763.  
  1764.  
  1765.     Choosing one of the first five selections above results in the
  1766.     color sub-menu being displayed to the right of the color menu: 
  1767.  
  1768. +----------------------------------- Setup ------------------------------------+
  1769. | Directories_Colors RamCopy=OFF MainMenu ScreenSave Entry=INS Passwords Files |
  1770. | Change colors of menus and windows                                           |
  1771. ++-------------------------------------------------+--------------------------++
  1772. ||_User_defined_menus      Help menu / window      |_Window_/_Border          ||
  1773. || Pop-up system menus     Input prompt window     | Title                    ||
  1774. || Selection update window Warning message window  | ID for selection         ||
  1775. || Menu update window      Bottom line             | Description of selection ||
  1776. |+-------------------------------------------------| Selection Bar            ||
  1777. |                            Games menu            +--------------------------+|
  1778. |                            Languages menu                                    |
  1779. |                            Miscellaneous menu                                |
  1780. |                            Picture graphics menu                             |
  1781. |                            Utilities menu                                    |
  1782. |                            Word processing                                   |
  1783. |                            Shutdown                                          |
  1784. |                            Help                                              |
  1785. |                                                                              |
  1786. |                                                                              |
  1787. |                                                                              |
  1788. |                                                                              |
  1789. |                                                                              |
  1790. |                                                                              |
  1791. +------------------------------------------------------------------------------+
  1792.  2:34:48 AM  Tuesday  May 17, 1988                             F1=Help  Max-Menu
  1793.  
  1794. 3.  If the color sub-menu appears, further qualify the item to inspect
  1795.     or change by selecting: 
  1796.  
  1797.     Window / Border is the color of the blank area and border
  1798.     (double/single line) around the outside of the window.  This
  1799.     selection may also be Window / Border / Text, which indicates that
  1800.     the text within the window will also have this color (for example,
  1801.     the text within the help window).
  1802.  
  1803.     Title is the color of the window's heading displayed in the top
  1804.     border line.  This selection may also be Title / Message or Title
  1805.     / Highlighted text.  The former indicates that the message line of
  1806.     the pop-up system menu will have the same color as the title.  The
  1807.     later indicates that the highlighted text will have the same color
  1808.     as the title (for example, the highlighted text within the help
  1809.     window).
  1810.                                                                         Page 33
  1811.  
  1812.     ID for selection is the highlighted selection identification to
  1813.     the left of each selection's description.  For example, T is the
  1814.     ID for "Title" in the color sub-menu.
  1815.  
  1816.     Description of selection is the description given to each
  1817.     selection.  For example, "Title" is the description given to the
  1818.     second selection of the color sub-menu.
  1819.  
  1820.     Selection Bar is the highlighted current selection.  For example,
  1821.     "Window / Border" is the current selection in the above color sub-
  1822.     menu.        
  1823.  
  1824. 4.  Inspect/change the color number shown in the input prompt window
  1825.     at the bottom of the screen.  Then press Enter to accept or Esc to
  1826.     abort the change.  Notice that the color chart appears just above
  1827.     the input prompt window:
  1828.  
  1829. +----------------------------------- Setup ------------------------------------+
  1830. | Directories_Colors RamCopy=OFF MainMenu ScreenSave Entry=INS Passwords Files |
  1831. | Change colors of menus and windows                                           |
  1832. ++-------------------------------------------------+---------------------------+
  1833. || User defined menus      Help menu / window      |                           |
  1834. || Pop-up system menus    _Input_prompt_window     |                           |
  1835. || Selection update window Warning message window  |                           |
  1836. || Menu update window      Bottom line             |                           |
  1837. |+-------------------------------------------------+                           |
  1838. |                             Data Management                                  |
  1839. |                             Games                                            |
  1840. |      +------------------------- Color Chart --------------------------+      |
  1841. |      |       1   2   3   4   5   6   7   8   9  10  11  12  13  14  15|      |
  1842. |      |  16      18  19  20  21  22  23  24  25  26  27  28  29  30  31|      |
  1843. |      |  32  33      35  36  37  38  39  40  41  42  43  44  45  46  47|      |
  1844. |      |  48  49  50      52  53  54  55  56  57  58  59  60  61  62  63|      |
  1845. |      |  64  65  66  67      69  70  71  72  73  74  75  76  77  78  79|      |
  1846. |      |  80  81  82  83  84      86  87  88  89  90  91  92  93  94  95|      |
  1847. |      |  96  97  98  99 100 101     103 104 105 106 107 108 109 110 111|      |
  1848. |      | 112 113 114 115 116 117 118     120 121 122 123 124 125 126 127|      |
  1849. |      +----------------------------------------------------------------+      |
  1850. +- Select Color (number) from chart above for Input prompt window -------------+
  1851. | 63                                                                           |
  1852. +------------------------------------------------------------------------------+
  1853.  7:55:14 AM  Tuesday  May 17, 1988    Ins                      F1=Help  Max-Menu
  1854.  
  1855.     The color chart contains 120 different combinations of foreground
  1856.     and background colors.  Some of these colors may not show up
  1857.     clearly or at all on your screen.
  1858.  
  1859. 5.  Once you have changed all the colors desired, use the Esc key to
  1860.     return to the setup menu.
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.                                                                         Page 34
  1869.  
  1870. RamCopy
  1871. =======
  1872.  
  1873.   RamCopy is used in conjunction with the RAM menus and keys
  1874. directory.  As mentioned earlier, you may specify a directory on a RAM
  1875. drive to search for user menus and the programmable keys before
  1876. looking into the User menus and keys directory.  This will improve the
  1877. performance of Max-Menu for those menus on the RAM directory.  You may
  1878. move the user menus (and programmable keys) desired to this directory
  1879. in your AUTOEXEC.BAT file.  However, this will increase the time it
  1880. takes your computer to initialize when you power it on.  A better
  1881. alternative could be to use RamCopy. 
  1882.  
  1883.   When RamCopy is on Max-Menu copies user menus and programmable keys
  1884. from the User menus and keys directory to the RAM menus and keys
  1885. directory.  This occurs when user menus or programmable keys are
  1886. accessed, but are not currently in the RAM menus and keys directory. 
  1887. Enter R to toggle RamCopy option on or off. 
  1888.  
  1889.  
  1890.  
  1891. Main Menu Name
  1892. ==============
  1893.  
  1894.   The default main menu name is "Main".  You may make an existing or
  1895. new menu your main menu.  To do this, press M while viewing the setup
  1896. menu.  This will display the input prompt window.  You may then change
  1897. the main menu name.  If a new menu name is entered, a selection menu
  1898. with no selections will be displayed the next time the main menu is
  1899. displayed.  You may then add selections to this menu.  
  1900.  
  1901.  
  1902.  
  1903. ScreenSave
  1904. ==========
  1905.  
  1906.   ScreenSave is the number of seconds Max-Menu waits for a response
  1907. from the user before clearing the screen.  Thus, if you get
  1908. interrupted by a phone call, the characters currently on the screen
  1909. will not get "burnt" into the screen.  The user can press any key to
  1910. display the screen again.  To change or deactivate this option, type S
  1911. from the setup menu.  Then enter 0 to deactivate option (that is,
  1912. screen will not be cleared at all) or enter the number of seconds Max-
  1913. Menu should wait for a response before clearing the screen.
  1914.  
  1915.  
  1916.  
  1917. Entry Mode for Input
  1918. ====================
  1919.  
  1920.   Entry is the default input entry mode and is either INS for insert
  1921. or OVR for overlay.  Each time you are requested for input, this will
  1922. be the initial entry mode.  The Insert key can then be used to toggle
  1923. between modes.  In insert mode, characters typed will be inserted into
  1924. the text, while overlay will replace the character above the cursor
  1925. with the character typed.  Press E to toggle between default entry
  1926. modes.   
  1927.                                                                         Page 35
  1928.  
  1929. Password Protecting System Functions
  1930. ====================================
  1931.  
  1932.   In addition to allowing menus and selections to be password
  1933. protected, Max-Menu allows for the following passwords:
  1934.  
  1935.     Creator password satisfies a prompt for any password.  It uniquely
  1936.     identifies the person who enters it as the installer of Max-Menu. 
  1937.     With this password, any other password protection can be bypassed
  1938.     and changed.  REMEMBER THIS PASSWORD! 
  1939.  
  1940.     Entry password protects entry into Max-Menu.  It will be requested
  1941.     for each time Max-Menu is entered.  In this way Max-Menu disallows
  1942.     unauthorized access.
  1943.  
  1944.     Quitting password protects leaving Max-Menu.  This password will
  1945.     be requested each time an attempt is made to quit Max-Menu and can
  1946.     be used to ensure that use of your computer is through the use of
  1947.     Max-Menu.   
  1948.  
  1949.     System password protects system windows/menus.  Whenever a slash
  1950.     (/) is entered from a user menu or the programmable keys menu, the
  1951.     first system window appears.  From this window, you can change
  1952.     Max-Menu's setup, menus and selections.  You can also exit to the
  1953.     DOS prompt and run DOS commands, programs and batch files.  This
  1954.     password prevents unauthorized use of these capabilities.  Each
  1955.     time the first system window is invoked, this password is
  1956.     requested.
  1957.  
  1958.     NOTE: The system password can become an irritant when doing
  1959.     massive updates to your menus and selections.  In this case, you
  1960.     should temporarily remove it.
  1961.  
  1962.  
  1963.   To change any of the above passwords:
  1964.  
  1965. 1.  Enter P for passwords from the setup menu.
  1966.  
  1967. 2.  If a creator password has been entered previously, you will be
  1968.     requested to enter it.  Thus, only the "creator" is allowed to
  1969.     inspect/modify these passwords.
  1970.  
  1971.     The password menu will be displayed at the top of the screen:
  1972.                                                                         Page 36
  1973.  
  1974. +--------------------------------- Passwords ----------------------------------+
  1975. |_Creator     Entry     Quitting     System                                    |
  1976. | Creator password will always satisfy a prompt for any password               |
  1977. +------------------------------------------------------------------------------+
  1978. |                                                                              |
  1979. |                                                                              |
  1980. |                                                                              |
  1981. |                           _Max-Menu_samples_menu                             |
  1982. |                            Data management menu                              |
  1983. |                            Games menu                                        |
  1984. |                            Languages menu                                    |
  1985. |                            Miscellaneous menu                                |
  1986. |                            Picture graphics menu                             |
  1987. |                            Utilities menu                                    |
  1988. |                            Word processing                                   |
  1989. |                            Shutdown                                          |
  1990. |                            Help                                              |
  1991. |                                                                              |
  1992. |                                                                              |
  1993. |                                                                              |
  1994. |                                                                              |
  1995. |                                                                              |
  1996. |                                                                              |
  1997. +------------------------------------------------------------------------------+
  1998.  8:59:46 AM  Tuesday  May 17, 1988                             F1=Help  Max-Menu
  1999.  
  2000. 3.  Press the first character of the type of password you want to
  2001.     change (ex. C for creator).  This will display the input prompt
  2002.     window to allow you to change/enter the password.  To remove a
  2003.     password, either delete it or set it to blanks.  
  2004.  
  2005. 4.  When the desired passwords have been entered or changed, press Esc
  2006.     from the password menu to return to the setup menu.
  2007.  
  2008.  
  2009.  
  2010. Files
  2011. =====
  2012.  
  2013.   The Files selection allows you to change the name of the following
  2014. files: 
  2015.  
  2016.  +  Temporary batch file built when executing a selection's batch
  2017.     commands (BAT extension).   
  2018.  
  2019.  +  Restart file used to retain information when a selection's
  2020.     execution mode is "Temporarily exit" (RST extension).
  2021.  
  2022.  +  Setup file used to retain setup information (SET extension).
  2023.  
  2024. The default is MAX-MNUX.  While you may change this to any valid file
  2025. name (no extension), the purpose of Files is to allow multiple users
  2026. of networks (LANs) and shared PC's to run at the same time and also
  2027. have separate setup (configurations).  This will be covered later in
  2028. the appendix on Networks and shared PCs.  To change the Files name,
  2029. enter F from the setup menu and then enter the new file name.
  2030.                                                                         Page 37
  2031.  
  2032. Appendix A: Hints
  2033. =================
  2034.  
  2035.   This appendix is intended to provide hints on how to get the most
  2036. from Max-Menu.  Only after installing and using Max-Menu, should you
  2037. read these hints.  It is assumed that the reader has developed some
  2038. knowledge of DOS and has the DOS manual available as a reference.
  2039.  
  2040.  
  2041.  
  2042. Invoke Max-Menu Without Directory Change
  2043. ========================================
  2044.  
  2045.   You may want to invoke Max-Menu by entering MENU from the DOS prompt
  2046. without having to change the current directory.  To do this, add the
  2047. directory containing the MENU.BAT and MAX-MENU.EXE files to your PATH. 
  2048. This directory is usually the directory you installed Max-Menu in. 
  2049. Also, it is normally specified in the setup as the "System files"
  2050. directory.
  2051.  
  2052.   Assuming you installed into the default directory of C:\MAX-MENU,
  2053. you could change your AUTOEXEC.BAT file to include the command PATH
  2054. C:\MAX-MENU\.  If you already have a PATH command in your
  2055. AUTOEXEC.BAT, then simply add this directory to those already
  2056. specified (the directories are separated by semi-colons (;)).
  2057.  
  2058.   Another alternative is to copy the MENU.BAT and MAX-MENU.EXE files
  2059. to a directory that is already in your path.  
  2060.  
  2061.  
  2062.  
  2063. Invoke Max-Menu Automatically
  2064. =============================
  2065.  
  2066.   You may want Max-Menu invoked automatically each time you power on
  2067. you computer.  To do this, edit your AUTOEXEC.BAT file.  Then add a
  2068. line to the bottom of the file that changes (DOS CHDIR command) to the
  2069. directory Max-Menu was installed in.  This is not needed if this
  2070. directory has already been added to your PATH.  After this, add a line
  2071. to invoke Max-Menu by entering MENU.  Now save the AUTOEXEC.BAT file. 
  2072.  
  2073.  
  2074.  
  2075. Keep Max-Menu from Changing Directory 
  2076. ======================================
  2077.  
  2078.   When Max-Menu executes your batch commands, they are first written
  2079. to a batch file.  This batch file is then executed.  The batch file
  2080. may then intentionally change the directory.  During this process,
  2081. Max-Menu may change the drive and directory to ensure that DOS will
  2082. find the batch file mentioned above (MAX-MNUX.BAT) and/or the MAX-
  2083. MENU.EXE program.  
  2084.  
  2085.   This can cause additional overhead.  It can also be undesirable if
  2086. you have a selection that changes the current drive and directory and
  2087. other selections that operate on that directory.  For instance, you
  2088. could have a menu with a selection that changes the current directory.
  2089.                                                                         Page 38
  2090.  
  2091. Other selections could display the files in that directory, type these
  2092. files, delete them etc.  If Max-Menu is constantly changing the
  2093. current drive and directory, this type of menu simply won't work.
  2094.  
  2095.   The solution: add the directories specified in your setup for the
  2096. Batch and Restart files and the System files into your PATH.  To do
  2097. this, edit your AUTOEXEC.BAT file and change (or add) the PATH command
  2098. specifying these directory(s).  Be sure to enter the directory(s)
  2099. exactly as it is specified in the setup.  Assuming you installed into
  2100. the default C:\MAX-MENU directory, the command PATH C:\MAX-
  2101. MENU\;C:\DOS\ would be used if you already had a path to the C:\DOS
  2102. directory.
  2103.  
  2104.   Max-Menu will first check that these directories are in the PATH
  2105. (thus, DOS will be able to find the desired batch file and program). 
  2106. If they are not, then it is forced to change the current drive and
  2107. directory so DOS will find them.    
  2108.  
  2109.  
  2110. Removing ECHO OFF
  2111. =================
  2112.  
  2113.   To keep "ECHO OFF" from appearing on your screen, upgrade to DOS
  2114. version 3.30 or above.  Then change the MENU.BAT file's "ECHO OFF"
  2115. statement to "@ECHO OFF".  You can use this same technique in your
  2116. batch files to also suppress the ECHO OFF.
  2117.  
  2118.  
  2119.  
  2120. Renaming MENU.BAT file
  2121. ======================
  2122.  
  2123.   The MENU.BAT file can be renamed.  This may become necessary if it
  2124. conflicts with another batch file or program.  This ability is
  2125. provided through the /M switch in this file.  To rename this file, 
  2126. use the DOS REN command.
  2127.  
  2128.  
  2129. Forgotten Passwords
  2130. ===================
  2131.  
  2132.   Max-Menu has a very generous password protection system.  This
  2133. allows for protecting a menu, selection or system function (for
  2134. example, quitting Max-Menu).  Once this password protection is set, it
  2135. may not be removed unless you either know the password or the
  2136. "creator" password.  The same is true when trying to view a menu,
  2137. choose a selection or do a system function that is password protected. 
  2138. For this reason, it is very important to set the "creator" password to
  2139. identify you as the creator of Max-Menu.  It is equally important to
  2140. not forget it!     
  2141.  
  2142.   If you forget a menu or selection password, you (that is the creator
  2143. of Max-Menu) may enter the "creator" password instead.  The "creator"
  2144. password will always be accepted on any prompt for a password.  To
  2145. determine what the menu password is, display and then modify the menu. 
  2146. To determine what a selection's password is, update the selection.  In
  2147. either case, you will need to enter the "creator" password when
  2148.                                                                         Page 39
  2149.  
  2150. requested for the menu/selection password (assuming you have forgotten
  2151. it).  You may then view or modify the password through the normal
  2152. menu/selection update window.
  2153.  
  2154.  
  2155.  
  2156. Selection Password Annoying
  2157. ===========================
  2158.  
  2159.   Selection password protection can become bothersome for selections
  2160. you repeatedly choose (since the password is requested each time).  As
  2161. an alternative, group selections  to be protected on a menu(s) and use
  2162. the menu password.  Then, the password will be requested once when the
  2163. menu is displayed as opposed to each time the selection is chosen.  
  2164.  
  2165.  
  2166.  
  2167. Providing Help for Menus and Selections
  2168. =======================================
  2169.  
  2170.   Max-Menu provides help on how to use and update the menus by
  2171. pressing the F1 key.  You may want to provide help for your menus and
  2172. the selections on them.  The best may to do this is to include a
  2173. "Help" selection.  This selection can either ECHO help text, list a
  2174. file containing help text or display a sub-menu of help topics with
  2175. each selection displaying help text.      
  2176.  
  2177.  
  2178. Maximizing Performance
  2179. ======================
  2180.  
  2181.   While Max-Menu's performance is quite good, there are several things
  2182. you can do to get maximum performance.  One of the easiest is to
  2183. specify BUFFERS=20 in your CONFIG.SYS file.  This change will benefit
  2184. many of the programs you run. 
  2185.  
  2186.   When creating selections, use the Shelling (faster) option for
  2187. execution mode where possible.  If there is not enough memory, DOS
  2188. will display message "Program too big to fit in memory".  In this
  2189. case, choose the Exiting temporarily (more memory) option.
  2190.  
  2191.   Also, keep the Batch commands short.  If they become too long (more
  2192. than 11 lines), consider sending (use Ctrl-S) these commands to a
  2193. batch file and then execute the batch file.  This is particularly
  2194. important for frequently used menus or selections (it slows up menu
  2195. display and selection invocation). 
  2196.  
  2197.   Finally, if you have a RAM drive (virtual disk) or are willing to
  2198. create one consider:
  2199.  
  2200.  +  Copying COMMAND.COM file from the root directory of your hard
  2201.     drive to the root directory of the RAM drive.  Turn on the read-
  2202.     only attribute so it will not be deleted accidentally.  Then set
  2203.     COMSPEC to the new location of COMMAND.COM file.  This can be done
  2204.     in your AUTOEXEC.BAT file.  For instance, if your RAM drive is D
  2205.     the batch file could do the following after creating the RAM
  2206.     drive:
  2207.                                                                         Page 40
  2208.  
  2209.          COPY C:\COMMAND.COM D:\*.*
  2210.          ATTRIB +R D:\COMMAND.COM
  2211.          SET COMSPEC=D:\COMMAND.COM
  2212.  
  2213.     This will speed up all programs that "shell" since the COMMAND.COM
  2214.     file can be loaded quicker from the RAM drive then the hard disk. 
  2215.     Thus, any selection that specifies an execution mode of Shelling
  2216.     (faster) will be quicker.  
  2217.  
  2218.  +  In the setup, change the Batch and restart files directory to be
  2219.     on the RAM drive.  Since the RAM drive is quicker than a hard
  2220.     disk, this will speed up the execution of the batch commands for a
  2221.     selection.  It will also make selections that specify an execution
  2222.     mode of Temporarily exiting (more memory) faster since the restart
  2223.     file can be read quicker.
  2224.  
  2225.  +  In the setup, change the RAM menus and keys directory to be on the
  2226.     RAM drive.  Then turn RamCopy=ON.  This will do two things: first,
  2227.     menus that do not exist in the RAM menus and keys directory will
  2228.     be copied into the directory as they are displayed.  Secondly,
  2229.     menus that exist in this directory will be read quicker and thus
  2230.     displayed quicker.
  2231.                                                                         Page 41
  2232.  
  2233. Appendix B: Networks and shared PCs
  2234. ===================================
  2235.  
  2236.   Max-Menu supports Local Area Networks (LANs) and will also allow
  2237. several people to share a PC.  In both cases, each user may use their
  2238. own and/or shared menus.  Each user will also have their own setup if
  2239. different from the system administrator's.  Thus, each user may have
  2240. different colors, directories, passwords, main menus, menus, etc. 
  2241. However, each user will be running off one copy of the Max-Menu code.
  2242.  
  2243.   To enable this function, first install Max-Menu.  Then follow these
  2244. steps:
  2245.  
  2246.  +  Decide what DOS environment variable will be used to indicate to
  2247.     Max-Menu which user it is working with.  You may already have one
  2248.     established.  In these examples and in the sample menus, ID will
  2249.     be used.  
  2250.  
  2251.  +  Use the DOS SET command to set your environment variable equal to
  2252.     max-mnux to identify yourself as the system administrator:
  2253.  
  2254.          SET ID=MAX-MNUX
  2255.  
  2256.     NOTE:   The system administrator is the only "user" allowed to
  2257.             update the Files and System files directory items in the
  2258.             setup for a multi-user system.
  2259.  
  2260.  +  Modify the MENU.BAT batch file which invokes Max-Menu.  You will
  2261.     need to change MAX-MNUX to your environment variable enclosed in
  2262.     percent (%) signs.  For example, it might look like:
  2263.  
  2264.          ECHO OFF
  2265.          MAX-MENU %1 %2 %3 %4 %5 %6 %7 %8 %9 /M%0
  2266.          %ID%
  2267.  
  2268.     When you invoke MENU, the %ID% variable will be replaced by the
  2269.     users identification (in this case MAX-MNUX).  This in turn will
  2270.     invoke the temporary batch file built from the selection chosen by
  2271.     that user.
  2272.  
  2273.  +  Invoke Max-Menu through the MENU.BAT file above.  Get into the
  2274.     setup by entering /S, then press F to modify the Files name.  Now
  2275.     enter your environment variable enclosed in percent (%) signs (ex.
  2276.     %ID%).  This tells Max-Menu that this is a multi-user system and
  2277.     that ID is the environment variable containing the user
  2278.     identification.  Use the Esc key to exit the setup, entering Y to
  2279.     the save setup prompt.
  2280.  
  2281.  +  Each user must set this environment variable prior to invoking
  2282.     Max-Menu.  They may do this either by modifying their AUTOEXEC.BAT
  2283.     file, their network login script, or explicitly entering the DOS
  2284.     set command (ex. SET ID=janet).  If this is not set or is set to a
  2285.     value which is not a standard DOS file name, Max-Menu will issue
  2286.     an error message and stop.
  2287.                                                                         Page 42
  2288.  
  2289.  +  The Alt-U programmable key will allow users to change the user
  2290.     identification.  This is particularly useful when working with a
  2291.     shared PC.  The programmable key uses the ID environment variable. 
  2292.     If you are using a different environment variable,  please update
  2293.     this programmable key, changing all occurrences of ID to your
  2294.     environment variable. 
  2295.  
  2296.  +  It is a good idea to include the user identification  environment
  2297.     variable (%ID%) in the main menu title.  This will allow users to
  2298.     easily determine that the desired identification is being used. 
  2299.     Some selections may also use this environment variable.  In this
  2300.     way the selection could act differently for each user.  For
  2301.     example, each user may have a separate directory that the
  2302.     selection switches to.  If this is the case, the selection's
  2303.     description should also have the user identification in it (ex.
  2304.     "Word processing for %ID%").  This will help identify which
  2305.     selections are dependent on the user's identification being
  2306.     correct.
  2307.  
  2308.  +  As each user modifies the setup, it is saved to a file with their
  2309.     user identification as the file name and an extension of SET. 
  2310.     This file is saved in the directory Max-Menu was installed in (see
  2311.     System files under setup directories).  If this file should be
  2312.     saved in a different directory, you may modify Files name in the
  2313.     setup to:
  2314.  
  2315.         A)  Precede environment variable with the directory to use. 
  2316.             For example, C:\DATA\%ID% will cause the setup files to be
  2317.             saved in the C:\DATA directory.
  2318.  
  2319.         B)  Specify two environment variables.  The user sets the
  2320.             first to the directory to get/save the setup in and the
  2321.             second to their user identification.  For example, %MAX-
  2322.             DIR%%ID% will allow the user to specify which directory to
  2323.             use by setting the MAX-DIR environment variable (SET MAX-
  2324.             DIR=C:\DATA\).  IF MAX-DIR is not set, then the directory
  2325.             Max-Menu was installed in is used.
  2326.  
  2327.  +  If some users have their own menus (in addition to a shared set),
  2328.     they can modify the User menus and keys directory of the setup. 
  2329.     They should specify their directory and then the shared directory
  2330.     separated by a semi-colon.  
  2331.  
  2332.  +  The /I parameter can be used when invoking Max-Menu to reset the
  2333.     setup to its original values.  When this parameter is used in a
  2334.     multi-user system it will only reset the setup to its original
  2335.     values for the system administrator (ID=MAX-MNUX).  For all other
  2336.     users, the setup will be reset to those specified by the system
  2337.     administrator.
  2338.                                                                         Page 43
  2339.  
  2340. Appendix C: Messages
  2341. ====================
  2342.  
  2343.   The message window reports any informational, warning or error
  2344. messages.  The vast majority of messages are warnings.  In addition to
  2345. the message, the window contains the message number in the lower right
  2346. hand corner.  All messages are documented by this message number
  2347. below.  After reading the message, you may hit any key to continue. 
  2348. Max-Menu will then take an appropriate action as documented.  You may
  2349. then take corrective action, if any, for the message. 
  2350.  
  2351.   The following is a list of message numbers on the left and the text
  2352. of the message on the right.  Each message will have a description of
  2353. the problem, the action Max-Menu will take and any corrective action
  2354. you might want to take.
  2355.  
  2356. 101 Turn your printer on and position to top of page
  2357.     Description: Before printing the registration form, please be sure
  2358.                  that your printer is on and that the print will start
  2359.                  at the top of a page.
  2360.          Action: None.
  2361.      Correction: None.
  2362.  
  2363. 102 Setup re-initialized as requested by /I parameter.
  2364.     Description: /I parameter was specified when invoking Max-Menu.
  2365.          Action: The setup has been re-initialized to the original
  2366.                  values.
  2367.      Correction: None.
  2368.  
  2369.  
  2370. 200 Menu [menu] not in [directory]
  2371.     where [menu] will be replaced with a menu name and [directory]
  2372.     will be replace with a directory name. 
  2373.     Description: The menu shown cannot be found in the user menus and
  2374.                  keys directory (also shown).
  2375.          Action: The menu will be displayed using a title of the menu
  2376.                  name with no selections. 
  2377.      Correction: If the menu should exist, press Esc to return to
  2378.                  prior menu.  Then locate the menu file and copy it to
  2379.                  the directory shown.  If the menu is new, add
  2380.                  selections.
  2381.  
  2382. 201 Maximum number of menus reached, ignoring [menu]
  2383.     where [menu] will be replaced with the name of the sub-menu
  2384.     requested.
  2385.     Description: A selection chosen has specified a sub-menu however,
  2386.                  the maximum number of nested menus has been reached.
  2387.          Action: Max-Menu will ignore the Sub-menu and display the
  2388.                  current menu.
  2389.      Correction: Transfer this selection to a higher level   menu.
  2390.                                                                         Page 44
  2391.  
  2392. 202 RAM menu directory does not exist, ignoring RamCopy - change setup
  2393.     Description: The RAM menu and keys directory specified in the
  2394.                  setup does not exist, however, RamCopy=ON.
  2395.          Action: RamCopy=ON option is ignored.
  2396.      Correction: In the setup, change the RAM menu directory to a
  2397.                  valid directory on a RAM drive or delete it.         
  2398.  
  2399. 301 No action defined for programmable key: [Alt-?]
  2400.     where [Alt-?] will be replaced with the programmable key pressed
  2401.     (ex. Alt-A).
  2402.     Description: A programmable key was pressed for which no action
  2403.                  (sub-menu or batch commands) has been defined.
  2404.          Action: Max-Menu will ignore the request.
  2405.      Correction: Either the wrong programmable key was pressed or this
  2406.                  programmable key must be updated to have an action.
  2407.  
  2408. 400 Menu has no selections - must choose a selection
  2409.     Description: You have requested to update a selection, however,
  2410.                  the current menu has no selections to update.
  2411.          Action: None.
  2412.      Correction: Locate a selection to be updated or add a selection
  2413.                  to this menu.
  2414.  
  2415. 401 No room in menu to insert selection.  Change menu option type to
  2416.     allow more.
  2417.     Description: You have attempted to insert a selection into a menu
  2418.                  which already has the maximum number of selections
  2419.                  allowed.        
  2420.          Action: Insert is not allowed.
  2421.      Correction: The menu has the alpha-numeric option ID.  Its
  2422.                  maximum number of selections can be increased from 36
  2423.                  to 99 by changing the option ID to numeric. 
  2424.                  Otherwise, split this menu into smaller menus.
  2425.  
  2426. 402 No room in menu to insert selection - [function] aborted
  2427.     where [function] is either add, copy or transfer.
  2428.     Description: You have attempted to insert a selection into a menu
  2429.                  which already has the maximum
  2430.                  number or selections allowed.
  2431.          Action: Insert is not allowed.
  2432.      Correction: Split this menu into smaller menus.  
  2433.  
  2434. 403 Description is a required field - please fill it in
  2435.     Description: The description field must be filled in when adding
  2436.                  or updating a selection.
  2437.          Action: Cursor will be placed in the description field.  
  2438.      Correction: Enter a description for the selection.  This
  2439.                  description will be displayed on the menu.
  2440.  
  2441. 404 Batch commands and/or Sub-menu must be filled in
  2442.     Description: The batch commands and/or sub-menu fields must be
  2443.                  filled in when adding or updating a selection.
  2444.          Action: None.
  2445.      Correction: Enter a sub-menu or batch commands.
  2446.                                                                         Page 45
  2447.  
  2448. 405 Menu [menu] is invalid
  2449.     where [menu] is the sub-menu
  2450.     Description: The sub-menu specified for a selection is not a valid
  2451.                  file name.
  2452.          Action: Allows you to change sub-menu name.
  2453.      Correction: Change the sub-menu name to a valid one.  Menu names
  2454.                  must conform to the same standards as file names.
  2455.  
  2456. 406 Menu [menu] has no matches
  2457.     where [menu] is the sub-menu
  2458.     Description: The sub-menu specified for a selection is a generic
  2459.                  name (that is, it has * or ? characters).  However,
  2460.                  no menu name matches.
  2461.          Action: List of menu names matching the generic name are not
  2462.                  shown. 
  2463.      Correction: Correct the generic menu name.  This may include
  2464.                  changing the generic file name to * to get a listing
  2465.                  of all menus. 
  2466.                   
  2467. 451 Cannot update programmable keys menu
  2468.     Description: You have attempted to update the programmable keys
  2469.                  menu characteristics.  This cannot be done.
  2470.          Action: None.
  2471.      Correction: None. 
  2472.  
  2473. 452 Cannot insert into programmable keys - [function] aborted
  2474.     where [function] is either add, copy or transfer.
  2475.     Description: You cannot insert a new selection into the
  2476.                  programmable keys menu.
  2477.          Action: The add, copy or transfer is not allowed.
  2478.      Correction: For copy or transfer, specify replace instead of
  2479.                  before or after.  This will replace the highlighted
  2480.                  programmable key with the one being
  2481.                  copied/transferred.
  2482.  
  2483. 501 Only system administrator can change [item]
  2484.     where [item] is either "System files directory" or "Files name".
  2485.     Description: These items in the setup can only be changed by the
  2486.                  "system administrator" for your Local Area Network or
  2487.                  PC through the max-mnux ID.
  2488.          Action: The change is disallowed.
  2489.      Correction: None.
  2490.  
  2491. 900 Could not find help file (MAX-MENU.HLP) in [directory]
  2492.     where [directory] is the directory specified in the setup for the
  2493.     system files.
  2494.     Description: The help file is not in the directory shown.
  2495.          Action: Help will not be displayed.
  2496.      Correction: Change the setup directory for system files to the
  2497.                  directory Max-Menu was installed in.
  2498.                                                                         Page 46
  2499.  
  2500. 901 Programmable keys (MAX-MENU.KYS) not in [directory]
  2501.     where [directory] is the directory specified in the setup for the
  2502.     user menus and keys. 
  2503.     Description: The programmable keys file is not in the directory
  2504.                  shown.
  2505.          Action: The programmable key is not invoked.
  2506.      Correction: Change the setup directory for user menus   and keys
  2507.                  to the directory containing these files (normally,
  2508.                  this is the directory Max-Menu was installed in).  If
  2509.                  the programmable keys file has been lost, display the
  2510.                  programmable keys and then define them. 
  2511.  
  2512. 902 Registration form (MAX-MENU.FRM) not in [directory]
  2513.     where [directory] is the directory specified in the setup for the
  2514.     system files.
  2515.     Description: The registration form is not in the directory shown.
  2516.          Action: The registration form is not printed. 
  2517.      Correction: Change the setup directory for system files to the
  2518.                  directory Max-Menu was installed in.
  2519.  
  2520. 903 Setup could not be saved
  2521.     Description: Max-Menu could not save its setup configuration.
  2522.          Action: The current user menu or keys is displayed.
  2523.      Correction: Report this as an error.
  2524.  
  2525. 904 Directory contains too many directories/files, will use first
  2526.     [number]
  2527.     where [number] is the maximum number of directories or
  2528.     files allowed.
  2529.     Description: The directory contains too many files or directories
  2530.                  (depending on whether you were trying to list files
  2531.                  or directories).
  2532.          Action: The maximum number of files or directories is
  2533.                  displayed.
  2534.      Correction: For files, change the file mask specified on the send
  2535.                  or receive to reduce the number of files to be
  2536.                  displayed.  
  2537.  
  2538. 905 Setup directories are invalid, changed to initial values
  2539.     Description: One or more of the directories specified in the setup
  2540.                  does not exist.
  2541.          Action: These directories will be reset to their initial
  2542.                  setting.  This will either be the directory Max-Menu
  2543.                  was invoked from or none at all, depending on the
  2544.                  directory that is bad. 
  2545.      Correction: Review all directories specified in the setup to
  2546.                  ensure they are correct.  
  2547.                                                                         Page 47
  2548.  
  2549. Appendix D: Registering Max-Menu
  2550. ================================
  2551.  
  2552.   You may register additional copies of Max-Menu.  Registration
  2553. includes the manual, notification of any changes and support.  Once
  2554. registered, you may upgrade to new versions for a nominal fee.  
  2555.  
  2556.   To print the registration form, enter /F from any user menu or the
  2557. programmable keys menu.  You will be asked to turn your printer on and
  2558. to set it to the top of a page.  Then enter any key and the
  2559. registration form will be printed.   
  2560.                                                       
  2561.   Once the registration form has been printed, fill in the requested
  2562. information, attach a check for the indicated amount and send to the
  2563. address shown.  
  2564.                                                       
  2565.   Thank you for your support!!                        
  2566.                                                                         Page 48
  2567.  
  2568. Index
  2569. =====
  2570.  
  2571. AUTOEXEC.BAT  5, 37-39
  2572. Batch commands  17, 36, 39, 40
  2573.   Editing keys  18
  2574.   Execution mode  26, 39
  2575. Colors  31
  2576.   Bottom line  32
  2577.   Description of selection  33
  2578.   Help menu / window  31
  2579.   ID for selection  33
  2580.   Input prompt window  32
  2581.   Menu update window  31
  2582.   Pop-up system menus  31
  2583.   Selection Bar  33
  2584.   Selection update window  31
  2585.   Title  32
  2586.   User defined menus  31
  2587.   Warning message window  32
  2588.   Window / border  32
  2589. Configuration
  2590.   Changing the  29
  2591.   Colors  31
  2592.   Directories  29
  2593.   Files  36
  2594.   Main menu name  34
  2595.   Password  35
  2596.   RamCopy  30, 34, 40
  2597.   Resetting  5
  2598.   ScreenSave  34
  2599. Directories
  2600.   Batch and restart files  30,
  2601.     38, 40
  2602.   Commands - send/receive  30
  2603.   In configuration  29
  2604.   RAM menu and keys  30
  2605.   RAM menus and keys  34, 40
  2606.   System files  30, 37, 38, 42
  2607.   User menus and keys  30, 42
  2608. Distribution disk  2
  2609. DOS
  2610.   Exit to  12
  2611.   Run a command  12
  2612. Execution mode  26, 39
  2613. Files  36, 41
  2614. Help
  2615.   For Max-Menu  7
  2616.   For Menu/Selections  39
  2617. Input
  2618.   Default entry mode  34
  2619.   Editing keys  9
  2620.   Entry mode  10
  2621.   Initial   25
  2622.   Prompt message  25
  2623.   Prompt window  9
  2624.   Variable  26
  2625.                                                                         Page 49
  2626.  
  2627. Installation  3
  2628. Invoking Max-Menu  5, 37, 38
  2629.    Keys
  2630.    Batch command editing  18
  2631.    Input editing  9
  2632.    Menu cursor movement  7
  2633.    Programmable  5, 11
  2634. Menu
  2635.    Add a sub-menu  16
  2636.    Anatomy  5
  2637.    Copy  28
  2638.    Cursor movement keys  7
  2639.    Delete a sub-menu  22
  2640.    ID type  15
  2641.    Main menu name  34
  2642.    Modify characteristics  14
  2643.    Navigation  8
  2644.    Password  15, 39
  2645.    Samples  4
  2646.    System   10
  2647.    Title  6, 15
  2648.    Transfer  28
  2649.    Messages  43
  2650. Networks  36, 41
  2651. Password
  2652.    Change forgotten  38
  2653.    Creator  35, 38
  2654.    Entry  35
  2655.    Menu  15, 39
  2656.    Quitting  35
  2657.    Selection  17, 39
  2658.    System  35
  2659. Performance  39
  2660. Programmable keys  5, 11
  2661. Quitting Max-Menu  13
  2662. RamCopy  30, 34, 40
  2663. Sample menus  4
  2664. ScreenSave  34
  2665. Selection
  2666.    Add  16
  2667.    Bar  6
  2668.    Batch commands  17, 39, 40
  2669.    Choosing  8
  2670.    Copy  21
  2671.    Delete  22
  2672.    Description  6, 17
  2673.    Execution mode  26, 39
  2674.    Input prompt  25
  2675.    Password  17, 39
  2676.    RamCopy  40
  2677.    Sub-menu  17
  2678.    Transfer  21
  2679.    Update  19
  2680. Shared PCs  36, 41
  2681.                                                                         Page 50
  2682.  
  2683. Sub-menu  17
  2684.   Add  16
  2685.   Copy  28
  2686.   Delete  22
  2687.   Transfer  28
  2688.   Wild cards  23
  2689. Switches
  2690.   /I  5, 42
  2691.   /K  5
  2692.   /M  38
  2693. System administrator  41
  2694. System requirements  2
  2695. Variables  26
  2696.   Environment  27
  2697.   Global  26
  2698.   Input  25, 26
  2699.   May be used in  27
  2700.   Setting  27
  2701.   Special  27
  2702.