home *** CD-ROM | disk | FTP | other *** search
/ CD-ROM Aktief 1995 #3 / CDA3.iso / comm / ts3m.zip / MNU.TXT < prev    next >
Text File  |  1994-12-16  |  19KB  |  515 lines
  1.  
  2.  
  3.                     MNU  Manual          Page 1
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                         _______
  10.                    ____|__     |               (R)
  11.                 --|       |    |-------------------
  12.                   |   ____|__  |  Association of
  13.                   |  |       |_|  Shareware
  14.                   |__|   o   |    Professionals
  15.                 -----|   |   |---------------------
  16.                      |___|___|    Member
  17.  
  18.  
  19.  
  20.                 Version 3.00           December, 1994
  21.  
  22.  
  23.           MNU, is a batch file enhancer, readme tool, and menu program.
  24.           Its included to help make the overall package easier to use
  25.           and to adapt to your needs, and to show you how you can use
  26.           the remote support/package package with your favourite menu
  27.           program.
  28.  
  29.  
  30.  
  31.  
  32.           MNU has 3 main modes:  ASK, MENU, and README
  33.  
  34.           Each of the modes can have behaviour changes depending on
  35.           various settings.  Much of the documentation suggests using
  36.           environmental variables, but you can use the MNU.INI file as
  37.           documented after the mode descriptions instead.
  38.  
  39.  
  40.           1) ASK MODE is a simple way of asking for user input within a
  41.           batch file.  It displays the "input string" at the current
  42.           screen position and waits for a one key response.  Only keys
  43.           in the "key list" are allowed:
  44.  
  45.           MNU ASK <input string>  - The string to display
  46.              <key list>      - Keys that are acceptable responses
  47.              [DEFAULT=c]     - The default key if enter is pressed
  48.              [TIMEOUT=n]     - The number of seconds to wait
  49.              [DEBUG]         - Causes the errorlevel to be displayed
  50.              [NOTIME]        - Time remaining won't be displayed.
  51.  
  52.           Upon exit it sets the DOS Errorlevel based on the order of key
  53.           pressed.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                     MNU  Manual          Page 2
  61.  
  62.  
  63.  
  64.           Example:  MNU ASK "<O>ki, <L>aser, <E>pson (press O, L, or
  65.           E):  " OLE
  66.  
  67.           After displaying "<O>ki, <L>aser, <E>pson (press O, L, or E):
  68.           " it waits for a keypress.If it's in the group (OLEole) it
  69.           sets the DOS Errorlevel according to the order in the key list
  70.           and exits.  Esc exits with 0.  Other options can be placed
  71.           after the key list:
  72.  
  73.           DEFAULT - This is used to set a Default Key, to be used if
  74.           Enter is pressed or a TIMEOUT is reached.  If "default=a" is
  75.           used, then when the user presses Enter, it would be the same
  76.           as pressing "a".
  77.  
  78.           TIMEOUT - An example would be "timeout=30".  If no key is
  79.           pressed within 30 seconds the program will terminate.  If
  80.           there is a DEFAULT key set, it will act as if that key were
  81.           pressed.
  82.  
  83.           DEBUG - (or /debug) This shows the DOS Errorlevel upon exit.
  84.  
  85.           NOTIME - This prevents the time remaining from being displayed
  86.           when TIMEOUT is active.
  87.  
  88.           An example linked to TeleShare:
  89.  
  90.           echo off
  91.           REM This could be part of your autoexec.bat
  92.           REM Put the MNU line, DEFAULT=Y and TIMEOUT=10 on one line.
  93.           MNU ask "Load TeleShare? Y or N?" YN DEFAULT=Y TIMEOUT=10
  94.           REM
  95.           if errorlevel == 2 goto :bypass
  96.           if errorlevel == 1 goto :loadtele
  97.           goto :bypass
  98.           :loadtele
  99.           rem The TSH could be TSR on the 'local' machine
  100.           TSH
  101.           :bypass
  102.           rem continue autoexec.bat
  103.  
  104.           A similar batch file could load a portion of the Hands On
  105.           remote access package.
  106.  
  107.  
  108.           2) MENU MODE is used to paint a menu on screen and allow users
  109.           to select a choice by positioning a light bar, or letter, and
  110.           pressing enter.  Normally the menu is full screen but the NC
  111.           option reduces the menu to a minimum size.  This allows you to
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                     MNU  Manual          Page 3
  118.  
  119.  
  120.  
  121.           stack successive menus, offset if you like, and to have the
  122.           menus pop up anywhere on the screen.  MENU MODE returns the
  123.           DOS errorlevel set to the sequence number of the item
  124.           selected.
  125.  
  126.  
  127.           MNU MENU <options list separated by commas or spaces>
  128.           [options]
  129.  
  130.           - MENU mode is used to pop up a list of menu choices.  When
  131.           the user selects one and presses "Enter", it sets the DOS
  132.           Errorlevel based on the order of the item chosen.
  133.  
  134.           Example:  MNU MENU "Oki Printer","Laser Printer","Epson
  135.           Printer"
  136.  
  137.           - A BOX will be displayed giving the options in a LIST.  The
  138.           user may choose an option using the up and down arrow keys and
  139.           then press enter.  It will set the DOS Errorlevel according to
  140.           the order of option chosen and then exit.
  141.  
  142.           - There is a DEBUG option.  If "debug" or "/debug" is placed
  143.           after the option list it will show the DOS Errorlevel upon
  144.           exit.
  145.  
  146.           - The LOCATION of the box can be controlled by setting an
  147.           environment variable.  Type the following at the command line
  148.           or in a batch file "set twp=1012".  This would set the upper
  149.           left corner of the box to row 10, column 12.  The coordinates
  150.           must contain 4 numbers.  For instance row 9, column 1 would be
  151.           "set twp=0901". Row 0, column 0 would be "set twp=0000".  If
  152.           you use the MNU.INI file to set TWP you lose the capability to
  153.           'stack' successive menus offset like cards unless you put
  154.           different MNU.INI files in different subdirectories.
  155.  
  156.           - A title will be placed at the top of the menu box, if the
  157.           parameters include "t:title".
  158.  
  159.           Example:  MNU MENU "t:Printer Menu" "Oki" "Laser" "Epson"
  160.  
  161.           - To create overlaid menus, use "NC" as a parameter.  The
  162.           screen won't be cleared before popping up the new menu.  You
  163.           can also use NC to make minimal sized menus.
  164.  
  165.           Example:  MNU MENU "NC" "t:Printer Menu" "Oki" "Laser" "Epson"
  166.  
  167.           - You can set an environment variable (TWH) to over-ride the
  168.           default header of "Menu Choices".  If you rename MNU to HOMNU
  169.  
  170.  
  171.  
  172.  
  173.  
  174.                     MNU  Manual          Page 4
  175.  
  176.  
  177.  
  178.           the header becomes 'Hands On Remote Access' without using
  179.           environment space.
  180.  
  181.           Example:  SET TWH=ACME COMPANY MENU
  182.  
  183.           - You can set an environment variable (TWSAV) to cause the
  184.           screen to be cleared and your message (up to 60 characters) to
  185.           be displayed.  If you run out of environment space the message
  186.           will be truncated.
  187.  
  188.           Example:  SET TWSAV=I'm at Lunch.  Return 1:30
  189.  
  190.           The screen saver activates when you tap F7, and the screen is
  191.           restored when you tap another key.  You can also use the
  192.           command line parameter or switch -NOBURN to have the screen
  193.           saver automatically start up when the menu starts.  It starts
  194.           up every time you restart the menu when used this way, so you
  195.           might consider a 'startup' menu that includes -noburn and a
  196.           'working' menu batch file setup for 'during the day' usage.
  197.  
  198.  
  199.           MNU menu "t:Main Menu" "WordPerfect" "Lotus" "Quit" -NOBURN
  200.           # a sample startup with the -NOBURN option
  201.  
  202.           Note that you can leave this screen saver running while the
  203.           remote access host is resident and waiting for a call, and it
  204.           will appear when the connection is completed.  This also
  205.           provides an initial menu of choices.
  206.  
  207.  
  208.           You can add command line password capability by adding -P for
  209.           password and either including a password in the batch file or
  210.           running the batch file with a command line password.  The
  211.           password capability is tied to the screen saver.  If you use
  212.           -P, but do not use -NOBURN the screen saver is activated as if
  213.           you used -NOBURN.
  214.  
  215.           # an example using passwor