home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / ACEY11.ZIP / IBBS29.ZIP / INTERBBS.DOC < prev    next >
Text File  |  1995-01-15  |  6KB  |  122 lines
  1.                                INTERBBS
  2.  
  3.                                   v2.9
  4.  
  5.                                    by
  6.  
  7.                               Al Lawrence
  8.  
  9.                              Sunrise-80  BBS
  10.                     (404) 256-9525 (Data 28.8 v.34)
  11.                     (404) 705-9104 (Data 28.8 v.34)
  12.                  (404) 256-9518 (Voice, 9am-9:30pm EST)
  13.  
  14.  
  15.  
  16.  
  17. The INTERBBS program is used by the InterBBS capable Sunrise Doors to
  18. facilitate the exchange of score files between any number of BBS'. You can
  19. be either a HUB, REGIONAL or a NODE.
  20.  
  21. An accompanying file called, INTERBBS.TXT, gives you all the information you
  22. will need to use Sunrise-80 BBS as your HUB (optional as you may use anyone
  23. or set yourself up as a HUB).
  24.  
  25. This ZIP (IBBSxx.ZIP) will be in every InterBBS Door ZIP file. However, to
  26. ensure that you stay up-to-date with the latest breaking news look for
  27. IBBSxx.ZIP as a standalone file.
  28.  
  29. ----------------------------------------------------------------------------
  30.  
  31. InterBBS will recognize whether you are operatring as a HUB, REGIONAL or NODE
  32. based on the entry (or lack of entry) on the InterBBS command line.
  33.  
  34. If you are a NODE you would upload your InterBBS files DIRECTLY to a HUB
  35. where all consolidation would take place. If you are a REGIONAL you can have
  36. as many NODES as you wish. Each NODE would send their INTERBBS filesto the
  37. REGIONAL who in turn combines them and sends them on to the HUB. In turn the
  38. REGIONAL would then pick up the most current combined score files, from the
  39. HUB, and make them available to the NODES. In this way only the REGIONAL has
  40. to make a call to the HUB. A REGIONAL MUST maintain the node number assigned
  41. by the HUB but may assign any numbers to their NODES.
  42.  
  43. Once a NODE or REGIONAL receives their file from the HUB, they would run
  44. INTERBBS again to import the new updated scores OR wait until they are ready
  45. to do an EXPORT... INTERBBS can be run ANY number of times during the day!
  46.  
  47.                     =========================
  48.                     | Command Line Examples |
  49.                     =========================
  50.  
  51.                 Node    :  INTERBBS Monte Monte.cfg
  52.                 Hub     :  INTERBBS Monte Monte.cfg HUB
  53.                 Regional:  INTERBBS Monte Monte.cfg REGIONAL
  54.  
  55.  
  56.  
  57.                          IBBSNODE.HUB File
  58.                          -----------------
  59.  
  60.                   (REQUIRED for Regionals and Hubs)
  61.  
  62. When running as a HUB or REGIONAL, you MUST create a file called IBBSNODE.HUB.
  63. This file will contain NODE Number, STATE or COUNTRY abbreviation code,
  64. BBSNAME information for each BBS participating in the InterBBS game.
  65.  
  66. This file MUST be in EVERY Door directory that is being played InterBBS.
  67. HOWEVER, if you wish to have only ONE copy of this file in your system
  68. (which is recommended), then you MUST set an environment variable with the
  69. FULL drive and pathname where the IBBSNODE.HUB file is located and it MUST end
  70. with a \. An example follows, assuming the file is located in a directory
  71. called UTILITY located on drive C.
  72.  
  73.                     SET IBBS=C:\UTILITY\
  74.  
  75. If you are tight on environment space then you may want to try setting the
  76. variable in the batch file you use to execute INTERBBS and then issue a
  77. SET IBBS=   at the end of the batch file to free up the space.
  78.  
  79. The IBBSNODE.HUB file layout (XXX YYY ZZZ) explanation follows:
  80.  
  81. Column 1: XXX = Node ID Number. MUST be 3 digits (ie: 010)
  82. Column 4: Blank
  83. Column 5: YYY = 2-character STATE or 3-character COUNTRY abbreviation indicating
  84.                 where the BBS is located. If you are in the United States then
  85.                 you must use the STATE abbreviation; if you are outside the US
  86.                 then use a 3 character COUNTRY CODE. This field MUST be a total
  87.                 of 3 characters. If you are entering 2 characters, the third
  88.                 character must be a BLANK. This field will be displayed at the
  89.                 end of each BBS name displayed in the High Scores for EACH
  90.                 InterBBS game. If it does not show then it means that the Door
  91.                 program has not been updated (they will all be updated so be
  92.                 patient).
  93. Column 8: Blank
  94. Column 9: ZZZ = BBS Name of participating BBS. The name MUST match the BBSname
  95.                 in the Door's CFG file
  96.  
  97.  
  98.                          INTERBBS.LOG File
  99.                          -----------------
  100.  
  101. An INTERBBS.LOG file is created in each Door Directory. This file logs the
  102. actions taken, as well as the errors encountered, with the files being acted on.
  103.  
  104. If you wish to maintain only ONE InterBBS.LOG file you MUST SET an IBBSLOG
  105. environmental variable. To SET this variable enter the following in your
  106. Autoexec.BAT file:  SET IBBSLOG=C:\UTILITY\    (assumming you wish to keep the
  107. LOG in your UTILITY directory). If you wish to continue maintaining separate
  108. LOG files DO NOT USE AN ENVIRONMENTAL VARIABLE. You should be forewarned that
  109. if you are using the environmental variable you MUST run your INTERBBS programs
  110. single stream ( one at a time ) as the LOG file will not behave well if more
  111. than one InterBBS program is trying to access it at one time!!!
  112.  
  113.                          Monthly Top 10 Score File
  114.                          -------------------------
  115.  
  116. A file will be created at the end of each month, for each InterBBS Door, that 
  117. will list the Top 10 scores from the prior month. The file will use the 
  118. Doorname found on the InterBBS command line plus an extension of "T10". The 
  119. file will be created by the HUB and should be made available for Node 
  120. downloading as is the combined score file.
  121.  
  122.