home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d7xx / d771 / bbbbs.lha / BBBBS / BBBBS.txt next >
Text File  |  1992-12-05  |  17KB  |  392 lines
  1.                         14 November 1992
  2.             *** Last revision for at least 6 months! ***
  3.  
  4.  BBBBS 5.7 - Baud Bandit Bulletin Board System for the Amiga - BBBBS 5.7
  5.    
  6.  All reported bugs have been repaired.
  7.  Up to 99 file libraries with extended filenotes.
  8.  Up to 99 fully threaded message conferences.
  9.  Number of users, files, messages, etc. are only limited by storage space.
  10.  Controlled file library and message conference access for users & sysops.
  11.  Interface to extra devices like CD-ROM & others, all treated as Read-Only.
  12.  Complete Email area including binary mail, and multiple forwarding.
  13.  User statistics including messages written, files ul/dled, time, etc.
  14.  Independent, freeform user profile/bio/resume area.
  15.  RexxDoors include Grin_du_Jour, Polling_Place, Star_Trek, ShoList,
  16.   Hollywood_Squares, Wheel_Of_Fortune, with many more available.
  17.  Searches: Search users, file descriptions, or messages.
  18.  Online Text Editor: with Cut, Paste, Replace, and Spellchecking.
  19.  Separate multi-tasking module for local sysop logon.
  20.  Background archiving of selected messages or file library descriptions.
  21.    
  22.   To see this BBS running, call (206) 744-1254  (PCPursuit: WASEA)
  23.    
  24.          written by Richard Lee Stockton of Gramma Software
  25.       FREELY DISTRIBUTABLE AS LONG AS COPYRIGHT NOTICE REMAINS
  26.      NOTE: Requires ARexx 1.15 and BaudBandit 1.50 (or greater).
  27.  
  28.     BBBBS - Baud Bandit Bulletin Board System for the Amiga - BBBBS
  29.  
  30.  
  31. ********************  Copyrights and Distribution  ********************
  32.  
  33. The ARexx modules in BBBBS are copyright 1990-91-92 Richard Lee Stockton,
  34. and ALL RIGHTS ARE RESERVED. In particular, commercial use of these
  35. programs requires a written agreement with the author. HOWEVER, these
  36. files may be freely distributed and used for non-commercial purposes
  37. AS LONG AS the copyright notices contained within the code remain intact.
  38.  
  39. To contact me for distribution or just more information:
  40.  
  41.                 Richard Lee Stockton
  42.                 21305 60th Ave West
  43.                 Mountlake Terrace, WA 98043-2009
  44.                 
  45.                 Phones:
  46.                 voice = 206-776-1253
  47.                 FAX   = 206-775-7573
  48.                 BBS   = 206-744-1254
  49.                 
  50.                 Telecomm:
  51.                 call the BBS number above and leave a [C]omment to sysop.
  52.                 - OR - send Email to RLStockton on PORTAL or BIX or GENIE
  53.                 - OR - (if you MUST), my Compu-$erve address is 71650,424
  54.  
  55.  
  56.  
  57. ******************   Requirements for operation   ************************
  58.  
  59. BBBBS Requirements:    Assumes standard 1.3 or 2.0 Amiga OS
  60.  
  61. RAM: ~2.5 MEGS of RAM to run. 2.0 MEG without spellchecking.
  62.  
  63. Commercial Software:
  64. (I have *nothing* to do with these, except for using them.)
  65.   BaudBandit  1.50 - $50 retail, ~$30 discounted
  66.   ARexx       1.15 - $50 retail, ~$30 discounted
  67.  
  68.  
  69. Freely Distributable Software:
  70. (comes with BBBBS or are easily found in the PD)
  71.   BBBBS.LZH
  72.     rexx  (must be in your rexx: drawer)
  73.       Answer.baud
  74.       ArcBrowse.rexx
  75.       ArcMsgs.rexx
  76.       baud.rexx
  77.       bbsALPHA.rexx
  78.       BBBBS.baud
  79.       BBBBSdemon.baud
  80.       bbsExtDL.baud
  81.       bbsHOURLY.rexx
  82.       bbsLOCAL.rexx
  83.       bbsMAINT.baud
  84.       bbsNewFile.rexx
  85.       bbsREPORT.rexx
  86.       bbsULDL.rexx
  87.       bbsUSER.rexx
  88.       BuildALPHA.rexx
  89.       BumpLevel.baud
  90.       BumpMember.baud
  91.       BumpTime.baud
  92.       ChangeUserName.rexx
  93.       Contents.rexx
  94.       doorDemon.baud
  95.       EditUsers.rexx
  96.       ForceChat.baud
  97.       Make_BrowseList.baud
  98.       OldEMail.rexx
  99.       Setup.rexx
  100.       ShowFKeys.baud
  101.       ShowLog.baud
  102.  
  103.     rexxDoors  (these are needed for opening and closing cookie, etc.)
  104.       Data (DIR)
  105.         Grins
  106.       Grin_du_jour.rexx
  107.       Moon.rexx
  108.       Time.rexx
  109.  
  110.  
  111.   libraries (must be in your system Libs: drawer)
  112.     arp.library           (VERS 39.1  by CHeath & others on bbs everywhere)
  113.     rexxarplib.library    (VERS  3.0  by Willy Langeveld on bbs everywhere)
  114.     screenshare.library   (VERS  1.52 comes with rexxarplib)
  115.     rexxmathlib.library   (VERS  1.3  by Willy Langeveld on bbs everywhere)
  116.     rexxsupport.library   (VERS 34.9  comes with ARexx 1.15)
  117.     rexxsyslib.library    (VERS 36.23 comes with ARexx 1.15)
  118.  
  119.   commands (must be in your system C: drawer
  120.     QuickSort             (by Marvin Weinstein - ARexxQSort.lzh)
  121.     sound                 (by RLStockton, needed to play BBS Yell.snd)
  122.     boot                  (optional: warm-boots if BBBBS seems frozen)
  123.     lha                   (freely distributable de-archivers...)
  124.     arc
  125.     zoo
  126.     unzip
  127.     dms
  128.  
  129.  
  130. **************************  Organization  **********************************
  131.  
  132. BBS:
  133.  
  134.   BBBBS looks in your s: directory for the file "CONFIG.BBS" which sets all
  135.     preferences including the device where the BBS files are located.
  136.   Within this device, the BBS may use 99 file & 99 message directories.
  137.   Users may be given access levels between 0 (new user) and 99 (super-sysop).
  138.   The lowest sysop level (gets to edit filenotes, maybe edit messages
  139.     depending on level) defaults to 80. Level 99 (and only level 99!) is
  140.     allowed to open a remote Shell and the power to edit ANY file remotely.
  141.   Uload/Dload access to libraries & conferences at or below the user's level.
  142.   Also, a sysop may exclude certain directories from the user's use.
  143.     (file libraries by name, or message conferences by number)
  144.  
  145.  
  146. BBS System File Directories:
  147.  
  148. 'Sysops'       = Holds files for sysop review.
  149.  
  150. 'Information'  = User viewable files. 'I' from the Main Menu.
  151.  
  152. 'Scratch'      = temporary editor files, etc. For debugging.
  153.  
  154. 'BBS_HELP'     = Command summary files, according to level.
  155.  
  156. 'rexxDoors'    = rexx doorway programs
  157.                   Grin_du_Jour.rexx      = 'one-liner' humor
  158.                   Moon.rexx              = the phase of the moon
  159.                   Time.rexx              = the time in words
  160.  
  161.                   rexxDoors/Data/Grins   = data for 'Grin_du_Jour.rexx'
  162.  
  163.                   ...other rexxDoors available in "BBDoors.lha"
  164.  
  165.  
  166. 'BBS_TEXT'     = Text (mostly) files used by the BBS.
  167.                   HELLO          = Sign on message. (19 lines max!)
  168.                   NEW            = New user welcome message.
  169.                   YELL.snd       = (optional) Yell-For-Sysop sound.
  170.                   YELL           = (optional) Yell voice script.
  171.                   WELCOME        = default welcome message
  172.                   WELCOME.Mon, WELCOME.Tue, ..., WELCOME.Sun
  173.                                  = Daily Welcome messages.
  174.                   WELCOME.1225   = Christmas welcome msg., etc.
  175.                   UNTIL.19920201 = displays at logon through Feb 1, 1992
  176.                   GOODBYE        = Logoff message. (local BBS numbers)
  177.                   DEF.NEW_USER   = new user defaults
  178.                   DEF.MEMBER     = member defaults
  179.                   DEF.COURTESY   = courtesy list defaults
  180.                   BIRTHDAY       = displays on user's birthday
  181.                   PROFILES       = intro message to user profiles area.
  182.  
  183. 'FileNotes'    = A dir of dirs. Each dir corresponding to a
  184.                   file library. Within each, a file desciption
  185.                   of the corresponding file in the library.
  186.                   Written by BBBBS.baud, but editable.
  187.  
  188. 'BBS_LIBS'     = Up to 99 file libraries. You select the names of
  189.                   these by editing the file 'BBS:Lists/Libraries'.
  190.                   The BBS sees them by name.
  191.                                 
  192. 'BBS_MSGS'     = Up to 99 message conferences. You select the
  193.                   names of these by editing the file
  194.                   'BBS:Lists/Conferences', but the BBS sees
  195.                   them as MSG1 thru MSG99.
  196.  
  197. 'Lists'        = System lists and lists needed by bbsREXX.
  198.                   Libraries    = see example for proper format
  199.                   Conferences  = see example for proper format
  200.                   Files        = THIS FILE IS WRITTEN BY BBBBS.baud.
  201.                    Under normal circumstances it should NOT be edited
  202.                    by humans.   format: 'filenum dirname filename'
  203.                   Files.ALPHA  = written by BBBBS.baud
  204.                   Courtesy     = List of VIP usernames. A new
  205.                    user on this list is given immediate access.
  206.                    That name is then removed from this list.
  207.                   Excuses      = list of randomly selected reasons why
  208.                    the sysop cannot CHAT right now.
  209.  
  210. *** Following dirs contain files written by BBBBS.baud. DO NOT EDIT! ***
  211.  
  212. 'Numbers'      = LastFile, LastMail, LastMessage1, etc.
  213.                  Also a dir called "Hourly" that contains data
  214.                   for the "average minutes of use per hour" graph.
  215.  
  216. 'Usage'        = Monthly files. Counts hours of modem usage.
  217.  
  218. 'Logs'         = Daily files. Tracks user, time, mail or message activity,
  219.                   uloads/dloads, internal errors, etc.
  220.                   Built in 'log-reader' for sysops.
  221.  
  222. 'EMailFiles'   = Private files left attached to EMail.
  223.  
  224. 'EMail'        = Private mail between users.
  225.  
  226. 'Users'        = User files.
  227.  
  228.  
  229.  
  230. ***************************  Setting Up  *****************************
  231.  
  232. Follow these steps to set up your own BBS..
  233.  
  234. 1. Do Initial Setup  (assumes that bbspath is "BBS:")
  235.  
  236.       a. CD to BBS:            ; the directory to de-lharc the bbs into
  237.  
  238.       b. Lha x BBBBSnn.lha     ; extract respecting original paths
  239.  
  240.       c. COPY BBS:rexx/QuickSort C:    ; ARexx QuickSort
  241.  
  242.       d. COPY BBS:S/#? S:      ; CONFIG.BBS, Bandit.Keys, Bandit.Config
  243.  
  244.       e. COPY BBS:rexx/#? REXX:  ; NOTE: 450K of rexx programs!
  245.  
  246. 2. Make sure that "C:DATE" returns the correct time and date. The BBS
  247. needs to know the correct time and date for many of its routines.
  248.  
  249. 3. Use a Text editor to edit the following lists. These lists can be
  250. changed or edited anytime. The libraries may be re-ordered at any time,
  251. but the message conferences can only be added to, not re-shuffled. That
  252. is, once you associate a message conference title with its number, and
  253. messages are actually written to that conference, you MUST keep that same
  254. number associated with that conference title. (This is because messages
  255. are kept in MSG1, MSG2, etc. while files are kept in directories created
  256. with the title that YOU give it.  Note: No spaces are allowed in titles).
  257. You may change the CONFERENCE title, but the old messages in that
  258. conference will still refer to the old title. It is possible to change
  259. a LIBRARY title, but you also have to rename the directory, and update
  260. all references to the old dir (which can be quite a few!), so I advise
  261. against it.  Use care in all title selections and save yourself future
  262. problems with re-naming.
  263.  
  264.      a. BBS:Lists/Conferences    (message conference names)
  265.  
  266.      b. BBS:Lists/Libraries    (file library names)
  267.  
  268. Note: If you wish to review uploaded files before public posting, you need
  269.       to be certain that the highest possible non-sysop directory is called
  270.       "Sysops", as this is where new uploads will be saved.
  271.  
  272.      c. BBS:Lists/Courtesy   (these names receive INSTANT validation)
  273.  
  274.      d. BBS:Lists/Excuses  (good reasons why the sysop can't chat right now)
  275.  
  276. 4. Use a Text editor to edit "S:CONFIG.BBS" to your preferences.
  277. IMPORTANT! Test your "c:info" from the CLI with your "info-compatible"
  278. device name to make sure that the blocks free amount is being returned.
  279. See BBS_TEXT/CONFIG.BBS for line by line a description of the options.
  280. Note that if line 30 of the config is 1, the BBS stays "up" all the time,
  281. which means the CONFIG.BBS and the various Lists are not reloaded each
  282. call. DO NOT change the file libraries using bbsLOCAL.rexx while the BBS
  283. is in resident mode as this will confuse the BBS and files will be lost.
  284. To exit resident, use SHIFT-F2 from BaudBandit to setclip BBS_QUIT=QUIT.
  285. It may take up to two minutes for BBBBS to notice that it is supposed to
  286. unload before it will actually halt the rexx process. Watch for the blue
  287. dot to disappear from the upper right part of the BaudBandit titlebar.
  288.  
  289. If you want the default sysop name to be something other than "SYSOP":
  290.   a. The name should be in all caps with the "_" character substituted for
  291.        spaces. (ie, RICHARD_LEE_STOCKTON).
  292.   b. Then, put "SYSOP" in the exclusion list to make sure no one else can
  293.        use "SYSOP" as their user name.
  294.   c. Delete the file "Users" in the "Lists" drawer of the BBS.
  295.   d. Finally, Rename BBS:Users/SYSOP BBS:Users/<your sysop name>
  296.  
  297. 5. Use the Text editor on the following textfiles to be read by the user.
  298.  
  299.     a. BBS:BBS_TEXT/HELLO     /* this is the title message */
  300.  
  301.     b. BBS:BBS_TEXT/NEW       /* message to new users */
  302.  
  303.     c. BBS:BBS_TEXT/WELCOME   /* once-a-day welcome to users */
  304.  
  305.     d. BBS:BBS_TEXT/GOODBYE   /* last thing the user sees */
  306.     
  307.     e. BBS:Information/SYSTEM_INFO   /* what Amiga model, OS, etc */
  308.  
  309. 6. You may also wish to edit the default user files in the BBS_TEXT drawer,
  310.     but I suggest leaving them alone until you gain a better understanding
  311.     of the BBS system.
  312.  
  313.     a. DEF.NEW_USER   /* all lines are used */
  314.  
  315.     b. DEF.COURTESY   /* all lines are used */
  316.  
  317.     c. DEF.MEMBER     /* ONLY time, level, and exclude_dirs are used */
  318.  
  319. 7. Start the LOCAL BBS by typing  "rx bbsLOCAL SETUP". Enter "sysop"
  320. (or the name you changed it to) when asked to enter your name, then
  321. enter "password" when asked for a password. This will construct the
  322. directories you specified in BBS:Lists/Libraries, (if they don't already
  323. exist).. likewise, the message conferences will be constructed, if needed.
  324. You will then enter the bbs _AS IF_ it were running from the modem,
  325. although Baud Bandit is not needed at all.
  326.  
  327. 8. Select "Y" to edit your personal data. CHANGE YOUR PASSWORD!!
  328.  
  329. 9. Read the BBBBS.COMMANDS file in [I]nformation for general command
  330. information, and take a look around the board. Try out some things a
  331. user would try.
  332.  
  333. 10. Use "G" to logoff which will rewrite your user file.
  334.  
  335. 11. Start BaudBandit. Check BB's Macro display. The important thing
  336. here is to make sure that "\mAnswer.baud" is in "RING" portion of BB's
  337. configuration.
  338.   2400 baud operation:
  339.     Handshake should be set to "NONE" (otherwise CTRL-S can hang the BBS).
  340.     AutoBaud should be set to "ON" and the baud rate to the same value
  341.      you have set in BBS:BBS/CONFIG as the Maximum baudrate.
  342.   9600 baud operation:
  343.     Handshake should be set to "7-Wire".
  344.     AutoBaud should be set to "OFF" and the baud rate set to the maximum
  345.      "terminal-to-modem" baudrate (19200 max for less than 68020 cpu).
  346.     I have used Practical Peripherals modems and the setup strings are:
  347.        9600SA    AT &F M0 &C1 &D3 S95=47 &W
  348.       14400FXSA  AT &F M0 W1 &C1 &D3 &T5 S37=11 S95=47 S118=2 &W
  349.  
  350.         &F      = factory defaults
  351.          M0     = turn speaker off  [optional]
  352.          W1     = enable progress messages
  353.         &C1     = track DCD
  354.         &D3     = monitor DTR and reset to power up conditions
  355.         &T5     = disable remote testing  [optional]
  356.          S37=11 = highest modem to modem rate is 14400
  357.          S95=47 = all progress messages and modem-modem speed report
  358.          S118=2 = LCD display 2 seconds per line of info.  [optional]
  359.         &W      = save to modem RAM so ATZ will recall these settings
  360.   
  361.      These may or may not work for you, but at least it's a place to start.
  362.      Note that you only have to give this command once, then the "ATZ"s
  363.       that BBBBS sends will reset your modem to this default.
  364.  
  365. There are Bandit.Config files provided for both 9600/14400 and 2400.
  366. If you make any changes remember to save them.
  367.  
  368. NOTE! Your modem MUST be set so that you can see verbose responses from
  369. your modem on your BB screen (ie, RING, CONNECT 9600/ARQ (or whatever),
  370. NO CARRIER, OK, etc). The baudrates reported by the modem should be the
  371. modem-to-modem baudrate. Correct BBS operation depends on these messages.
  372.  
  373. 12. If you have RAM to spare, give yourself a large capture buffer in
  374. BaudBandit, especially if you will be debugging. You can use BB's
  375. review buffer to study what the user did, in what order, and what
  376. happened. I have mine set to about 150k..
  377.  
  378. 13. To set up the BBS to start automatically in the background, add
  379. these lines to your startup-sequence:
  380. (assumes that BaudBandit is in the BBS: drawer)
  381.  
  382.     assign rexx: dh0:rexx  ; Edit dh0:rexx to YOUR rexx drawer.
  383.     rx setup
  384.     BBS:BB                 ; Edit this to YOUR BaudBandit path
  385.     WaitForPort BAUD
  386.     ;rx Baud OFF  ; uncomment this line to close BB's screen after startup
  387.     run rx "ADDRESS BAUD;Send '\mBBBBS.baud'"
  388.  
  389. 14. Wait for callers, and soon become beloved sysop to billions of users...
  390.  
  391. ***********************  end of BBBBS.txt  ****************************
  392.