home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbsdoor / bblst101.zip / SYSOP.DOC < prev   
Text File  |  1994-02-13  |  12KB  |  258 lines
  1.                             
  2.                             
  3.                                 Big BBS List
  4.                                 
  5.                                 version 1.00
  6.                       
  7.                       Copyright (c) 1994 by Sean Laurent
  8.  
  9.                              February 13th, 1993
  10.  
  11.  
  12. ==============================================================================
  13.  
  14.                                   Shareware
  15.                                   ~~~~~~~~~
  16.     This  program is distributed  under the  shareware concept.  It is NOT
  17.     crippled in  any way.  You may use Big BBS List for a  period 30 days.
  18.     If,  after trying it for 30 days,  you continue using BBList, you  are 
  19.     required  to  register it.  Please see  REGISTER.ME  and  the 
  20.     information at the end of this document.
  21.  
  22.                                   Warranty
  23.                                   ~~~~~~~~
  24.     Big BBS List  is distributed without warranty.  Sean  Laurent is in no
  25.     way responsible for  any damages caused by  the use of this program. I
  26.     only guarantee that Regis will take up space. 
  27.     
  28.     The validation data for Big BBS List v1.00 is:
  29.                 
  30.                 File Name:  bbslist.exe
  31.                      Size:  78,736
  32.                      Date:  2-10-1994
  33.       File Authentication:
  34.            Check Method 1 - 486D
  35.            Check Method 2 - 011D
  36.     
  37.     If  your  results  do not match, you  may have a corrupted  or  virus-
  38.     infected copy of BBList.  To obtain the  newest copy of Regis Security
  39.     Check see the information at the end of this document.
  40.  
  41. ==============================================================================
  42.  
  43.                      WHAT THIS PROGRAM IS SUPPOSED TO DO
  44.                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  45.     BBList is an on-line door program that will keep track of information
  46.     on other BBS's.  Users may remotely view a short list of BBS's, view
  47.     a more detailed list of BBS's, or add another BBS to the list.  BBS
  48.     entries can be deleted by the user who entered the data, the sysop of
  49.     the BBS itself, or the sysop of the BBS running BBList.  BBList will
  50.     also generate ANSI/ASCII BBS lists each time the list is modified
  51.     which can be used as bulletins, logon screens, etc.
  52.  
  53.     BBList currently keeps track of the following information for each
  54.     BBS: 
  55.       
  56.       The name of the BBS
  57.       The sysop's name
  58.       The city the BBS is located in
  59.       The state the BBS is located in
  60.       The BBS's phone number
  61.       Whether the BBS supports 24 hour operation
  62.       The BBS's Fidonet address
  63.       The number of nodes the BBS has
  64.       Whether the BBS is a subscription board or not
  65.       The on-line storage space the BBS has
  66.       Three lines of description for the BBS
  67.  
  68. ==============================================================================
  69.  
  70.                              CONFIGURING BBList
  71.                              ~~~~~~~~~~~~~~~~~~
  72.  
  73.     Before  running Big BBS List, a configuration file needs to be 
  74.     created/modified:
  75.     
  76.     Line 1:   Door data file type.
  77.     Line 2:   Path to the door data file(s).
  78.     Line 3:   BBS name.
  79.     Line 4:   Sysop's name.
  80.     Line 5:   Locked baud rate.
  81.     Line 6:   Number of lines between each pause in the ANSI/ASCII files.
  82.     Line 7:   CTRL-codes or @-codes to be placed at the top of the ANSI &
  83.               ASCII files.
  84.     Line 8:   Text to be displayed before a pause prompt.
  85.     Line 9:   CTRL-codes or @-codes to force the BBS to pause while
  86.               listing the ANSI/ASCII files.
  87.     
  88.     As illustrated above, the door's data file type is specified in line 1
  89.     and can be PCB for PCBoard,  GAP for GAP (DOOR.SYS), SF for  Spitfire,
  90.     RBBS for  RBBS, WC for WildCat!, TRIBBS for  TriBBS, or WWIV for WWIV.
  91.     The  locked baud  rate  is  specified in  line 5.   If  you don't lock
  92.     your  serial  port, you  must  specify  0  for the  locked  baud rate.
  93.     NOTE: Although  many door formats do pass the  locked baud rate in the
  94.     door  data  files,  some older  formats  such  as RBBS  do  not.   For
  95.     conformity,  BBList requires  that you specify the locked baud rate in
  96.     line 5 and ignores any value passed in the door data files.
  97.  
  98.     Many BBS's now  support embedded CTRL  or @ codes that determine how a
  99.     text  file  is  displayed.  TriBBS,  for  example, has  an  @-command, 
  100.     @MOREON@, that forces the BBS, while displaying an ANSI/ASCII file, to
  101.     pause  every  23 lines.  If your BBS  supports a  feature  like  this,
  102.     insert this text  on line  7.  Another of these  @-codes forces TriBBS
  103.     to automatically display "Press any key to continue..." and wait for a
  104.     keypress.  If your BBS supports this feature, insert the text for this
  105.     command  on line  9.  If  you use this  feature,  insert the number of
  106.     lines  between  each pause on line 6.  Some BBS's, like Remote Access,
  107.     support  this  feature, but  do  not  display  any  text.  If your BBS
  108.     supports a  pause  feature, but will not  automatically  display text,
  109.     insert  the text to  be displayed on  line 8.  To find out if your BBS 
  110.     package supports  these features, consult your BBS manual.  DO NOT USE
  111.     BOTH LINES 7  AND 9. USE ONLY  ONE OR  THE OTHER  OR  NEITHER.   Funny
  112.     things might happen.  Leave any unused lines blank.
  113.  
  114.     Included in this archive is a sample file called SAMPLE.CFG:
  115.  
  116.     TRIBBS             <- Data file type
  117.     C:\TRIBBS          <- Path to data file
  118.     The Magic Of Krynn <- BBS Name
  119.     Sean Laurent       <- Sysop name
  120.     38400              <- Locked baud rate 
  121.     23                 <- Pause in the ANSI/ASCII files every 23 lines
  122.                        <- BBS command to auto-pause every xx lines
  123.                        <- Text to be displayed before a pause
  124.     @PAUSE@            <- BBS command to pause
  125.  
  126. ==============================================================================
  127.                                 EXTRA  FILES
  128.                                 ~~~~~~~~~~~~
  129.    
  130.    BBList will also create the following files:
  131.  
  132.    BBSLIST.DAT - Data file containing the information about each BBS.
  133.    FIRST.DAT   - Tells BBList where the first record, alphabetically, is
  134.                  in the BBS listing.
  135.  
  136.    BBSLIST.ANS
  137.        &
  138.    BBSLIST.BBS - ANSI/ASCII BBS listings.  Created only when someone adds
  139.                  or deletes a BBS.
  140.  
  141. ==============================================================================
  142.                                RUNNING BBLIST
  143.                                ~~~~~~~~~~~~~~
  144.  
  145.    Running BBList involves a simple command line:
  146.    
  147.    BBSLIST.EXE nameofconfigurationfile {/L} {nonstandard IRQ}
  148.  
  149.    nameofconfigurationfile is a required parameter specifying the name of
  150.      the configuration file to use.
  151.    
  152.    /L is an optional parameter to force a Local Logon.
  153.    
  154.    nonstandard IRQ is an optional parameter for BBS's using modems on 
  155.      nonstandard IRQs.  Simply specify the IRQ on the command line if
  156.      you're using a non-standard IRQ.
  157.   
  158.    Also  included  in  this archive is a sample  batch  file to run BBList
  159.    called BBLIST.BAT:
  160.  
  161.    @ECHO OFF
  162.    CD\DOORS\BBLIST   <- Change to the BBList directory
  163.    BBSLIST NODE1.CFG <- Run BBSLIST using NODE1.CFG
  164.    IF EXIST BBSLIST.ANS MOVE BBSLIST.ANS C:\TRIBBS\DISPLAY\BULLET3.ANS
  165.    IF EXIST BBSLIST.BBS MOVE BBSLIST.BBS C:\TRIBBS\DISPLAY\BULLET3.BBS
  166.    CD\TRIBBS         <- Change back to the main TriBBS directory
  167.    BOARD.BAT         <- Reload the BBS
  168.  
  169. ==============================================================================
  170.  
  171.                              CLEARING BBS LIST
  172.                              ~~~~~~~~~~~~~~~~~
  173.                              
  174.     To clear or rest the BBS list simply delete BBSLIST.DAT.  BBList will
  175.     automatically  create a new BBSLIST.DAT and a new FIRST.DAT the  next
  176.     time it is run.
  177.  
  178. ==============================================================================
  179.                                               
  180.                              MULTI-NODE SUPPORT
  181.                              ~~~~~~~~~~~~~~~~~~
  182.  
  183.    BBList DOES have support for multiple nodes. Simply create a different
  184.    drop-file configuration file for each node and call BBSLIST.EXE 
  185.    accordingly.
  186.  
  187.    Example:
  188.     NODE1.CFG is the configuration file for node 1 on The Magic Of Krynn.
  189.     NODE2.CFG is the configuration file for node 2 on The Magic Of Krynn.
  190.  
  191.     To run Regis from node 1, the following command line could be used:
  192.     BBSLIST.EXE NODE1.CFG
  193.    
  194.     To run Regis from node 2, the following command line could be used:
  195.     BBSLIST.EXE NODE2.CFG
  196.  
  197. ==============================================================================
  198.  
  199.                FAQ: FREQUENTLY ASKED QUESTIONS & THEIR ANSWERS
  200.                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  201.  
  202.     Q: I ran the batch file included with BBList, but DOS gives me a BAD
  203.        command or filename error.  What's wrong?
  204.  
  205.     A: The batch file included with BBList is just a sample configuration
  206.        configured according to my setup on my system.  To eliminate this
  207.        problem, use a text editor, and edit the batch file.  Change the
  208.        line that says, "CD\DOORS\BBLIST"  to reflect the name of the
  209.        directory on your system that BBList resides in.
  210.  
  211. ==============================================================================
  212.                            
  213.                            PROGRAMMING INFORMATION
  214.                            ~~~~~~~~~~~~~~~~~~~~~~~
  215.     Big  BBS  List was  written  entirely in  Turbo Pascal 6.0,  utilizing
  216.     RMDoor 4.1  communication routines  written by Mark Goodwin and  Randy
  217.     Hunt.
  218.  
  219. ==============================================================================
  220.  
  221.                            WHERE CAN I BE REACHED?
  222.                            ~~~~~~~~~~~~~~~~~~~~~~~
  223.                                    SUPPORT
  224.                                    ~~~~~~~
  225.     If  you  have  any  problems  or  questions,  I can  be  reached  at: 
  226.         
  227.         The  Magic  Of  Krynn  BBS     Fidonet - 1:238/440
  228.           (715) 344-4142 v.32bis       Doornet - 75:7715/0
  229.               24 hours a day                     75:7715/1
  230.  
  231.     You can leave me a message on my board, explaining the problem and I
  232.     will do my best to help you.  I can also be reached in the Fidonet
  233.     conferences Doorware and TriBBS Support on either Fidonet or WME.
  234.     
  235.     The latest version of BBLIST is available on The Magic Of Krynn or you
  236.     can just F'REQ the magic word BBLIST.
  237.  
  238.  
  239.                                 REGISTRATION
  240.                                 ~~~~~~~~~~~~
  241.     If  you  find  BBList  useful  or  use  it  for  more  than  30  days,
  242.     registration is required.  To register, fill out the registration form
  243.     included  in  this archive  (REGISTER.ME),  enclose  a cheque or money
  244.     order for $15.00.  United States currency only, please.
  245.  
  246.     After I receive your registration form and money, I will create a key
  247.     file  for you  and send it to you - see REGISTER.ME for more  details.
  248.     NOTE - DO NOT DISTRIBUTE YOUR KEY FILE. 
  249.  
  250. ==============================================================================
  251.  
  252.                                   COPYRIGHTS
  253.                                   ~~~~~~~~~~
  254.  
  255.     MS-DOS       copyright by the Microsoft Corporation.
  256.     Turbo Pascal copyright by Borland.
  257.     RMDoor 4.1   copyright by Mark Goodwin and Randy Hunt.
  258.