home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / UTILS2 / ULTMNU3.ZIP / ULTMU37A.DOC < prev    next >
Text File  |  1993-12-02  |  14KB  |  278 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.               UltraSoft ULTRAMENU Version 3.7a Documentation
  9.                          Written by Steve Hansen
  10.  
  11.                  Copyright (C) UltraSoft 1990,1991,1992,1993
  12.                                Software Division of 
  13.                                UltraSystems Hawaii
  14.  
  15.                           5070 Likini St. 
  16.                           Suite 1209
  17.                           Honolulu, HI 96818
  18.  
  19.                           UltraSoft BBS Support System 
  20.                           (808)833-1525
  21.  
  22.                           ACME BBS - Livermore, CA
  23.                           UltraSoft Product Support BBS - West
  24.                           (510)373-1267
  25.                           (510)373-1035
  26.                           (510)373-1316
  27.  
  28.                           Dan's Place BBS - Wahiawa, HI, also             
  29.                           features UltraSoft Door Games and Products
  30.                           (808)624-9239
  31.  
  32.      
  33.      Requirements:
  34.  
  35.      An  IBM  PC  or compatible with Color video display CGA/EGA/VGA or
  36.      a graphics display that can simulate one of the above. UltraMenu is
  37.      compatible with MS DOS version 3.3 and above. It may operate with
  38.      earlier versions of MSDOS, but has not been tested.
  39.  
  40.      While  ULTRAMENU is full-featured  and  is not crippled in any        
  41.      way, it is NOT Freeware and must be Registered. You may use ULTRAMENU 
  42.      subject to the restrictions below. We hope this product is extremely 
  43.      useful to you as previous versions have been to others..
  44.  
  45.      Copying and Distribution:
  46.  
  47.      ULTRAMENU may be copied and distributed freely in it's ShareWare
  48.      form, but not the Registered version entitled RULTMU37.EXE, 
  49.      as distributed from UltraSoft. If you distribute UltraMenu on   
  50.      communications systems such as CompuServe, the Source, Genie, BBS
  51.      Systems, etc, you must include all files contained in this package
  52.      which consist of the following:
  53.  
  54.      AUTOEXE.BAT   -    Produced by UltraMenu
  55.      DESC.SDI      -    A description file used by some BBS Systems
  56.      FILE.LST      -    A List of all Files and attributes
  57.      FILE_ID.DIZ   -    Another description file used by some BBS's
  58.      INSTALL.EXE   -    An Installation Utility for UltraMenu
  59.      MENU.DAT      -    An example Menu configuration
  60.      ORDER.FRM     -    The Registration and Order Form
  61.      PIT.COM       -    A blatent BBS Commercial
  62.      READ.ME       -    Small update info file
  63.      ULTMU37a.DOC  -    The current file you are reading
  64.      ULTRMENU.EXE  -    The main Exe file
  65.      WHATS.NEW     -    A File describing new features and product history
  66.      X.BAT         -    Necessary to run properly
  67.  
  68.      No fees may be charged for its distribution, other than a minimal
  69.      fee to cover the cost of media and handling without the express 
  70.      written consent of UltraSoft.
  71.  
  72.  
  73.  
  74.      INTRODUCTION
  75.  
  76.      UltraMenu, when appropriately used, is a powerful and flexible
  77.      tool. However, it MUST be installed precisely as defined herein.
  78.  
  79.      UltraMenu is a Task/Application management utility to organize your
  80.      many computerized job requirements and make them accessible to you
  81.      with ultimate simplicity and speed. It has been described as a
  82.      small, fast version of a Windows-like environment, but is in no
  83.      way a Multi-Tasker and could probably be better not compared in           
  84.      this way.
  85.  
  86.      In writing the many versions and enhancements to this program, we
  87.      have continually endeavored to keep simplicity as our ultimate
  88.      priority. As such, UltraMenu can be used very effectively by the
  89.      novice computer user, as well as the seasoned professional.
  90.  
  91.      When installing the program, the most efficient way is to 
  92.      utilize the INSTALL.EXE program included. Another way is to
  93.      load all files included in this distribution into your root
  94.      directory, or unzip the package into the C:\ directory of your
  95.      hard disk. The packing list should appear as in the list above.
  96.  
  97.      The install program will alter your Autoexec.bat file to include
  98.      an X at the end. Upon booting your system, the Autoexec.bat file
  99.      calls a small batch file called X.BAT, which in turn activates
  100.      UltraMenu. If it is not desired to have UltraMenu active at start
  101.      up (highly recommended however), then do not elect to alter your
  102.      Autoexec.bat file during Install. In that case UltraMenu would be
  103.      called using simply the X command. Either way, it is not a TSR, and
  104.      takes up no memory space. However, UltraMenu MUST be in your PATH.
  105.  
  106.  
  107.      MENU.DAT
  108.  
  109.      The Menu.DAT file included here, is the actual file which is read
  110.      by UltraMenu, and acted upon. This file is alterable by the user,
  111.      to fit his/her own personal needs, and can be configured by using
  112.      any good ascii (text) editor. 
  113.      
  114.      A major addition to Version 3.50 was the ability to alter the Menu 
  115.      from the UltraMenu screen, using the Ins key to insert an entry and 
  116.      the Del key to delete an entry. To alter the MENU.DAT file from the 
  117.      main screen, simply tap either of these keys and follow the directions, 
  118.      keeping in mind that "Next command" refers to sequential commands 
  119.      required to activate a given application, as in a batch file.
  120.  
  121.      We have not attempted to make the Install program an ascii text
  122.      editor since so many good ones are already available including the
  123.      program distributed as a part of MS DOS 5.0 and MS DOS 6.0.
  124.  
  125.      Each line in Menu.dat ultimately becomes a Job Control function and
  126.      is inserted in a batch file for subsequent execution by UltraMenu.
  127.      The line format is as follows:
  128.  
  129.      MYPROGRM-,C:,CD\MYPROG,MYPROGRM,X
  130.         |    | |  |         |        |
  131.         |    | |  |         |        Return to UltraMenu after finished
  132.         |    | |  |         Execute THIS program as a result
  133.         |    | |  Change Directory to where Application resides
  134.         |    | Change to C: Drive
  135.         |    If included, allows the insertion of parameters at time of Call
  136.         This is the title which will appear in the Menu. (Caps only)
  137.  
  138.      If you go into the Root Directory (C:\) and key in TYPE MENU.DAT
  139.      or otherwise display the Menu.DAT file, you will see several
  140.      examples of ways to format command streams.
  141.  
  142.      Line entries can be up to 60 total in length and 9 commands long,
  143.      for each line. This is more than we have ever needed, and suspect
  144.      you will find it at least adequate. Each line forms one Menu
  145.      Selection and is displayed when UltraMenu is run. To simplify
  146.      understanding, it is a sequence of commands you wish to have
  147.      executed as part of running any application program.
  148.  
  149.      With Version 3.50 and up, multiple Menus can be used throughout your
  150.      computer environment, using the EXE file in the Root Directory
  151.      alone. Any of these menus can activate each other, by calling the
  152.      appropriate change directory (CD\XX) and then activating UltraMenu
  153.      with an X command. In this case, the SubDirectory switched to should
  154.      have it's own unique Menu.DAT file, to allow the program to run
  155.      properly. Important note: This multiple directory Menus option can
  156.      become more than a little confusing, and if used, is unlimited, but
  157.      the CD\ line must be removed from the X.BAT file, or it will always
  158.      return to the Root Directory. Also it is HIGHLY recommended that
  159.      the first line in each separate Menu.Dat file be called MASTER MENU or
  160.      something similar with a following CD\,X to activate the Master
  161.      Control Menu in the Root Directory.
  162.  
  163.      NOTES: The dash <-> you see in the example, indicates the
  164.      possibility of parameters being desired when entering a program.
  165.      If a program requires parameters, include a dash at the end of the
  166.      title. UltraMenu will note the dash while presenting options,
  167.      and if it sees a dash there, it will query you for parameters, at
  168.      the top left hand side of your screen, before running a program.
  169.      An example might be DIR- . You will be queried for the directory
  170.      would like to have displayed, etc.. Or DRAW- will query you for
  171.      a possible drawing to load into the program.
  172.  
  173.      Note: If Parameters do exist but are always the same. do not use the
  174.      dash symbol in your command entry, use the parameters as part of
  175.      the actual MENU.DAT line item entry that calls your application. 
  176.      i.e.    Q&A,QA -sc,    etc.
  177.                  |__|
  178.  
  179.      The X you see at the end of the example is optional. If included on
  180.      a line, the X calls UltraMenu back in, when the application is
  181.      complete. If it is not there, The system is returned to the DOS
  182.      prompt upon completion of the Application or Task. Some applications
  183.      will not allow this, and if this is the case, simply type X after
  184.      the application terminates, to return to UltraMenu. UltraMenu will
  185.      remind you to do this, if it is not automatically called back in.
  186.  
  187.      UltraMenu also incorporates a screen blanker to protect your monitor
  188.      from burned images in the screen which often haunt us as a computer
  189.      gets a bit older, or is not thusly protected. If the System is
  190.      inactive for several minutes UltraMenu notifies you twice that is
  191.      is blanking the screen, and no concern is necessary. To reactivate
  192.      your display simply tap any key on your keyboard.
  193.  
  194.      IMPORTANT: UltraMenu's Main Menu Display MUST be active for the
  195.      blanking feature to work. If you are in an application program,
  196.      UltraMenu is not active or in memory and can not blank your screen.
  197.      This is usually not a problem though, since if you are using the
  198.      UltraMenu environment, The Main Menu should normally be present when 
  199.      the computer is idle anyway..
  200.  
  201.      When operating UltraMenu, note that multiple menu pages are allowed
  202.      up to 5, with 12 possible selections for each page (Menu). So you
  203.      are able to include up to 60 applications to be controlled by
  204.      UltraMenu. As previously discussed, the number of possible Sub-Menus
  205.      is unlimited.
  206.  
  207.      Once we have it in operation, I think you'll realize the
  208.      Ultimate UltraMenu benefits rather quickly.
  209.  
  210.  
  211.      OPERATION
  212.  
  213.      Note that you can select an entry by selecting the first
  214.      letter of the program. If others exist on the same screen
  215.      with the same first letter, select the same letter again
  216.      and UltraMenu will move to the next one, and on and on.
  217.      Also, you can speed select by typing the first letter, and
  218.      then the second and so on. UltraMenu will jump to the first
  219.      entry that includes the letters you have typed so far. Ex:
  220.      "P" will select the first entry in any menu, that begins
  221.      with "P". However, if you then type "C", UltraMenu will
  222.      jump to the first entry in any menu that begins with "PC"
  223.      (i.e. PCTOOLS). If you then type "E" it will go to the first
  224.      entry that starts with "PCE", and so on.
  225.  
  226.      The Up, Down, Right and Left arrows also select menu entries.
  227.      A moving highlight will show the operator where you are.
  228.      When an application is selected, press <ENTER> to execute it.
  229.  
  230.      The Esc key terminates the program. To return to UltraMenu,
  231.      simply type "X".
  232.  
  233.  
  234.      APPLICATION IMAGINATION
  235.  
  236.      UltraMenu is not a HUGE program, which makes its possible uses
  237.      almost limitless. It can do almost anything from executing simple
  238.      DOS commands to activating very complex packages such as Word
  239.      Perfect, DBase, Framework, Lotus, or Symphony, with many parameters.
  240.  
  241.      UltraMenu's possible applications are limited only by your
  242.      imagination and your particular needs. Unique copies of Menu.DAT
  243.      and X.BAT might also be used in various parts of your system where you
  244.      may have certain types of applications categorized. For example: The
  245.      Main Ultra Menu might reside in the Root directory, and the menu
  246.      selections might include calling up as many as 60 Sub UltraMenus with
  247.      categorized or specialized software such as various Stock Analysis
  248.      applications, Communications programs or Software Compilers.
  249.      These UltraMenu EXE file would be in the Root while the Menu.DAT files
  250.      would of course be in their own sub-directories and would be in charge
  251.      of their own unique set of programs or applications. So you are
  252.      limited by only ideas..
  253.  
  254.      Mouse support is not included in this release.
  255.  
  256.      Oh, one last but not least item. Be sure your config.sys
  257.      file, in the root directory, contains "DEVICE=ANSI.SYS", or
  258.      your display will appear very confused.
  259.  
  260.      UltraSoft is always open to new ideas and suggestions relative 
  261.      to future enhancements of its products. If you have ideas that
  262.      might be included in a future release, please take the time to
  263.      note them and forward your thoughts to the address included 
  264.      herein, or one of the Product Support BBS Systems listed. This 
  265.      product and others will continue to evolve with the assistance 
  266.      and support of people like yourself. 
  267.  
  268.      DISCLAIMER
  269.  
  270.      The use of this software is purely at the discretion of the
  271.      user. The author and/or UltraSoft bear no responsibility for
  272.      any complication or damage to personal property which may be
  273.      created or perceived to have been created by it's use.
  274.  
  275.  
  276.      Please register and Enjoy!                   Steve Hansen
  277.                                                   UltraSoft
  278.