home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / GTPL_411.ZIP / RIMELIST.DOC < prev    next >
Text File  |  1993-05-27  |  16KB  |  318 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                   The Rime List Door
  8.                              (formerly PCRelay List Door)
  9.         =====================================================================
  10.  
  11.              Starting with the first STATES.RPT (now called LOCATE.RPT) since
  12.         going to  the Postlink software we all find that the BAUD rate option
  13.         has been dropped from the report. I for one am sorry to see it go and
  14.         it is beyond my control. 
  15.  
  16.              Program  now uses Door Patch 3.8 (other versions used Door Patch
  17.         3.5) and  supports the  following BBS  drop  file formats:  DOOR.SYS,
  18.         PCBOARD.SYS,  SFDOORS.DAT,  CALLINFO.BBS, DORINFO1.DEF,  DORINFO2.DEF
  19.         and CHAIN.TXT. Compatible  with at least  these BBS systems:  PCBoard
  20.         14+,  GAP 4+, RBBS-PC 17+. WILDCAT 2+  and Spitfire 3+. Also supports
  21.         baud rates up to 115,200 BPS.
  22.  
  23.  
  24.                           ***** Attention Rime Sysops! *****
  25.  
  26.              If  you register  this door  you may  deduct $5  from this  door
  27.         registration or  any combination in  the registration form.  You must
  28.         include your HUB ID and NODE ID. No discounts after registration!!
  29.  
  30.                                    ------ o ------
  31.  
  32.  
  33.              My programs may  be on  various BBSes around  the country  under
  34.         different archive extensions and types. This is the state of  all the
  35.         BBSes  around the country. I personally like LHARC better, slower but
  36.         smaller and suggest you give it a try.
  37.  
  38.              The archive file should contain the following files:
  39.  
  40.                       RIMELIST.EXE   RIMELIST.CFG   RIMELIST.DOC
  41.                    RLCREATE.EXE   READ.ME   SYSOP.DOC   LOCATE.RPT
  42.                                DOORS.TXT   SUPPORT.TXT
  43.  
  44.              RIMELIST.EXE  is  the main  program.  RIMELIST.CFG  is a  sample
  45.         configuration   file.  RIMELIST.DOC   is  this  file.   SYSOP.DOC  is
  46.         documentation   for  Sysop   (this   document   contains   additional
  47.         information to  the RIMELIST.DOC) and  the READ.ME contains  some bug
  48.         fixes  (if any)  and must  be included  in the  archive file  that is
  49.         downloadable on your  system. These files may  not be altered in  any
  50.         way.
  51.  
  52.              DOORS.TXT is  a list of my current BBS doors. SUPPORT.TXT is the
  53.         current BBS where I do my support from.
  54.  
  55.              LOCATE.RPT  is  the current  copy of  the text,  was STATES.RPT,
  56.         database that The  Rime List Door  converts and uses to  generate the
  57.         door's main database.  This can  be replaced with  later versions  of
  58.         same.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                           ************ Changes ************
  65.  
  66.              Starting with version 10.0 some of the program's file names have
  67.         changed along with STATE.EXE to RLCREATE.EXE,  etc. The database used
  68.         to be  called  STATE.DAT and  now it  is RIMELIST.DAT,  STATE is  now
  69.         LOCATE, some extensions were 'SDX' and the are now 'RDX'.  There have
  70.         been no file format changes, only some of the names.
  71.  
  72.              Blank fields (9.00+) were changed to a single '?'. They sort out
  73.         and look better  in the door.  Of course  now that the  Postlink/Rime
  74.         LOCATE.RPT is  out I see that  there are fewer blank  entries as they
  75.         should have been from the start. Thank you Bonnie Anthony!
  76.  
  77.  
  78.                                First Time Installation
  79.  
  80.              Put  RLCREATE.EXE,  RIMELIST.EXE,  RIMELIST.CFG (configured  for
  81.         your system) and LOCATE.RPT in the directory you plan to run the door
  82.         from. Run  RLCREATE.EXE to create the database  used by RIMELIST.EXE.
  83.         When it if finished your door is ready to run.
  84.  
  85.  
  86.                             Upgrade from Pre-10.0 Release
  87.  
  88.              Erase  the directory and start over. You may rename your current
  89.         STATES.RPT  to  LOCATE.RPT  and  then proceed  with  the  First  Time
  90.         Installation,  or you may  use the enclosed  LOCATE.RPT, whichever is
  91.         most current for your BBS.
  92.  
  93.  
  94.                                    ------ o ------
  95.  
  96.              My archive files no longer contains DORPCH38.EXE and BRUN30.EXE.
  97.         This was done to make the file smaller so that it takes up less space
  98.         on the  host BBS.  If you  need either the  DORPCH38.EXE file  or the
  99.         patched  BRUN30.EXE, they can  be obtained  from various  BBS systems
  100.         around the country.  If you cannot fine them, please  contact me. The
  101.         filename for Door Patch is DORPCH38.ZIP. 
  102.  
  103.              This  door comes with an example RIMELIST.CFG. It is supplied to
  104.         show  you how  to set  up  the configuration  file. The  file may  be
  105.         modified to suit. Please try  and limit the limit of your  Sysop name
  106.         to PCBoard's  name length of twenty-seven  characters (total length).
  107.         The  sixth line is for registration  serial number. If you change the
  108.         "Unregistered BBS" name or serial number it will still come up in the
  109.         door  as "Unregistered  BBS"  until  you  get a  registration  serial
  110.         number. No bulletin is generated by this program.
  111.  
  112.              C:\PCB\PCBOARD.SYS < change to suit your system
  113.              Unregistered BBS   < changes only take affect with registration
  114.              Boss               < change to sysop's first name
  115.              Dude               < change to sysop's last name
  116.              Your Sysop         < Door Donor's name
  117.              0000               < changes only take affect with registration
  118.  
  119.  
  120.  
  121.  
  122.  
  123.              On a network  system you must  set up a  separate .CFG for  each
  124.         node. Example:  RIMELST1.CFG, RIMELST2.CFG,  or whatever it  takes on
  125.         your BBS. You must then generate the BBS calling batch files for each
  126.         different node, and in their own directories to separate them.
  127.  
  128.              A typical batch file, RIMELIST. might look like this:
  129.  
  130.                   ECHO OFF                   ;turn echo off, not needed
  131.                   CD \PCB\DOORS\RIMELIST     ;change to door directory
  132.                   RIMELIST RIMELST1.CFG      ;configuration for Node 1
  133.                   CD \PCB\NODE1              ;return to Node 1
  134.                   NODE1                      ;reload Node 1
  135.  
  136.              A  single node BBS would  only need one  configuration file, but
  137.         the steps would be the same.
  138.  
  139.              The program, including Door Patch, uses six buffers, one through
  140.         six.  Your system  must  have this  many  or more.  RIMELIST.EXE  and
  141.         RIMELIST.CFG must be in the current directory along with the database
  142.         and it's indexes.
  143.  
  144.              Registration provides you with a serial number that will let you
  145.         enter your BBS name in the second line of the RIMELIST.CFG file. This
  146.         number replaces the "0000" in the sixth line of the .CFG file. Please
  147.         support Shareware!
  148.  
  149.  
  150.                                    Support Programs
  151.  
  152.                                      RLCREATE.EXE
  153.  
  154.              This program  is used in  conjunction with  LOCATE.RPT. It  will
  155.         extract the data,  create and  then sort the  indexes. The  resulting
  156.         files must be in the same directory as the door program.
  157.  
  158.              It  is suggested  that you  put the  above program  in  the same
  159.         directory  as  the RIMELIST.EXE/.CFG  files.  Each time  there  is an
  160.         update to LOCATE.RPT, you just put the new file in the door directory
  161.         and  rerun  RLCREATE.EXE. The  old  database  files are  deleted  and
  162.         replaced with new  ones. After  running RLCREATE.EXE  you can  delete
  163.         LOCATE.RPT, if  you really  need the disk  space. I do  not recommend
  164.         this since you might  want to make updates to the list  and rerun the
  165.         programs to update the door's database and indexes. You should always
  166.         keep the original file in some safe place no matter what you do.
  167.  
  168.  
  169.                   **************** W A R N I N I G ****************
  170.  
  171.              If you  add  a new  LOCATE.RPT to  the door,  please check  it's
  172.         format against  the previous  format  to make  sure that  it has  not
  173.         changed. If  the  format has  changed,  the database  generated  most
  174.         likely will  not run  properly  in the  door, and  a  new version  is
  175.         required. So  to keep  the door  up, do not  add the  newly formatted
  176.         LOCATE.RPT. I  have no control over what changes, when, or any of the
  177.  
  178.  
  179.  
  180.  
  181.  
  182.         strange formats and omissions in the report.
  183.  
  184.                                    ------ o ------
  185.  
  186.              The current time to convert the database is  about 20 seconds on
  187.         my 80386/33 mhz  (19ms/SCSI) machine.  Of course this  time is  being
  188.         figured on the current 1,000+ nodes. This is down at least four and a
  189.         half minutes from the QB 3.0 version and uses Turbo Pascal.
  190.  
  191.  
  192.                                       LOCATE.RPT
  193.  
  194.              LOCATE.RPT is extracted  from the most  current RIME.ZIP at  the
  195.         time the archive was  assembled. It is a  report generated by  Bonnie
  196.         Anthony ->RUNNINGA (#2).  It is suggested that you edit  this file to
  197.         insure that the information,  especially as it pertains to  your BBS,
  198.         is correct before you run RLCREATE.EXE.
  199.  
  200.              If  is possible  to do  an auto  update of the  LOCATE.RPT using
  201.         something  like this  in  your daily  event. A  line  like "IF  EXIST
  202.         C:\POSTLINK\UPLOADS\RIME.ZIP  THEN CALL UPDATE".  Where UPDATE.BAT is
  203.         something like:
  204.  
  205.              ECHO OFF                                       <optional
  206.              C:                                             <drive
  207.              CD \DOORS\RIMELIST                             <door directory
  208.              PKUNZIP C:\POSTLINK\UPLOADS\RIME LOCATE.RPT /o <unarchive
  209.              RLCREATE                                       <create database
  210.              C:                                             <resume event
  211.              CD \BBS                                         drive&directory
  212.  
  213.              If you use  something like this  you must  remember to move  the
  214.         RIME.ZIP archive from wherever it is searched for or  the update will
  215.         happen  on every  event. This  way whenever  Postlink receives  a new
  216.         RIME.ZIP  the door can be automatically updated with the most current
  217.         LOCATE.RPT.
  218.  
  219.  
  220.                                 If File Format Changes
  221.  
  222.              If the data file format changes a new release will be written as
  223.         soon at such  an event is  brought to my  attention. I do  not always
  224.         have the most current LOCATE.RPT and the one in the  archive might be
  225.         old by the time you receive it. Because of the varied formats already
  226.         in existence  it is impossible to configure the software to fit. If a
  227.         standard format  for files is ever  achieved, I can  do likewise with
  228.         the door and the support program(s).
  229.  
  230.  
  231.                                      Other Stuff
  232.  
  233.              If you have comments on the program, please feel free to contact
  234.         me. Also,  if program errors  develop, please  contact me at  once so
  235.         that corrections can be made.
  236.  
  237.  
  238.  
  239.  
  240.  
  241.              Usable idea's for  door programs (games  or anything else)  will
  242.         provide the donor BBS with a free, registered, copy of that
  243.         particular program. This  is my  way of saying  "Thank you" for  your
  244.         program ideas.
  245.  
  246.              At this time  the programs are  written to work on  any computer
  247.         with an eighty column screen.
  248.  
  249.              You can  get all my door software directly from me by sending me
  250.         diskette(s), any PC format, to cover one meg of files,  and include a
  251.         mailer  with return postage. You may  include postage and label for a
  252.         reusable mailer. See DOORS.TXT in archive!
  253.  
  254.              Registration is for one BBS/Network configuration! More than one
  255.         copy  may run  on  the  same BBS/Network  at  the  same location.  If
  256.         ownership changes new owner must pay an update  fee, which includes a
  257.         new serial number, and most current release.
  258.  
  259.  
  260.                           J A M E S  H U C K A B E Y  
  261.                               software with a heart
  262.  
  263.                                  James Huckabey                   Date:
  264.                               3621-A Fraser Street
  265.                           Bellingham, Washington 98226
  266. ===============================================================================
  267. QUANTITY|               DESCRIPTION                       | EACH  |    TOTAL 
  268. =============================================================================== 
  269.         |   Registration of RIMELIST.EXE (Rime List)      | 20.00 |
  270.         |   U.S. for current copy of software please add  |  2.00 |
  271.         |                        Outside U.S. please add  |  4.00 |
  272.         |   Please check disk type below.                 |       |
  273. -------------------------------------------------------------------------------
  274.         |   Upgrade from an earlier version to current    | FREE  |
  275.         |   please send diskette with return postage.     |       |
  276. ------------------------------------------------------------------------------
  277.         |    Dual registration of any two different       | 35.00 |
  278.         |    doors, any versions, $17.50 each.            |       |
  279. -------------------------------------------------------------------------------
  280.         |    Registration of any four or more doors at    | 60.00+|
  281.         |    one time at $15.00 each.                     |       |
  282. -------------------------------------------------------------------------------
  283.         | 1 set of all door software on your diskette(s)  | FREE  |
  284.         | (1 meg) in your return postage paid mailer.     |       |
  285. -------------------------------------------------------------------------------
  286.            (prices are subject to change)                SUBTOTAL |
  287.            (Washington state residents please add 7.8%) SALES TAX |
  288.                                                                   =============
  289.                                     (U.S. funds only) GRAND TOTAL |
  290. ..................................................................... ..........
  291. FROM: 
  292.         NAME: 
  293.              -------------------------------------------------------
  294.      ADDRESS:  
  295.              -------------------------------------------------------
  296.         CITY: 
  297.              -------------------------------------------------------
  298.  STATE & ZIP: 
  299.              -------------------------------------------------------
  300.       HUB ID:                        NODE ID:
  301.              -----------------------         -----------------------
  302. PHONE(voice):                          (data)
  303.              -----------------------         -----------------------
  304.  
  305.    Please supply  name of BBS  to be added to  program(s); it may  include other
  306. data up  to thirty characters.  This is to  be on one line  of code and  must be
  307. legible since  the  serial number(s)  is  based on  exact  syntax. I  cannot  be
  308. responsible for unreadable data. Please print. Case sensitive!
  309.  
  310. Example: "Jim's Graphic BBS". In the door it comes out:
  311.  
  312.                           This program is registered to
  313.  
  314.                                Jim's Graphics BBS
  315.  
  316. -------------------------------------------------------------------------------
  317.  
  318.                 1.44 meg [ ]   720K [ ]   1.2 meg [ ]   360K [ ]