^
@APLINE1C
:RO
                                                                                 ┌─────────────────────────────────────────────────────────────────────────────┐ │                 ╒═════════════════════════════════════════╕                 │ │  ┌──────────────┤    SF■File List & Bulletin Generator    ├──────────────┐  │ │┌─┼─┐            ╘═════════════════════════════════════════╛            ┌─┼─┐│ ││ └─┘                                                                   └─┘ ││ ││                               Version 1.07                                ││ ││                                                                           ││ ││                                                                           ││ ││                            By: Philip K. Brown                            ││ ││                                                                           ││ ││                     Flaming Star Computer Accessories                     ││ ││                   A Division Of Brown Business Software                   ││ ││                           28 West Sutliff Drive                           ││ ││                      Terre Haute, Indiana  47802                          ││ ││                                                                           ││ ││                                                                           ││ ││                                Support BBS:                               ││ ││                                                                           ││ ││ ┌─┐   Ivy Tech's BBS  (812) 299-9306  -  HST    - RIME ID:IVYTECH     ┌─┐ ││ │└─┼─┘  Flaming Star BBS (812) 898-2561  - DUAL - FidoNet ID:1:2230/102  └─┼─┘│ │  └───────────────────────────────────────────────────────────────────────┘  │ └─────────────────────────────────────────────────────────────────────────────┘                                                                                                                                                                                                                                                                                   Introduction                                                                                                                   This program is created for Spitfire Bulletin Board Systems so users can        download a complete list of files on your Bulletin Board.   This is nice for    you too for keeping a catalog of available files and the bulletin it creates    informs you and your callers on what your board has available to them.                                                                                          This list will be available in 3 formats.  One will be a ASCII .LST Text file   and the other will be a file with your choice of compression programs listed    below. (ARC, ARJ, LHA, PAK, ZIP).  Third option is a executable .ARJ or         .ZIP but this is only available in the registered version.                                                                                                      This program will also take the information used in creating the list to        create a File Area Statistics bulletin that will display the file area          description, file area number, directory size and total number of files in      each file area.  After all file areas are displayed, a total will be            displayed at the bottom.  This will be in 1 bulletin, With a .CLR (color) and   .BBS (black and white) placed in the Spitfire Display path.                                                                                                                                                                                                                    Upon Registration                                                                                                                Once you have registered this program,  you will receive a update that will     enable the following options:                                                                                                                                     - Disables the nag screens on the opening screen and closing screen.            - Display your Bulletin Board Name on the File Area Statistics Bulletin.        - Display your Bulletin Board Name in the listing that was created.             - It will use your name instead of 'Unregistered Copy' when running this          as an event.                                                                  - Enable the Create executable option for .ARJ and .ZIP.  This will convert      .ARJ or .ZIP into a .EXE file.  Appropriate changes in SFFILES.BBS will         be made.   NOTE: ZIP2EXE.EXE Must Be In Your DOS Path.                                                                                                                                          Warranty                                                                                                                                                                                                     This product is provided "as is" without warranty of any kind.  The entire      risk as to the results and performance of the program is assumed by you.        Further more, I, the author, do not warranty, guarantee, or make any            representations regarding the use of, or the results of the use of the          program, and you rely on the program and results solely at your own risk.  I,   the author, cannot accept responsibility for system damage, loss of profit, or  any other special, incidental, or consequential damages resulting from the use  or inability to use this product.                                                                                                                                                                                                                                                  Copyright                                                                                                                                                                                                    File List & Bulletin Generator is to be distributed as SHAREWARE.               Under this concept you may use the SHAREWARE (unregistered) version for a       reasonable period of time, which I consider to be four weeks, after which you   must either register your copy or discontinue usage.                                                                                                                                                                                                                                                                                                                                                                                                                                                                             Distribution                                                                                                                   You are free, in fact encouraged, to distribute the SHAREWARE (unregistered)    version of File List & Bulletin Generator provided that all files contained in  the original File List archive are distributed in their original, unmodified    state.                                                                                                                                                                                                                                          The following files are required for the File List & Bulletin Generator:                                                                                          - SFLSTGEN.EXE     Executable Program                                           - SFLSTGEN.OVL     Overlay File for SFLSTGEN.EXE                                -    SETUP.OVL     Overlay File for SFLSTGEN.EXE (When running SETUP)           - SFLSTGEN.DOC     Documentation (Currently Reading it)                         - SFLSTGEN.HLP     A help file required by SFLSTGEN.EXE (F1=HELP)               - AREA2TXT.EXE     Collects Spitfire File Area Information                                              (Called From SFLSTGEN.EXE)                                                                                                            The following file(s) are created the first time you run SFLSTGEN SETUP:                                                                                          - SFLSTGEN.000     Data File - Information needed by SFLSTGEN.EXE               - SFLSTGEN.001     Data File - Used when reading SFFILES.BBS                    - SFLSTGEN.002     Data File - Used in Creating Bulletin                        - SFLSTGEN.003     Data File - File Area Information                            -     WORK.000     Data File - Also Used When Reading SFFILES.BBS                                                                                             The following file(s) are created & deleted during the execution of the         program.  NOTE: You never see the files listed below unless their is an error.                                                                                    - SFLSTGEN.TMP     Data File - Passes Command-line parameters to and from                                      parts of SFLSTGEN.                               - SFLSTGEN.PTH     Data File - Used by AREA2TXT.EXE to collect                                                 information in SFFAREA.DAT.                      - SFLSTGEN.DSK     Disk File - Used in saving memory to disk before                                            dropping to DOS to perform the compression                                      program or reading SFFAREA.DAT.  When the                                       tasks are completed memory is restored.          - ERROR.DAT        Data File - Used to store error information and                                             deleted after ERROR.LOG has been created                                        or appended to.                                                                                                                The following file is created if a error is encountered:                                                                                                          - ERROR.LOG        This LOG file reports most Errors Found.                                                                                                                                                                                               ----- Features of File List & Bulletin Generator -----                                                                                               -  Now supports Multi-line File Descriptions in Spitfire 3.5 (unlimited)        -  Runs on Spitfire Bulletin Boards Version 2.8 to 3.x!                         -  Need Help?  Type SFLSTGEN HELP and a brief help window is displayed.         -  Ease of Configuring!  Type SFLSTGEN SETUP and follow the prompts..           -  Creates both .BBS & .CLR Bulletins.                                          -  Lets you pick what Directory you want to put your List in.                   -  Lets you pick what file areas you want to add to the list.                   -  Lets you turn OFF/ON the 'Create .LST option'.                               -  Lets you turn OFF/ON the ability to abort bulletin that is created.          -  Lets you turn OFF/ON the screen clearing codes in the bulletin created.      -  Lets you turn OFF/ON the ability to create a .EXE from .ARJ or .ZIP.         -  Add a ZIP or ARJ Comment!                                                    -  Include a File in the ZIP'ed or ARJ'ed File List! ie. Color Logo Screen      -  Ability to use either LHA or LHARC!                                          -  CD-ROM Support.                                                              -  Works well in a multi-node environment.                                      -  Has been tested on a multi-node Network using LANtastic Version 4.0IA        -  Has been tested on a OS/2 Beta Version 2.1 system.                           -  Has been tested on a WEB Network Version 2.55.                               -  Has been tested on a Lantastic Z (Par/Serial) Network                        -  Has been tested on a Lantastic 5.0/AI Network                                                                                                                                     ****** Setting Up File List ******                                                                                                        You will need to create a directory you wish to run this program from.  I       suggest C:\SF\SFLSTGEN or something similar, after it's created, then change    to that directory, and then unzip the SFLST106.ZIP into that directory.                                                                                         When that is done, you must type SFLSTGEN SETUP then it will display a screen   with some options for you to fill in.  If you make a mistake, just use you      arrow keys to move to the line and make the correction.                                                                                                         The first line and second line is for your BBS Phone Number and Bulletin Board  name.  This is only available upon your registration.                                                                                                           If you are using 'ZIP' and have answered 'Y' for the last 2 questions about     zip comments and including a file in the Zip file, then you will have to        additional questions to answered.                                                                                                                               When you have filled in all the blanks, just press enter and it will ask you    if the above information is correct.  If not, then please press "N" and make    the appropriate changes.  When the above information is correct answer "Y"      the next question it will ask is "Have you made any changes in the File Area    Section.".  Please answer "Y" to this question.                                 This will allow you to select the File Areas you want to include in this        Complete File Listing.                                                                                                                                                                                                                          NOTE:  If you do not have the first file area listed inside the box, it may            have ran out of memory.   Make sure Spitfire is not in memory when              configuring SFLSTGEN!.                                                                                                                                          If you run SFLSTGEN and it returns a message saying 'out of memory'             and you know for sure you have memory available.   Please add this              line to your AUTOEXEC.BAT.                                                                                                                                           SET CLIPPER=E000;                                                                                                                                          Something with MS-DOS 6.x requires the above command before it will             execute.                                                                                                                                                 Using the Up and Down (arrows) keys, you can browse thru the File Areas.        If you see a File Area you don't want to include in the list, press the         Spacebar; it will put "Don't Use" in a box on the line above.  If you decide    you want that File Area then press the Spacebar again to unselect it.                                                                                                                                                                           NOTE: The compressed File Format you select in setup will be used                     instead of ZIP.                                                                                                                                           When you come to the area you want your compressed file and Text file to be     placed, press the Insert Key and "Put ZIP Here" is placed in the second box     on your screen.  If you make a mistake press the Insert key a second time to    remove your selection.  Remember, this list can only go to one File Area.       Please make sure you select the right area.                                                                                                                     If you have a CD-ROM setup on your board using the CD-ROM option in the file    area then as you are browsing thru the file areas and one is a CD-ROM area      then the words "CD-ROM" will appear in the third box on the line above.                                                                                         This is done automatically for you.  All CD-ROM areas will check the DISPLAY    directory for the individual SFFILES.<File Area Number>.                                                                                                        When you have selected everything you need, press enter <Enter> or Return to    save your corrections.  This will return you to the DOS prompt.                                                                                                 The next step is setting up an Event for this program to run under.                                                                                             Using your favorite Text Editor, you will need to edit SF.BAT in your           Spitfire System directory usually C:\SF.                                                                                                                        Listed below are 2 examples you can use to create your event:                                                                                                   NOTE: The following examples assume your Spitfire directory is C:\SF and              you have placed the files in a directory called SFLSTGEN off of your            C:\SF directory. ie.  C:\SF\SFLSTGEN                                                                                                                            If your system does not support ANSI color graphics then use the                following line when running this event.                                                                                                                                 Replace "SFLSTGEN COLOR" with "SFLSTGEN MONO"                                                                                                     --- Sample Batch File For Normal Setup ---                                                                                                                     :EVENT_K                                                                           REM  Spitfire's SF■File List & Bulletin Generator                               CD C:\SF\SFLSTGEN                                                               SFLSTGEN COLOR                                                                  CD C:\SF                                                                        GOTO LOOP                                                                                                                                                     --- Sample Batch File For Multi-Node ---                                                                                                                        If yours is a multi-node board, use the following commands.                     (SFBUSY.COM is shareware available from Buffalo Creek Software.)                This usage has been tested on multi-node Spitfire board.                                                                                                       :EVENT_K                                                                           REM  Spitfire's SF■File List & Bulletin Generator                               CD C:\SF\SFLSTGEN                                                               SFBUSY C:\SF\WORK /S                                                            IF ERRORLEVEL 2 GOTO EVENT_K                                                    IF ERRORLEVEL 1 GOTO K_END                                                      SFLSTGEN COLOR                                                                  SFBUSY C:\SF\WORK /C                                                         :K_END                                                                             CD C:\SF                                                                        GOTO LOOP                                                                                                                                                     After you have added the Event to SF.BAT you must Enable the Event within       Spitfire.   Please refer to the Spitfire Manual for assistance.                                                                                                                                                                                 NOTE: If this program has a Disk Full Error then a ERROR.LOG is created               and pauses a moment on the screen and then returns to DOS or to your            next event.                                                                                                                                                     This program may not work Dropped to DOS via Spitfire!  Insufficient            memory.                                                                                                                                                         When in SFLSTGEN SETUP, press ALT-M to display available RAM.                   That will display RAM left while in SFLSTGEN!                                                                                                                   Type SFLSTGEN STATUS for a quick list of your SFLSTGEN Configuration.                                                                                           Please make sure the compression program you use is in your DOS path.                                                                                           AREA2TXT was created for SFLSTGEN by Greg Rumple.                                                                                                               Adding Zip Comment and additional File is for PKZIP from PKWARE only.                                                                                           Adding ARJ Comment & additional File is for ARJ from Robert K. Jung.                                                                                            If you are using PKZIP higher than Version 1.10 then when you run               SFLSTGEN SETUP, press ALT-O and select 440K or higher.   If you don't           then this program will give you an error when creating your File                Listing.                                                                                                                                                        If you use ARJ, or LZH and out of memory when creating the list, use            ALT-O and select a higher amount.  640K to be safe.                                                                                                             When SFLSTGEN is reading the SFFILES.BBS and finds a file size like             1,000,00 it will add 9 bytes to the filesize.   This will only show in          the .LSTing and file statistics.  The SFFILES.BBS won't be corrected.                                                                                           If converting .ZIP to .EXE, make sure ZIP2EXE.EXE is in Your DOS Path.                                                                                    ====== Support == Support == Support == Support == Support == Support =======                                                                                  If you have any problems, find any bugs, just have an idea; please feel free    to contact me.  Listed below are a two ways to do so.                                                                                                              Call the following Bulletin Boards:                                                                                                                                 Ivy Tech's BBS        (812) 299-9306 14400/9600/2400/1200  Baud - HST         Flaming Star BBS        (812) 898-2561 16800/14400/9600/2400 Baud - DUAL                                                                                      If you are a member of RIME, you can leave me a message in any of               the Spitfire Conferences, or in the COMMON Conference and you can route         the message to me at Ivy Tech's BBS by placing a ->IVYTECH   on the             first line of the message and sending it to Philip Brown.                                                                                                       If you are a member of FidoNet, you can leave me a message in the SPITFIRE      FidoNet Conference, and The Flaming Star address is 1:2230/102.                                                                                                 If you are a Registered Sysop, all new updates will be available to you.        However, you must select one of three means of getting your registered copy     of SFLSTGEN to you.                                                                                                                                           ====== Support == Support == Support == Support == Support == Support =======                                                                                                                                                                                                                                                                           Something That Needs To Be Said                                                                                                         I would like to thank my wife, April Brown for standing by me while             updating SFLSTGEN.                                                                                                                                              I would like to thank Richard Heckelsberg for the help and ideas he gave me     while writing this program and for standing by me while I used his Bulletin     Board for testing.   Not many people would allow you to do that.                                                                                                I would like to thank my Dad, Donald Brown for his help in general and          starting a Computer Consulting Company.  Brown Business Software.                                                                                               I would like to thank Mike Woltz for creating Spitfire Bulletin Board           Software.  Without it this program would not have been.                                                                                                         This program is written using Clipper, a dBASE Compiler.  Many thanks to        Doug Stevens and Larry Taylor, two instructors who taught dbase II and          Advanced dBASE III+.                                                                                                                                            I would also like to thank Greg Rumple for writing a utility to extract         Spitfire File Area Information for me.   A key program I really needed.                                                                                                                                                                                          Copyright, Trademark and Service Mark Notices                                                                                                  CLIPPER is a trademark of Nantucket Corporation                                                                                                                 NANTUCKET is a registered trademark of Nantucket Corporation                                                                                                    SPITFIRE is Copyright (c) 1987-1994 by Mike Woltz                                                                                                               SPITFIRE is a registered trademark of Buffalo Creek Software.                                                                                                   PKZIP is a Copyright (c) 1989-1994 PKWARE Inc.  All Rights Reserved.                                                                                            ARJ is a Copyright (c) 1990-1993 by Robert K. Jung                                                                                                              ARC is a Copyright (c) 1988-1989 by System Enhancement Associates                                                                                               LHA is a Copyright (c) 1988-1991 by Haruyasu Yoshizaki                                                                                                          PAK is a Copyright (c) 1988-1990 by NoGate Consulting                                                                                                           SWAP is a Copyright (c) 1988-1991 by Berner & Associates.                                                                                                       AREA2TXT is a Copyright (c) 1990-1994 by Greg Rumple                                                                                                            LANTASTIC is a registered trademark of Artisoft Corporation.                                                                                                    IBM is a registered trademark of International Business Machines.                                                                                               OS/2 is a Copyright (c) 1994 by International Business Machines.                                                                                                                                                                                                          *** History Of Changes ***                                                                                                                                                                                           Version 1.00ß:                                                                                                                                                      ■  This was the first BETA release of SFLSTGEN, Version 1.00.                                                                                                   ■  Added support for PKZIP, PKWARE, Inc.                                                                                                                    Version 1.01:                                                                                                                                                       ■  First Public Release of SFLSTGEN!                                                                                                                            ■  Updated program to work with Spitfire Version 2.8 thru 3.xx                                                                                                  ■  Fixed a screen problem with total disk space over 1 Gigabyte.                                                                                                ■  Added Internal Error handling (For Most Catchable Errors).                                                                                                   ■  Registration of 'Swap!',  A Memory to disk swapping utility from                Berner & Associates.                                                                                                                                         ■  Added capability to modify .LST/ZIP description lines.                                                                                                   Version 1.02:                                                                                                                                                       ■  Fixed bulletin problem with File Areas over 100!                                                                                                             ■  Cleaned up some internal routines to cut processing time in half.                                                                                            ■  Added support for the following compression programs:                                                                                                               ARJ - Robert K Jung                                                             ARC - System Enhancement Associates                                             LHA - Haruyasu Yoshizaki (LHA)                                                  PAK - NoGate Consulting                                                                                                                                  ■  Added a option to turn OFF or ON the creation of the .LST program.                                                                                           ■  Supports Zip Comment (ZIP Only)                                                                                                                              ■  Option to add 1 additional File to ZIP'ed File List. (ZIP Only)                                                                                              ■  On-Line Help Support when running SFLSTGEN SETUP by pressing F1.                                                                                             ■  Display SFLSTGEN's configuration when running SFLSTGEN STATUS.                                                                                               ■  ALT-O - Select amount of memory required for compression program.                                                                                            ■  ALT-M - Displays amount of Ram you have when running SFLSTGEN SETUP.                                                                                                                                                                     Version 1.03:                                                                                                                                                       ■  Added support for multi-line file descriptions for Spitfire 3.2.                                                                                             ■  Added BBS Phone Number option to setup screen.                                                                                                               ■  BBS phone number is appended to BBS Name on listing.                                                                                                         ■  Added option for registered PKZIP users!  Uses the -AV switch                                                                                                ■  Added option to allow users to break out of bulletin that is                    created.                                                                                                                                                 Version 1.04ßa: (Released to Registered Users who needed this phone support)                                                                                        ■  Added International Phone Number Option.                                                                                                                 Version 1.04ßb:                                                                                                                                                     ■  Mike Downie brought to my attention of a problem in calculating                 files over 1 meg.   This is because of several different ways                   1 meg files are displayed within spitfire.                                                                                                                      Now checks for file sizes like:                                                         1000,000                                                                       1,000,000                                                                        1,000,00 (Adds 9 bytes for file sizes reported like this)                                                                                        Version 1.05:                                                                                                                                                       ■  Skipped a public release of 1.04 because of minor changes and a                 released copy of 1.04b to a Registered International caller.                                                                                                 ■  For Registered Users Only --                                                    Added a option for make a executable file from .ARJ or .ZIP.  This              will create the .ZIP or .ARJ as usual, but then it will convert the             compressed file to .EXE and removes the .ZIP or .ARJ.                                                                                                        ■  Changed the SFLSTGEN registration policy.                                                                                                                    ■  Added option to disable the screen clearing codes in the bulletin               that SFLSTGEN creates.                                                                                                                                       ■  All registered users will receive a letter when future versions of              SFLSTGEN are available.                                                                                                                                      ■  Added a line before each File Area listed in the .LSTing that is                written.   Example: ■ This is for the Untitled File Area (#1)                                                                                            Version 1.06ßa:                                                                     ■  Added multi-line capability!  Unlimited I think! (grin)                                                                                                  Version 1.07:                                                                       ■  SFLSTGEN released and capabile of reading Spitfire 3.5's extended               file descriptions.                                                                                                                                                                                                                                                                                                                                      ***** Registration *****                                                                                                        Mail to:   Flaming Star Computer Accessories                                               A Division of Brown Business Software                                           c/o  Philip K. Brown                                                            28 West Sutliff Drive                                                           Terre Haute, Indiana  47802                                                                                                                          MAKE PAYABLE TO: Philip Brown                                                                                                                                         Version Of SFLSTGEN You Currently Run__________________________                                                                                                 Your Name______________________________________________________                                                                                            Street Address______________________________________________________                                                                                                      City______________________________________________________                                                                                                State, Zip______________________________________________________                                                                                               Home Phone#______________________________________________________                                                                                             BBS Name___________________________________________________________                                                                                             BBS Hours____________________ /Baud Rate___________________________                                                                                             BBS Phone#_________________________________________________________                                                                                             BBS Software_______________________________________________________                                                                                             Are you a Member of:                                                                                                                                                      RelayNet?_________  If Yes, What is your ID:___________                                                                                                    of CircuitNet?_________  If Yes, What is your ID:___________                                                                                                       of FidoNet?_________  If Yes, What is your ID:___________                                                                                                      Other not listed above:______________, What ID:___________                                                                                             Brown Business Software offers (3) different means to receive your              registered copy of SFLSTGEN.                                                                                                                                    Please check appropriate box.                                                                                                                                   [ ]  (1) For $ 15.00 your copy of SFLSTGEN will be available for download                from Ivy Tech's BBS or The Flaming Star BBS.     (Total $ 15.00)                                                                                                If Checked, Which BBS to download from?   Circle One.                                                                                                  [ ]  (2) For $ 5.00 shipping and handling I will mail your copy of SFLSTGEN              on a 5 ¼ in. (360k) or a 3 ½ in. (720k) Diskette. (Total $ 20.00)                                                                                      [ ]  (3) For $ 7.50 handling fee, I will call your bulletin board and upload             your copy of SFLSTGEN.        (Total $ 22.50)                                                                                                           Please send a Bank draft/money order or Postal Money order for the amount       shown above in U.S. Funds to the address on the top of this form.  If you       must send a Personal check, this will cause a 2-3 week delay in processing.                                                                                     If you are outside the North American continent, then a shipping and            handling fee will be $ 15.00 will be added.                                                                                                                                                                                                                         THANK YOU for registering.                                                                                                                      It will encourage me to write more Programs in the future.                                                                                                                                                                                                                                                                           Ivy Tech's BBS                    The Flaming Star BBS                        Philip Brown, SysOp                Philip Brown, Co-Sysop                         (812) 299-9306                       (812) 898-2561                       14400/9600/2400 Baud (HST)           14400/9600/2400 Baud (Dual)                                                                                            RelayNet:IVYTECH or 488                                                          FidoNet:1:2230/114 or 1:2230/102                                                 PCLink:23:201/0                                                                  SFNet:A0812001                                                                                                                                               NOTE: The Flaming Star BBS is ran by April Brown (my wife) at home.                   Ivy Tech's BBS is ran by Philip Brown at work.                                                                                                                  Shareware version of SFLSTGEN can be File Requested via FidoNet                 at 1:2230/102 (The Flaming Star)  Magic name: SFLSTGEN                                                                                                   