home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / vrac / mmenu10b.zip / MMENU.DOC < prev    next >
Text File  |  1994-07-24  |  39KB  |  879 lines
  1.  
  2.                         * MultiMenu Door 1.00 *
  3.  
  4.                         Released July 24, 1994
  5.                       Copyright 1994 Mike Robinson
  6.  
  7.                             The Soft Parade
  8.                         Shelton, Connecticut, USA
  9.                         1:141/485    203-924-5603
  10.                         1:141/486    203-922-1794
  11.               Fast Online registration using Visa or Mastercard
  12.  
  13.       MultiMenu is a menu extension door for any BBS that creates a
  14.       DOOR.SYS, DORINFOx.DEF, or SFDOORS.DAT door drop file.
  15.  
  16.       It uses either a plain UART, FOSSIL driver, or DigiBoard Driver.
  17.       It will work on multi-port IO cards that utilize a shared IRQ.
  18.  
  19.       Up to 254 doors, access control by security/age/baud/password,
  20.       automatic display generation, custom display screens, Ansi/Ascii
  21.       graphics, optional status line, port speed up to 115,200 bps,
  22.       multitasker aware, multi-node and network support, file sharing and
  23.       locking, chat mode, local drop to Dos, carrier detect, inactivity
  24.       timeout, activity log. Can run in local mode in the BBS or from the
  25.       DOS command line.
  26.  
  27.       MultiMenu exits with an ErrorLevel which is then used in a batch file
  28.       to pass control to the selected external door or other program.
  29.  
  30.       MultiMenu is shareware with a $20 registration. See the end of this
  31.       file or REGISTER.DOC for registration form and information.
  32.  
  33. ----- SETUP -------------------------------------------------------------
  34.  
  35.       Here is the quick version of the setup instructions:
  36.  
  37.       1. Unzip this archive into one subdirectory.
  38.  
  39.       2. Edit the included MMENU.CFG configuration file.
  40.  
  41.       3. Edit the included MENU.BAT file.
  42.  
  43.       4. Run the program using MENU.BAT.
  44.  
  45.       Take a quick look at MMENU.CFG and MENU.BAT and you will get the
  46.       general idea. MENU.BAT uses the multiple IF ERRORLEVEL format common
  47.       on many BBS systems. MMENU.CFG is a simple Ascii text configuration
  48.       file.
  49.  
  50.       Here is a more detailed description of each step:
  51.  
  52.       1. Unzip this archive into one subdirectory. This will be the
  53.          MultiMenu home directory, which is named C:\MMENU in the following
  54.          example, but any subdirectory name may be used.
  55.  
  56.       2. Modify the included MMENU.CFG file to suit your system.
  57.          See CONFIGURATION COMMANDS section below for description of each
  58.          option. Any line in MMENU.CFG that does not begin with a letter is
  59.          ignored. The lines that begin with semicolons, for example, are
  60.          used for comments and ignored by the program. Keep this file in
  61.          the MultiMenu home directory.
  62.  
  63.       3. Modify the included MENU.BAT file to suit your system. This is the
  64.          batch file which runs MultiMenu and you must put the commands to
  65.          run all your doors in this file. MultiMenu exits with an
  66.          ErrorLevel which is then used in this batch file to pass control
  67.          to the selected external door. When the caller exits the external
  68.          door, the GOTO LOOP command passes control back up to the top of
  69.          MENU.BAT and restarts MultiMenu. There should be a GOTO loop
  70.          command after every door in MENU.BAT. If you run any batch files
  71.          inside of MENU.BAT then you should use a DOS CALL command to run
  72.          the batch file like this:
  73.  
  74.          :DOOR1
  75.             CALL DOOR1.BAT
  76.             GOTO LOOP
  77.  
  78.          You may use any ErrorLevel from 1 to 254. ErrorLevel 0 is
  79.          generated when the caller chooses to exit MultiMenu without
  80.          selecting a door. ErrorLevel 255 is generated if there is an
  81.          error, carrier drop, or inactivity timeout. The IF ERRORLEVEL
  82.          statements in MENU.BAT must be in DESCENDING order.
  83.  
  84.          If you use DOOR.SYS, then part of MENU.BAT looks like this:
  85.  
  86.          CD C:\MMENU
  87.          MMENU  C:\BBS\DOOR.SYS  C:\MMENU\MMENU.CFG
  88.  
  89.          If you use DORINFOx.DEF, then part of MENU.BAT looks like this:
  90.  
  91.          CD C:\MMENU
  92.          MMENU  C:\BBS\DORINFO1.DEF C:\MMENU\MMENU.CFG
  93.  
  94.          If you use SFDOORS.DAT, then part of MENU.BAT looks like this:
  95.  
  96.          CD C:\MMENU
  97.          MMENU  C:\SF\SFDOORS.DAT C:\MMENU\MMENU.CFG
  98.  
  99.          SFDOORS.DAT is used on Spitfire BBS. You may also use any one of
  100.          the other Spitfire door drop files: SFMAIN.DAT, SFFILE.DAT, or
  101.          SFMESS.DAT. These files are identical, only the names are
  102.          different.
  103.  
  104.          MultiMenu uses the door drop file extension to determine which
  105.          type of door drop file to read. If the extension is .SYS then
  106.          MultiMenu assumes it is a DOOR.SYS type. If the extension is .DEF
  107.          then DORINFO?.DEF is assumed. If the extension is .DAT then
  108.          SFDOORS.DAT or equivalent is assumed.
  109.  
  110.          In MENU.BAT, note that the current directory is changed to the
  111.          home directory C:\MMENU before execution of MMENU.EXE. This is
  112.          important because MultiMenu looks for certain files in the current
  113.          directory.
  114.  
  115.       4. Run the program using MENU.BAT.
  116.  
  117.  
  118. ----- LOCAL MODE --------------------------------------------------------
  119.  
  120.       MultiMenu may be run in local mode if you log onto the BBS locally.
  121.  
  122.       It may also be run in local mode from the DOS command line:
  123.  
  124.       MMENU
  125.       ( Help mode. Gives a quick summary of these commands )
  126.  
  127.       MMENU  LOCAL
  128.       ( Local mode.  Looks for MMENU.CFG in current directory.
  129.  
  130.       MMENU  L
  131.       ( Local mode.  Same as above. )
  132.  
  133.       MMENU  L  C:\MMENU\MMENU.CFG
  134.       ( Local mode.  Uses configuration file specified. )
  135.  
  136.       Note that local mode allows you to use MultiMenu as a regular
  137.       DOS menu program. A BBS is not required.
  138.  
  139.  
  140. ----- CONFIGURATION COMMANDS --------------------------------------------
  141.  
  142.       The MMENU.CFG file contains the configuration commands that control
  143.       the behavior of MultiMenu. Almost all of the configuration commands
  144.       are optional and most people will be able to accept the default
  145.       values. The supplied MMENU.CFG shows the default values. This file
  146.       should be edited to suit your system.
  147.  
  148.       At startup, MultiMenu reads each line and if it begins with a
  149.       configuration command, then the configuration is modified as directed
  150.       by the command. If a line begins with anything other than a letter,
  151.       it is ignored. The explanatory comments are on lines beginning with a
  152.       semicolon and are therefore ignored. The commands are NOT case
  153.       sensitive, but they must be spelled correctly. Each command must
  154.       begin on the far left margin (column 1). The order of the commands is
  155.       generally not important except for the BEGIN and END commands.
  156.  
  157.       The BEGIN and END commands are used to define the list of doors:
  158.  
  159.       BEGIN
  160.       1, Door Title 1,
  161.       2, Door Title 2,
  162.       3, Door Title 3,
  163.       4, Door Title 4,
  164.       5, Door Title 5,
  165.       6, Door Title 6,
  166.       7, Door Title 7,
  167.       8, Door Title 8,
  168.       9, Door Title 9,
  169.       END
  170.  
  171.       Each line represents one door. The number on the far left of each
  172.       line is the number typed by the caller to select that door. It is
  173.       also the exit ErrorLevel when that door is selected. This number is
  174.       followed by a comma and then the descriptive title of the door, up to
  175.       50 characters long.
  176.       The list MUST BEGIN with the command "BEGIN".
  177.       The list MUST END with the command "END".
  178.  
  179.       The list of doors can also accept optional access control commands:
  180.  
  181.       BEGIN
  182.       1, Door Title 1, OFF,
  183.       2, Door Title 2, SEC>=10,
  184.       3, Door Title 3, AGE>=21,
  185.       4, Door Title 4, BAUD>=14400,
  186.       5, Door Title 5, PW=SWORDFISH,
  187.       6, Door Title 6, SEC>=10, AGE>=21,
  188.       7, Door Title 7, SEC>=10, AGE>=21, BAUD>=14400,
  189.       8, Door Title 8, SEC>=10, AGE>=21, BAUD>=14400, PW=SWORDFISH,
  190.       9, Door Title 9,
  191.       END
  192.  
  193.       Note that the commands are SEPARATED BY COMMAS.
  194.       On each line, the first two commands are the ErrorLevel and title as
  195.       in the previous example. These are mandatory and must be in the order
  196.       shown. These two mandatory commands are then followed by the optional
  197.       commands of OFF, SEC, AGE, BAUD, and PW=. These optional commands may
  198.       be in any order. All commands are separated by commas. Commands are
  199.       not case-sensitive, but the commands must be spelled correctly.
  200.  
  201.         Command:     Meaning:
  202.         OFF       This door is offline. No access.
  203.  
  204.         SEC>=10   Security levels greater than or equal to 10 may enter.
  205.         SEC<=10   Security levels less than or equal to 10 may enter.
  206.         SEC=10    Security levels equal to 10 may enter.
  207.         SEC>10    Security levels greater than 10 may enter.
  208.         SEC<10    Security levels less than 10 may enter.
  209.  
  210.         AGE>=21   Age greater than or equal to 21 may enter.
  211.         AGE<=21   Age less than or equal to 21 may enter.
  212.         AGE=21    Age equal to 21 may enter.
  213.         AGE>21    Age greater than 21 may enter.
  214.         AGE<21    Age less than 21 may enter.
  215.  
  216.         BAUD>=9600   Connect baud greater than or equal to 9600 may enter.
  217.         BAUD<=9600   Connect baud less than or equal to 9600 may enter.
  218.         BAUD=9600    Connect baud equal to 9600 may enter.
  219.         BAUD>9600    Connect baud greater than 9600 may enter.
  220.         BAUD<9600    Connect baud less than 9600 may enter.
  221.  
  222.         PW=SWORDFISH   The caller will be asked to enter a password.
  223.                        Only callers who know the password may enter.
  224.                        In the example shown, the password is SWORDFISH.
  225.                        Password may be up to 30 characters long.
  226.                        Password is NOT case sensitive.
  227.  
  228.       The age, security, and baud limits will NOT work when Multimenu is
  229.       run in local mode from the DOS command line. The baud limit only
  230.       works when in online mode. The password command will work in all
  231.       modes.
  232.  
  233.       The age limits will only work correctly when MultiMenu is run on a
  234.       BBS which knows the age of the caller and puts the age in the
  235.       DOOR.SYS file. The age limits will NOT work if you use MultiMenu with
  236.       a DORINFOx.DEF file or SFDOORS.DAT files since neither of these files
  237.       contains the caller's age.
  238.  
  239.  
  240.    DRIVER  UART
  241.    DRIVER  FOSSIL
  242.    DRIVER  DIGIBOARD
  243.  
  244.       Optional. Choose ONE. Default is Driver UART.
  245.       MultiMenu can use one of 3 different communications drivers:
  246.  
  247.       UART ........ Use built-in MultiMenu UART comm driver.
  248.       FOSSIL ...... Use external Fossil comm driver such as BNU or X00.
  249.       DIGIBOARD ... Use external DigiBoard comm driver such as XIDOS5.SYS.
  250.  
  251.       Set DRIVER UART for use with non-DigiBoard multi-port IO cards.
  252.       MultiMenu will also work on IO cards that use a shared IRQ.
  253.  
  254.       MultiMenu supports Uart and Digiboard to maximum speed of 115200 bps.
  255.       MultiMenu supports Fossil to maximum speed of 38400 bps.
  256.  
  257.       If you use Fossil or DigiBoard, then the appropriate comm driver
  258.       must be loaded in memory and activated before running MultiMenu.
  259.       MultiMenu has been tested with two of the more common Fossil comm
  260.       drivers: BNU version 1.70 and X00 version 1.24. It has also been
  261.       tested with the DigiBoard universal comm device driver XIDOS5.SYS.
  262.  
  263.  
  264.    SHARE OFF
  265.  
  266.       Optional. Use SHARE ON to enable file sharing and locking.
  267.       If you have more than 1 node and want to have them share menus and/or
  268.       display files, then set SHARE ON. In order for file sharing and
  269.       locking to work, you must use DOS 3.1 or higher, and DOS SHARE.EXE
  270.       must be loaded in your CONFIG.SYS or AUTOEXEC.BAT.
  271.       Default is Share OFF.
  272.  
  273.  
  274.    DEBUG ON
  275.  
  276.       Optional. Use DEBUG OFF to turn off the program error log ERROR.LOG.
  277.       If you are experiencing difficulties, leave DEBUG ON.
  278.       Default is Debug ON.
  279.  
  280.  
  281.    STATLINE  TOP  BLUE  YELLOW
  282.  
  283.       Optional. Default is shown.
  284.       Controls the location and colors of the local onscreen status lines.
  285.       The second command may be TOP, BOTTOM, or OFF.
  286.       OFF means that no status line will be shown.
  287.       The third command is status line background color.
  288.       The fourth command is the status line foreground (character) color.
  289.       Possible colors are:
  290.                 Background             Foreground
  291.                   BLACK            BLACK       DARKGRAY
  292.                   BLUE             BLUE        LIGHTBLUE
  293.                   GREEN            GREEN       LIGHTGREEN
  294.                   CYAN             CYAN        LIGHTCYAN
  295.                   RED              RED         LIGHTRED
  296.                   MAGENTA          MAGENTA     LIGHTMAGENTA
  297.                   BROWN            BROWN       YELLOW
  298.                   LIGHTGRAY        LIGHTGRAY   WHITE
  299.  
  300.  
  301.    LINESPERPAGE 22
  302.  
  303.       Optional. Determines the number of lines shown for each screen page.
  304.       Values from 5 to 30 lines per page are allowed.
  305.       Default is LinesPerPage 22.
  306.  
  307.  
  308.    LEFTMARGIN 14
  309.  
  310.       Optional. Determines the location of the left screen margin.
  311.       Values from 0 to 32 spaces are allowed.
  312.       Default is LeftMargin 14.
  313.  
  314.  
  315.    TIMEOUT 180
  316.  
  317.       Optional. This is the caller inactivity timeout delay in seconds.
  318.       If no keystrokes are received for this length of time, the door will
  319.       exit and return the caller to the BBS. Timeout only applies when the
  320.       door is run from the BBS. There will be no timeout when run from the
  321.       DOS command line.
  322.       Values from 60 to 600 seconds are allowed.
  323.       Default is TimeOut 240.
  324.  
  325.  
  326.    DELAYSECS 10
  327.  
  328.       Optional. This the pause time in seconds for the "Strike any Key To
  329.       Continue" message that appears in many places in the door. The door
  330.       will wait for a keystroke for this number of seconds. If no keystroke
  331.       is received within this time, then the door will proceed to the next
  332.       screen. If some of the display screens pass by too quickly to read,
  333.       then try increasing this number.
  334.       Values from 1 to 3600 seconds are allowed.
  335.       Default is DelaySecs 10.
  336.  
  337.  
  338.    DROPPENALTY 0
  339.  
  340.       Optional. Number of MINUTES to penalize the caller if carrier is
  341.       dropped when in the door. This option will work on Spitfire BBS if
  342.       you use SFDOORS.DAT (or equivalent). It will not work on systems
  343.       using DORINFOx.DEF since this file has no place to put the time
  344.       penalty info. It will likely not work on systems using DOOR.SYS
  345.       because while the time penalty is written to DOOR.SYS line 42, most
  346.       BBS systems do not read back this information. The DropPenalty will
  347.       be subtracted from the callers time allowed during the next call that
  348.       day. If the caller does not call back until the next day, then this
  349.       penalty will have no effect. Also note that if FixTime OFF is set
  350.       then the drop penalty will not be written to the drop file.
  351.       Values from 0 to 1440 minutes are allowed.
  352.       Default is DropPenalty 0.
  353.  
  354.  
  355.    FIXTIME ON
  356.  
  357.       Optional. Controls whether MultiMenu updates the caller time left
  358.       information in the door drop file. If FixTime OFF then the time will
  359.       not be adjusted. Many doors require FixTime ON this so that the
  360.       caller time is correctly adjusted when he enters and exits several
  361.       different doors during the same run of MultiMenu. Also note that if
  362.       FixTime OFF, then the DropPenalty will also not be written to the
  363.       drop file.
  364.       Default is FixTime ON.
  365.  
  366.  
  367.    LOCKPORT 19200
  368.  
  369.       Optional. Do not use this command unless you are sure you need it.
  370.       MultiMenu will automatically read the hardware to determine the port
  371.       speed to use. Use of this command overides the automatic speed
  372.       detection and forces the port to open at the speed indicated.
  373.       Valid port speeds are: 300, 1200, 2400, 4800, 9600, 19200, 38400,
  374.       57600, 115200. The FOSSIL routines in MultiMenu are limited to a
  375.       maximum speed of 38400.
  376.  
  377.  
  378.    PORT 2
  379.  
  380.       Optional. Do not use this command unless you are sure you need it.
  381.       Com port selection is fully automatic based on the value passed by
  382.       DOOR.SYS, DORINFO?.DEF, or SFDOORS.DAT. Use of this command overides
  383.       this value and forces use of the specified com port.
  384.       Allowable for this command is 1 to 8.
  385.  
  386.  
  387.    IO $02F8
  388.  
  389.       Optional. Do not use this command unless you are sure you need it.
  390.       I/O port base address selection is fully automatic based on
  391.       the standard IBM PC values associated with the selected com
  392.       port number. Use of this command overides this value and forces
  393.       use of the specified I/O port base address. The $ indicates
  394.       that the address is specified as a hexadecimal number.
  395.       Allowable for this command is any value from $02E8 to $5228.
  396.       Please note that no checking is done on this value and it
  397.       is entirely possible to specify a non-existant base address.
  398.  
  399.  
  400.    IRQ 3
  401.  
  402.       Optional. Do not use this command unless you are sure you need it.
  403.       The IRQ number selection is fully automatic based on the
  404.       standard IBM PC values associated with the selected com port
  405.       number. Use of this command overides this value and forces use
  406.       of the specified IRQ number.
  407.       Allowable for this command is any value from 0 to 15.
  408.  
  409.  
  410.    HARDFLOW  ON
  411.  
  412.       Optional. Do not use this command unless you are sure you need it.
  413.       Set HardFlow OFF to turn OFF hardware flow control (RTS/CTS). In
  414.       general, you should leave HardFlow ON. Most modern modems support
  415.       hardware flow control.
  416.       Default is HardFlow ON.
  417.  
  418.  
  419.    SOFTFLOW  OFF
  420.  
  421.       Optional. Do not use this command unless you are sure you need it.
  422.       Set SoftFlow ON to turn on software flow control (XON/XOFF). In
  423.       general, Hardware flow control (RTS/CTS) is much better, and most
  424.       modern modems support it. Software flow control will probably not
  425.       work very well on a high speed modem. If you use software flow
  426.       control, please send me a note. I am curious if anyone uses it.
  427.       It is possible to turn on both hardware and software flow control,
  428.       but this is not recommended.
  429.       Default is SoftFlow OFF.
  430.  
  431.  
  432.    DIRECTVIDEO ON
  433.  
  434.       Optional. With DirectVideo ON, all local screen writes will be done
  435.       directly to video memory instead of through the BIOS.
  436.       Set DirectVideo OFF to disable direct local screen writes.
  437.       Default is DirectVideo ON which seems to work fine on most systems.
  438.  
  439.  
  440.    CHECKSNOW OFF
  441.  
  442.       Optional. CheckSnow ON enables "snow checking" when using DirectVideo
  443.       ON. It has no effect if DirectVideo OFF. Some older CGA monitors may
  444.       requires this. It should not be a problem on most monochrome, EGA or
  445.       VGA video systems. CheckSnow OFF is a bit faster.
  446.       Default is CheckSnow OFF.
  447.  
  448.  
  449.    BIOSSCROLL ON
  450.  
  451.       Optional. If BiosScroll OFF, then a special scrolling routine is used
  452.       that suppresses snow and flicker on systems with any kind of color
  453.       graphics. However, BiosScroll ON is a bit faster.
  454.       Default is BiosScroll ON.
  455.  
  456.  
  457.    GRAPHICS ON
  458.  
  459.       Optional. MultiMenu will automatically read the graphics mode from
  460.       DOOR.SYS line 20. This command overides the value passed in DOOR.SYS.
  461.       When using DORINFO?.DEF MultiMenu starts in ASCII mode.
  462.       Graphics ON  forces MultiMenu to start in ANSI  graphics (Color) mode.
  463.       Graphics OFF forces MultiMenu to start in ASCII graphics (B & W) mode.
  464.  
  465.  
  466.    LOG ON
  467.  
  468.       Optional. Registered versions only.
  469.       Set Log ON to turn on the caller activity log defined by LogName.
  470.       In unregistered versions the log is forced OFF.
  471.       In registered versions the default is Log ON.
  472.       In local mode from the DOS command line the log is always forced OFF.
  473.  
  474.  
  475.    LOGNAME  C:\BBS\BBS.LOG
  476.  
  477.       Optional. Registered versions only.
  478.       Gives the name of the caller activity log file. If your BBS uses an
  479.       ASCII text log file, then you can specify that log file name here and
  480.       the MultiMenu log entries will be written directly to your BBS log.
  481.       Default is LogName BBS.LOG.
  482.  
  483.  
  484.    LOGLEADER  '     * '
  485.  
  486.       Optional. Registered versions only.
  487.       This string of characters between the apostrophes '' is placed in
  488.       front of each caller activity log entry. The default of 6 spaces,
  489.       a star, and one space is shown above. The default is designed for
  490.       Wildcat BBS.
  491.  
  492.  
  493.    INDENTLOG 0
  494.  
  495.       Optional. Registered versions only.
  496.       This is the number of characters each line of the caller activity log
  497.       will be shifted to the right beyond the amount specified by
  498.       LogLeader. The line with the caller name (optional, see below)
  499.       is NOT shifted.
  500.       Default is IndentLog 0.
  501.  
  502.  
  503.    LOGUSERNAME OFF
  504.  
  505.       Optional. Registered versions only.
  506.       If LogUserName ON, then MultiMenu writes the caller's name to the
  507.       caller log. Some may wish to turn this ON if the BBS software does
  508.       not write the callers name to the same log.
  509.       Default is LogUserName OFF.
  510.  
  511.  
  512. ----- DISPLAY FILES -----------------------------------------------------
  513.  
  514.       All display files are OPTIONAL.
  515.  
  516.       MultiMenu automatically generates all required screen graphics. These
  517.       optional display files allow you to customize the appearance of
  518.       MultiMenu with ANSI/ASCII graphics screens. Place all of these files
  519.       in the MultiMenu home directory.
  520.  
  521.       In the unregistered version, only MENU.ANS/ASC is displayed.
  522.  
  523.       In all of the display files,
  524.       the .ANS file will be shown if the caller is in ANSI graphics mode and
  525.       the .ASC file will be shown if the caller is in ASCII graphics mode.
  526.  
  527.       MENU.ANS/ASC ...... List of doors available to caller
  528.                           (See below for more information.)
  529.       WELCOME.ANS/ASC ... Displayed when entering MultiMenu.
  530.       GOODBYE.ANS/ASC ... Displayed when exiting MultiMenu.
  531.       CHAT.ANS/ASC ...... Displayed when entering chat mode while online.
  532.       DROPDOS.ANS/ASC ... Displayed before a drop to DOS in online mode.
  533.       BULLx.ANS/ASC ..... Displayed before entering door number x.
  534.                           This is a bulletin or info file about the door.
  535.  
  536.       Not that CHAT and DROPDOS are not displayed in local mode.
  537.  
  538.       The most important display file is the optional main menu which shows
  539.       the list of doors:
  540.  
  541.       ANSI                  ASCII
  542.       -----------           -----------
  543.       MENUxxx.ANS           MENUxxx.ASC
  544.       MENUxxx.ASC           MENU.ASC
  545.       MENU.ANS
  546.       MENU.ASC
  547.  
  548.       The "xxx" shown above represents a security level. For example,
  549.       MENU10.ANS is the ANSI menu for security level 10. MultiMenu
  550.       searches for the display files in the order indicated above.
  551.       If specific display files are not found for the caller's
  552.       security level, then the general MENU.ANS/ASC files are shown.
  553.       If none of these files are found, then MultiMenu will automatically
  554.       generate a screen display of all the doors available to the
  555.       current caller based on the information in MMENU.CFG configuration
  556.       file.
  557.  
  558.       - MULTI-PAGE MENUS -
  559.  
  560.       You can also create a multi-page MENU.ANS/ASC.
  561.       In this case, put all the pages in one file. Each
  562.       page should be no more than 21 displayed lines long and there
  563.       should be 4 blank lines between each page. The door will pause
  564.       at the end of each page and allow the caller to select a command
  565.       or scroll to the next page.
  566.       A good method for creating multi-page ANSI menus is to create each
  567.       page separately in an ANSI editor such as TheDraw. Then use the DOS
  568.       COPY command to join the screens like this:
  569.  
  570.       COPY  PAGE1.ANS+PAGE2.ANS+PAGE3.ANS  ALLPAGES.ANS
  571.  
  572.  
  573. ----- LOCAL KEYBOARD CONTROLS -------------------------------------------
  574.  
  575.       ALT+C --- Chat Mode On/Off
  576.       ALT+D --- Drop To DOS (local sysop only)
  577.       ALT+J --- Drop To DOS (local sysop only)
  578.       F6 ------ Take Five Minutes From Caller
  579.       F7 ------ Give Five Minutes To Caller
  580.       F10 ----- Exit The Door
  581.       ALT+F1 -- Exit The Door
  582.       ALT+F2 -- Exit The Door
  583.       ALT+K --- Kill. Throw the caller off the BBS *NOW*
  584.  
  585.  
  586. ----- STATUS SCREENS ----------------------------------------------------
  587.  
  588.       The top two lines of the local display show status information that
  589.       varies according to the mode and comm driver in use.
  590.  
  591. For DOS Local Mode:
  592. DOS Local Mode              Sunday  July 24, 1994                        12:00pm
  593. MultiMenu 1.00   For Any BBS - Uart, Fossil, or DigiBoard.   Mem Available: 508K
  594.  
  595. For Local Mode in the BBS:
  596. Michael Robinson     Shelton CT     203-922-1794     #125     Sec:10      60 Min
  597. MultiMenu 1.00                         Node:1                               540K
  598.  
  599. Online Mode - DigiBoard:
  600. Michael Robinson     Shelton CT     203-922-1794     #125     Sec:10      60 Min
  601. MultiMenu 1.00        DIGIBOARD    Channel:0    Node:1      14400           540K
  602.  
  603. Online Mode - Fossil:
  604. Michael Robinson     Shelton CT     203-922-1794     #125     Sec:10      60 Min
  605. MultiMenu 1.00           FOSSIL      Com2      Node:1      14400            540K
  606.  
  607. Online Mode - Uart:
  608. Michael Robinson     Shelton CT     203-922-1794     #125     Sec:10      60 Min
  609. MultiMenu 1.00      16550A UART  COM2  Node:1  14400/38400  IRQ:3  IO:02F8  540K
  610.  
  611.       Michael Robinson --- Caller name.
  612.       Shelton CT --------- Caller address.
  613.       203-922-1794 ------- Caller phone number.
  614.       #125 --------------- Caller user file record number.
  615.       Sec:10 ------------- Caller security level.
  616.       60 Min ------------- The number of minutes left.
  617.  
  618.       MultiMenu 1.00 ----- Program name and version number.
  619.       16550A UART -------- The comm driver in use and the UART type detected.
  620.       COM2 --------------- The Com port number.
  621.       Node:1 ------------- The BBS node number.
  622.       14400/38400 -------- Caller connect speed / Port speed.
  623.       IRQ:3 -------------- Interrupt number.
  624.       IO:02F8 ------------ IO port base address as a hexadecimal number.
  625.       540K --------------- Current memory available after loading MultiMenu.
  626.  
  627.       The Uart type, port speed, IRQ, and IO address are not displayed
  628.       when using the Fossil or DigiBoard comm drivers.
  629.  
  630.  
  631. ----- TROUBLESHOOTING ---------------------------------------------------
  632.  
  633.       Check this document first. Perhaps your problem is discussed here.
  634.  
  635.       MultiMenu writes error messages to file ERROR.LOG in the current
  636.       directory. Check this file. If you set Debug OFF then errors will
  637.       not be written to this file.
  638.  
  639.       If you use a Fossil or DigiBoard driver, make sure it is properly
  640.       loaded in memory and activated before running MultiMenu.
  641.  
  642.       The most common problem is a failure to open the com port. If you
  643.       see MultiMenu appear on the local screen, but see nothing on the
  644.       remote end, then you are using the wrong port, the wrong MultiMenu
  645.       DRIVER, or you have a non-standard port. MultiMenu determines the
  646.       port to use by reading the door drop file:
  647.  
  648.       DOOR.SYS       file line 1
  649.       DORINFOx.DEF   file line 4
  650.       SFDOORS.DAT    file line 6
  651.  
  652.       Check the door drop file line indicated above to be sure that it is
  653.       the correct port. You can also force MultiMenu to use a certain port
  654.       by using the PORT command in MMMENU.CFG. This will override the port
  655.       specified in the door drop file.
  656.  
  657.       Check the MultiMenu comm driver used by checking the local screen
  658.       status line. Be sure this is the driver you expect.
  659.  
  660.       If you are using a non-standard port IRQ or IO base address, then you
  661.       must use the IRQ and/or the IO commands in MMENU.CFG. This is the
  662.       only way to "tell" MultiMenu which settings to use. You can see the
  663.       settings which actually were used on the local screen status line.
  664.  
  665.       If MultiMenu starts, shows some of the initial displays, and then
  666.       seems to halt, this is almost always a conflict with another device
  667.       or software on the system. The most common such problem is an
  668.       internal modem and IO card trying to use the same IRQ number. Make
  669.       sure that nothing else on your system is using the IRQ and IO base
  670.       address used by MultiMenu. Other devices which could cause conflicts
  671.       are a mouse, sound card, CD-ROM card, network card, tape backup card,
  672.       scanner card, or just about any other piece of "extra" hardware
  673.       plugged into the computer.
  674.  
  675.       MultiMenu should work OK with multiport IO cards that use a shared
  676.       IRQ. For a DigiBoard (or compatible) set Driver DigiBoard in
  677.       MMENU.CFG. All other multiport IO cards should use Driver Uart.
  678.  
  679.       If you have read the docs and still need help, call my BBS and leave
  680.       a message which fully describes the problem.
  681.       Please upload the following files:
  682.  
  683.       1. Any ERROR.LOG files created by MultiMenu.
  684.       2. MMENU.BAT - the batch file that runs MultiMenu.
  685.       3. MMENU.CFG - the configuration file.
  686.       4. DOOR.SYS, DORINFOx.DEF, or SFDOORS.DAT (whichever you use).
  687.  
  688.       I will post a reply message on my BBS for you within 24 hours.
  689.       FidoNet nodes may netmail the same information, and then poll for a
  690.       reply in 24 hours. I fully support both registered and unregistered
  691.       versions. Node 2 (203-922-1794  FidoNet 1:141/486) is dedicated
  692.       exclusively to handling support for my shareware. Traffic on this
  693.       node is very light, and it is almost always ready and waiting for
  694.       callers.
  695.  
  696.  
  697. ------- REGISTRATION ------------------------------------------------------
  698.  
  699.       This program is SHAREWARE with a registration fee of $20.00
  700.       (Twenty Dollars US).
  701.  
  702.       You may use this program for a free 30 day trial period. After that,
  703.       you must register it or stop using it. You may give away free copies
  704.       of this entire unmodified package, but you may not sell it. I retain
  705.       all rights to this program.
  706.  
  707.       As an incentive to encourage registration, the following features
  708.       are ONLY AVAILABLE IN THE REGISTERED VERSION:
  709.  
  710.       ■ The *** UNREGISTERED ***  message on the first screen is replaced
  711.         by your name and your BBS Name.
  712.  
  713.       ■ The unregistered version is limited to 9 doors numbered 1 to 9.
  714.         The registered version can run up to 254 doors numbered 1 to 254.
  715.  
  716.       ■ WELCOME, GOODBYE, CHAT, DROPDOS and BULLx files will be displayed
  717.         (optional).
  718.  
  719.       ■ Full logging of all caller activities. You can log activities to
  720.         your BBS log, or to a separate MultiMenu log.
  721.         In the unregistered version, only error conditions are logged.
  722.         No caller activity log is created in the unregistered version.
  723.  
  724.       HOW TO REGISTER:
  725.  
  726.       Please fill out and mail the form below to register the MultiMenu door
  727.       or call my BBS for fast online registration using your credit card.
  728.       I accept Visa, Mastercard, Carte Blanche, Diners' Club.
  729.       Call The Soft Parade BBS at:  203-922-1794  or  203-924-5603
  730.  
  731.       Registered Sysops are entitled to free program support, and free
  732.       access to all files and features on my BBS. Support is available from
  733.       me on my BBS, in FidoNet (Wildcat, PCBoard, or Spitfire echos),
  734.       Spitfire SF-NET (@SPITFIRE 3RD Conference) and via direct FidoNet
  735.       crash netmail. Suggestions for future improvements from registered
  736.       Sysops will receive careful consideration.
  737.  
  738.       When you register, you will receive a customized personal
  739.       registration key file and instruction file. The key file activates
  740.       the registered features in the shareware version, so there will be no
  741.       need to download any specially compiled versions of the executable
  742.       program itself.
  743.  
  744.       Please be sure to specify your name and your BBS name exactly as you
  745.       would like them to appear on the first door screen.
  746.  
  747.       ---------------------------------------------------------
  748.       ---------------------------------------------------------
  749.       ---------------------------------------------------------
  750.  
  751.                    MultiMenu 1.00 Door REGISTRATION FORM
  752.  
  753.       Your Name: ______________________________________________
  754.  
  755.       BBS Name:  ______________________________________________
  756.  
  757.       Address:   ______________________________________________
  758.  
  759.       Address:   ______________________________________________
  760.  
  761.       BBS Phone Number: ________________
  762.  
  763.       Please answer the following if you want to charge your registration:
  764.  
  765.       Credit Card Type: _____________________
  766.  
  767.       Name as it appears on the card: _______________________________
  768.  
  769.       Credit Card Number: ___________________________________________
  770.  
  771.       Expiration Date: _______  Voice Phone Number: _________________
  772.  
  773.       Please choose ONE of the following registration options:
  774.  
  775.       ___ $20 (Twenty Dollars)
  776.           Call Mike Robinson's BBS and download your registration file.
  777.           I will establish an account for you in advance if you give the
  778.           following logon information:
  779.  
  780.           Password to use on  Mike Robinson's BBS: _____________________
  781.  
  782.           BirthDate to use on Mike Robinson's BBS: _____________________
  783.  
  784.       ___ $25 (Twenty Five Dollars) - First Class Mail anywhere in the world.
  785.           I will mail your registration to you. Specify floppy disk type.
  786.           3.5 inch HD will be used if not otherwise specified.
  787.  
  788.       ___ $25 (Twenty Five Dollars) - USA and CANADA ONLY.
  789.           Mike Robinson will call your BBS and upload your registration to
  790.           you or he will NetMail your registration to your FidoNet address.
  791.           BBS phone number or FidoNet Address:
  792.  
  793.       ---------------------------------------------------------
  794.       ---------------------------------------------------------
  795.       ---------------------------------------------------------
  796.  
  797.       Send this form and payment in US DOLLARS to:
  798.  
  799.           Michael Robinson
  800.           909 BRIDGEPORT AVE #102
  801.           Shelton, CT. 06484-4386
  802.  
  803.       I accept Visa, Mastercard, Carte Blanche, Diners' Club,
  804.       personal check, bank check, or money orders.
  805.       Checks must be from a bank or financial institution with
  806.       a cashing address within the USA listed on the front of the
  807.       check. Most major banks in other countries can issue such an
  808.       international money order or international bank check.
  809.  
  810.       InterNet  Mike.Robinson@485.n141.z1.fidonet.org
  811.       InterNet  Mike.Robinson@486.n141.z1.fidonet.org
  812.       ╔════════════════════════════════════════════════╗
  813.       ║  * The Soft Parade - Shelton Connecticut USA * ║
  814.       ║  * Home of MultiMenu, EZ-ROM & SF-ROM Doors  * ║
  815.       ║  * Online Registration using Visa/Mastercard * ║
  816.       ╚════════════════════════════════════════════════╝
  817.       Node 1  203-924-5603  FidoNet 1:141/485  General Public Access
  818.       Node 2  203-922-1794  FidoNet 1:141/486  MultiMenu Support Only
  819.       FidoNet File Request MMENU for latest version.
  820.       Support and Online Registration available on both nodes.
  821.       Node 2 is for door support only and is rarely busy.
  822.  
  823.       Legal Stuff:
  824.       Use this program at your own risk. No guarantees of any sort.
  825.       File sharing and locking implemented via BCSHARE Beta Version 0.7
  826.       Copyright (C) By Mike Woltz 1990 Buffalo Creek Software.
  827.  
  828.       MultiMenu Revision History
  829.       Version 1.00 -- July 24, 1994 - Initial Public Release
  830.  
  831.       *******************************************************************
  832.  
  833.       OTHER SHAREWARE PROGRAMS BY MIKE ROBINSON:
  834.  
  835.       * EZ-ROM CD-ROM Door for ANY BBS that creates DOOR.SYS or DORINFO?.DEF
  836.       FidoNet file request EZROM for latest version.
  837.       EZ-ROM is a file access and download door. Includes a unique internal
  838.       database that tracks and limits downloads and requests on ANY BBS.
  839.       Files may be located on CD-ROM disk or magnetic disk, up to 100
  840.       disks, up to 500 file areas per disk, requests from offline disks,
  841.       full multi-node and network support, batch downloads, file tagging,
  842.       fast text search single or all disks, ZIP and text file viewer,
  843.       insertion of BBS ads into ZIP files, Pioneer multi-disk changer
  844.       support, maintains it's own user/download/request database, automatic
  845.       request manager/editor program, user manager/editor program,
  846.       configurable user limits, chat mode, local drop to DOS, and
  847.       multitasker aware. Can be run in local copy-to-hardrive mode in the
  848.       BBS or from the DOS command line. Includes special support for
  849.       Wildcat BBS so that the number of files/bytes downloaded are recorded
  850.       in the main Wildcat database. The number of files/bytes downloaded is
  851.       also written to DOOR.SYS for those systems that are able to read back
  852.       DOOR.SYS. Fast online registration.
  853.  
  854.       * SF-ROM CD-ROM Door for Spitfire BBS
  855.       FidoNet file request SFROM for latest version.
  856.       SF-ROM is a file access and download door specially designed for use
  857.       on Spitfire 3.x BBS. It can track the number of files/bytes
  858.       downloaded, enforce daily limits, and then record this information in
  859.       the main Spitfire database. Files may be located on CD-ROM disk or
  860.       magnetic disk, up to 100 disks, up to 500 file areas per disk,
  861.       requests from offline disks, full multi-node and network support,
  862.       batch downloads, file tagging, fast text search single or all disks,
  863.       ZIP and text file viewer, insertion of BBS ads into ZIP files,
  864.       Pioneer multi-disk changer support, maintains it's own
  865.       user/download/request database, automatic request manager/editor
  866.       program, user manager/editor program, configurable user limits, chat
  867.       mode, local drop to DOS, and multitasker aware. Can be run in local
  868.       copy-to-hardrive mode in the BBS or from the DOS command line.
  869.       Fast Online registration.
  870.  
  871.       *******************************************************************
  872.  
  873.       PKZIP archive security notice for this archive should read:
  874.       Authentic files Verified!   # FEZ251
  875.       MICHAEL N. ROBINSON
  876.  
  877.  
  878.  
  879.