home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / SPITFIRE / SFLASTEN.ZIP / SFLASTEN.DOC < prev   
Text File  |  1994-03-15  |  9KB  |  199 lines
  1.                                SFLASTEN
  2.                           (SPITFIRE LAST TEN)
  3.                              Version 1.52
  4.                   Copyright (C) by Mike Woltz, 1991-1994
  5.                          Buffalo Creek Software
  6.     
  7.  
  8.     INTRODUCTION
  9.     ------------
  10.  
  11.        SFLASTEN is a utility written by Mike Woltz, author of SPITFIRE,
  12.     to generate a last ten callers display file for a SPITFIRE BBS.
  13.     SFLASTEN will create <filename>.BBS/CLR/RIP display files which lists
  14.     the last ten callers of the board.  The display files will look
  15.     similar to the below example...
  16.  
  17.          ┌───┐     ╒═══════════════════════════════╕     ┌───┐
  18.          │   │     │ SPITFIRE BBS Last Ten Callers │     │   │
  19.          └───┼─────┴───────────────────────────────┴─────┼───┘
  20.              │                                           │
  21.              │ Stan Kapala .............. 10-22-91 13:39 │
  22.              │ Tom Blalock .............. 10-22-91 13:35 │
  23.              │ Ira Lichtenstein ......... 10-22-91 13:34 │
  24.              │ Chuck Gilmore ............ 10-22-91 13:26 │
  25.              │ Walt Bush ................ 10-22-91 13:11 │
  26.              │ Frank Lech  .............. 10-22-91 13:01 │
  27.              │ Guy Rink ................. 10-22-91 12:53 │
  28.              │ Larry Miller ............. 10-22-91 12:34 │
  29.              │ Robert Arguello .......... 10-22-91 12:32 │
  30.              │ Frank Crispell ........... 10-22-91 12:17 │
  31.              │                                           │
  32.          ┌───┼───────────────────────────────────────────┼───┐
  33.          │   │                                           │   │
  34.          └───┘                                           └───┘
  35.  
  36.        SFLASTEN is extremely fast and the size of SFLASTEN.COM file is
  37.     very small (a big plus to all Sysops who are concerned about disk
  38.     space) because it is written in assembler language.
  39.     
  40.        SFLASTEN is not intended to undermine the use of any other utility
  41.     (there are several others) which performs basically the same task.
  42.  
  43.  
  44.     SETUP AND OPERATION AND COMMAND LINE PARAMETERS
  45.     -----------------------------------------------
  46.  
  47.        SFLASTEN must reside in the HOME directory of the SPITFIRE BBS.
  48.     SFLASTEN first reads SPITFIRE's SFNODE.DAT and then SFUSERS.DAT
  49.     file.  If either of these are not found, SFLASTEN will notify
  50.     the file was not found and halt operation.  SFLASTEN reads the
  51.     information in the SFUSERS.DAT file to determine the last ten
  52.     callers and creates ANSI, non-ANSI and RIP display files listing
  53.     the board's last ten callers.
  54.     
  55.        SFLASTEN can be used by any combination of the following command
  56.     line parameters, however, the name of the file to be created is
  57.     required:
  58.     
  59.        Usage...
  60.        C>SFLASTEN WELCOME2 /SSL=xxx /P
  61.  
  62.        WELCOME2 = Display File Name ................. Required!
  63.        /SSL=xxx = Skip Security Level Equal To xxx .. Optional!
  64.        /P       = Pause Prompt Control Character .... Optional!
  65.     
  66.  
  67.        While SFLASTEN is designed to be used within SFINIT.BAT, it can
  68.     be executed either from the DOS prompt or as an event from your
  69.     SF.BAT file.  SFLASTEN uses a command line parameter which allows
  70.     you to specify the name of the display files to be generated.
  71.     Please note that the specified file name should NOT include a path
  72.     and a file extension since SPITFIRE automatically creates the display
  73.     files in your DISPLAY directory and automatically adds the extension
  74.     .BBS to the first created file, .CLR to the second created file and .RIP
  75.     to the third created file.  Listed below is an example of a SFINIT.BAT
  76.     file which could be used to execute SFLASTEN between callers.
  77.  
  78.     @Echo Off
  79.     SFLASTEN WELCOME2 /SSL=999 /P
  80.     
  81.        Notice, no extension is used in the command line parameter.  If 
  82.     an extension is added, it is ignored and *.BBS\CLR\RIP files are created.
  83.     Further, please notice that no path is included with the file name.
  84.     In the event a path is entered on the command line, a file creation
  85.     error will occur.
  86.  
  87.        The /P parameter will cause SFLASTEN to place a ^E^P at the end
  88.     of each display file created.  SPITFIRE will cause the 'pause prompt'
  89.     to appear when the ^E^P is found in the created display files.
  90.  
  91.        The /SSL=xxx will cause SFLASTEN to ignore callers with a security
  92.     level of xxx.  For example, if /SSL=999 is used on the command line,
  93.     the any caller with a security level of 999 will not be included in
  94.     the created display files.
  95.  
  96.  
  97.     OPERATION ERRORS
  98.     ----------------
  99.    
  100.        If SFLASTEN is not executed from the directory in which 
  101.     SFUSERS.DAT resides, SFLASTEN will beep and give the following
  102.     error message: "SFNODE.DAT not found!".
  103.     
  104.        If you entered a path in the command line parameter
  105.     SFLASTEN will give an error message stating, "Error creating
  106.     <the path that you entered>".
  107.     
  108.  
  109.     SFLASTEN ON A MULTI-NODE SYSTEM
  110.     -------------------------------
  111.    
  112.        SFLASTEN is fully compatible for operation on a multi-node BBS.
  113.     It automatically handles any file locking and file sharing 
  114.     required during the execution.   
  115.  
  116.  
  117.  
  118.     DISTRIBUTION
  119.     ------------
  120.  
  121.        SFLASTEN is distributed under the shareware concept.  You are
  122.     free to distribute the SFLASTEN program as long as it remains
  123.     unmodified and no fee is charged.  If you continue to use this 
  124.     program after an adequate evaluation period, then a fee is required.
  125.     A $1.00 fee is required of registered SPITFIRE sysops and a 
  126.     $ 5.00 fee is required of those who are not registered users
  127.     of SPITFIRE. 
  128.  
  129.         Those registering SFLASTEN, can for a $5 fee, have a special
  130.     version compiled so that the display file header will list the name
  131.     of the BBS rather than the default 'SPITFIRE BBS Last Ten Callers'
  132.     header and so that the color of the .CLR file can be designated.
  133.     Listed below is the default display file header and a sample of
  134.     a header which could be created by a specially compiled copy of
  135.     SFLASTEN.
  136.  
  137.          ┌───┐     ╒═══════════════════════════════╕     ┌───┐
  138.          │   │     │ SPITFIRE BBS Last Ten Callers │     │   │
  139.          └───┼─────┴───────────────────────────────┴─────┼───┘
  140.              │                                           │
  141.              │ Stan Kapala .............. 04-10-92 13:39 │
  142.  
  143.          ┌───┐     ╒═══════════════════════════════╕     ┌───┐
  144.          │   │     │ Solid Rock's Last Ten Callers │     │   │
  145.          └───┼─────┴───────────────────────────────┴─────┼───┘
  146.              │                                           │
  147.              │ Stan Kapala .............. 04-10-92 13:39 │
  148.  
  149.        In the event you decide to have a copy of SFLASTEN compiled
  150.     specifically for you ($5.00 fee), then the name you want in
  151.     the header must be 30 characters or less.
  152.  
  153.     DISCLAIMER
  154.     ----------
  155.         
  156.        Mike Woltz and/or Buffalo Creek Software shall in no way be 
  157.     held responsible for any damage incurred while operating SFLASTEN.
  158.     All responsibility lies with the user of the software.
  159.  
  160.        The documentation for SFLASTEN is contributed by Jacque
  161.     Shipley and The Mother Board BBS.  The shareware version of
  162.     SPITFIRE and other SPITFIRE utilities are available for download
  163.     from:
  164.  
  165.          Buffalo Creek's BBS              The Mother Board BBS
  166.           Mike Woltz, Sysop               Jacque Shipley, Sysop
  167.            (515) 225-8496                    (515) 986-3464
  168.     38400/19200/9600/2400/1200 Baud        9600/2400/1200 Baud
  169.  
  170.     REVISIONS
  171.     _________
  172.  
  173.     Version 1.1 (November 11, 1991) - SFLASTEN was revised so that callers
  174.     either locked out and/or marked for deletion would not be included in
  175.     the list of last ten callers.
  176.  
  177.     Version 1.2 (November 16, 1991) - SFLASTEN was revised in a manner to
  178.     increase the speed of reading SFUSERS.DAT.  This utility should run
  179.     many times faster than previous versions.
  180.  
  181.     Version 1.3 (January 26, 1992) - SFLASTEN was revised to display the
  182.     created .CLR file at the conclusion of the operation.  This was added
  183.     to avoid a sharing violation which could occur (multi-node operation)
  184.     if the DOS TYPE command was used in the SFINIT.BAT file to display
  185.     the created file.  The color of the .CLR file was also changed.
  186.  
  187.     Version 1.4 (April 17, 1992) - SFLASTEN was revised to cure a problem
  188.     which would occur if a caller's name (one of the last 10 callers) was
  189.     in excess of 26 characters.
  190.  
  191.     Version 1.5 (November 27, 1993) - SFLASTEN was revised to create a RIP
  192.     last ten caller display file.
  193.  
  194.     Version 1.51 (January 2, 1994) - SFLASTEN was revised to utilize a key
  195.     file to convert the shareware version to registered.
  196.  
  197.     Version 1.52 (March 15, 1994) - SFLASTEN was revised to fix the placement
  198.     of the cursor upon completion of displaying the create RIP display file.
  199.