home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / bbsdoor / sfrom120.zip / SFROM.DOC < prev    next >
Text File  |  1993-03-07  |  48KB  |  992 lines
  1.  
  2.                               SF-ROM DOOR
  3.                               Version 1.20
  4.                           Released March 7, 1993
  5.  
  6.                  Copyright (C) 1992-1993 by Mike Robinson
  7.  
  8.                             The Soft Parade
  9.                         Shelton, Connecticut, USA
  10.                              203-924-5603
  11.  
  12. ------- OVERVIEW ------------------------------------------------------------
  13.  
  14.         SF-Rom Door is a file access and download door designed for use on
  15.         Spitfire 3.x BBS. Files may be located on CD-ROM disks, magnetic
  16.         disks, or both. It provides browsing, text search and download
  17.         capabilities from within the door. It can even track the number of
  18.         files/bytes downloaded, enforce daily limits, and then record this
  19.         information in the main Spitfire database. A Spitfire SFFILES.BBS
  20.         type of file list is required for each file area. The door can be
  21.         run from the door menu or any of the menu extensions. This version
  22.         adds support for multiple CD-ROM disks.
  23.  
  24.         SF-Rom can also serve as a very configurable menu extension. From
  25.         the same main menu a caller can choose from a selection of CD-ROM
  26.         disks, magnetic disk file areas, and external doors. These may be
  27.         used in any combination. When an external door is chosen, SF-Rom
  28.         exits with an ErrorLevel which is then used in a batch file to pass
  29.         control to the selected external door.
  30.  
  31.         Right from the beginning this door was designed and optimized for
  32.         speed. And it is FAST. A file search of a 500 megabyte CD-ROM disk
  33.         takes only a few seconds.
  34.  
  35.         Speed is especially important to those who run multiple nodes
  36.         and/or multiple CD-ROM drives such as the Pioneer DRM-600
  37.         "six pack." Considerable time and energy was spent working around
  38.         the speed limitations of today's CD-ROM drives.
  39.         Actual CD-ROM drive hardware access time has been minimized by:
  40.  
  41.         1. Maintaining the file lists on the magnetic drive. This is
  42.            optional. If the CD-ROM itself contains file lists, these can be
  43.            be accessed directly by the door in order to save hard drive
  44.            space.
  45.  
  46.         2. Copying the file to a holding directory on the hard drive and
  47.            downloading it from there. This is also optional. You can
  48.            configure the door to download directly from the CD-ROM drive.
  49.  
  50.         3. Careful design of the the door logic. The CD-ROM drive hardware
  51.            is accessed as rapidly as possible and only when absolutely
  52.            required.
  53.  
  54.  
  55. ------- FEATURES ------------------------------------------------------------
  56.  
  57.         ■ Multiple disk support for up to 100 disks. Up to 1000 separate
  58.           file areas per disk. No external menu program required. In fact,
  59.           SF-Rom can now also be used as a menu extension. It will display
  60.           menus and terminate with an ErrorLevel. You can combine CD-ROMs
  61.           and other doors on the same menu. Disks can be put on/off line by
  62.           setting one value in the configuration file. Offline disks look
  63.           the same as online except no downloads. MegaSearch feature can
  64.           search ALL disks for matching text. Separate custom access
  65.           control for each disk can be set greater than, less than, or
  66.           equal to caller security level. This sets which levels can get
  67.           into each disk. In addition, any number of specific security
  68.           levels can be set for each disk to allow browse-only access with
  69.           no downloads.
  70.  
  71.         ■ Batch downloads and file tagging of up to 20 files.
  72.  
  73.         ■ Local browse and copy to hard drive mode. Also copies the
  74.           complete description line to SFFILES.BBS.
  75.  
  76.         ■ Number of files/bytes downloaded is recorded in the Spitfire
  77.           main database and daily download limits are enforced.
  78.           (This feature is NOT available in unregistered versions.)
  79.  
  80.         ■ Multi-colored file lists just like seen in Spitfire 3.2 & 3.3.
  81.           Now supports Spitfire style multi-line descriptions using
  82.           the smiley face  (ASCII 02) character.
  83.  
  84.         ■ Run as a door or menu extension using SFDOORS.DAT, SFFILE.DAT,
  85.           SFMESS.DAT or SFMAIN.DAT. Low memory requirements. Only uses
  86.           about 180 kilobytes, which includes the memory required for the
  87.           DSZ external protocol.
  88.  
  89.         ■ Caller time in door is limited to remaining time allowed on BBS.
  90.           (This feature is available in ALL versions.)
  91.  
  92.         ■ Complete logging of all caller activity.
  93.           (This feature is NOT available in unregistered versions.)
  94.  
  95.         ■ Download from within door using Xmodem, Ymodem or Zmodem.
  96.           A copy of DSZ.COM or DSZ.EXE by Omen Technology Incorporated
  97.           is required. Zmodem MobyTurbo is supported.
  98.  
  99.         ■ Very rapid text search of both file names and descriptions.
  100.           Matches are highlighted in color.
  101.  
  102.         ■ File sharing and locking for multinode and network operation. All
  103.           file lists, menus, data files and logs may be shared. DOS version
  104.           3.0 or higher, with DOS SHARE installed, is required for proper
  105.           operation of file sharing and locking. Special collision
  106.           avoidance for multi-node and multi-disk. Prevents "thrashing" on
  107.           Pioneer multi-disk changer CD-ROM drives.
  108.  
  109.         ■ Automatically uses Spitfire's communication port settings.
  110.           Comm port speeds to 115,200 bps with hardware or software flow
  111.           control. Uses Spitfire's configured port speed, data bits, stop
  112.           bit, parity, comm port, I/O port and interrupt. Handles any UART.
  113.           Does not require or use a FOSSIL driver, but is compatible with a
  114.           FOSSIL if one is installed.
  115.  
  116.         ■ Reads DAILYLMT.DAT to determine allowable downloads per day.
  117.  
  118.         ■ The door will recognize caller connect speeds of 0, 300, 1200,
  119.           2400, 4800, 7200, 9600, 12000, 14400, 16800, 19200.
  120.           It will use the value passed by Spitfire in SFDOORS.DAT line 5
  121.           to calculate the estimated download times. Note that sometimes
  122.           this value is incorrect. Some systems connect at 12000, 14400,
  123.           or 16800 but "lie" and tell Spitfire that the connect is 9600.
  124.           The good news is that the door now factors in a speed
  125.           increase due to error correction.
  126.  
  127.         ■ Carrier detection. Resets the BBS if caller drops carrier.
  128.  
  129.         ■ Inactivity timeout configurable from 1 to 10 minutes.
  130.  
  131.         ■ Multitasker aware. Releases time slices (clock tics) to tasks
  132.           running in other windows when SF-Rom is idle.
  133.           These multitaskers are automatically detected and supported:
  134.  
  135.           Windows 3.x & NT
  136.           DESQview 2.xx
  137.           DoubleDOS
  138.           VMiX 2.xx
  139.           MultiDos Plus 4.xx
  140.           OS/2 2.0
  141.           DOS 5.0 Task Switcher and Compatibles
  142.           TaskView, TopView, OmniView, & Compatibles
  143.  
  144.         ■ Runs locally inside of Spitfire (where baud rate = 0).
  145.           Local browse and copy to hard drive mode available when
  146.           run in Spitfire and also when run local from the command line.
  147.  
  148.         ■ Detailed status lines visible on top of local screen.
  149.           Shows caller name, statistics, time left, etc.
  150.  
  151.         ■ Detailed status screen displayed during download.
  152.           Shows caller's entire download/upload history and more.
  153.  
  154.         ■ Sysop local keyboard controls same as Spitfire:
  155.  
  156.               ALT+C --- Chat Mode On/Off
  157.               ALT+D --- Drop To DOS (local sysop only)
  158.               ALT+J --- Drop To DOS (local sysop only)
  159.               F6 ------ Take Five Minutes From Caller
  160.               F7 ------ Give Five Minutes To Caller
  161.               F10 ----- Exit The Door
  162.               ALT+F1 -- Exit The Door
  163.               ALT+F2 -- Exit The Door
  164.               ALT+K --- Kill. Throw the caller off the BBS *NOW*
  165.  
  166.         ■ ANSI color or plain ASCII text modes. Initial mode is the same as
  167.           passed by Spitfire. Caller can toggle ANSI on/off from within the
  168.           door. Door contains its own ANSI driver and can show ANSI
  169.           graphics on the local screen even if DOS ANSI.SYS is not loaded.
  170.  
  171.         ■ Sysops can design their own (optional) custom screens.
  172.           Door will display WELCOME.CLR or WELCOME.BBS before it runs.
  173.           (Available in registered versions only).
  174.           Place these in the same directory as SFROM.EXE.
  175.           If ANSI is on then the .CLR file will be shown, otherwise
  176.           the .BBS file will be shown.
  177.  
  178.         ■ Several configuration options:
  179.           Optional logoff after transfer.
  180.           Optional time penalty for dropped carrier.
  181.           Configurable number of lines displayed per page.
  182.           Can now specify the character used in determining which lines
  183.           in a file list contain a valid file for tagging and display
  184.           purposes.
  185.           Configurable activity log format.
  186.  
  187.         ■ DSZmodem is "trapped" inside a window so that data does not
  188.           scroll up off screen as download progresses.
  189.  
  190.  
  191.  
  192. ------- SETUP for SINGLE-DISK MODE ------------------------------------------
  193.  
  194.         1. Unzip this archive into one subdirectory.
  195.            This will be the SF-Rom home directory.
  196.  
  197.         2. Modify the included SFROM.CFG file to meet your needs.
  198.            See CONFIGURATION VERBS below for description of each option.
  199.            Any line in SFROM.CFG that does not begin with a letter is
  200.            ignored. The lines that begin with semicolons, for example, are
  201.            used for comments and ignored by the program. Keep this file in
  202.            the SF-Rom home directory.
  203.  
  204.         3. Modify the included DISK.CLR and DISK.BBS to meet your needs.
  205.            These two files are the list of file areas on the disk and are
  206.            mandatory or the program will not run. Try to keep these to
  207.            under 21 displayed lines or the top may scroll off the screen.
  208.            Additional options for these files are described below.
  209.            Keep these files in the SF-Rom home directory.
  210.  
  211.         4. Make sure a copy of DSZ.COM or DSZ.EXE is somewhere on your DOS
  212.            path or in the SF-Rom home directory.
  213.  
  214.         5. (OPTIONAL) Place custom screens in the SF-Rom home directory.
  215.            Registered versions will display WELCOME.CLR or WELCOME.BBS if
  216.            these files exist.
  217.            All versions will display GOODBYE.CLR or GOODBYE.BBS after a
  218.            download if the caller selects log off after transfer.
  219.  
  220.         6. Run the program using these commands:
  221.  
  222.            CD C:\SF\SFROM
  223.            SFROM  C:\SF\SFFILE.DAT  C:\SF\SFROM\SFROM.CFG
  224.  
  225.            The complete paths and file names must be specified.
  226.            Spitfire creates one of the following files when a door
  227.            or menu extension is executed. Any one of these may be used
  228.            in place of SFFILE.DAT in the above example:
  229.  
  230.            SFFILE.DAT    File menu extension
  231.            SFMAIN.DAT    Main menu extension
  232.            SFMESS.DAT    Message menu extension
  233.            SFDOORS.DAT   Door menu
  234.  
  235.  
  236. ------- SETUP for MULTI-DISK MODE ------------------------------------------
  237.  
  238.         1. Unzip this archive into one subdirectory.
  239.            This will be the SF-Rom home directory.
  240.            You only need one copy of SFROM.EXE and it must be kept here.
  241.  
  242.         2. Modify the included SFROM.MAS file to meet your needs.
  243.            See CONFIGURATION VERBS below for description of each option.
  244.            This is the master file that sets the configuration and location
  245.            for all of the disks. Any line in SFROM.MAS that does not begin
  246.            with a letter is ignored. The lines that begin with semicolons,
  247.            for example, are used for comments and ignored by the program.
  248.            Keep this file in the SF-Rom home directory.
  249.  
  250.         3. Create a separate subdirectory for each of your CD-ROM disks.
  251.            The general arrangement should look something like this:
  252.                             ┌──────────────┐
  253.                             │ SFROM.EXE    │ SF-Rom home directory
  254.                             │ SFROM.MAS    │
  255.                             │ MAIN.BBS/CLR │
  256.                             └───────┬──────┘
  257.                                     │
  258.                   ┌─────────────────┼─────────────────┬────── - - - etc.
  259.            ┌──────┴───────┐  ┌──────┴───────┐  ┌──────┴───────┐
  260.            │ SFROM.CFG    │  │ SFROM.CFG    │  │ SFROM.CFG    │
  261.            │ DISK.BBS/CLR │  │ DISK.BBS/CLR │  │ DISK.BBS/CLR │
  262.            │ FILELISTS    │  │ FILELISTS    │  │ FILELISTS    │
  263.            └──────────────┘  └──────────────┘  └──────────────┘
  264.             subdirectory      subdirectory       subdirectory
  265.             for disk 1        for disk 2         for disk 3
  266.  
  267.         4. Copy SFROM.CFG to each of the disk subdirectories. This is the
  268.            configuration file for that disk and must be modified to suit
  269.            that disk. SFROM.CFG must contain the disk name and all the
  270.            paths to the files and lists for that disk. This is all that
  271.            MUST be included, any of the other settings are optional, but
  272.            they will be applied if they are there.
  273.  
  274.         5. Copy DISK.BBS and DISK.CLR to each of the disk subdirectories.
  275.            This is the display menu showing the file areas available on the
  276.            disk and must be modified to suit the disk. Try to keep these to
  277.            under 21 displayed lines or the top may scroll off the screen.
  278.            Addition options for these files are described below.
  279.  
  280.         4. Make sure a copy of DSZ.COM or DSZ.EXE is somewhere on your DOS
  281.            path or in the SF-Rom home directory.
  282.  
  283.         5. (OPTIONAL) Place custom screens in the SF-Rom home directory.
  284.            Registered versions will display WELCOME.CLR or WELCOME.BBS if
  285.            these files exist.
  286.            All versions will display GOODBYE.CLR or GOODBYE.BBS after a
  287.            download if the caller selects log off after transfer.
  288.  
  289.         6. Run the program using these commands:
  290.  
  291.            CD C:\SF\SFROM
  292.            SFROM  C:\SF\SFFILE.DAT  C:\SF\SFROM\SFROM.MAS
  293.  
  294.            SF-Rom runs multi-disk mode if config file extension is .MAS.
  295.            (Single-disk mode is selected by using extension .CFG)
  296.            The complete paths and file names must be specified.
  297.            Spitfire creates one of the following files when a door
  298.            or menu extension is executed. Any one of these may be used
  299.            in place of SFFILE.DAT in the above example:
  300.  
  301.            SFFILE.DAT    File menu extension
  302.            SFMAIN.DAT    Main menu extension
  303.            SFMESS.DAT    Message menu extension
  304.            SFDOORS.DAT   Door menu
  305.  
  306.  
  307. ------- LOCAL MODE ---------------------------------------------------------
  308.  
  309.            SF-Rom may be run in local mode if you log onto Spitfire
  310.            locally. It may also be run in local mode from the DOS
  311.            command line:
  312.  
  313.            CD C:\SF\SFROM
  314.            SFROM  LOCAL
  315.  
  316.            If SFROM.MAS is found in the current directory, then multi-disk
  317.            mode is selected. If SFROM.CFG is found, then single-disk mode
  318.            is run. Local mode allows you to browse the lists, tag files,
  319.            and copy the files (and descriptions) to the hard drive.
  320.  
  321.  
  322. ------- CONFIGURATION VERBS -------------------------------------------------
  323.  
  324.            Configuration verbs are used in SFROM.CFG for both single-disk
  325.            mode and multi-disk mode. The program reads each line and if it
  326.            begins with a configuration verb, then the configuration is
  327.            modified as directed by the verb. If a line begins with
  328.            anything other than a letter, it is ignored. The explanatory
  329.            comments are on lines beginning with a semicolon and are
  330.            therefore ignored. The verbs are NOT case sensitive, but they
  331.            must be spelled correctly. The order of the lines is generally
  332.            not important except for the DISKS and AREAS verbs.
  333.  
  334.            For multi-disk mode, many of the same configuration verbs are
  335.            also used in SFROM.MAS. The configuration verbs in SFROM.MAS are
  336.            read into memory when the program starts. When a disk is
  337.            selected by the caller, the SFROM.CFG file for that disk is
  338.            read. When returning to the main menu from a disk menu, program
  339.            startup values are restored from memory. Most of the
  340.            configuration verbs can be set in either (or both) the master
  341.            SFROM.MAS or the disk specific SFROM.CFG. The values in the
  342.            master prevail when the program is at the first menu. The values
  343.            for each disk prevail whenever that disk is loaded or read.
  344.  
  345.  
  346.            DISKNAME So Much Shareware 2
  347.  
  348.            This verb is only used in SFROM.CFG and has no effect in
  349.            SFROM.MAS. This name is used in the local status bar display on
  350.            the top of the screen and in the door log entries.
  351.  
  352.  
  353.            COPYTOMAG ON
  354.            COPYTOMAG OFF
  355.  
  356.            Choose one. If CopyToMag ON then files will be copied to the
  357.            magnetic hard drive just before downloading. These files will
  358.            then be erased once the download is completed. If CopyToMag OFF
  359.            then the files will be downloaded directly from the CD-ROM
  360.            drive. Default is CopyToMag ON
  361.  
  362.  
  363.            HOLDDIR  C:\SF\CD-HOLD
  364.  
  365.            This is the holding directory where the files are copied to if
  366.            CopyToMag is ON. The program also stores the batch download file
  367.            list here in all cases. The program takes care of its own
  368.            housekeeping and deletes the copied files after the download.
  369.            Just the copied files are deleted. Any other files that exist in
  370.            this directory will NOT be deleted. In local mode, the files are
  371.            also copied here and the descriptions are added to an
  372.            SFFILES.BBS in this subdirectory. If no SFFILES.BBS exists, one
  373.            is created. The default is the root directory C:\.
  374.  
  375.  
  376.            LOGNAME  C:\SF\CALLERS.TMP
  377.  
  378.            Registered versions only. Gives the name of the caller activity
  379.            log file. The default is CALLERS.TMP in the Spitfire home
  380.            directory for this node as defined in SFFILE.DAT or equivalent.
  381.  
  382.  
  383.            LOG ON
  384.            LOG OFF
  385.  
  386.            Choose one. Turns call log ON or OFF.
  387.            In unregistered versions the log is forced OFF.
  388.            In registered versions the default is Log ON.
  389.            In local mode the log is forced OFF.
  390.  
  391.  
  392.            SHARE ON
  393.            SHARE OFF
  394.  
  395.            Choose one. Turns file sharing and locking ON or OFF. File
  396.            sharing is generally not required on a single-node BBS. This
  397.            program will run much faster with Share OFF. The default is
  398.            Share ON.
  399.  
  400.  
  401.            TIMEOUT 180
  402.  
  403.            This is the caller inactivity timeout delay in SECONDS. If no
  404.            keystrokes are received for this length of time, the door will
  405.            exit and return the caller to the BBS. Values from 60 to 600
  406.            seconds are allowed. The default is 180 seconds (3 minutes).
  407.  
  408.  
  409.            DEBUG ON
  410.            DEBUG OFF
  411.  
  412.            Choose one. Most program error conditions are logged to
  413.            SFROM.LOG if Debug is turned on. The program may load a bit
  414.            faster if you turn this off. If you are experiencing
  415.            difficulties, leave Debug ON. The default is Debug ON.
  416.  
  417.  
  418.            DIRECTVIDEO ON
  419.            DIRECTVIDEO OFF
  420.  
  421.            Choose one. With DirectVideo ON, all local screen writes will
  422.            done directly to video memory instead of through the BIOS. The
  423.            default is DirectVideo ON. This seems to work fine on most
  424.            systems.
  425.  
  426.  
  427.            CHECKSNOW ON
  428.            CHECKSNOW OFF
  429.  
  430.            Choose one. CheckSnow ON enables "snow checking" when using
  431.            DirectVideo ON. It has no effect if DirectVideo OFF. Some older
  432.            CGA monitors may requires this. It should not be a problem on
  433.            most monochrome, EGA or VGA video systems. Some systems may run
  434.            a bit faster with CheckSnow OFF. The default is CheckSnow ON.
  435.  
  436.  
  437.            BIOSSCROLL ON
  438.            BIOSSCROLL OFF
  439.  
  440.            Choose one. If BiosScroll OFF, then a special scrolling routine
  441.            is used that suppresses snow and flicker on systems with any
  442.            kind of color graphics. However, BiosScroll ON is a bit faster.
  443.            The default is BiosScroll ON.
  444.  
  445.  
  446.            DROPPENALTY 300
  447.  
  448.            Number of SECONDS to penalize the caller if carrier is dropped
  449.            when in the door. This time will be subtracted from the callers
  450.            time allowed during the next call that day. If the caller does
  451.            not call back until the next day, then this penalty will have no
  452.            effect. Values from 0 to 7200 seconds (0 to 120 minutes) are
  453.            allowed. The default is 300 seconds (5 minutes).
  454.  
  455.  
  456.            ALLOWLOGOFF ON
  457.            ALLOWLOGOFF OFF
  458.  
  459.            If AllowLogOff ON then the caller will be offered the option to
  460.            select unattended automatic logoff after each download. If you
  461.            allow logoff then you can place a copy of your desired logoff
  462.            display screen(s) in the SF-Rom home directory. This is
  463.            optional. If this screen exists, it will be shown only after an
  464.            automatic logoff. I use my normal BBS GOODBYE.BBS/CLR.
  465.            The default is AllowLogOff ON.
  466.  
  467.  
  468.            LINESPERPAGE 21
  469.  
  470.            Determines the number of lines shown for each screen page when
  471.            the caller is scrolling through the file lists. Values from 5 to
  472.            30 lines per page are allowed. The default is 21 lines per page.
  473.  
  474.  
  475.            TAGCHAR 26 -
  476.  
  477.            This determines the line position and character used to
  478.            determine which lines in a file list contain a valid file for
  479.            tagging and display purposes. Lines which contain this exact
  480.            character at this exact position are colorized and assigned a
  481.            tag letter. Lines which do NOT contain this character at this
  482.            position are assumed to be header lines or extended description
  483.            lines. This option allows the use off many different styles of
  484.            file lists.
  485.            The default is a dash at position 26 as shown below:
  486.  
  487. ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+
  488. SFROM120.ZIP   75,085  03-07-93  Spitfire CD-ROM Door 1.20 by Mike Robinson
  489.                          ^
  490.                          character at position (column) 26 is a dash
  491.  
  492.            Examples of common file formats:
  493.            TagChar 26 -   (tag lines with a dash at position 26) (default)
  494.            TagChar 28 -   (tag lines with a dash at position 28)
  495.            TagChar 26 /   (tag lines with a forward slash at position 26)
  496.            TagChar 28 /   (tag lines with a forward slash at position 28)
  497.            TagChar 18 ,   (tag lines with a comma at position 18 )
  498.  
  499.            Only one character and position may be designated as the
  500.            TagChar. If multiple TagChar are specified in SFROM.CFG then the
  501.            last TagChar specified is used.
  502.  
  503.  
  504.            TOTALDOWN ON
  505.            TOTALDOWN OFF
  506.  
  507.            Updates the Spitfire global record of how many downloads today.
  508.            This is the value seen by callers during logon.
  509.            TotalDown is forced off in the unregistered version.
  510.            The default is TotalDown Off.
  511.  
  512.  
  513.            NODOWNLOAD 10 15 20
  514.  
  515.            This sets no download status for listed security levels.
  516.            In the example shown above security levels 10, 15 and 20 are not
  517.            allowed to download. Up to 20 levels can be set on one
  518.            NoDownLoad line. Use as many lines as your require, each line
  519.            beginning with NoDownLoad. If running multi-disk and this verb
  520.            is set in SFROM.MAS, then it applies to all disks. If set in
  521.            SFROM.CFG then it applies to just one disk. The value in
  522.            SFROM.CFG prevails.
  523.  
  524.  
  525.            AREAS
  526.            E:\GAMES1   C:\SF\CDROM1\01.LST
  527.            E:\GAMES2   C:\SF\CDROM1\02.LST
  528.            E:\EDUCATE  C:\SF\CDROM1\03.LST
  529.            E:\MUSIC    C:\SF\CDROM1\04.LST
  530.            E:\GRAPHICS C:\SF\CDROM1\05.LST
  531.            E:\CLIPART  C:\SF\CDROM1\06.LST
  532.            E:\GIFS     C:\SF\CDROM1\07.LST
  533.            E:\HOBBY    C:\SF\CDROM1\08.LST
  534.            AREAS
  535.  
  536.            The AREAS configuration verb is a special case. It is only used
  537.            in SFROM.CFG, but it is used for both single-disk mode and
  538.            multi-disk mode. It is used to signify both the beginning and
  539.            end of a list of file areas. The example above shows 6 file
  540.            areas, but you can have as many as 1000 file areas per disk.
  541.            There must be one area per line and they must be on consecutive
  542.            lines. The first line is file area number 1 and the rest follow
  543.            in order until you reach the end.
  544.            The list MUST BEGIN and END with the keyword "AREAS".
  545.            The list MUST BEGIN and END with the keyword "AREAS".
  546.            Each line has two entries separated by at least one blank space.
  547.            The first is the path to the file area on the CD-ROM. The second
  548.            is the full path and filename of the associated file list. The
  549.            list can have any filename, it does not have to be SFFILES.BBS.
  550.  
  551.            The file lists can be located on a normal magnetic hard disk or
  552.            on the CD-ROM (if they exist on the CD-ROM). The door will run
  553.            much faster if you locate the file lists on the normal magnetic
  554.            hard disk. Note that you can also use this door to access normal
  555.            file areas on your hard drive. You can mix normal file areas
  556.            with CD-ROM areas in the same door. The file areas do not have
  557.            to reside on the same drive letter or same physical drive. If
  558.            you have a network, you can access file areas on a different
  559.            machine. You could even put ALL of your Spitfire file areas in
  560.            one or more of these doors. For example, you could put adult
  561.            files in one door and restrict access to adults only. Or you
  562.            could have special file doors reserved for privileged,
  563.            contributing or subscribing callers.
  564.  
  565.            The example above is a portion of the sample SFROM.CFG supplied
  566.            in this package. It is for the "So Much Shareware 2" CD-ROM disk
  567.            first published in September 1992. The file lists are resident
  568.            on the CD-ROM as SFFILES.BBS in each subdirectory and can be
  569.            easily copied to a hard drive.
  570.  
  571.  
  572.  
  573.            DISKS
  574.            1   ON   >5   0   C:\SF\CDROM1\SFROM.CFG
  575.            2   ON   <30  0   C:\SF\CDROM2\SFROM.CFG
  576.            3   ON   =20  0   C:\SF\CDROM3\SFROM.CFG
  577.            4   OFF  >5   0   C:\SF\CDROM4\SFROM.CFG
  578.            5   ON   >5   20
  579.            6   ON   >5   0   C:\SF\CDROM6\SFROM.CFG
  580.            DISKS
  581.  
  582.            The DISKS configuration verb is a special case. It is only used
  583.            in SFROM.MAS and is for multi-disk mode only. It is used to
  584.            signify both the beginning and end of a list of disks. The
  585.            example above shows 6 disks, but you can have as many as 100.
  586.            There must be one disk per line and they must be on consecutive
  587.            lines.
  588.            The list MUST BEGIN and END with the keyword "DISKS".
  589.            The list MUST BEGIN and END with the keyword "DISKS".
  590.  
  591.            COLUMN 1 is the key character that the caller uses to select the
  592.               disk. Number 1 to 6 are shown, but any almost any single
  593.               character may be used. This includes letters, numbers and
  594.               symbols. Letters must be uppercase. Do not use the letters K,
  595.               Q, and S since these are used to select options on the SF-Rom
  596.               main menu. Do not use numbers greater than 9 since these
  597.               require more than one character.
  598.            COLUMN 2 shows if door is ON or OFF line. If OFF, the disk is
  599.              browse-only with no downloads allowed.
  600.            COLUMN 3 shows the security level required to enter the disk.
  601.              For example if it is set to:
  602.              >5   (only security levels greater than 5 may enter)
  603.              <30  (only security levels less than 30 may enter)
  604.              =20  (only security level equal to 20 may enter)
  605.              There must be no spaces between the symbol and the level
  606.              number.
  607.            COLUMN 4 is the type. Set this to 0 for a CD-ROM disk. Set it
  608.              any value between 10 and 255 and SF-Rom will terminate with
  609.              this ErrorLevel when this door is selected by the caller. This
  610.              allows SF-Rom to be used like an external menu program. In
  611.              this case, you need to catch and respond to these ErrorLevels
  612.              in the batch file that runs SF-Rom. CD-ROM disks and external
  613.              doors may be combined freely in the same menu. A normal SF-Rom
  614.              exit where no door or disk is selected is ErrorLevel 0.
  615.              Internal errors in SF-Rom exit with ErrorLevel 1. Do not set
  616.              ErrorLevels 1 to 9 as these are reserved for future use.
  617.            COLUMN 5 is the full path and file name of the SFROM.CFG used
  618.              for each CD-Rom disk. Create a separate subdirectory for each
  619.              disk. Place all the files for that particular disk in the same
  620.              subdirectory along with the SFROM.CFG for that disk. Column 5
  621.              is blank if this line indicates an external door.
  622.  
  623.  
  624.  
  625.            STYLE 1
  626.            STYLE 2
  627.            STYLE 3
  628.  
  629.            Choose one of the style commands shown above. Determines the
  630.            style of the download line in the caller activity log entries in
  631.            registered versions only. Has no effect in unregistered
  632.            versions. Some third party utility programs read the callers log
  633.            and count or log downloads. These programs require certain
  634.            download log entry styles which are similar to those created by
  635.            a normal Spitfire download.
  636.  
  637.            Three styles are now offered. More will be added if requested.
  638.            Only one style may be used in each configuration file. If
  639.            multiple styles are specified, then the last one specified is
  640.            used.
  641.  
  642.            For Style 1 a typical log entry looks like this:
  643.            1800LIST.TXT    2,276  Listing Of 1-800 BBS Systems
  644.            This is the default style and is the same as all previous
  645.            versions of SF-Rom.
  646.  
  647.            For Style 2 a typical log entry looks like this:
  648.            Downloaded E:\MODEM\800LIST.TXT
  649.            Note that this is the path to the file on the CD-ROM.
  650.  
  651.            For Style 3 a typical log entry looks like this:
  652.            Downloaded C:\SF\CDROM1\800LIST.TXT
  653.            Note that this is the file name appended to the path
  654.            to the file list that contains the file.
  655.  
  656.  
  657.            BUSYFLAG C:\SF\CD-HOLD\DRIVE1.BSY
  658.  
  659.            For use in multi-disk mode. Optional. A semaphore marker file
  660.            system of collision protection is set by this verb. SF-Rom
  661.            checks for the existence of this busy flag file before each
  662.            CD-ROM read. If the file is there, then it waits until the other
  663.            node erases the file. SF-Rom creates this file whenever it
  664.            begins to read from the CD-ROM drive and erases this file when
  665.            the read is complete. The same busy flag name must be set for
  666.            each disk that uses the same drive.
  667.  
  668.  
  669.            FLAGDELAY 30
  670.  
  671.            For use in multi-disk mode. Optional. Sets the maximum time
  672.            in seconds that the door will wait for a busy CD-ROM drive.
  673.            The default is 30 seconds which means the door will wait for
  674.            up to 30 seconds before halting the attempted disk read
  675.            operation and sending a message of "please try again later."
  676.            The allowable range is 0 to 300 seconds.
  677.  
  678.  
  679.            DELOLDFLAG 30
  680.  
  681.            For use in multi-disk mode. Optional. When SF-Rom encounters a
  682.            busyflag, it checks it's age. If it is older than DELOLDFLAG in
  683.            minutes, then the flag is deleted. Only the flag declared by the
  684.            BusyFlag verb in the same configuration file is deleted. This is
  685.            a cleanup feature in case old flags are orphaned by a power
  686.            failure or other system problem. The default is 30 minutes which
  687.            means the door will delete any flag older than 30 minutes. The
  688.            system clocks on a network must be synchronized in order for
  689.            this verb to work properly. It is recommended that you set this
  690.            value to at least the maximum system time difference between any
  691.            2 network nodes. Remember that PC system clocks will drift out
  692.            of synchronization over time.
  693.            The allowable range is 5 to 720 minutes.
  694.  
  695.  
  696.            CHECKSIZE ON
  697.            CHECKSIZE OFF
  698.  
  699.            Choose one. For use in either multi-disk or single-disk mode.
  700.            Optional. The default is CheckSize ON.
  701.            If ON, then the CD-ROM drive will be read during file tagging
  702.            to determine if the file is actually there and it's size/date.
  703.            This is the same as in all previous versions.
  704.            If OFF, then the CD-ROM will not be read during file tagging.
  705.            The file size and date will be read from the file list.
  706.            This will speed up the tagging operation and reduce the load
  707.            on the CD-ROM drive on multi-node and networked systems.
  708.            OFF should work well if your file lists are in Spitfire format
  709.            and are accurate. Note that if the file size in the list is
  710.            wrong, a caller could exceed his daily byte or time limit.
  711.            If set OFF and a file size cannot be read from the list, then
  712.            a default size of 50 kilobytes is used. If this verb is used in
  713.            SFROM.MAS, then it applies to all disks. If used in SFROM.CFG,
  714.            it applies to just one disk.
  715.  
  716.  
  717.            SOFTFLOW
  718.  
  719.            Do not use this verb unless you are sure you need it. Flow
  720.            control is ALWAYS hardware (RTS/CTS) unless this verb is used.
  721.            It FORCES software flow control (XON/XOFF) and shuts off
  722.            hardware flow control. The Software Data Flow Control value
  723.            passed by Spitfire on line 19 in SFFILE.DAT is no longer used.
  724.            Hardware flow control is better and most modern modems support
  725.            it. Even if you are running Spitfire with hardware flow control
  726.            off, you should probably not use this verb. SF-Rom can usually
  727.            run with hardware flow control even if Spitfire is not using it.
  728.  
  729.  
  730.  
  731. ------- DISPLAY FILES -------------------------------------------------------
  732.  
  733.            In multi-disk mode, the following display files may be used
  734.            to show the list of available disks:
  735.  
  736.            ANSI                  ASCII
  737.            -----------           -----------
  738.            MAINxxx.CLR           MAINxxx.BBS
  739.            MAINxxx.BBS           MAIN.BBS
  740.            MAIN.CLR
  741.            MAIN.BBS
  742.  
  743.            The "xxx" shown above represents a security level. For example,
  744.            MAIN10.CLR is the ANSI menu for security level 10. SF-Rom
  745.            searches for the display files in the order indicated above.
  746.            If specific display files are not found for the caller's
  747.            security level, then the general MAIN.CLR/BBS files are shown.
  748.  
  749.            In both single-disk mode and multi-disk mode, the following
  750.            display files may be used to show the list of available
  751.            file areas on a specific disk:
  752.  
  753.            ANSI                  ASCII
  754.            -----------           -----------
  755.            DISKxxx.CLR           DISKxxx.BBS
  756.            DISKxxx.BBS           DISK.BBS
  757.            DISK.CLR              AREALIST.BBS
  758.            DISK.BBS
  759.            AREALIST.CLR
  760.            AREALIST.BBS
  761.  
  762.            The "xxx" shown above represents a security level. For example,
  763.            DISK150.BBS is the ASCII menu for security level 150. SF-Rom
  764.            searches for the display files in the order indicated above.
  765.            If specific display files are not found for the caller's
  766.            security level, then the general DISK.CLR/BBS files are shown.
  767.            The AREALIST.CLR/BBS files are included as a last choice for
  768.            compatibility with previous SF-Rom versions.
  769.  
  770.  
  771.            - MULTI-PAGE MENUS -
  772.  
  773.            You can also create a multi-page MAIN.CLR/BBS and/or
  774.            DISK.CLR/BBS. In this case, put all the pages in one file. Each
  775.            page should be no more than 21 displayed lines long and there
  776.            should be 4 blank lines between each page. The door will pause
  777.            at the end of each page and allow the caller to select a command
  778.            or scroll to the next page.
  779.  
  780.  
  781.  
  782. ------- REGISTRATION --------------------------------------------------------
  783.  
  784.         This is SHAREWARE. You may use this program for a free 30 day trial
  785.         period. After that, you must register it or stop using it.
  786.         You may give away free copies of this entire unmodified package,
  787.         but you may not sell it. I retain all rights to this program.
  788.  
  789.         As an incentive to encourage registration, the following features
  790.         are ONLY AVAILABLE IN THE REGISTERED VERSION:
  791.  
  792.         ■ The *** UNREGISTERED ***  message on the first screen is replaced
  793.           by your name and your BBS Name.
  794.  
  795.         ■ Spitfire's daily download file and byte limits will be enforced
  796.           by the door. The door will also record all downloads and add the
  797.           number of files and bytes downloaded to the main Spitfire data
  798.           base. So the caller's total daily downloads (sum of downloads
  799.           inside the door and normal Spitfire downloads) will never be more
  800.           than allowed by Spitfire in DAILYLMT.DAT. These limits are
  801.           correctly tracked in any combination, even if the caller enters
  802.           and exits the door several times. If Spitfire says a caller can
  803.           only grab 10 files per day, he will only be able to grab 10 files
  804.           total per day.
  805.  
  806.             example:
  807.             A caller is allowed 10 downloads per day. He downloads 3 files
  808.             in this door. He is then only allowed 7 more downloads when he
  809.             returns to Spitfire.
  810.  
  811.           In the unregistered version, only the caller's daily time limit
  812.           is enforced. In the unregistered version, downloads are not
  813.           recorded and file/byte per day limits are not enforced.
  814.  
  815.         ■ WELCOME.CLR or WELCOME.BBS file will be displayed (optional).
  816.  
  817.         ■ Full logging of all caller activities in the door to CALLERS.LOG
  818.           or any file you choose. These log entries are designed to blend
  819.           nicely with the normal Spitfire log entries.
  820.           Here is an example from the CALLERS.LOG on my BBS:
  821.         -----------------------------------------------------------------
  822.         John Smith called at 14:34:37 on 03-07-93 using Node 1 at 2400 baud.
  823.              Entered So Much Shareware at 14:35:51
  824.                1800LIST.TXT    2,276  Listing Of 1-800 BBS Systems
  825.                GOVTBBS.ZIP     3,781  List Of Gov't BBS Numbers
  826.                WHATPORT.ZIP    9,044  Handy To Find Conflicting COM Ports
  827.                Begin Zmodem at 14:39:20  Estimated Time:  1.1 Min.
  828.                End   Zmodem at 14:40:26     Actual Time:  1.1 Min.
  829.                Updated download records +3 file(s) and +15,101 bytes.
  830.              Exited  So Much Shareware SF-ROM Door at 14:41:05
  831.         John Smith logged off at 14:43:02
  832.         -----------------------------------------------------------------
  833.  
  834.         In the unregistered version, only error conditions are logged.
  835.         No caller activity log is created in the unregistered version.
  836.  
  837.         Registration is $20 (Twenty) US DOLLARS.
  838.         Personal check, bank check or money orders are acceptable.
  839.         Checks must be from a bank or financial institution with
  840.         a cashing address within the USA listed on the front of the
  841.         check. Most major banks in other countries can issue such an
  842.         international money order or international bank check.
  843.  
  844.         Registered Sysops are entitled to free program support, free
  845.         upgrades to all future versions, and free access to all files and
  846.         features on my BBS. Support is available from me on my BBS, in
  847.         CircuitNet and in FidoNet. Suggestions for future improvements from
  848.         registered Sysops will receive careful consideration.
  849.  
  850.         In order to register the program, you will have to call my BBS and
  851.         download your personal registration key and instruction file. This
  852.         key will work for all future versions, so there will be no need to
  853.         download any specially compiled versions of the executable program
  854.         itself.
  855.  
  856.         If you do not yet have access to my BBS, please be sure to send
  857.         along a password and birthdate with your registration. Then I can
  858.         set up your logon account in advance. Please be sure to specify
  859.         your name and your BBS name exactly as you would like them to
  860.         appear on the first door screen.
  861.  
  862.         Your personal registration key and instruction file will be
  863.         ready for you to download on the day I receive your check,
  864.         usually by 19:00 eastern time.
  865.  
  866.         Registrations will not be mailed.
  867.  
  868.         -------------------------------------------------------
  869.         -------------------------------------------------------
  870.         -------------------------------------------------------
  871.  
  872.                      SF-Rom 1.20 Door REGISTRATION FORM
  873.  
  874.         Your Name:
  875.         (40 characters maximum)
  876.  
  877.         BBS Name:
  878.         (40 characters maximum)
  879.  
  880.         BBS Phone Number:
  881.         (xxx-xxx-xxxx)
  882.  
  883.         Password to use on  Mike Robinson's BBS:
  884.         (14 characters maximum)
  885.  
  886.         BirthDate to use on Mike Robinson's BBS:
  887.         (mm-dd-yy)
  888.  
  889.         Your Address:
  890.  
  891.         Send this form and $20 (Twenty) US DOLLARS to:
  892.  
  893.         Michael Robinson
  894.         9 Richard Boulevard
  895.         Shelton, CT. 06484-4386
  896.  
  897.         Personal check, bank check or money orders are acceptable
  898.         and must be drawn on a bank in the USA.
  899.  
  900.         -------------------------------------------------------
  901.         -------------------------------------------------------
  902.         -------------------------------------------------------
  903.  
  904.         InterNet address:  Mike.Robinson@485.n141.z1.fidonet.org
  905.  
  906.         ╔═══════════════════╗ ╔══════════════════════╗ ╔═══════════════════╗
  907.         ║  The Soft Parade  ║ ║ Sysop: Mike Robinson ║ ║ 1200 to 16800 bps ║
  908.         ║  Shelton, CT. USA ║ ║ Spitfire version 3.3 ║ ║   HST   V.32bis   ║
  909.         ║   203-924-5603    ║ ║ Open 24 hours 7 days ║ ║  MNP 5   V.42bis  ║
  910.         ║ FidoNet 1:141/485 ║ ║  CircuitNet  203000  ║ ║ USR Dual Standard ║
  911.         ╚═══════════════════╝ ╚══════════════════════╝ ╚═══════════════════╝
  912.         Latest version of the SF-Rom Door may be File Requested (freq'ed)
  913.         by any Fido compatible mailer 24 hours a day using the
  914.         magic name: SFROM
  915.  
  916.         24 hour crash mail & file requests of any file listed in FILES
  917.         Magic Names: SFROM   EZROM   PMEISTER   CATCHEM   RATIO   FILES
  918.  
  919.         VALIDATE Version 0.4
  920.         Copyright (C) 1989-1992 by McAfee Associates.
  921.         File Name:  sfrom.exe
  922.              Size:  54,638
  923.              Date:  3-7-1993
  924.         File Authentication:
  925.         Check Method 1 - 306D
  926.         Check Method 2 - 1EB6
  927.  
  928.         PKZIP archive security notice for this archive should read:
  929.         Authentic files Verified!   # FEZ251
  930.         MICHAEL N. ROBINSON
  931.  
  932.         Legal Stuff:
  933.         Use this program at your own risk. No guarantees of any sort.
  934.         "SPITFIRE" is Copyright (C) 1987-1993 by Mike Woltz.
  935.         "SPITFIRE" is a registered trademark of Buffalo Creek Software.
  936.         File sharing and locking implemented via BCSHARE Beta Version 0.7
  937.         Copyright (C) By Mike Woltz 1990 Buffalo Creek Software.
  938.         DSZ program Copyright by Omen Technology Inc.
  939.  
  940.         SF ROM Revision History (abbreviated)
  941.         Version 1.00 -- May 31, 1992 - Initial Public Release
  942.         Version 1.10 -- Sep 05, 1992 - Added batch downloads & file tagging.
  943.         Version 1.15 -- Oct 10, 1992 - Various bug fixes and test versions.
  944.         Version 1.20 -- Mar  7, 1993 - Multiple disk support. Enhancements.
  945.  
  946.         ********************************************************************
  947.  
  948.         OTHER PROGRAMS BY MIKE ROBINSON:
  949.  
  950.         EZROM120.ZIP   79,877  05-31-93  EZ-Rom 1.20 CD-ROM Download Door.
  951.                                          For Wildcat or any DOOR.SYS BBS.
  952.  
  953.         EZ-Rom Door is a file access and download door designed for use on
  954.         Wildcat 3.x BBS or any BBS that can create a DOOR.SYS file. Files
  955.         may be located on CD-ROM disk(s), magnetic disk(s), or both. It
  956.         provides browsing, text search and download capabilities from
  957.         within the door. It can even track the number of files/bytes
  958.         downloaded, enforce daily limits, and then record this information
  959.         in the main Wildcat database. The door can be run online, locally
  960.         in the BBS, and locally from the DOS command line. Up to 100 CD-ROM
  961.         disks are supported with up to 500 file areas on each disk.
  962.         Shareware with $20 registration.
  963.         FidoNet file request EZROM for latest version.
  964.  
  965.         PMSTR101.ZIP   40,176  10-03-92  The PortMeister 1.01
  966.  
  967.         The Portmeister 1.01 is a PC communications port lock and unlock
  968.         utility designed for use on a Spitfire 3.x BBS. It adjusts the
  969.         computer-to-modem (DTE/DCE) data communications speed on the fly.
  970.         It does not alter the modem-to-modem link speed. It works well with
  971.         the US Robotics Dual Standard modem, including the new 16800 HST
  972.         model. Shareware with $10 Registration.
  973.         FidoNet file request PMEISTER for latest version.
  974.  
  975.         SFCAT20.ZIP    37,127  01-19-92  Catchem 2.0, View/Sort User Lists
  976.  
  977.         Catchem 2.0 is a Spitfire 3.x utility to display sorted user list
  978.         files. The idea is to display this information so that you can
  979.         easily observe patterns and weed out duplicate or bogus users. Even
  980.         though a birth date, phone number or password may not be exactly
  981.         the same for 2 users, they may be close enough to arouse suspicion.
  982.         Free Program.
  983.         FidoNet file request CATCHEM for latest version.
  984.  
  985.         RATIO101.ZIP   20,223  05-28-93  Ratio 1.01 Upload Ratio Bulletin
  986.  
  987.         RATIO 1.01 is a Spitfire 3.x BBS utility program that makes a nice
  988.         color/ascii bulletin of the 36 callers with the worst file
  989.         download/upload ratio. Free Program.
  990.         FidoNet file request RATIO for latest version.
  991.  
  992.