home *** CD-ROM | disk | FTP | other *** search
/ Big Blue Disk 10 / bbd10new.zip / AUTOMENU.DOC < prev    next >
Text File  |  1987-05-15  |  128KB  |  3,732 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                             tm
  17.                                     Automenu 
  18.  
  19.  
  20.                            Software Management System 
  21.  
  22.  
  23.                                    Version 4.0
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                                   USERS' MANUAL
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.                                                  
  46.                                 Magee Enterprises
  47.                        6577 Peachtree Industrial Boulevard
  48.                         Norcross, Georgia 30092-3796 USA
  49.  
  50.                                   404-446-6611
  51.  
  52.              FAX 404-446-7434/BBS 404-446-6650/CompuServe 70167,2200
  53.  
  54.  
  55.  
  56.  
  57.                                 May 1987 Release
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                                 LICENSE AGREEMENT
  66.  
  67.  
  68.         (C) Copyright 1983, 1985, 1986, 1987 Magee Enterprises for this 
  69.         software, documentation, and user interface. Norcross, Georgia, 
  70.         United States of America. All rights reserved.
  71.  
  72.         Magee Enterprises grants you without charge the right to 
  73.         reproduce, distribute and use copies of this "shareware" version 
  74.         of our AUTOMENU software product (including the on disk 
  75.         documentation), on the express condition that you do not receive 
  76.         any payment, commercial benefit, other consideration for such 
  77.         reproduction or distribution, or change this license agreement or 
  78.         copyright notice.                                                 
  79.  
  80.         The rights to receive any such financial or other benefit, and to 
  81.         modify the product or its components, are reserved exclusively by 
  82.         Magee Enterprises.
  83.  
  84.         Support from users enables us to develop additional features and 
  85.         future versions of the AUTOMENU product. Your payment of $50.00 
  86.         would be greatly appreciated; your payment should be sent to:
  87.  
  88.                                 Magee Enterprises
  89.                        6577 Peachtree Industrial Boulevard
  90.                         Norcross, Georgia 30092-3796 USA
  91.  
  92.         Also, by sending in your payment, together with your name, 
  93.         company name (if any), mailing address, telephone number, version 
  94.         number, and where you heard about the AUTOMENU product and got 
  95.         your copy, your copy of AUTOMENU will be registered with us, 
  96.         thereby enabling you to receive (i) technical support and (ii) 
  97.         announcements of possible later releases, the latest version and 
  98.         a printed manual. Also, please feel free to contribute your ideas 
  99.         regarding desired additional product features and functionality.
  100.            
  101.  
  102.         THIS PRODUCT IS LICENSED WITHOUT ANY WARRANTY OF MERCHANTABILITY, 
  103.         FITNESS OF PARTICULAR PURPOSE, PERFORMANCE, OR OTHERWISE; ALL 
  104.         WARRANTIES ARE DISCLAIMED. BY USING THE AUTOMENU PRODUCT, YOU 
  105.         AGREE THAT NEITHER MAGEE ENTERPRISES NOR ANY OF OUR EMPLOYEES, 
  106.         AFFILIATES, OWNERS, OR OTHER RELATED PARTIES WILL BE LIABLE TO 
  107.         YOU OR ANY THIRD PARTY FOR ANY USE OF (OR INABILITY TO USE) THIS 
  108.         SOFTWARE, OR FOR ANY DAMAGES WHATSOEVER. EVEN IF WE ARE APPRISED 
  109.         OF POSSIBLITY OF SUCH DAMAGES OCCURING.
  110.  
  111.         This software may not be reversed-engineered or disassembled, 
  112.         and includes certain trade secrets and confidential information 
  113.         of Magee Enterprises.
  114.  
  115.  
  116.         AUTOMENU, SOFTWARE MANAGEMENT SYSTEM, MDL,and MDF are trademarks 
  117.         of Magee Enterprises.
  118.  
  119.  
  120.  
  121.  
  122.  
  123.         Automenu version 4.0                             Contents
  124.  
  125.  
  126.                                 TABLE OF CONTENTS
  127.  
  128.  
  129.         Section                        Title
  130.         -------                        -----
  131.  
  132.         1                        This  Is Automenu
  133.  
  134.           1-1                    Getting Acquainted With Automenu
  135.           1-2                    Using This Documentation
  136.           1-2.1                  Usage Conventions
  137.           1-2.2                  Format and Presentation
  138.           1-3                    System Requirements
  139.           1-4                    Getting Started
  140.  
  141.         2                        DOS and Automenu
  142.  
  143.           2-1                    Types of Commands
  144.           2-2                    Subdirectories
  145.           2-3                    Extensions
  146.           2-4                    Batch Files
  147.  
  148.         3                        Installing Automenu
  149.  
  150.           3-1                    Installing Automenu
  151.           3-2                    Sample MDF
  152.           3-3                    Menu-Building Facility Key Functions
  153.           3-4                    Exiting the Edit Mode of Menu-Building
  154.                                   Facility
  155.           3-5                    Using Automenu on a diskette system
  156.  
  157.         4                        Making a Menu
  158.  
  159.           4-1                    Developing an Menu Definition File
  160.           4-1.1                  Entering Commands
  161.           4-1.2                  Titling Your Menu
  162.           4-1.3                  Entering Your Menu Selections
  163.           4-1.4                  Including DOS Commands on the Menu
  164.           4-2                    Completing the Menu
  165.  
  166.         5                        Using Your Menu
  167.  
  168.           5-1                    The Menu
  169.           5-2                    Programmed Menu Keys
  170.  
  171.         6                        Using Automenu's other capabilities
  172.  
  173.           6-1                    Menu Design Functions
  174.           6-2                    DOS Commands
  175.           6-2.1                  Batch Commands
  176.           6-2.1.1                Non-Resident Commands
  177.           6-2.1.2                Resident Commands
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.         Automenu version 4.0                             Contents
  185.  
  186.  
  187.         Section                        Title
  188.         -------                        -----
  189.  
  190.           6-2.2                  Direct Commands
  191.           6-2.2.1                Direct Command without Pause
  192.           6-2.2.2                Direct Command with Pause
  193.           6-3                    Special Functions
  194.           6-3.1                  Password
  195.           6-3.2                  Alternate MDF
  196.           6-3.3                  Output Messages
  197.           6-3.4                  Input
  198.           6-3.5                  Time Execution
  199.           6-4                    MDF Command Symbol Summary
  200.  
  201.         7                        Customizing Your Menu
  202.  
  203.           7-1                    Accessing the Customizing Utility
  204.           7-2                    Color Customization
  205.           7-3                    Custom Switches
  206.           7-4                    Change Default Filename for MDF
  207.           7-5                    Change Default Filename for Temporary
  208.                                   Batch File
  209.           7-6                    Reset All Values and Save
  210.           7-7                    Creating Your Own Menus
  211.  
  212.         8                        Technical Considerations
  213.  
  214.           8-1                    Automenu Configuration
  215.           8-1.1                  Program Interfaces
  216.           8-1.2                  Other files
  217.           8-2                    Program Operation
  218.           8-3                    Running a BASIC Program
  219.           8-4                    Using Automenu on Networks
  220.           8-5                    Mouse Support
  221.           8-6                    Uses and Performance of Floppy
  222.                                   Diskette Systems
  223.           8-7                    Contents of an Example AUTOMENU.MDF
  224.           8-8                    Examples of Batch Files
  225.           8-8.1                  Floppy Diskette version of AUTOEXEC.BAT
  226.           8-8.2                  Fixed Disk version of AUTOEXEC.BAT
  227.           8-8.3                  Example of AUTO.BAT
  228.           8-9                    Menu Definition File (MDF) Description
  229.           8-10                   User Support
  230.           8-10.1                 Problems and Technical Support
  231.           8-10.2                 Updates
  232.           8-11                   Source Code
  233.           8-12                   Dealer, VAR, and Consultants
  234.           8-13                   Shareware
  235.           8-14                   Future   
  236.  
  237.         Appendix A               Error Messages
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.         Automenu version 4.0                         This is Automenu
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.                                     SECTION 1
  255.  
  256.  
  257.  
  258.                                 THIS IS AUTOMENU
  259.  
  260.  
  261.  
  262.  
  263.         Welcome to AUTOMENU (TM), the Software Management System.      
  264.  
  265.         AUTOMENU was designed to enable you to organize and control the 
  266.         use of your computer in a way that you never could before! With 
  267.         AUTOMENU, you can create menus that access all of your frequently 
  268.         used programs, and perform DOS commands with a single keystroke. 
  269.         You no longer have to remember complex DOS commands, syntax or 
  270.         subdirectories, because AUTOMENU will do it for you. You can even 
  271.         customize AUTOMENU to perform complicated batch routine 
  272.         procedures.
  273.  
  274.  
  275.         1-1. Getting Acquainted with AUTOMENU
  276.  
  277.         With AUTOMENU, you create your own menu. This is made possible by 
  278.         Magee Enterprises' proprietary Menu Definition Language (MDL). 
  279.         Using MDL, you create a Menu Definition File (MDF), and write 
  280.         your individualized menu in this file.
  281.  
  282.         This gives you capabilities you may not have had previously. You 
  283.         can password protect any menu selection or for that matter, an 
  284.         entire menu. AUTOMENU will support a mouse option, if desired. 
  285.         Help messages and user-defined prompts are included, and 
  286.         available as needed. It will execute any DOS command, batch file, 
  287.         or program directly, without user intervention.
  288.  
  289.         And it is flexible:
  290.  
  291.              *it can execute any DOS command, batch file or program 
  292.               directly from the menu; it is not necessary to create batch 
  293.               files outside AUTOMENU;
  294.  
  295.              *memory is allocated dynamically; AUTOMENU uses only the 
  296.               memory it needs for a given function;
  297.  
  298.              *individual features can be modified or changed to fit your
  299.               needs, using the Customizing utility; 
  300.  
  301.              *you can switch viewing between two active monitors;
  302.  
  303.  
  304.  
  305.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  306.         Automenu version 4.0                         This is Automenu
  307.  
  308.  
  309.              *it supports any and all monitors--color, monochrome, even
  310.               the Enhanced Graphics Adapter;
  311.  
  312.              *timed execution of any menu selection at pre-selected time;
  313.  
  314.              *user-defined prompts, to interactively exchange information
  315.               with programs; 
  316.  
  317.              *automatic screen blackout.
  318.  
  319.  
  320.         AUTOMENU is completely user oriented. Self-contained help screens 
  321.         and prompts walk you through every aspect of the software. A 
  322.         single keystroke will call up HELP messages from any screen or 
  323.         menu. And the HELP keys are displayed on the related screen.
  324.  
  325.  
  326.         1-2. Using This Documentation
  327.  
  328.         This document describes the features and functions of AUTOMENU. 
  329.         You do not need a great deal of technical knowledge to understand 
  330.         and operate AUTOMENU. The tutorial sections of this document walk 
  331.         you through every aspect of the program, from installing it on 
  332.         your fixed disk, to creating your own individual menu.
  333.  
  334.         If you are a new or inexperienced computer user, it is 
  335.         recommended that you pay special attention to Section 2, which 
  336.         discusses DOS. You will need to know a few aspects of using DOS 
  337.         to utilize all of AUTOMENU's capabilities. You may want to refer 
  338.         to your DOS manual, as well.
  339.  
  340.         Experienced DOS users will find the more technical discussion in 
  341.         Section 8 of particular interest.
  342.  
  343.         All users will find AUTOMENU easy to understand and operate.
  344.  
  345.  
  346.         1-2.1. Usage Conventions
  347.  
  348.         Certain conventions are used in this documentation to ensure 
  349.         consistency and understandability of instructions. These are 
  350.         listed here:
  351.  
  352.           --MDL command symbols used in creating your menu are always
  353.             shown in brackets { }; example, {.}. When you use  these
  354.             commands,  you do not type the  brackets,  only the symbol 
  355.             itself.
  356.  
  357.           --phrases,  numbers and  words you type in MDF's and on menus
  358.             are shown in quotes " "; example, Type "WS". You do not
  359.             type the quotes, only the data they enclose;
  360.  
  361.           --Dos commands, prompts and similar on-screen data are shown 
  362.             exactly as they appear; example, the DOS prompt is shown as C>.   
  363.  
  364.  
  365.  
  366.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  367.         Automenu version 4.0                         This is Automenu
  368.  
  369.  
  370.           --when you must enter data you have typed, you will be
  371.             instructed, Press ENTER; the ENTER key is the large key with
  372.             the hooked arrow pointing left. This key is sometimes called
  373.             return.
  374.  
  375.  
  376.         1-2.2. Format and Presentation
  377.  
  378.         Sections 3 through 7 are tutorial in nature. It is recommended 
  379.         that inexperienced computer users follow them as they are 
  380.         presented. All procedures should be performed.
  381.  
  382.         Experienced users may find that the tabular summaries at the end 
  383.         of each section, together with a brief reading of the tutorial 
  384.         sections, will suffice.
  385.  
  386.         These tabular summaries of each section are designed to be used 
  387.         as a computer-side user guide once you are familiar with 
  388.         AUTOMENU's basic operation. 
  389.  
  390.  
  391.         1-3. System Requirements
  392.  
  393.         AUTOMENU can be used on any IBM-PC or compatible, including: PC, 
  394.         XT, AT, JR., Portable, Convertible, 3270-PC, all Personal System 
  395.         /2 models; AT&T 6300; Compaq Portable, Plus, Deskpro 386; Corona 
  396.         PC; Leading Edge PC; North Star Dimension; Sperry PC; Zenith Z-
  397.         150; Toshiba T1100+, T3100; Epson Equity II; Tandy 2000; Tandy 
  398.         3000; HP Vector; Wyse PC286; and Sanyo 550.
  399.              
  400.         AUTOMENU operates using DOS 2.0 or later versions. It requires 
  401.         only 32 KB of free memory, and less than 20 KB on disk. It is 
  402.         fully operational with either fixed or diskette drives. It uses 
  403.         only standard DOS and BIOS system calls. And is compatible with 
  404.         Microsoft Windows and Networks, including: Novell, 3COM, and 
  405.         Alloy. 
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  428.         Automenu version 4.0                         This is Automenu
  429.  
  430.  
  431.         1-4. Getting Started
  432.  
  433.         Before you begin the tutorial, make a backup/working copy of the 
  434.         program diskette, as you would with any diskette that contains 
  435.         important information. Store the original in a safe place.
  436.  
  437.         If you downloaded this version of Automenu from a Bulletin Board 
  438.         System (BBS), please read the READ.ME file that came with this 
  439.         version for some additional instructions.
  440.          
  441.         Please take a moment to complete and mail the Warranty 
  442.         Registration form provided. This will register you as a user of 
  443.         AUTOMENU and help us provide you with better service.  
  444.  
  445.         We welcome user comments and suggestions concerning the software 
  446.         and the documentation. Please feel free to call, write or use the 
  447.         comment form provided with this documentation to give us your 
  448.         reactions to this product. All user comments are carefully 
  449.         considered in our continuing effort to improve the program and 
  450.         its documentation.
  451.  
  452.         Thank you for purchasing AUTOMENU.
  453.          
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  489.         Automenu version 4.0                        DOS and Automenu
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.                                     SECTION 2
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.                                 DOS and Automenu
  505.  
  506.  
  507.  
  508.  
  509.         We referred to "DOS" commands in Section 1 of this manual. You 
  510.         probably have seen the letters "DOS" in other reference books for 
  511.         your computer, and the applications for it. The letters, stand 
  512.         for Disk Operating System. This is simply a program that runs 
  513.         your computer. It handles tasks such as input and output 
  514.         functions...reading, writing, and printing to the screen.
  515.  
  516.         You see one aspect of DOS each time you turn on your computer. 
  517.         That is the "DOS prompt" that always greets you: A>, if  you have 
  518.         floppy drives, and C> if you have a fixed disk. You will see this 
  519.         prompt referred to often in these instructions. It will always be 
  520.         shown just the way we have used it here: C>. You will see this 
  521.         reference when you are required to enter a command that you want 
  522.         DOS to execute directly from the prompt.
  523.  
  524.         2-1. Types of Commands
  525.  
  526.         DOS uses two types of commands: internal and external.
  527.  
  528.         Internal commands are loaded into the computer's memory from a 
  529.         file called COMMAND.COM. These commands remain in memory until 
  530.         the machine is turned off. They are referred to as "resident" or 
  531.         internal commands.
  532.  
  533.         External commands are located on your DOS disk. They are loaded 
  534.         into memory only when you call them up. They are referred to as 
  535.         external or non-resident commands.
  536.  
  537.         2-2. Subdirectories
  538.  
  539.         DOS version 2.0 and subsequent versions have the capability of 
  540.         organizing your fixed disk into "subdirectories." This means you 
  541.         can divide your fixed disk into many smaller "disks," or 
  542.         subdirectories, which gives you much more flexibility in 
  543.         organizing your files. It also prevents any one directory from 
  544.         becoming so large that the process of locating files and 
  545.         executing commands is slowed.
  546.  
  547.  
  548.  
  549.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  550.         Automenu version 4.0                        DOS and Automenu
  551.  
  552.  
  553.         A subdirectory actually is a specific section of your fixed disk 
  554.         that contains a group of related files. All of your DOS files are 
  555.         probably in a directory. The concept of subdirectories is 
  556.         important to your use of AUTOMENU. You will have many occasions 
  557.         to work with subdirectories when you create your menus.
  558.  
  559.         A directory is a table of contents of the files on a specific 
  560.         part of the disk. You might think of it as a file drawer. The 
  561.         main directory--the file drawer--is called the "root" directory. 
  562.         DOS identifies the root directory with a backslash (\). You will 
  563.         often use this symbol when you create menus.
  564.  
  565.         In the filedrawer--the root directory--may be many file folders. 
  566.         These are the subdirectories that are linked to the root like 
  567.         branches on a tree. A typical group of file folders might be 
  568.         linked to the root like this:
  569.  
  570.                                       \ (root directory)
  571.                                       |
  572.                           ____________|____________      these are all
  573.                          |                        |      subdirectories
  574.                          |                        |           /
  575.                        \SALES                 \AUTOMENU  <---/
  576.                          |                                  /
  577.                 _________|__________                       /
  578.                 |                  |                      /
  579.                 |                  |                     /
  580.           \SALES\ATL         \SALES\DEN  <--------------/
  581.                          
  582.  
  583.         Notice that there is a specific path from the root to, say, your 
  584.         Atlanta sales data. If you wanted to access that data, you would 
  585.         have to tell your system what path to take to get to that data. 
  586.         To do this you would type: \SALES\ATL\ATLANTA.SLS.
  587.  
  588.         The \SALES tells the system to go to that directory. Then the 
  589.         \ATL directs the system to the next lower directory.
  590.  
  591.         2-3. Extensions
  592.  
  593.         The last term, ATLANTA.SLS, represents the specific document in 
  594.         the \SALES\ATL file folder that you want to see. All files on 
  595.         your system have a name similar to this. The term, "Atlanta," is 
  596.         the primary name given the data. The .SLS term is known as the 
  597.         "extension." This describes the type of data in the file. 
  598.         Extensions are always separated from the name by a period (.). 
  599.         AUTOMENU uses the extension (.MDF), or Menu Definition File. The 
  600.         file on your DOS disk have extensions such as (.COM) for command, 
  601.         (.EXE) for executable, and (.BAT) for batch file.
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  611.         Automenu version 4.0                        DOS and Automenu
  612.  
  613.  
  614.         2-4. Batch Files
  615.  
  616.         A batch file is a series of DOS commands collected into a single 
  617.         file, that can then be executed any time. You will find uses for 
  618.         batch files in creating menus.
  619.  
  620.  
  621.         One batch file in the DOS root directory is AUTOEXEC.BAT. This is  
  622.         the utility DOS uses to get your computer running, or operating, 
  623.         when you first turn it on. AUTOMENU will be most useful if it is 
  624.         called up when your system is first turned on. We can make this 
  625.         happen by putting commands in the AUTOEXEC file that 
  626.         automatically take you to the menu. You will do that when you 
  627.         install AUTOMENU on your fixed disk (see Section 3).
  628.  
  629.         You will learn how that can be done in the next section.
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  672.         Automenu version 4.0                                  Install
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.                                     SECTION 3
  681.  
  682.  
  683.  
  684.  
  685.  
  686.                                INSTALLING AUTOMENU
  687.  
  688.  
  689.  
  690.  
  691.  
  692.         Now that you've seen how AUTOMENU can help you get the most from 
  693.         your computer and software, let's learn how to put this powerful 
  694.         tool to work for us.
  695.  
  696.         AUTOMENU is most useful for systems with fixed disk that contain 
  697.         most of the programs, software and utilities you work with in 
  698.         your day-to-day computer use. These files usually include 
  699.         programs for word processing, spreadsheets, and data base 
  700.         management. Since procedures for fixed and diskette drives are 
  701.         similar, we will concentrate on fixed disk systems. 
  702.  
  703.  
  704.         3-1. Installing AUTOMENU
  705.  
  706.         When you install AUTOMENU, you will set up the conditions 
  707.         required to integrate AUTOMENU with all your files and programs. 
  708.         The AUTOMENU installation program will ask you for specific 
  709.         information. Typing in this information sets up the program to 
  710.         your individual specifications.
  711.          
  712.         The first action you must take to use AUTOMENU is to "load" the 
  713.         program onto your fixed disk so it can be linked, or connected, 
  714.         to the programs it will control for you.
  715.  
  716.         To install AUTOMENU, perform the following steps:
  717.  
  718.  
  719.              1. Start up your system.
  720.  
  721.              2. Your "C prompt," - C> - will be displayed on the screen.
  722.  
  723.              3. Insert the AUTOMENU diskette into your diskette drive
  724.                 (assuming all files are on a diskette).
  725.              
  726.              4. On the prompt line, type  "A:install".
  727.  
  728.              5. Press ENTER .          
  729.  
  730.  
  731.  
  732.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  733.         Automenu version 4.0                                  Install
  734.  
  735.  
  736.  
  737.         You will now see the first of a series of help and prompt screens 
  738.         that will walk you through the installation procedure. This first 
  739.         display summarizes the decisions you will be asked to make as you 
  740.         proceed with installation. Study them closely, so you will be 
  741.         ready to respond to the prompts as they occur.
  742.  
  743.         If you don't understand a question right now, continue on with 
  744.         this tutorial. We will explain each prompt as it is displayed. It 
  745.         is also explained by AUTOMENU, on screen.
  746.  
  747.         The next display tells you more about what will be happening as 
  748.         you proceed with installation. As this prompt notes, the act of 
  749.         installing the program will teach you a great deal about 
  750.         AUTOMENU.
  751.  
  752.         What you see now is the AUTOMENU Installation menu. As we want to 
  753.         install the program, select option "1."  Press the "1" key.
  754.  
  755.         The next display tells  you how to choose the drive on which you 
  756.         wish to load AUTOMENU. The default drive, as you can see, is C:, 
  757.         for fixed disk systems.  
  758.  
  759.         The next screen asks for the "subdirectory" in which we wish 
  760.         AUTOMENU to reside. You can use the cursor keys to make the 
  761.         desired menu selection.
  762.  
  763.         When you press ENTER, the next display asks for the name of the 
  764.         sub-directory that your DOS commands are located. This is vital 
  765.         for the operation of the program. Type in the name of the 
  766.         directory containing your DOS commands. This is usually \DOS.
  767.  
  768.         When you press ENTER, the next display asks if your AUTOEXEC file 
  769.         sets the path--that is, links--your system to the DOS commands. 
  770.         As the prompt tells you, if you aren't sure, respond with a "NO" 
  771.         by pressing the right cursor key, and the program will 
  772.         automatically set the path properly.  
  773.  
  774.         Next, you are asked if you want AUTOMENU to come up each time you 
  775.         boot up. Certainly, in most cases, this gives you the most 
  776.         flexibility. Select the default "YES."
  777.  
  778.         Now, you will be given the opportunity to review the decisions 
  779.         you have made. Review these carefully. If they are wrong, press 
  780.         enter, and you can revise them. If they are correct, select "OK" 
  781.         with the right cursor key, and press ENTER.
  782.  
  783.         AUTOMENU will now complete the installation process, and when the 
  784.         program is installed on your fixed disk, a screen indicating that 
  785.         will appear. This can take a few minutes depending on the speed 
  786.         of your system. 
  787.  
  788.         At this point, remove the AUTOMENU diskette from Drive A:, and 
  789.         start up you system again. You do this by pressing CTRL, ALT, and 
  790.         DEL keys all at the same time.                                    
  791.  
  792.  
  793.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  794.         Automenu version 4.0                                  Install
  795.  
  796.  
  797.  
  798.         If you told install to bring up AUTOMENU when the system is first 
  799.         started up, you will now see a sample menu. Note that selection 1 
  800.         is the AUTOMENU Menu-Building Facility. Press the "1" key to 
  801.         execute this facility. 
  802.  
  803.         If you did not tell install to bring up AUTOMENU or you are using 
  804.         a diskette only system; enter the command "AUTO" at the DOS 
  805.         prompt to start AUTOMENU and to bring up the sample menu. 
  806.  
  807.  
  808.         3-2 Sample MDF        
  809.  
  810.  
  811.         You will now see the Menu-Building Facility menu on your screen.
  812.  
  813.  
  814.         *****************************************************************
  815.  
  816.                          Automenu Menu-Building Facility
  817.  
  818.  
  819.               1 - Modify an old or start a new Menu Definition File
  820.  
  821.               2 - Print Menu Definition File to Printer
  822.  
  823.               3 - Leave this Facility
  824.  
  825.  
  826.  
  827.                          Please enter selection (1-3) =>
  828.  
  829.         ****************************************************************
  830.                      Figure 3-1. Menu-Building Facility Menu
  831.  
  832.  
  833.         To create a new menu, select "1" by typing the numeral "1" at the 
  834.         prompt.  AUTOMAKE will then ask for an MDF name. Let's call this 
  835.         Menu Definition File (MDF), "TEST.MDF". Type that in and press 
  836.         ENTER; AUTOMAKE will inform you that TEST.MDF must be new and 
  837.         will require you to press the space bar to continue. AUTOMAKE 
  838.         will then display to you a sample Menu Definition File, or MDF on 
  839.         the screen. 
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  855.         Automenu version 4.0                                  Install
  856.  
  857.  
  858.         ================================================================
  859.           MDF Functions      |              MDF Information
  860.         -----------------+---+------------------------------------------
  861.                          |   |
  862.               -1-        |   |                 -3-
  863.                          |   |
  864.                          |-2-|
  865.                          |   |
  866.                          |   |
  867.         -----------------+---+------------------------------------------
  868.                                 -4-
  869.         ----------------------------------------------------------------
  870.                                    -5-
  871.  
  872.         ----------------------------------------------------------------
  873.                                        -6-
  874.         ================================================================
  875.                 Figure 3-2. Areas of MDF Display (see Table 3.1)
  876.  
  877.  
  878.         This is the screen you will subsequently use to build your own 
  879.         menu. You can see the type of entries you will be making. Each 
  880.         area of the MDF screen is defined in Table 3.1.
  881.  
  882.         The Menu Definition File, MDF, is the file, like AUTOEXEC.BAT and 
  883.         others, in which your menu is stored. You can put eight menus in 
  884.         each MDF. The file is actually a ordinary ASCII file and could be 
  885.         edited with any editor that can read and write ASCII files, like 
  886.         Wordstar in non-document mode. We provide AUTOMAKE to make it 
  887.         easier to get started. After learning the basic of AUTOMENU 
  888.         advanced users might want to use their own text editor which may 
  889.         have more features than this version of AUTOMAKE.
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  916.         Automenu version 4.0                                  Install
  917.  
  918.  
  919.               Table 3.1. Menu-Building Facility Screen Description
  920.         ------+------------------------+---------------------------------
  921.          Area |        Function        |         Description
  922.         ------+------------------------+---------------------------------
  923.  
  924.           1     Protected--AUTOMAKE       The entries in this column
  925.                 identifies symbol         describe the function of the
  926.                 entered in Area 2.        command in column 2.
  927.  
  928.  
  929.           2     Command symbols are       The function codes you enter here
  930.                 entered here.             (explained in the next section)
  931.                                           execute the required menu 
  932.                                           building functions.
  933.  
  934.  
  935.           3     Text to appear on         The text you type in this column 
  936.                 your menu or used         is the text you want in the menu
  937.                 by AUTOMENU               section specified in column 1,
  938.                                           or commands you want AUTOMENU
  939.                                           to execute.
  940.  
  941.           4     Protected--status         Error messages are displayed in
  942.                 line.                     this area.
  943.  
  944.  
  945.           5     Protected--MDF            When HELP toggle (F1) is ON,
  946.                 functions and             functions entered in column 2
  947.                 HELP messages are         are defined. When HELP toggle
  948.                 displayed.                is OFF, the name of all MDF
  949.                                           symbols are shown.
  950.  
  951.           6     Protected--               Certain keys are programmed to
  952.                 frequently used           make your work easier. These are
  953.                 key functions.            indicated here.
  954.         ----------------------------------------------------------------
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  977.         Automenu version 4.0                                  Install
  978.  
  979.  
  980.         3-3. Menu-Building Facility Key Functions
  981.  
  982.         To make menu-building easier, several keys are given special 
  983.         functions. These are described in Table 3.2.
  984.  
  985.  
  986.            Table 3.2. Menu-Building Facility Programmed Key Functions
  987.         --------+-------------------+-----------------------------------
  988.           Key   |      Function     |           Description
  989.         --------+-------------------+-----------------------------------
  990.          F1       HELP toggle         ON--extended Help messages 
  991.                                       displayed;
  992.                                       OFF--function of all MDF symbols.
  993.  
  994.          F3       Line insert         Adds a blank line below cursor
  995.  
  996.          F4       Delete              Delete entire line on which cursor
  997.                                       appears.
  998.  
  999.          INS      Insert toggle       ON--allows you to insert text from
  1000.                                       cursor position;
  1001.                                       OFF--new text overwrites old.
  1002.  
  1003.          DEL      Delete              Deletes a character to the left 
  1004.                                       of the cursor.
  1005.  
  1006.          ESC      Exit MDF            With cursor in column 2, ESC returns
  1007.                                       you to operating system.
  1008.  
  1009.          ENTER    Enter data          Enters the line just completed, and
  1010.                                       moves cursor to next line;
  1011.                                       On some keyboards, this key is 
  1012.                                       marked RETURN.
  1013.  
  1014.          HOME     Cursor return       When cursor is in column 3, this
  1015.                                       key moves it to the first character
  1016.                                       in the first line in column 3.
  1017.  
  1018.          END      End of page         Moves cursor to last character in
  1019.                                       column 3.
  1020.  
  1021.          CTRL     Top of MDF          Moves cursor to top of MDF
  1022.          HOME
  1023.  
  1024.          CTRL     Bottom of           Moves cursor to bottom of MDF.
  1025.          END      MDF
  1026.  
  1027.          PgDn     Next page           Displays next page in MDF
  1028.  
  1029.          PgUp     Previous            Displays previous page in MDF
  1030.                   page
  1031.  
  1032.          Arrow    Cursor              Moves cursor right, left, up, down,
  1033.                   movement            in direction of arrow.
  1034.         -----------------------------------------------------------------
  1035.  
  1036.  
  1037.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  1038.         Automenu version 4.0                                  Install
  1039.  
  1040.  
  1041.         3-4. Exiting the Edit Mode of the Menu-Building Facility
  1042.  
  1043.         Now that you are familiar with the facilities you will use, you 
  1044.         are almost ready to build a menu. First, lets exit the sample.
  1045.  
  1046.         1. Place the cursor in column 2.
  1047.  
  1048.         2. Press the ESC key.
  1049.  
  1050.         3. At the prompt, type "Y".
  1051.  
  1052.         4. At the next prompt, type "N".
  1053.  
  1054.         You are returned to the Menu-Building Facility menu.
  1055.  
  1056.  
  1057.         3-5. Using AUTOMENU on a diskette system
  1058.  
  1059.         To use AUTOMENU on a diskette system which has no fixed disk 
  1060.         requires you to copy the AUTOMENU files needed. The minimum 
  1061.         configuration requires the files: AUTOMENU.COM, AUTOMENU.MDF, 
  1062.         AUTOMAKE.EXE, and AUTO.BAT. The file AUTOMAKE.EXE is only needed 
  1063.         during the menu building process and can be erased if space on 
  1064.         the diskette is needed. See section 8 for examples of the file
  1065.         AUTOEXEC.BAT required to bring up AUTOMENU directly when the 
  1066.         diskette is the boot disk. 
  1067.                             
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  1099.         Automenu version 4.0                         Making a Menu
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.                                     SECTION 4
  1108.  
  1109.  
  1110.  
  1111.  
  1112.                                   MAKING A MENU
  1113.  
  1114.  
  1115.         Now that you're acquainted with AUTOMENU's menu-building 
  1116.         facility, you are ready to construct your own customized menu.
  1117.  
  1118.         We will walk through the construction of a test menu to 
  1119.         familiarize you with the primary functions. These are summarized 
  1120.         at the end of this section.
  1121.  
  1122.         4-1. Developing an MDF
  1123.  
  1124.         Remember, a Menu Definition File (MDF) is the AUTOMENU file in 
  1125.         which your menu is stored. You can store as many as eight menus 
  1126.         in each MDF.
  1127.  
  1128.         To begin creating a menu, perform the following steps:
  1129.  
  1130.              1.  Access the Menu Building Facility menu as explained 
  1131.                  in paragraph 3-2, or by typing "automake" at the C>
  1132.                  prompt once you are in the AUTOMENU subdirectory.
  1133.  
  1134.              2.  Select "1" by pressing the "1" key.
  1135.  
  1136.              3.  You are prompted to enter a file name for your MDF.
  1137.                  You can give your MDF any valid DOS file name of up to
  1138.                  eight characters, with three extension characters, such
  1139.                  as TEST.MDF. Type in your MDF name. If you use TEST.MDF,
  1140.                  Type: "TEST.MDF". Then press ENTER.
  1141.  
  1142.              4.  AUTOMAKE will tell you that this must be a new MDF, so 
  1143.                  press ENTER to continue. A starter menu will then be 
  1144.                  displayed.
  1145.  
  1146.  
  1147.         This starter menu shows you a small example of some of the types 
  1148.         of entries you will be making when you create a menu. Study them 
  1149.         before continuing.
  1150.  
  1151.         It may be useful to "dump" the screen to your printer, so you 
  1152.         will have a permanent record for reference. Use the Shift-PrtSc 
  1153.         to print the current screen to printer. 
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  1160.         Automenu version 4.0                         Making a Menu
  1161.  
  1162.  
  1163.  
  1164.         4-1.1. Entering Comments
  1165.  
  1166.         This starter menu is designed to function as a "template" for 
  1167.         your own menu. You are going to create your menu by adding to 
  1168.         this template. This gives you the chance to see how a selection 
  1169.         or item was entered, so you will have a better idea of how to 
  1170.         enter your own.
  1171.  
  1172.         First, move the cursor to column 2, and then move it to the line 
  1173.         just above the "Exit to DOS" selection on the starter menu. Now 
  1174.         press F3 to insert a line. You must always have an "Exit to DOS" 
  1175.         selection on your menu so you can return to the system if 
  1176.         necessary.
  1177.  
  1178.         You will be using the F3 insert function throughout the 
  1179.         development of  your menu. Remember that each time you are 
  1180.         instructed to press F3, your cursor must be on the line ABOVE 
  1181.         where you want the inserted line to appear.
  1182.  
  1183.         You will probably want to provide certain data and notes on each 
  1184.         menu that explain aspects of the menu to anyone revising or 
  1185.         modifying the file. The first function we look at will make that 
  1186.         possible (column numbers refer to those illustrated in Figure
  1187.         3-1).
  1188.  
  1189.             
  1190.              1. Move the cursor to column 2. 
  1191.  
  1192.              2. Type a period {.}.
  1193.                 Remember, you are typing over the sample. That is
  1194.                 what it is designed for.
  1195.             
  1196.                 The word "Comment" appears in column 1.
  1197.  
  1198.         The period {.} tells AUTOMENU that any entry made in column 3, 
  1199.         following that symbol, is a comment only, and should be ignored. 
  1200.         This gives you the ability to enter explanatory data in the MDF, 
  1201.         such as the date of the last menu update, for your own use.
  1202.  
  1203.              3. Type "Menu-Building Test" in column 3.
  1204.  
  1205.              4. Press ENTER to return the cursor to column 2.
  1206.  
  1207.              5. Press F3 to insert a line (as explained above).
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  1221.         Automenu version 4.0                         Making a Menu
  1222.  
  1223.  
  1224.         4-1.2. Titling Your Menu
  1225.  
  1226.         Each menu needs a descriptive title that is displayed centered at 
  1227.         the top of the menu when it is used. This function provides that 
  1228.         capability.
  1229.  
  1230.              1. Type {%}.
  1231.  
  1232.                 The word "Title" appears in column 1.
  1233.  
  1234.         The percent {%} symbol tells AUTOMENU that an entry in column 3 
  1235.         following the {%} symbol is a menu title. The title will be 
  1236.         displayed on your completed menu, in the center of the top line.
  1237.  
  1238.              2. Type "Test Menu" in column 3.
  1239.  
  1240.              3. Return the cursor to column 2 by pressing ENTER.
  1241.  
  1242.  
  1243.         4-1.3. Entering Your Menu Selections
  1244.  
  1245.         Each menu will give the user the program selections he can  
  1246.         select from that menu. As many as eight selections per menu page 
  1247.         are available.
  1248.  
  1249.              1. Type the symbol {*} in column 2.
  1250.  
  1251.                 The word "Selection" appears in column 1.
  1252.  
  1253.         The {*} symbol is the code for a menu selection.
  1254.  
  1255.              2. Type "Word Processing."
  1256.  
  1257.              3. Press ENTER.
  1258.  
  1259.         You have just put the first selection on your menu.
  1260.  
  1261.              4. Type {*} in column 2.
  1262.  
  1263.              5. Type "LOTUS 123" in column 3.
  1264.  
  1265.              6. Press ENTER.
  1266.  
  1267.  
  1268.         You have now added the LOTUS 123 spreadsheet to your menu.
  1269.  
  1270.  
  1271.         4-1.4. Including DOS Commands on the Menu
  1272.  
  1273.         Your menu is not yet complete. If you recall the discussion in 
  1274.         Section 2 regarding subdirectories, you know that AUTOMENU is in 
  1275.         one specific subdirectory. Your word processing program is in 
  1276.         another, different subdirectory. For AUTOMENU to "call up" the 
  1277.         word processing program, it must tell the operating system that 
  1278.         it has to move from the current directory, to the directory 
  1279.  
  1280.  
  1281.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  1282.         Automenu version 4.0                         Making a Menu
  1283.  
  1284.  
  1285.         containing word processing. Here is how to do that.
  1286.  
  1287.         First, move the cursor to the line where your "Word Processing" 
  1288.         entry is. Let's assume you use Wordstar.
  1289.  
  1290.  
  1291.              1. Place the cursor in column 2.
  1292.  
  1293.              2. Press F3 to insert a line.
  1294.  
  1295.              3. Move the cursor to the blank line.
  1296.  
  1297.              4. Type {+} in column 2.
  1298.  
  1299.         The {+} symbol directs AUTOMENU to execute any command  following 
  1300.         the code as a DOS command.
  1301.  
  1302.              5. Type "CD \WS".
  1303.  
  1304.              6. Press ENTER.
  1305.  
  1306.         This tells the operating system to move to the directory that 
  1307.         contains the Wordstar program. Remember the discussion of 
  1308.         PATHNAMES in Section 2? You are giving the pathname for Wordstar. 
  1309.         You must ALWAYS change subdirectories using the "CD" command when 
  1310.         you have AUTOMENU call a program.
  1311.  
  1312.              7.  Press F3.  Remember to move the cursor to the previous 
  1313.                  line.
  1314.  
  1315.              8.  Type {+}
  1316.  
  1317.              9.  Type "WS".
  1318.  
  1319.              10. Press ENTER.
  1320.  
  1321.         This is the filename for Wordstar. Previously, when you wanted to 
  1322.         use this program, you typed "WS" at the system prompt:
  1323.  
  1324.                             C>WS.
  1325.  
  1326.  
  1327.         Now, AUTOMENU will automatically call Wordstar when you select 
  1328.         Word Processing on your menu.
  1329.  
  1330.         When we have completed work with Wordstar, we must return to 
  1331.         AUTOMENU. To do that, the system must be given the return path.
  1332.  
  1333.              11. Press F3.
  1334.  
  1335.              12. Move the cursor to the blank line.
  1336.  
  1337.              13. Type {+}.
  1338.  
  1339.              14. Type "CD \AUTOMENU.
  1340.  
  1341.  
  1342.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  1343.         Automenu version 4.0                         Making a Menu
  1344.  
  1345.  
  1346.  
  1347.              15. Press ENTER.
  1348.  
  1349.              16. Press F3.
  1350.  
  1351.              17. Move the cursor to the blank line.
  1352.             
  1353.              18. Type {+}.
  1354.              
  1355.              19. Type "AUTO".
  1356.  
  1357.         This last command, "AUTO", returns control to AUTOMENU. It is 
  1358.         important that you end all command series--those preceded by the 
  1359.         plus {+} symbol--with "AUTO" so your menu returns to the screen 
  1360.         when you complete your work with the selection. If you do not 
  1361.         make "AUTO" the last command, the user will be returned to DOS.
  1362.  
  1363.         What you have now on this portion of the menu is this:
  1364.  
  1365.                             %Test Menu
  1366.                             *Word Processing
  1367.                             +CD \WS 
  1368.                             +WS
  1369.                             +CD \AUTOMENU
  1370.                             +AUTO
  1371.  
  1372.  
  1373.         What you have done is to create a "DOS Batch routine," similar to 
  1374.         the batch files discussed in Section 2. This is not a true batch 
  1375.         file, but it does consist of a series of commands--a program 
  1376.         routine--that instructs your computer to perform the desired 
  1377.         functions. All required commands are included in the order they 
  1378.         are to be performed. The user will not have to perform any 
  1379.         additional action. AUTOMENU does the entire job.
  1380.  
  1381.  
  1382.         4-2. Completing the Menu
  1383.  
  1384.         We must also construct a command routine for our other selections. 
  1385.         Here is how your command routine for LOTUS should look:
  1386.                             
  1387.                             *LOTUS 123
  1388.                             +CD \LOTUS
  1389.                             +123
  1390.                             +CD \AUTOMENU
  1391.                             +AUTO
  1392.  
  1393.         When you have entered all the menu selections and DOS command 
  1394.         routines you need, you must tell AUTOMENU the MDF is ended.
  1395.  
  1396.               Type {#} in column 2.
  1397.  
  1398.         This symbol is an "end-of-file" command. It tells AUTOMENU you 
  1399.         have completed the menu.
  1400.  
  1401.  
  1402.  
  1403.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  1404.         Automenu version 4.0                         Making a Menu
  1405.  
  1406.  
  1407.         The {#} symbol MUST be entered as the final symbol on every menu.
  1408.  
  1409.         Exit and save your test menu: 
  1410.  
  1411.                   1. Place the cursor in column 2.
  1412.  
  1413.                   2. Press the ESC key.
  1414.  
  1415.                   3. At the prompt, type "Y".
  1416.  
  1417.                   4. At the next prompt, type "Y", as we want to save 
  1418.                      our sample this time.
  1419.  
  1420.         AUTOMENU now asks if you wish to Password protect your menu. A 
  1421.         password lets you prevent unauthorized users from accessing your 
  1422.         MDF. This protects your MDF from being changed. For now, we have 
  1423.         no need to protect the test menu. Press ENTER.
  1424.               
  1425.  
  1426.         The functions and symbols you have just used are summarized, 
  1427.         along with others, in Section 6. For now, let's take a look at 
  1428.         the menu we've built.
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  1465.         Automenu version 4.0                          Using Your Menu
  1466.  
  1467.  
  1468.  
  1469.                                                                          
  1470.  
  1471.                                     SECTION  5
  1472.  
  1473.  
  1474.  
  1475.  
  1476.                                  USING YOUR MENU
  1477.  
  1478.                                                                          
  1479.         Let's take a look at the menu we've built, and learn to use it.
  1480.  
  1481.         If you find yourself in the Sample Menu, select the menu 
  1482.         selection "Return to Disk Operating System". If you already at 
  1483.         the DOS prompt then continue.
  1484.          
  1485.         To display the test menu will require that you change directories 
  1486.         to the AUTOMENU directory by entering the command "CD \AUTOMENU". 
  1487.         To display the menu you just finished, at the DOS prompt enter 
  1488.         the command "AUTOMENU TEST.MDF". 
  1489.  
  1490.         What we are doing is running the menu program against your 
  1491.         TEST.MDF and causing AUTOMENU to read that menu and display it.
  1492.  
  1493.         This method is for example only. For this example you would type 
  1494.         in the name you gave the MDF created in Section 4.
  1495.  
  1496.  
  1497.         5-1. The Menu
  1498.  
  1499.         When you access the MDF, you will see your menu. It should look 
  1500.         similar to this representation:
  1501.  
  1502.         ****************************************************************
  1503.  
  1504.                            >1<--- TEST MENU
  1505.                                                     >2<---Menu 1 of 4
  1506.  
  1507.  
  1508.  
  1509.                   >3<--- 1. Word Processing--->4<
  1510.                            
  1511.  
  1512.                   >5<--- 2. LOTUS 123
  1513.  
  1514.  
  1515.                                    ------------
  1516.                             >6<---|Run Wordstar|                >7<
  1517.                                    ------------                   \
  1518.         ----------------------------------------------------------------
  1519.         July 2, 1986  11:07:14am       CAPS               Memory: 307 K
  1520.         ----------------------------------------------------------------
  1521.                            >8<    Press H for HELP
  1522.         ****************************************************************
  1523.  
  1524.  
  1525.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  1526.         Automenu version 4.0                          Using Your Menu
  1527.  
  1528.  
  1529.  
  1530.         Table 5.1, below explains the various parts of the menu, and how 
  1531.         to use the functions.
  1532.  
  1533.  
  1534.                            Table 5.1. Menu Description
  1535.         ----------+-----------------+-----------------------------------
  1536.          Item No. |    Function     |      Description and Use
  1537.         ----------+-----------------+-----------------------------------
  1538.  
  1539.             1       Title              The menu title you specified.
  1540.  
  1541.             2       Number of menus    You can have up to eight menus in
  1542.                     in MDF             each MDF.
  1543.  
  1544.             3       Menu selection     The arrow pointer can be moved,
  1545.                                        using the space bar, to make a
  1546.                                        menu selection.                        
  1547.  
  1548.             4       Menu selection     A highlight bar may also be used
  1549.                                        to make a selection.
  1550.  
  1551.             5       Selections         These are the options you specified
  1552.                                        for you menu. The option may be
  1553.                                        selected by typing the option number.
  1554.  
  1555.             6       Explanation        Text you can put on your MDF to 
  1556.                                        clarify a menu selection.
  1557.  
  1558.             7       Status line        Gives you the following data:
  1559.  
  1560.                                        date--three formats you choose
  1561.  
  1562.                                        time--two formats you choose
  1563.  
  1564.                                        special keys in use, such as Caps
  1565.                                        Lock, Shift, Alt, etc.
  1566.  
  1567.                                        memory available.
  1568.  
  1569.             8       Help               Press "H" once to obtain a menu
  1570.                                        help key. Press "H" again for more
  1571.                                        information.
  1572.         ----------------------------------------------------------------
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  1587.         Automenu version 4.0                          Using Your Menu
  1588.  
  1589.  
  1590.         5-2. Programmed Menu Keys
  1591.  
  1592.         Several keys are given specific functions when a menu is on 
  1593.         screen. These are described in Table 5.2, below.
  1594.  
  1595.  
  1596.                          Table 5.2. Programmed Menu Keys
  1597.         -------+----------------+---------------------------------------
  1598.           Key  |    Function    |        Description and Use
  1599.         -------+----------------+---------------------------------------
  1600.  
  1601.         F10     Next menu page   Displays the next menu page in the MDF
  1602.  
  1603.         PgDn    Next menu page   Displays the next menu page in the MDF
  1604.  
  1605.         -->     Next menu page   Displays the next menu page in the MDF
  1606.  
  1607.         F9      Previous         Displays the previous menu page in the 
  1608.                 menu page        MDF
  1609.                 
  1610.         PgUp                     Displays the previous menu page
  1611.  
  1612.         <--                      Displays the previous menu page
  1613.              
  1614.         HOME    First menu       Displays the first menu page in MDF
  1615.  
  1616.         END     Last menu        Displays the last menu page in MDF
  1617.  
  1618.         B       Screen           Activates the screen blackout feature 
  1619.                 blackout         
  1620.  
  1621.         H       Help             Displays help messages
  1622.  
  1623.                                  Press once to display "menu help key" 
  1624.                                  that, when pressed, displays a brief   
  1625.                                  help message. Press twice to call up
  1626.                                  an extended help message.
  1627.  
  1628.         M       Message          Prompts user for a user-defined message
  1629.                                  that will be displayed when screen
  1630.                                  blackout is activated.
  1631.  
  1632.         S       Monitor          Switches from color to monochrome
  1633.                 switch           monitor, and back. Switches active 
  1634.                                  monitor.
  1635.  
  1636.         P       Program info     Displays information about this program. 
  1637.         ----------------------------------------------------------------
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  1648.         Automenu version 4.0                          Using Your Menu
  1649.  
  1650.  
  1651.  
  1652.         Work with your test menu to get acquainted with all these 
  1653.         functions. Then you will be ready to build your own custom menu.
  1654.  
  1655.         You can return to the test menu and edit it, or build a brand new 
  1656.         MDF. The file AUTOMENU.MDF is designed to be your main menu and 
  1657.         we recommend that you use it as a template. The menu selections 
  1658.         AUTOMENU.MDF contains are for example only and can be removed and 
  1659.         modified to meet your needs.
  1660.  
  1661.         Before doing that, you may wish to review the next section. 
  1662.         Additional AUTOMENU functions are explained, and these will prove 
  1663.         useful in building a full-scale menu.
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  1709.         Automenu version 4.0                     Other Capabilities
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.                                     SECTION 6
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.                        USING AUTOMENU'S OTHER CAPABILITIES
  1725.  
  1726.  
  1727.  
  1728.  
  1729.         The tutorials you have worked through to this point have given 
  1730.         you an understanding of AUTOMENU's basic capabilities. There are 
  1731.         many more unique and useful features. 
  1732.  
  1733.         AUTOMENU's capabilities can be grouped into three types of 
  1734.         functions. These are: Menu Design; DOS Commands; and Special 
  1735.         Functions. You have used some of the menu design functions in the 
  1736.         previous section. These were the {.}, {%}, and {*} symbol 
  1737.         functions. You've also used one of the DOS Command functions the 
  1738.         {+} symbol.
  1739.  
  1740.         The other functions in each group also use special symbols that 
  1741.         are entered in column 2 of the MDF. We will describe these in 
  1742.         this section. All symbols are summarized in Table 6-1, at the end 
  1743.         of the section.
  1744.  
  1745.  
  1746.         6-1. Menu Design Functions
  1747.  
  1748.         As noted, you are already acquainted with most of the menu design 
  1749.         features. These are:
  1750.  
  1751.                        %--Menu Title
  1752.  
  1753.                        .--MDF Comment
  1754.  
  1755.                        *--Menu Selection
  1756.  
  1757.         There is one other function we can include in this group.
  1758.  
  1759.         It may sometimes be useful and necessary to provide a user with 
  1760.         additional information about a menu selection. For example, when 
  1761.         he is selecting a copy protected program for which a disk must be 
  1762.         inserted. It could be useful to warn the user he will have to do 
  1763.         this before he actually makes the selection.
  1764.  
  1765.         The Selection Help function, a question mark {?} symbol, does 
  1766.         this. With the Selection Help functions, an explanatory message 
  1767.  
  1768.  
  1769.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  1770.         Automenu version 4.0                     Other Capabilities
  1771.  
  1772.  
  1773.         of your choice is displayed in a reverse video block just above 
  1774.         the Menu Status Line on the menu.
  1775.  
  1776.         Why don't you edit your test MDF and include this function?
  1777.  
  1778.         --Access TEST.MDF.
  1779.  
  1780.         --With the cursor in column 2, move to the line containing
  1781.           |Selection|*|LOTUS 123|. 
  1782.  
  1783.         --Press the F3 key to add a blank line below the |LOTUS 123|     
  1784.           line.
  1785.                                  
  1786.         --Move the cursor to the new blank line.
  1787.  
  1788.         --Type {?}.
  1789.  
  1790.           The word "Descript" is displayed in column 1.
  1791.  
  1792.         --In column 3, type "Insert the 123 diskette in Drive A:"
  1793.  
  1794.         Save the edited MDF, and call up the test menu to see the message 
  1795.         displayed when the arrow pointer or highlight block is moved to 
  1796.         the Lotus 123 selection.
  1797.  
  1798.         To summarize the four Menu Design functions:
  1799.  
  1800.                   %--Menu Title
  1801.  
  1802.                   .--MDF Comment
  1803.  
  1804.                   *--Menu Selection
  1805.  
  1806.                   ?--Selection Help Message
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  1831.         Automenu version 4.0                     Other Capabilities
  1832.  
  1833.  
  1834.         Here is an example of how these might be used in an MDF.
  1835.  
  1836.              .Menu-Building Test
  1837.              %TEST MENU
  1838.              *Word Processing
  1839.              +CD \WS
  1840.              +WS
  1841.              +CD \AUTOMENU
  1842.              +AUTO
  1843.              *LOTUS 123
  1844.              ?Need Lotus Disk in Drive A:
  1845.              +CD \LOTUS
  1846.              +123
  1847.              +CD \AUTOMENU
  1848.              +AUTO
  1849.              *Return to Disk Operating System
  1850.              +CD \
  1851.              +ECHO ON
  1852.              .
  1853.              . Below is an example how to add a second and third page
  1854.              . to your MDF. These pages would be available by pressing
  1855.              . Page Down while the menu is displayed.
  1856.              .
  1857.              %Second Menu
  1858.              *Erase files on Drive A:
  1859.              +ERASE A:*.*
  1860.              +AUTO
  1861.              %THIRD MENU
  1862.              *Copy diskette in Drive A: to Drive B:
  1863.              +DISKCOPY A: B:
  1864.              +AUTO
  1865.              #End of MDF
  1866.  
  1867.  
  1868.         6-2. DOS Commands
  1869.  
  1870.         In Section 3, you used the plus {+} symbol command to write 
  1871.         routines needed to permit the user to proceed with his menu 
  1872.         selection. These were DOS commands executed by the operating 
  1873.         system. AUTOMENU has the capability of executing DOS commands in 
  1874.         a variety of ways, depending on your needs and what you want the 
  1875.         system to do. There are two general categories of commands: batch 
  1876.         and direct.
  1877.  
  1878.         6-2.1. Batch Commands
  1879.  
  1880.         When you used the {+} symbol in building the test menu, you 
  1881.         combined several into a routine that performed one specific 
  1882.         function. When several commands are combined into one routine 
  1883.         like this, it is known as a batch routine--all the commands are 
  1884.         batched together in a single procedure. For complex routines, 
  1885.         these are the most advantageous. AUTOMENU utilizes two types of 
  1886.         batch routines: non-resident and resident.
  1887.  
  1888.  
  1889.  
  1890.  
  1891.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  1892.         Automenu version 4.0                     Other Capabilities
  1893.  
  1894.  
  1895.         6-2.1.1. Non-Resident Commands
  1896.  
  1897.         The routine you wrote for selecting Wordstar caused AUTOMENU to 
  1898.         build a external batch file, AUTOTEMP.BAT, and returned to the 
  1899.         operating system. Where the commands would then be executed as a 
  1900.         batch file line-by-line.
  1901.          
  1902.         AUTOMENU was "non-resident" in memory. This means that no memory 
  1903.         is required to hold large blocks of data. In other words, 
  1904.         AUTOMENU is not in memory at the time the series of DOS commands 
  1905.         are being executed.
  1906.  
  1907.         There is no limit to the number of {+} commands that can be 
  1908.         combined into a batch routine for any single menu selection. Each 
  1909.         command can be up to 127 characters in length.
  1910.  
  1911.         One major advantage of the {+} symbol is its ability to execute 
  1912.         programs that terminate and stay resident--known as TSR 
  1913.         programs--such as SIDEKICK, PROKEY, PRINT.COM, and others.
  1914.  
  1915.         But, there are disadvantages in some instances: this type of 
  1916.         batch routine is quite slow; a CONTROL-BREAK also will return you 
  1917.         to DOS, which undermines any security sets you may have 
  1918.         installed; and AUTOMENU must be reloaded when you want to return 
  1919.         to the menu.
  1920.  
  1921.         To use the {+} commands require the use of the batch file 
  1922.         AUTO.BAT. Which basically has two commands in it, one to run 
  1923.         AUTOMENU.COM and the other to run AUTOTEMP.BAT, the batch file 
  1924.         build by AUTOMENU. 
  1925.  
  1926.         The {+} commands are also use in situations where the user wants 
  1927.         to return to DOS when finished with a series of commands. See the 
  1928.         examples below to return to DOS or copy a file and then return to 
  1929.         DOS; the reason they do not return to the menu is because the 
  1930.         AUTO command is not included.
  1931.  
  1932.              %Example Menu
  1933.              *Copy text files to C: from A: and return to MENU
  1934.              +COPY A:*.TXT C:
  1935.              +AUTO
  1936.              *Copy text files to C: from A: and goto DOS
  1937.              +COPY A:*.TXT C:
  1938.              *Return to DOS
  1939.              +CLS
  1940.              #End of example menu 
  1941.  
  1942.         Even though the {+} commands are the slowest method, we recommend 
  1943.         that they be used by NEW USERS FIRST because they are less prone 
  1944.         to mistakes. Once you get used to AUTOMENU, the other methods 
  1945.         could be used. 
  1946.  
  1947.         When using the {+} commands in a alternate menu, it might be 
  1948.         desired for the alternate menu to be redisplayed when the routine 
  1949.         is finished instead of AUTOMENU.MDF or the main menu. To do this 
  1950.  
  1951.  
  1952.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  1953.         Automenu version 4.0                     Other Capabilities
  1954.  
  1955.  
  1956.         requires the user to specify the name of the alternate menu on 
  1957.         the same line with AUTO. For example, lets say you have a 
  1958.         communications menu called COMM.MDF and you want to return to the 
  1959.         COMM.MDF when ProComm is finished.
  1960.  
  1961.              %Communications Menu
  1962.              *ProComm
  1963.              +CD \PROCOMM
  1964.              +PROCOMM
  1965.              +CD \AUTOMENU
  1966.              +AUTO COMM.MDF
  1967.              *Return to Main Menu
  1968.              @AUTOMENU.MDF
  1969.              #End of COMM.MDF 
  1970.  
  1971.  
  1972.         6-2.1.2. Resident Commands
  1973.  
  1974.         The disadvantages mentioned in the paragraph above can be 
  1975.         overcome to a great extent by keeping AUTOMENU in memory. This 
  1976.         can be done with the {!} symbol command. This symbol is used in 
  1977.         exactly the same manner as the {+} symbol. There is no limit to 
  1978.         the number of commands that can be included in each routine, and 
  1979.         each line may contain as many as 127 characters. 
  1980.  
  1981.         The {!} symbol creates a batch file called AUTOTEMP.BAT. This 
  1982.         file contains each command in the routine. When it is initiated, 
  1983.         the routine is executed directly from AUTOMENU, which remains 
  1984.         dormant in memory.   
  1985.  
  1986.         This type of batch file is faster than the {+} command file, and 
  1987.         is useful for actions that do not require exiting to DOS.
  1988.  
  1989.         Here is an example with a routine for calling Wordstar using this 
  1990.         symbol:
  1991.                           
  1992.              %Example Menu
  1993.              *Word Processing
  1994.              !ECHO OFF
  1995.              !CLS
  1996.              !CD \WS
  1997.              !WS
  1998.              !CD \AUTOMENU
  1999.              *Return to DOS
  2000.              +CLS
  2001.              #End of example menu 
  2002.  
  2003.  
  2004.                                     >WARNING<
  2005.                            NEVER use the command !AUTO
  2006.  
  2007.         Also, do not attempt to execute TSR programs with the {!} symbol.
  2008.  
  2009.         Note that you still need to enter the CD change directory 
  2010.         commands before and after executing the program, if the program 
  2011.  
  2012.  
  2013.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  2014.         Automenu version 4.0                     Other Capabilities
  2015.  
  2016.  
  2017.         is in another directory. This is always necessary.
  2018.  
  2019.         In the example above the DOS commands ECHO OFF and CLS were added 
  2020.         to the beginning of the routine. This is because this method uses 
  2021.         a secondary command processor to run AUTOTEMP.BAT and ECHO would 
  2022.         be ON. In other words, without those two lines you would see the 
  2023.         individual commands displayed on the screen while they are being 
  2024.         executed.
  2025.  
  2026.         When the routine is finished, the last menu displayed will be the 
  2027.         menu that reappears. Note that it returns without the use of 
  2028.         !AUTO, which is not needed and would cause problems.  
  2029.  
  2030.  
  2031.         6-2.2. Direct Commands
  2032.  
  2033.         Batch commands are most useful for lengthy routines in which a 
  2034.         number of actions must be executed. Many times, a single command 
  2035.         is all that is necessary. In this case, the command can be 
  2036.         interpreted by the operating system as a command entered directly 
  2037.         from the system prompt--C>. It is a "direct" command.
  2038.  
  2039.         AUTOMENU uses two types of direct commands--with pause, and 
  2040.         without pause.
  2041.  
  2042.  
  2043.         6-2.2.1 Direct Command without Pause
  2044.  
  2045.         The dash {-} symbol creates a direct command. The command can be 
  2046.         up to 127 characters in length, but there can be only one command 
  2047.         per menu selection.
  2048.  
  2049.         This symbol does not create a batch file. When the command is 
  2050.         completed, the menu from which it was initiated is redisplayed.
  2051.  
  2052.                                     >WARNING<
  2053.                 Resident and non-resident commands CANNOT be used 
  2054.                       together on the same menu selection.
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  2075.         Automenu version 4.0                     Other Capabilities
  2076.  
  2077.  
  2078.         This command is useful for functions such as formatting a 
  2079.         diskette or viewing a directory. Here is how you might do 
  2080.         that:
  2081.  
  2082.              %TEST MENU
  2083.              *Format Drive A:
  2084.              -Format A:
  2085.              #END
  2086.  
  2087.         or:
  2088.                             
  2089.              %TEST MENU        
  2090.              *Directory
  2091.              -DIR A:
  2092.              #END 
  2093.  
  2094.         Note that you cannot use this function on any menu selection in 
  2095.         which you have used {+} or {!} symbols.
  2096.  
  2097.  
  2098.         6-2.2.2. Direct Command with Pause
  2099.  
  2100.         The equal {=} symbol operates in the same manner as the {-}, with 
  2101.         one exception. When the command has been completed, the user must 
  2102.         press the spacebar (or any mouse button) to redisplay the menu. 
  2103.         This is useful when it is vital that the user observe the results
  2104.         of the command.
  2105.  
  2106.         For instance, in the directory example in paragraph 6-2.2.1, the 
  2107.         directory disappears. The {=} symbol can prevent that.
  2108.  
  2109.         Here is one way in which this symbol might be used:
  2110.  
  2111.              %TEST MENU
  2112.              *Directory
  2113.              =DIR A:                                       
  2114.              #END
  2115.                                       
  2116.         As you see, the command entered at the {=} symbol is the "DIR" 
  2117.         command you normally use from the DOS prompt to view a directory 
  2118.         (C>DIR:). Direct commands execute more quickly than others. They 
  2119.         do however use more memory, and only ONE command per selection is 
  2120.         permitted.
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  2136.         Automenu version 4.0                     Other Capabilities
  2137.  
  2138.  
  2139.         Here is a summary of all DOS symbol commands.
  2140.  
  2141.  
  2142.                          Table 6.1. DOS Symbol Commands
  2143.         --------+-----------------+-------------------------------------
  2144.          Symbol |    Function     |      Description and Use
  2145.         --------+-----------------+-------------------------------------
  2146.  
  2147.            +        Batch Command     Use for lengthy routines;
  2148.                     non-resident      when necessary to exit to DOS;
  2149.                                       when user must take exterior 
  2150.                                       action.
  2151.  
  2152.            !        Batch command     Use when it is not necessary to
  2153.                     resident          return to DOS;
  2154.                                       for lengthy routines.
  2155.  
  2156.                                     >WARNING<
  2157.              Only one of these symbols can be used in a single menu      
  2158.              selection. You cannot use two different symbols in within 
  2159.              one menu selection.
  2160.              
  2161.  
  2162.            -        Direct            Use when fast execution is needed.
  2163.  
  2164.            =        Direct            Use for fast execution, when it is
  2165.                     with pause        appropriate to have operator press
  2166.                                       the space bar to redisplay the
  2167.                                       menu.
  2168.         ----------------------------------------------------------------
  2169.  
  2170.         If you would like to learn more about how these symbol commands 
  2171.         work, their technical aspects are analyzed in Section 8.
  2172.  
  2173.  
  2174.         6-3. Special Functions
  2175.  
  2176.         The largest group of symbols are reserved to execute the 
  2177.         functions that make AUTOMENU unique. These functions give you 
  2178.         sophisticated capabilities that provide that total control you 
  2179.         desire. There are seven Special Function symbols:
  2180.  
  2181.                        #--end of MDF
  2182.  
  2183.                        .--comment
  2184.  
  2185.                        ^--password
  2186.  
  2187.                        @--alternate MDF
  2188.  
  2189.                        >--output message
  2190.  
  2191.                        <--input                         
  2192.  
  2193.                        [--time execution
  2194.  
  2195.  
  2196.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  2197.         Automenu version 4.0                     Other Capabilities
  2198.  
  2199.  
  2200.  
  2201.         You have already used the first two--{#} and {.}--in Section 3. 
  2202.  
  2203.         If you recall, the {#} End of MDF symbol MUST be used to end 
  2204.         every MDF.
  2205.  
  2206.  
  2207.         6-3.1. Password
  2208.  
  2209.         A password enables you to prevent unauthorized individuals from 
  2210.         accessing individual selections on the menu. You can even specify 
  2211.         multiple passwords for each menu selection. This enables you to 
  2212.         set up different levels of security for different individuals. 
  2213.         While you would be able to access all menus, your accounting 
  2214.         clerk could be limited only to those with accounting functions, 
  2215.         and only to those selections on the menu. Your word processing 
  2216.         operator can be limited to those functions only, so they cannot 
  2217.         inadvertently juggle your books.
  2218.  
  2219.  
  2220.         The password symbol is {^}.
  2221.  
  2222.         A password can contain up to 30 characters. And there is no 
  2223.         limit to the number of passwords that can be defined for each 
  2224.         menu selection.
  2225.  
  2226.         Here is how a password might be added to a previous example, 
  2227.         please note that both passwords "OK" and "BOSS" would execute 
  2228.         this menu selection:
  2229.  
  2230.              %TEST MENU        
  2231.              *Format Drive A:
  2232.              ^OK
  2233.              ^BOSS
  2234.              -Format A:
  2235.              #END 
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  2258.         Automenu version 4.0                     Other Capabilities
  2259.  
  2260.  
  2261.         6-3.2. Alternate MDF
  2262.  
  2263.         One of the strengths of AUTOMENU is its ability to connect menus 
  2264.         and MDF's to create a menu controlled system for separate pieces 
  2265.         of software. The Alternate MDF function gives you the ability to 
  2266.         access any MDF from any other MDF. Thereby providing unlimited 
  2267.         numbers of menus and menu selections
  2268.  
  2269.         The Alternate MDF symbol is {@}.
  2270.  
  2271.         To use this in an MDF, enter the {@} in column 2, and the 
  2272.         filename of the menu you wish to call in column 3. AUTOMENU    
  2273.         supports full pathnames for alternate MDF's.
  2274.  
  2275.                                     >WARNING<
  2276.              This function cannot be used together with the {+}, {!}
  2277.              {-} or {=} symbols.
  2278.  
  2279.         The following Example shows how the main menu, AUTOMENU.MDF, might 
  2280.         lead to Alternate menus:
  2281.  
  2282.              %Main System Menu
  2283.              *Communications Menu
  2284.              ?Display Communications Menu
  2285.              @COMM.MDF
  2286.              *Accounting Menu
  2287.              ?Display Accounting Menu
  2288.              @ACCOUNT.MDF
  2289.              *Utility Menu
  2290.              ?DOS Utility Menu, ask supervisor for password
  2291.              ^BOSS
  2292.              @UTILITY.MDF
  2293.              #End of AUTOMENU.MDF
  2294.  
  2295.  
  2296.         The utility menu example above also shows a good way to protect all 
  2297.         the menu selections in an alternate menu. In other words, the 
  2298.         user must know the password to get to the utility menu to execute 
  2299.         any of the utility menu selections.
  2300.  
  2301.         The example below shows what one of the alternate menus might 
  2302.         look like. Note that the second menu selection is setup to return 
  2303.         the user to the main menu:
  2304.  
  2305.              %Communications Menu
  2306.              *ProComm
  2307.              +CD \PROCOMM
  2308.              +PROCOMM
  2309.              +CD \AUTOMENU
  2310.              +AUTO COMM.MDF
  2311.              *Return to Main Menu
  2312.              @AUTOMENU.MDF
  2313.              #End of COMM.MDF 
  2314.  
  2315.  
  2316.  
  2317.  
  2318.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  2319.         Automenu version 4.0                     Other Capabilities
  2320.  
  2321.  
  2322.         6-3.3. Output Message
  2323.  
  2324.         It is often necessary to give a user information or data about 
  2325.         some action he must take, or observation he should make, after a 
  2326.         menu selection. This function does that.
  2327.  
  2328.         ----------------------------------------------------------------
  2329.         %Example Menu
  2330.         *Directory 
  2331.         >The directory displayed below is of the diskette in Drive A:
  2332.         >The only files listed are Work Sheet files, or those files
  2333.         >whose filename extension is WKS.
  2334.         =DIR A:*.WKS/W
  2335.         #End of Example
  2336.         ---------------------------------------------------------------- 
  2337.  
  2338.         Each output message is limited to 80 characters, but you can 
  2339.         enter as many message lines as you wish. However, if the message 
  2340.         is more than 23 lines, the additional lines will scroll off the 
  2341.         screen. All output messages will be displayed before any DOS 
  2342.         commands defined are executed. 
  2343.  
  2344.  
  2345.         6-3.4. Input
  2346.  
  2347.         Some programs require additional information to be passed to 
  2348.         them. For example, many programs will require that a filename be
  2349.         entered at the time of execution. The Input function, used with 
  2350.         the Output Message function, makes it possible to prompt the 
  2351.         user for this information.
  2352.  
  2353.         The Input symbol is {<}.
  2354.  
  2355.         Let's suppose you want to go directly to a file to edit when you 
  2356.         select the word processing option. Here is how you would set up 
  2357.         your MDF to accomplish that.
  2358.  
  2359.         ----------------------------------------------------------------
  2360.         %Example Menu
  2361.         *Word Processing
  2362.         ?Run Wordstar               
  2363.         >This option requires the filename you wish to edit.
  2364.         >Enter the filename on the DOTTED line below and press ENTER.
  2365.         <                                                   
  2366.         +CD \WS
  2367.         +WS %1
  2368.         +CD \AUTOMENU
  2369.         +AUTO
  2370.         #End of Example
  2371.         ----------------------------------------------------------------
  2372.  
  2373.         When the output messages appear on the screen, a row of dots will  
  2374.         appear below it. The user then simply types in the filename, and 
  2375.         AUTOMENU will take him directly to that file. The information 
  2376.         entered will be used to replace the %1 before the DOS commands 
  2377.  
  2378.  
  2379.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  2380.         Automenu version 4.0                     Other Capabilities
  2381.  
  2382.  
  2383.         are executed. 
  2384.  
  2385.         This is called "Dynamic Input." It is also possible to give the 
  2386.         user the choices he has available from which to select. This 
  2387.         function is known as "Static Input."
  2388.  
  2389.         AUTOMENU accepts any entry following the {<} command as input to 
  2390.         be passed to DOS. You can give the user as many choices as will 
  2391.         fit on one line. Each must be separated by a comma. The user then 
  2392.         need only move the cursor to the desired choice and press ENTER.
  2393.  
  2394.         Using either Dynamic and Static Input, you can define up to nine 
  2395.         prompts per menu selection, mixing Dynamic and Static request.
  2396.  
  2397.         The results of each input request will be used to replace 
  2398.         variables defined within a particular menu selection. Each 
  2399.         variable is given a number, 1-9, preceded by a percent {%} sign. 
  2400.         For example, %1, %2, etc.
  2401.  
  2402.         Here is how you might use both these capabilities in an MDF.
  2403.  
  2404.  
  2405.         ----------------------------------------------------------------
  2406.         *Copy a file to TEMP directory on Drive C.
  2407.         >Please select the diskette drive from which you wish to copy.
  2408.         >Use the arrow keys to highlight the desired drive letter,
  2409.         >then press ENTER.
  2410.         <A:,B:
  2411.         >    
  2412.         >Now enter the name of the file you wish to copy.
  2413.         >The filename can be up to eight characters, followed by a 
  2414.         >three character extension. Example: TEST.DAT.
  2415.         >Press ENTER when you have entered the filename.   
  2416.         >Or you may quit now by pressing the ESC key.
  2417.         <
  2418.         >
  2419.         >The file will be copied from Drive %1
  2420.         >The filename is %2
  2421.         -Copy %1%2 C:\TEMP
  2422.         ----------------------------------------------------------------
  2423.  
  2424.         Another feature of the input function that gives added 
  2425.         flexibility is the use of the <ESC> key. The user can return to 
  2426.         the menu at any time during an input request by pressing <ESC>.
  2427.  
  2428.  
  2429.         6-3.5. Timed Execution
  2430.  
  2431.         There may be times when you want a menu selection to be selected 
  2432.         at some future time. This function does that.
  2433.  
  2434.         The symbol for timed execution is {[}.
  2435.  
  2436.         As many as 128 different times can be specified in an MDF. And 
  2437.         since a menu selection using the {@} symbol could load a second 
  2438.  
  2439.  
  2440.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  2441.         Automenu version 4.0                     Other Capabilities
  2442.  
  2443.  
  2444.         MDF with 128 more times, the number of times is all but 
  2445.         limitless.
  2446.  
  2447.         The times must be entered in international 24-hour format. For 
  2448.         example, 10:30 AM must be entered as 10:30; 10:30 PM must be 
  2449.         entered as 22:30.
  2450.  
  2451.         The MDF from which the execution will take place must be 
  2452.         displayed at the specified time for the function to operate.
  2453.  
  2454.         This function also WILL NOT EXECUTE automatically if the user is 
  2455.         inside an application. If you are working in your word processing 
  2456.         application a 10:00 AM, the backup menu selection would NOT be 
  2457.         executed.
  2458.  
  2459.         This capability is especially useful for automatic backups or 
  2460.         reading equipment connected to the computer like in this example:
  2461.  
  2462.              %Example Menu
  2463.              *Backup                             
  2464.              [10:00
  2465.              [16:00
  2466.              -Backup C:
  2467.              *Check Rain Guage automatically
  2468.              . This example reads a rain gauge connected to COM1:
  2469.              . every two hours and then appends the results to a file
  2470.              [01:00
  2471.              [03:00
  2472.              [05:00
  2473.              [07:00
  2474.              [09:00
  2475.              [11:00
  2476.              [13:00
  2477.              [15:00
  2478.              [17:00
  2479.              [19:00
  2480.              [21:00
  2481.              [23:00
  2482.              +CD \WEATHER 
  2483.              +RAINREAD
  2484.              +COPY RESULTS.OLD+RESULTS RESULTS.OLD
  2485.              +CD \AUTOMENU
  2486.              +AUTO
  2487.              #End of Example
  2488.  
  2489.  
  2490.         6-4. MDF Command Symbol Summary
  2491.  
  2492.         All command symbols are summarized in Table 6.2, below.
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  2502.         Automenu version 4.0                     Other Capabilities
  2503.  
  2504.  
  2505.                        Table 6.2. MDF Command Symbols
  2506.         --------+-----------------+-------------------------------------
  2507.          Symbol |    Function     |      Description and Use
  2508.         --------+-----------------+-------------------------------------
  2509.            %     Menu Title         Display title of menu
  2510.  
  2511.            *     Menu selection     The selections available to user
  2512.  
  2513.            ?     Menu HELP          Explain a menu selection in further
  2514.                  message            detail
  2515.  
  2516.            ^     Password           Limit access to selections
  2517.  
  2518.            @     Alternate          Link menus and MDF's to create menu
  2519.                  MDF                driven systems
  2520.  
  2521.            -     Direct             Executed as if command were entered
  2522.                  DOS Cmd            at DOS prompt (A>);
  2523.                                     one command per selection limit;
  2524.                                     127 character line limit;
  2525.                                     AUTOMENU remains dormant in memory.
  2526.  
  2527.            =     Direct             Same as previous command, but user
  2528.                  Cmd/pause          must press spacebar to return to
  2529.                                     menu.
  2530.  
  2531.            !     Resident           Creates batch file for series of
  2532.                  Batch Cmd          commands;
  2533.                                     AUTOMENU remains resident;
  2534.                                     127 character line limit;
  2535.                                     number of lines unlimited per 
  2536.                                     selection.
  2537.  
  2538.            +     Non-Resident       Creates batch file for series of
  2539.                  batch Cmd.         commands;
  2540.                                     returns user to operating system;
  2541.                                     127 character line limit;
  2542.                                     number of lines per selection
  2543.                                     unlimited.
  2544.  
  2545.            .     Comment            Places comment in MDF that is not
  2546.                                     displayed on menu.
  2547.  
  2548.            >     Output             Displays a message on menu.
  2549.  
  2550.            <     Input              Permits user to enter variable
  2551.                                     parameters or data defining files,
  2552.                                     etc., to be called up when menu
  2553.                                     selection is made.
  2554.  
  2555.            [     Time               Allows user to specify a future time
  2556.                  execution          for execution of menu selection.
  2557.  
  2558.            #     End of             Must be entered as final command on
  2559.                  MDF                every MDF.
  2560.  
  2561.  
  2562.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  2563.         Automenu version 4.0                            Customizing
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.                                     SECTION 7
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.                               CUSTOMIZING YOUR MENU
  2579.  
  2580.  
  2581.  
  2582.         As individual and unique as your menus can be made with the 
  2583.         functions discussed up to now, there may still be additional 
  2584.         features you want to include. You may even want to switch off 
  2585.         certain features such as the selection bar or arrow. Only one may 
  2586.         be needed. You almost certainly will want to customize the menu 
  2587.         screen colors. AUTOMENU provides a customization utility that 
  2588.         allows you to do this.
  2589.  
  2590.  
  2591.         7-1. Accessing the Customization Utility
  2592.  
  2593.         The customizing program is in the file AUTOCUST.COM. You can call 
  2594.         this up directly from the DOS prompt, C>.
  2595.  
  2596.         It can be more useful, however, if you make AUTOCUST.COM a 
  2597.         selection on one of your menus, perhaps the main menu. This will 
  2598.         enable you to change features of your menu as often as you 
  2599.         desire, without exiting to DOS.
  2600.  
  2601.         You can access the customizing function from DOS by typing 
  2602.         "AUTOCUST" at the prompt: C>AUTOCUST.
  2603.  
  2604.         If you have changed the name of the AUTOMENU.COM, however, you 
  2605.         must specify the new file name. To do this, enter:
  2606.  
  2607.                             C>AUTOCUST "NEW FILENAME"
  2608.  
  2609.         Be sure to include drive and pathname if necessary.
  2610.  
  2611.         AUTOCUST is a menu driven program, containing three menus. When 
  2612.         you call AUTOCUST you will first see the main menu.
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  2624.         Automenu version 4.0                            Customizing
  2625.  
  2626.  
  2627.         ----------------------------------------------------------------
  2628.  
  2629.                  Automenu Customization Utility for version 4.00
  2630.  
  2631.  
  2632.  
  2633.              1 - Color Customization
  2634.  
  2635.              2 - Custom Switches
  2636.  
  2637.              3 - Change default filename for Menu Definition File
  2638.  
  2639.              4 - Change default filename for Temporary Batch File
  2640.  
  2641.              5 - Reset all values to original defaults and save them
  2642.  
  2643.              6 - Return to DOS
  2644.  
  2645.  
  2646.           Enter number of Selection ->
  2647.  
  2648.         -----------------------------------------------------------------
  2649.  
  2650.         These functions will be discussed in the order in which they 
  2651.         appear on the menu. The changes made to the individual 
  2652.         characteristics of the menu are stored as part of AUTOMENU.COM 
  2653.         and NOT in a seperate configuration file.
  2654.  
  2655.  
  2656.         7-2. Color Customization
  2657.  
  2658.         Select this function by typing "1" at the menu prompt. The 
  2659.         AUTOMENU Color Customization Section menu will be displayed.
  2660.  
  2661.         This menu lists all sections of the menu for which the color can 
  2662.         be customized. Select the area you wish to change color on by 
  2663.         moving the double bracket pointers ( --> item  <-- ) with the up 
  2664.         and down arrow keys.
  2665.  
  2666.         The keys that make the color changes are indicated at the lower 
  2667.         third of this menu. If you want to black out a section of your 
  2668.         menu, simply set the foreground color to match the background 
  2669.         color, for example black on black.
  2670.  
  2671.         When you have made all your desired color changes, press "W" to 
  2672.         make the changes permanent until you change the defaults again. 
  2673.  
  2674.  
  2675.         7-3. Custom Switches
  2676.  
  2677.         This menu operates in the same manner as the color menu. The 
  2678.         switches are described in Table 7.1.   
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  2685.         Automenu version 4.0                            Customizing
  2686.  
  2687.  
  2688.                            Table 7.1. Custom Switches
  2689.         -------------+----------------------+---------------------------
  2690.            Switch    |       Options        |  Description & Use
  2691.         -------------+----------------------+---------------------------
  2692.         Country        USA--mm/dd/yy            Sets form in which date
  2693.         format for     Europe--dd/mm/yy         is displayed.
  2694.         date           Japan--yy/mm/dd
  2695.  
  2696.         Time           12 or 24 hour            12 hour shows AM, PM
  2697.  
  2698.         Date/Time      enabled/disabled         Determines if date/time is
  2699.         display                                 displayed
  2700.  
  2701.         Key display    enabled/disabled         displays or blanks CAPS, 
  2702.                                                 NUM LOCK, etc. display
  2703.  
  2704.         Blackout       OFF, or 1-45 min.        Default delay is 3 min.
  2705.         delay
  2706.  
  2707.         Blackout       enabled/disabled         Displays blackout message
  2708.         message                                 when enabled.
  2709.  
  2710.         Cursor type    IBM/Tandy                Prevents the cursor from
  2711.                                                 being seen on the menu
  2712.  
  2713.         Screen mode    color/b&w                Used if computer requires
  2714.                                                 specific mode
  2715.  
  2716.         Display        color/b&w                Used for amber screens            
  2717.  
  2718.         Selection                      _                        
  2719.         --bar          enabled/disabled  |                  
  2720.         --pointer      enabled/disabled  -------Generally, only one of these
  2721.         --numbers      displayed/not     |      is utilized
  2722.                        displayed        _|      
  2723.  
  2724.         Control        enabled/disabled         When disabled, user cannot
  2725.         Break                                   use CTRL-BREAK to exit to 
  2726.                                                 DOS
  2727.  
  2728.         Screen swap    enabled/disabled         Enabled, allows switching
  2729.                                                 between monitors
  2730.  
  2731.         Automatic      enabled/disabled         Enabled, prevents user from
  2732.         clearing                                making entries before a menu
  2733.         of keyboard                             is displayed, or before a
  2734.         buffer                                  command is completed.
  2735.  
  2736.         Mouse          enabled/disabled         Disable mouse
  2737.         support
  2738.  
  2739.         Mouse          5  to 60                 Set in increments of  5;
  2740.         sensitivity                             default is 20; Lower 
  2741.                                                 numbers = more sensitive
  2742.  
  2743.  
  2744.  
  2745.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  2746.         Automenu version 4.0                            Customizing
  2747.  
  2748.  
  2749.  
  2750.  
  2751.         7-4. Change Default Filename for MDF
  2752.  
  2753.         If you want to change the default MDF to your own MDF (from 
  2754.         automenu.mdf), you must tell AUTOMENU that is the file you want 
  2755.         to call whenever AUTOMENU is booted. This switch permits you to 
  2756.         specify your own MDF as the default MDF. The name you specify 
  2757.         here remains in effect until you change it. However, we recommend 
  2758.         that you use AUTOMENU.MDF as your main menu.
  2759.  
  2760.  
  2761.         7-5. Change Default Filename for Temporary Batch File
  2762.  
  2763.         Changing the batch filename (default is AUTOTEMP.BAT) enables you 
  2764.         to write the temporary file to a virtual disk, specific drive, or 
  2765.         specific subdirectory. The filename you enter here remains in 
  2766.         effect until it is changed. This capability gives you needed 
  2767.         flexibility in working with networks and write protected drives.
  2768.  
  2769.  
  2770.         7-6. Reset All Values and Save
  2771.  
  2772.         This function permits to return all switches, colors and 
  2773.         filenames to the original program value. You can do this anytime 
  2774.         the program is running.
  2775.  
  2776.  
  2777.  
  2778.         7-7. Creating Your Own Menus
  2779.  
  2780.         You now have all the information you need to build any kind of 
  2781.         menu or menu system, and make it as individual as yourself.
  2782.  
  2783.         After you have installed Automenu on your system, it will be time 
  2784.         to add items to the menu system. Using AUTOMAKE, you should 
  2785.         modify AUTOMENU.MDF and enter in menu selection for your own 
  2786.         programs and delete all the examples in this MDF that you do not 
  2787.         need. We recommend that you basically use only the {%},{*},{+}, 
  2788.         and {#} at get started at first. Once you have the system up and 
  2789.         running, you can go back and improve it. 
  2790.  
  2791.         If you have any problems or questions at this point, please take 
  2792.         the time to contact our technical support department and see if 
  2793.         we can get you back on track. 
  2794.  
  2795.         For those who would like a deeper understanding of AUTOMENU, the 
  2796.         next section provides a more technical discussion of the more 
  2797.         complex functions. There are also some examples to look at in 
  2798.         addition to the MDF's that are on the disk.
  2799.  
  2800.         It is not necessary to go into the technical aspects, however, to 
  2801.         fully utilize every one of AUTOMENU's capabilities. You can do 
  2802.         that right now.
  2803.  
  2804.  
  2805.  
  2806.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  2807.         Automenu version 4.0                 Technical Considerations
  2808.  
  2809.  
  2810.  
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.                                     SECTION 8
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.                             TECHNICAL CONSIDERATIONS
  2824.  
  2825.  
  2826.  
  2827.  
  2828.         Users familiar with DOS and who have some programming experience 
  2829.         can use AUTOMENU's capabilities to an even greater extent. This 
  2830.         section discusses the more technical aspects of the program, so 
  2831.         those who desire can enjoy even more flexibility.
  2832.  
  2833.  
  2834.         8-1. AUTOMENU Configuration
  2835.  
  2836.         AUTOMENU provides a direct interface with the DOS operating 
  2837.         system. Menus are created with Magee Enterprises' proprietary and 
  2838.         copyrighted Menu Definition Language (MDL). MDL creates a Menu 
  2839.         Definition File (MDF) in which the menus are stored.
  2840.  
  2841.         The AUTOMENU program reads the Menu Definition File (MDF) and 
  2842.         effectively routes commands entered there to the operating system 
  2843.         for execution.
  2844.  
  2845.  
  2846.         8-1.1. Program Interfaces
  2847.  
  2848.         A batch file, AUTO.BAT, is the program root. When you follow the 
  2849.         installation procedure in Section 3 AUTO.BAT is placed into the 
  2850.         DOS AUTOEXEC.BAT file.
  2851.  
  2852.         AUTO.BAT basically contains two commands: AUTOMENU, which 
  2853.         executes the main program, and AUTOTEMP.BAT, which holds commands 
  2854.         written to it by AUTOMENU.
  2855.  
  2856.  
  2857.         8-1.2. Other Files
  2858.  
  2859.         All files contained on the program diskette, and their function, 
  2860.         are listed below. There may be additional files with AUTOMENU, 
  2861.         but these are the main ones.  
  2862.  
  2863.  
  2864.                   AUTO.BAT            Batch file that calls AUTOMENU
  2865.  
  2866.  
  2867.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  2868.         Automenu version 4.0                 Technical Considerations
  2869.  
  2870.  
  2871.  
  2872.                   AUTOCUST.COM        Menu customization utility
  2873.  
  2874.                   AUTOMAKE.EXE        Menu-building facility
  2875.  
  2876.                   AUTOMENU.COM        Main Menu Program 
  2877.  
  2878.                   AUTOMENU.MDF        Main Menu Definition File
  2879.  
  2880.                   DOS.MDF             Examples of DOS commands used
  2881.  
  2882.                   INSTALL.BAT         Fixed disk installation routine
  2883.  
  2884.                   INSTALL.MDF         Installation menu
  2885.  
  2886.                   PRINTER.MDF         Printer control menu
  2887.  
  2888.                   AUTOMENU.DOC        This document
  2889.  
  2890.                   PRINTDOC.BAT        Utility to print this document
  2891.  
  2892.                   READ.ME             Special information 
  2893.  
  2894.  
  2895.         8-2. Program Operation
  2896.  
  2897.         AUTOMENU executes a menu selection either directly, or through 
  2898.         the batch file, AUTOTEMP.BAT. The method of execution is set 
  2899.         by symbol commands entered in the MDF (see Section 5).
  2900.  
  2901.         In the direct mode, AUTOMENU routes the MDF DOS command directly 
  2902.         to DOS. This method is fast, and since the program remains 
  2903.         dormant in memory, the MDF does not have to be reread. The direct 
  2904.         mode does, however, use more memory than the batch mode.
  2905.  
  2906.         In the batch mode, AUTOMENU creates the batch file, AUTOTEMP.BAT. 
  2907.         If the resident batch command {!} is present, the program 
  2908.         executes AUTOTEMP.BAT while remaining in memory.
  2909.  
  2910.         If the non-resident batch command {+} is present, AUTOMENU is 
  2911.         exited, and the batch routine is executed by a continuation of 
  2912.         AUTO.BAT. This requires that the final command in the batch 
  2913.         routine be "AUTO" so that AUTOMENU is recalled.
  2914.  
  2915.         This program hierarchy is illustrated below.
  2916.  
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.  
  2925.  
  2926.  
  2927.  
  2928.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  2929.         Automenu version 4.0                 Technical Considerations
  2930.  
  2931.  
  2932.  
  2933.          DOS Command Processor------>---- C>AUTO ----<-------------<----+
  2934.                                             |                           |
  2935.                                             |                           |
  2936.                                          AUTO.BAT                       |
  2937.                                             |                           |
  2938.                                             |                           |
  2939.         +------------>-----------------AUTOMENU.COM                     ^
  2940.         |                                   |                           |
  2941.         |                                   |                           |
  2942.         | {-}Command-----------+-----<------|------>-----{+}Command     | 
  2943.         |      |               |            |                   |       |
  2944.         ^      |               |            |                   |       |
  2945.         |      |         {=}Command   {!}Command              Create    |
  2946.         |      |               |            |              AUTOTEMP.BAT |
  2947.         |      |               |            |                   |       |
  2948.         |  Secondary DOS----<--|          Create                |       ^
  2949.         | Command Processor            AUTOTEMP.BAT             |       |
  2950.         |      |                            |                   |       |
  2951.         ^      |                  Secondary DOS Command         |       |
  2952.         |<Execute Command               Processor              Exit     |
  2953.         |                                   |              AUTOMENU.COM |
  2954.         ^                                   |                   |       |
  2955.         |                                  Run                  |       ^
  2956.         +------------<-----------------AUTOTEMP.BAT            Run      |
  2957.                                                           AUTOTEMP.BAT->+
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.  
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.  
  2976.  
  2977.  
  2978.  
  2979.  
  2980.  
  2981.  
  2982.  
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.  
  2989.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  2990.         Automenu version 4.0                 Technical Considerations
  2991.  
  2992.  
  2993.         8-3. Running Basic Programs                                 
  2994.  
  2995.         If you have programs written in BASIC language on your fixed 
  2996.         disk, you can access them using the {+} symbol in the MDF. When 
  2997.         you do so, you must always call up BASIC. Here is how you might 
  2998.         set up a BASIC program selection:
  2999.  
  3000.              %Example Menu
  3001.              *Space Wars
  3002.              +CD \GAMES
  3003.              +BASICA SPACEWARS 
  3004.              +CD \AUTOMENU
  3005.              +AUTO
  3006.              #End of Example
  3007.  
  3008.         When the program has finished running, the BASIC prompt, "OK," 
  3009.         will be displayed. Type "SYSTEM" at this prompt, and you will 
  3010.         return to AUTOMENU. If you create your own BASIC programs put the 
  3011.         command "SYSTEM" as the next to last command before "END" 
  3012.         statement.
  3013.  
  3014.  
  3015.         8-4. Using AUTOMENU On Networks
  3016.  
  3017.         AUTOMENU is fully compatible with networks. The main problem with 
  3018.         Automenu and Networks is the creation of AUTOTEMP.BAT. If more 
  3019.         than one user runs the same copy of AUTOMENU from a file server, 
  3020.         then more than one person will be writing the same file and a 
  3021.         conflict will occur. That is why AUTOMENU provides a 
  3022.         customization utility that allows the user to change the filename 
  3023.         of the Temporary Batch File to include both a drive and path 
  3024.         name.
  3025.          
  3026.         After you have a copy Automenu installed on your file server, you 
  3027.         have basically three methods of configuring AUTOMENU for use with 
  3028.         a network. 
  3029.  
  3030.         The preferred method would be to write AUTOTEMP.BAT to a RAM disk 
  3031.         at the individual work station.
  3032.  
  3033.         If that is not practical, AUTOTEMP.BAT can be written to a local 
  3034.         disk drive.
  3035.  
  3036.         A third method would be to have each user work with separate 
  3037.         copies of AUTOMENU. These would be named: AUTOMEN1.COM for the 
  3038.         first work station; AUTOMEN2.COM for the second station, and so 
  3039.         on. Then each copy could be modified to access a unique 
  3040.         AUTOMENU.MDF and write a unique AUTOTEMP.BAT
  3041.  
  3042.         The variety for networks out there make it hard to have one way 
  3043.         of configuring your system. We have helped users setup Automenu 
  3044.         to work on networks with as many as 400 nodes. Therefore, we 
  3045.         advise that you contact our technical support department for more 
  3046.         information on networking with AUTOMENU. Also contact our sales 
  3047.         department on our unique pricing for Networks.
  3048.  
  3049.  
  3050.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  3051.         Automenu version 4.0                 Technical Considerations
  3052.  
  3053.  
  3054.  
  3055.         8-5.  Mouse Support
  3056.  
  3057.         AUTOMENU supports the use of a mouse to allow the user to move 
  3058.         the pointer and to select an option.  Moving the mouse up and 
  3059.         down simulates the use of the up and down arrow keys which moves 
  3060.         the option pointer up and down on the menu.  Moving the mouse 
  3061.         from side to side will simulate the use of the left and right 
  3062.         arrow keys which will then display other menus if they were 
  3063.         defined.  Pressing any of the mouse buttons will simulate the 
  3064.         pressing of the return key which selects the option being pointed 
  3065.         to.
  3066.  
  3067.         The mouse interface which AUTOMENU uses to control the mouse is 
  3068.         provided by the mouse manufacturer through a device driver or DOS 
  3069.         resident program.  AUTOMENU looks for this support through 
  3070.         interrupt 33H. If this interface is installed, AUTOMENU will 
  3071.         detect its presences and communicate with the interface.
  3072.  
  3073.         8-6.  Uses and Performance for Floppy Diskette Systems
  3074.  
  3075.         For a floppy based system, placing the AUTOMENU files on  a newly 
  3076.         formatted diskette will enhance AUTOMENU's performance. The use 
  3077.         of a RAM drive and the copying of the COMMAND.COM file into this 
  3078.         RAM Drive will also help.  The Customization section can also 
  3079.         help to change the location of where the temporary batch file is 
  3080.         to be written for example on the RAM drive D:\ .
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.  
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  3112.         Automenu version 4.0                 Technical Considerations
  3113.  
  3114.  
  3115.         8-7. Contents of an example AUTOMENU.MDF
  3116.  
  3117.                ...................................................
  3118.                .          AUTOMENU Menu Definition File
  3119.                .
  3120.                .               By Marshall W. Magee
  3121.                ...................................................
  3122.                %User-Defined Menu Title
  3123.                *Word Processor
  3124.                ?Run the PERSONAL EDITOR program (Password = IBM)
  3125.                ^IBM
  3126.                -pe
  3127.                *Install AUTOMENU
  3128.                ?This will allow you to customize AUTOMENU
  3129.                +AUTOCUST
  3130.                +AUTO
  3131.                *Basic
  3132.                ?Run BASIC directly
  3133.                -basica
  3134.                *Check fixed disk
  3135.                =CHKDSK/F
  3136.                *Print Directory to screen
  3137.                =DIR
  3138.                *DOS COMMAND MENU
  3139.                ?Load AUTOMENU Simply DOS Menu
  3140.                @DOS.MDF
  3141.                *Copy AUTOMENU Documentation to line printer
  3142.                ?Prints Document to PRN:
  3143.                -COPY AUTOMENU.DOC PRN:
  3144.                *Disk Operating System
  3145.                ?Return to Disk Operating System
  3146.                +ECHO OFF
  3147.                +ECHO +---------------------+
  3148.                +ECHO |   Returning to DOS  |
  3149.                +ECHO +---------------------+
  3150.                +ECHO |   Enter  > AUTO <   |
  3151.                +ECHO |to return to the Menu|
  3152.                +ECHO +---------------------+
  3153.                +ECHO ON
  3154.                .
  3155.                .------------------------------
  3156.                .    Define another menu page 
  3157.                .------------------------------
  3158.                %*******  Second Menu  *******
  3159.                *Format a diskette in Drive A:
  3160.                !CD \DOS
  3161.                !Format A:
  3162.                !CD \AUTOMENU
  3163.                *Play a game of Chess
  3164.                .This menu selection is for example only
  3165.                .No chess game is included with Automenu.      
  3166.                !CD \GAMES
  3167.                !JUMPJOE
  3168.                !CD \AUTOMENU
  3169.                # END OF AUTOMENU.MDF
  3170.  
  3171.  
  3172.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  3173.         Automenu version 4.0                 Technical Considerations
  3174.  
  3175.  
  3176.         8-8. Examples of Batch Files
  3177.         ----------------------------
  3178.         8-8.1. Floppy Diskette Version
  3179.         ------------------------------
  3180.  
  3181.                 Contents of AUTOEXEC.BAT             
  3182.             +--------------------------------+
  3183.             |AUTO                            |
  3184.             +--------------------------------+
  3185.  
  3186.         8-8.2. Fixed Disk Version
  3187.  
  3188.  
  3189.          Example contents of AUTOEXEC.BAT good for fixed disk systems
  3190.         +---------------------------+
  3191.         |ECHO OFF                   |  <- Don't display commands that follow
  3192.         |CLS                        |  <- Clear Screen
  3193.         |VER                        |  <- Display current DOS version.      
  3194.         |DATE                       |  <- Request present date
  3195.         |TIME                       |  <- Request present time
  3196.         |COPY COMMAND.COM D:\       |  <- Copy COMMAND.COM to RAM Drive
  3197.         |SET COMSPEC=D:\COMMAND.COM |  <- Tell DOS new location of COMMAND.COM
  3198.         |PROMPT $P$G                |  <- Prompt to show present subdirectory
  3199.         |PATH C:\PUBLIC             |  <- Path to subdirectory PUBLIC on C:
  3200.         |VERIFY on                  |  <- Disk read after write check
  3201.         |AUTO                       |  <- Execute AUTOMENU batch file
  3202.         |REM autoexec.bat           |  <- Remark statement in batch file.
  3203.         |REM by Marshall W. Magee   |
  3204.         |REM on 07/02/83            |
  3205.         +---------------------------+
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  3234.         Automenu version 4.0                 Technical Considerations
  3235.  
  3236.  
  3237.         8-8.3. Example of AUTO.BAT
  3238.         --------------------------
  3239.  
  3240.              Example of AUTO.BAT
  3241.         +---------------------------+
  3242.         |ECHO OFF                   |  <- Don't Display commands that follow
  3243.         |C:                         |  <- Change to C: drive
  3244.         |CD \AUTOMENU               |  <- Change to where Automenu is 
  3245.         |AUTOMENU %1                |  <- Execute AUTOMENU program
  3246.         |IF ERRORLEVEL 1 GOTO QUIT  |  <- Check for ERROR during AUTOMENU
  3247.         |AUTOTEMP                   |  <- No Error, Execute AUTOTEMP.BAT 
  3248.         |:QUIT                      |  <- Label for error goto statement
  3249.         |ECHO ON                    |  <- Display commands that follow
  3250.         +---------------------------+
  3251.  
  3252.         8-9. Menu Definition File (MDF) Description
  3253.  
  3254.         The MDF is a standard text file that is read by AUTOMENU to 
  3255.         obtain the information needed to display the menu.  The file 
  3256.         consists of lines of information ending with a carriage return 
  3257.         and line feed characters.  The first character of each line is 
  3258.         used to define the function of that line to AUTOMENU.
  3259.  
  3260.         8-10. USER SUPPORT
  3261.  
  3262.         8-10.1. Problems and Technical Support
  3263.  
  3264.         If you have problems with AUTOMENU, please read this manual first 
  3265.         to make sure you do understand everything.  We have tried to 
  3266.         provide a problem-free product but sometimes we make mistakes. If 
  3267.         you think you have found a problem please take the time to 
  3268.         contact us and explain your problem to us.  All registered users 
  3269.         will be informed of any problems and their solution.  Make sure 
  3270.         that you include the following information to help us evaluate 
  3271.         the problem:
  3272.  
  3273.                  1.    Version of DOS used
  3274.                  2.    Machine type, memory, monitors, etc.
  3275.                  3.    Any application executed before AUTOMENU
  3276.                  4.    Your address and telephone number
  3277.                  5.    Where and how you obtained AUTOMENU
  3278.                  6.    Which version of AUTOMENU you are using
  3279.                  7.    Copies of your current MDF's
  3280.  
  3281.         We also provide a private Bulletin Board System for anyone 
  3282.         interested in AUTOMENU. This board currently supports 2400 baud 
  3283.         communications and is available 24 hours a day year round. We 
  3284.         maintain the most current releases there and any other helpful 
  3285.         files concerning AUTOMENU. It can be reached by calling 404-446-
  3286.         6650. We also can be reached through a CompuServe ID: 70167,2200. 
  3287.         And we can be reached through our business phone at 404-446-6611, 
  3288.         providing technical support between the hours of 9am to 5pm EST 
  3289.         Monday thru Friday. We also a have FAX available at 404-446-7434.
  3290.  
  3291.  
  3292.  
  3293.  
  3294.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  3295.         Automenu version 4.0                 Technical Considerations
  3296.  
  3297.  
  3298.         8-10.2.  Updates
  3299.  
  3300.         AUTOMENU changes to respond to the requests of its users. For 
  3301.         registered users, our update policy is that all future releases 
  3302.         of this product will be under a new cost only policy. In other 
  3303.         words, we will only charge you for the cost of getting the 
  3304.         updated version to you. 
  3305.  
  3306.  
  3307.         8-11.  Source Code
  3308.  
  3309.         The source code for AUTOMENU.COM and AUTOCUST.COM is written 
  3310.         entirely in assembly language. The Menu-Building Facility for 
  3311.         version 4.0 is written in compiled Basic; however, it will be 
  3312.         rewritten in the next version in assembly language.
  3313.  
  3314.         For those interested, the source code was composed with IBM's 
  3315.         Personal Editor II and assembled with Microsoft's Macro Assembler 
  3316.         Version 4.00 under DOS 3.1.
  3317.  
  3318.  
  3319.         8-12.  Dealers, Value Added Resellers, and Consultants
  3320.  
  3321.         AUTOMENU is your ticket to setting up a turnkey system for your 
  3322.         customers.  This software was designed for this use.  If you 
  3323.         would like to use AUTOMENU and include it with your packages, 
  3324.         please write to us.
  3325.  
  3326.         We have a complete dealer program available, please inquire 
  3327.         today.
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  
  3333.  
  3334.  
  3335.  
  3336.  
  3337.  
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.  
  3344.  
  3345.  
  3346.  
  3347.  
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  3356.         Automenu version 4.0                 Technical Considerations
  3357.  
  3358.  
  3359.         8-13.  Shareware
  3360.  
  3361.         Shareware distribution gives users a chance to try software 
  3362.         before buying it.  If you try a Shareware program and continue 
  3363.         using it, you are expected to register. Individual programs 
  3364.         differ on details -- some request registration while others 
  3365.         require it, some specify a maximum trial period.  With 
  3366.         registration, you get anything from the simple right to continue 
  3367.         using the software to an updated program with printed manual.
  3368.  
  3369.         Copyright laws apply to both Shareware and commercial software, 
  3370.         and the copyright holder retains all rights, with a few specific 
  3371.         exceptions as stated below. Shareware authors are accomplished 
  3372.         programmers, just like commercial authors, and the programs are 
  3373.         of comparable quality. (In both cases, there are good programs 
  3374.         and bad ones!) The main difference is in the method of 
  3375.         distribution.  The author specifically grants the right to copy 
  3376.         and distribute the software, either to all and sundry or to a 
  3377.         specific group.  For example, some authors require written 
  3378.         permission before a commercial disk vendor may copy their 
  3379.         Shareware.
  3380.  
  3381.         So, Shareware is a distribution method, not a type of software. 
  3382.         You should find software that suits your needs and pocketbook, 
  3383.         whether it's commercial or Shareware.  The Shareware system makes 
  3384.         fitting your needs easier, because you can try before you buy. 
  3385.         And because the overhead is low, prices are low also.  Shareware 
  3386.         has the ultimate money-back guarantee -- if you don't use the 
  3387.         product, you don't pay for it.
  3388.  
  3389.         The above statement about shareware was provided by the 
  3390.         Association of Shareware Professionals (ASP). If you are 
  3391.         interested in Shareware or the Association, please feel free to 
  3392.         contact us and we will provide you with current information. 
  3393.  
  3394.         A common question is asked of us, "How do I find out about other 
  3395.         Shareware products that are available?" There are many companies 
  3396.         that provide the service of finding and cataloging Shareware 
  3397.         products; and for a small fee, will send you a diskette with 
  3398.         Shareware products on it. The first company to provide this 
  3399.         service was "The Public (Software) Library." To reach them, write 
  3400.         to Nelson Ford, P.O. Box 35707, Houston, Texas 77235-5705 or call 
  3401.         713-721-5205. For the names for other companies that provide this 
  3402.         service, look for ads in your favorite magazines.
  3403.  
  3404.         8-14.  Future
  3405.  
  3406.         There will always be improvements in this software as the need 
  3407.         warrants. Any comments or suggestions concerning AUTOMENU would 
  3408.         be greatly appreciated. Updates and other exciting programs will 
  3409.         be available in the future. Please support the free enterprise 
  3410.         system. Thank you!
  3411.  
  3412.         ================================================================
  3413.                 End of Documentation for Version 4.0 of AUTOMENU
  3414.  
  3415.  
  3416.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  3417.         Automenu version 4.0                          Error Messages
  3418.  
  3419.  
  3420.  
  3421.  
  3422.                                    APPENDIX A
  3423.  
  3424.  
  3425.  
  3426.                                  ERROR MESSAGES
  3427.  
  3428.  
  3429.  
  3430.  
  3431.         Message: ERROR READING MENU DEFINITION FILE                    
  3432.  
  3433.         Reason: AUTOMENU cannot find or read the menu definition file, or 
  3434.         the file is in an improper format.
  3435.  
  3436.         Action: Ensure that the file is in the proper format and properly 
  3437.         named. Also, check for any possible disk-related hardware 
  3438.         problems. 
  3439.  
  3440.                    
  3441.  
  3442.  
  3443.         Message: INVALID FILENAME
  3444.  
  3445.         Reason: The filename given contains too many characters--it is
  3446.         too long.
  3447.  
  3448.         Action: Rename your MDF. It's name can have eight characters.
  3449.  
  3450.  
  3451.         Message: NOT ENOUGH MEMORY AVAILABLE TO LOAD MDF
  3452.  
  3453.         Reason: Your MDF is too large for your computer's memory.
  3454.  
  3455.         Action: Use {@} to place a portion of your menu into an alternate 
  3456.         MDF. Call the alternate MDF from the original menu. 
  3457.  
  3458.         Reason:  You have attempted to run a TSR program using the {!}, 
  3459.         {-}, or {=} symbol. The system cannot get to the open portion of 
  3460.         memory.
  3461.  
  3462.         Action: Rewrite the menu selection with the TSR program using {+}
  3463.         symbols.
  3464.                                                                        
  3465.         Message: AUTOMENU REQUIRES DOS 2.0 OR HIGHER
  3466.  
  3467.         Reason: This software will not operate  under DOS 1.0 or 1.1.
  3468.  
  3469.         Action: You must update your version of DOS to version 2.0 or 
  3470.         higher.
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.         Copyright (C) 1983, 1987 Magee Enterprises. All Rights Reserved.
  3478.         Automenu version 4.0                          Error Messages
  3479.  
  3480.  
  3481.         Message: NOT ENOUGH MEMORY TO LOAD COMMAND.COM
  3482.  
  3483.         Reason: To execute any direct DOS commands, at least 17KB of 
  3484.         memory is required so COMMAND.COM can be loaded.
  3485.  
  3486.         Action: You can utilize only the non-resident features of 
  3487.         AUTOMENU.
  3488.  
  3489.  
  3490.         Message: COMSPEC= NOT FOUND IN ENVIRONMENT
  3491.  
  3492.         Reason: This information must be in the environment space for 
  3493.         AUTOMENU to be able to locate COMMAND.COM.
  3494.  
  3495.         Action: Use the "SET" command in AUTOEXEC.BAT to place COMSPEC= 
  3496.         in the system environment space.
  3497.  
  3498.         Example: SET COMSPEC=D:\COMMAND.COM.
  3499.         This example would help AUTOMENU find COMMAND.COM on DRIVE D:
  3500.  
  3501.  
  3502.         Message: CAN'T WRITE TEMPORARY BATCH FILE
  3503.  
  3504.         Reason: You do not have sufficient space left on your disk, or 
  3505.         the disk is write-protected.
  3506.  
  3507.         Action: Delete unnecessary files on disk. Remove any write-
  3508.         protect tabs. Replace disk with non-write-protected disk. Check 
  3509.         for disk related hardware problems.
  3510.  
  3511.  
  3512.         Message: CAN'T OPEN MDF
  3513.  
  3514.         Reason:  The user has failed to return to the AUTOMENU 
  3515.         subdirectory after execution of a DOS command using the {!} 
  3516.         symbol. 
  3517.  
  3518.         Action:  Rewrite the menu selection to include a CD \AUTOMENU.
  3519.  
  3520.                   %Example Menu
  3521.                   *Wordstar
  3522.                   !CD \WS
  3523.                   !WS
  3524.                   !CD \AUTOMENU
  3525.                   #End of Example 
  3526.  
  3527.  
  3528.  
  3529.  
  3530.  
  3531.  
  3532.  
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538.  
  3539.  
  3540.  
  3541.  
  3542.  
  3543.  
  3544.  
  3545.                                 ABOUT THE AUTHOR
  3546.  
  3547.  
  3548.  
  3549.         Marshall W. Magee's ten years of programming and software design 
  3550.         experience has produced this version of AUTOMENU.
  3551.  
  3552.         Originally introduced in 1983 through computer user groups and 
  3553.         electronic bulletin boards, AUTOMENU was an immediate success as 
  3554.         a shareware product.
  3555.  
  3556.         Mr. Magee has continued to maintain an active association with 
  3557.         many personal computer user groups. He currently is
  3558.         Vice-President of the Atlanta IBM-PC Users' Group and Chairman of 
  3559.         it's Programmers' Special Interest Group. This group is an 
  3560.         organization formed to discuss the technical aspects of DOS and 
  3561.         programming in various computer languages. He contributes his 
  3562.         technical expertise to these organizations by providing 
  3563.         instruction to their members, contributing articles to  their 
  3564.         newsletters, and helping organize and direct activities.
  3565.  
  3566.         As an Industrial and Computer Engineering student at Auburn 
  3567.         University in Auburn, Alabama, Mr. Magee provided consulting 
  3568.         services  to the university and to numerous business clients. 
  3569.         While still a student at Auburn,  he taught computer-related 
  3570.         courses in the university's Continuing Education Program.
  3571.  
  3572.         Currently, he teaches classes for the Georgia Tech Computer 
  3573.         Institute.
  3574.  
  3575.         Mr. Magee is a native of Atlanta, Georgia. Magee Enterprises is 
  3576.         located in Norcross, Georgia, a suburb of Atlanta.
  3577.  
  3578.  
  3579.  
  3580.  
  3581.  
  3582.  
  3583.  
  3584.  
  3585.  
  3586.  
  3587.  
  3588.  
  3589.  
  3590.  
  3591.  
  3592.  
  3593.  
  3594.  
  3595.  
  3596.  
  3597.  
  3598.  
  3599.  
  3600.  
  3601.                        ------------------------------------
  3602.                         Automenu Registration Payment Form
  3603.                        ------------------------------------
  3604.  
  3605.         To order Automenu, please fill out the form below. Use street
  3606.         address only (we cannot ship to a post office box).
  3607.  
  3608.                                                       Date: _____________
  3609.  
  3610.         Name: _____________________________  Title:   ___________________
  3611.  
  3612.         Company: ________________________________________________________
  3613.  
  3614.         Address: ________________________________________________________
  3615.  
  3616.         _________________________________________________________________
  3617.  
  3618.         City: ___________________________________________________________
  3619.  
  3620.         State/Country: ________________________ Zip: ____________________
  3621.  
  3622.         Phone  Work: (_____) _____ - ______  Home: (_____) _____ - ______
  3623.  
  3624.  
  3625.         Method of payment: Please complete the worksheet below and choose
  3626.         one of the payment options indicated. Georgia State residents
  3627.         must add sales tax. ALL CHECKS AND MONEY ORDERS MUST BE DRAWN ON
  3628.         U.S. ACCOUNTS ONLY.
  3629.  
  3630.  
  3631.         +----------+------------------------------+----------+----------+
  3632.         |          |                              |   Cost   |   Total  |
  3633.         | Quantity |          Description         | per unit |   Cost   |
  3634.         +==========+==============================+==========+==========+
  3635.         |          |                              |          |          |
  3636.         |          |  Automenu Software Package   |  $50.00  |          |
  3637.         |          |                              |          |          |
  3638.         +==========+=+============================+==========+==========+
  3639.                      |       Georgia residents add sales tax |          |
  3640.                      +---------------------------------------+----------+
  3641.                      | Shipping Cost if Overseas, add $20.00 |          |
  3642.                      +---------------------------------------+==========+
  3643.                                                        TOTAL |          |
  3644.         Please indicate diskette format:  [ ] 5.25           +==========+
  3645.                                           [ ] 3.5 
  3646.  
  3647.          [ ] Check with order  [ ] Money Order  [ ] MasterCard  [ ] VISA
  3648.  
  3649.         Credit card #:______________________________ Exp. Date: ____/____
  3650.  
  3651.         Signature: ______________________________________________________
  3652.  
  3653.         Cardholder's name: ______________________________________________
  3654.  
  3655.         Cardholder's address: ___________________________________________
  3656.         (If different from above)
  3657.         *****************************************************************
  3658.         Send all items to:     Magee Enterprises
  3659.                                Automenu Order Department
  3660.                                6577 Peachtree Industrial Boulevard
  3661.                                Norcross, Georgia 30092-3796 USA
  3662.         *****************************************************************
  3663.         If you have any questions, please call 404-446-6611. Volume users
  3664.         of Automenu please inquire about quantity discounts
  3665.  
  3666.  
  3667.  
  3668.                                  --------------
  3669.                                   COMMENT FORM
  3670.                                  --------------
  3671.  
  3672.         Your comments about this software and documentation are welcome.
  3673.         Please take the time to fill out this form or write or call us
  3674.         with your comments.
  3675.  
  3676.         Name: _____________________________  Title:   __________________
  3677.  
  3678.         Company: _______________________________________________________
  3679.  
  3680.         Address: _______________________________________________________
  3681.  
  3682.         ________________________________________________________________
  3683.  
  3684.         City: __________________________________________________________
  3685.  
  3686.         State/Country: ________________________ Zip: ___________________
  3687.  
  3688.         Phone Work: (_____) _____ - ______  Home: (_____) _____ - ______
  3689.  
  3690.         Automenu Version Number: _____________  Date: __________________
  3691.  
  3692.  
  3693.         ________________________________________________________________
  3694.  
  3695.         ________________________________________________________________
  3696.  
  3697.         ________________________________________________________________
  3698.  
  3699.         ________________________________________________________________
  3700.  
  3701.         ________________________________________________________________
  3702.  
  3703.         ________________________________________________________________
  3704.  
  3705.         ________________________________________________________________
  3706.  
  3707.         ________________________________________________________________
  3708.  
  3709.         ________________________________________________________________
  3710.  
  3711.         ________________________________________________________________
  3712.  
  3713.         ________________________________________________________________
  3714.  
  3715.         ________________________________________________________________
  3716.  
  3717.         ________________________________________________________________
  3718.  
  3719.         ________________________________________________________________
  3720.                                                                714.8705
  3721.  
  3722.         *****************************************************************
  3723.         Send this form to:     Magee Enterprises
  3724.                                Automenu Comments
  3725.                                6577 Peachtree Industrial Boulevard
  3726.                                Norcross, Georgia 30092-3796 USA
  3727.         *****************************************************************
  3728.  
  3729.  
  3730.  
  3731.  
  3732.