home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / MAGAZINE / MISC / CDR120.ZIP / CDRSYSOP.DOC < prev    next >
Encoding:
Text File  |  1991-11-13  |  14.3 KB  |  330 lines

  1.  
  2.      CDR-Door - Carrier Detect Reader Door - Version 1.20
  3.      -------------------------------------
  4.           CDR-Door and Local Reader (c) 1991 Scott M. Baker
  5.           Carrier Detect Journals (c) 1991 Michael W. Crosson
  6.  
  7.           The Carrier Detect Reading Door (or CDR-DOOR for short)
  8.           is a door that will allow your callers to your BBS system
  9.           read articles from the journal while online.  The reasons
  10.           why someone would want to do this are numerous. One of the
  11.           best would be to help decide which program to download from
  12.           your system when faced with numerous choices (such as in
  13.           in case of a BBS package).  This door presents the articles
  14.           from all issues in a manner that makes it very easy to compare
  15.           the features, prices, and performance of many programs all
  16.           in one convenient place.
  17.  
  18.  
  19.      FILES IN PACKAGE
  20.      ----------------
  21.  
  22.           Your CDR-Door archive should contain the following files:
  23.  
  24.           CDRDOOR  CTL    Control File for Door
  25.           CD01JULY CDX    CD July 91 door edition
  26.           CD01MAY  CDX    CD May  91 door edition
  27.           CDRDOOR  EXE    Cdr-Door Executable
  28.           DOFIRST  CDX    Cdr-Door Indexing File
  29.           CDREADER ANS    The ANSI format main menu
  30.           CDRSYSOP DOC    This documentation
  31.           REGISTER FRM    CDR-Door Registration Form
  32.  
  33.           Please note that CDR-Door files are distributed in a secure PKZIP
  34.           envelope with -AV authenticity verification.
  35.  
  36.  
  37.      SETUP INFORMATION
  38.      -----------------
  39.  
  40.        I. Unzip CDR-DOOR into a subdirectory on your bbs system.
  41.  
  42.       II. Edit CDRDOOR.CTL with any plain-Ascii text editor. The control
  43.           file is pretty much self-explanatory, but I will list some of
  44.           the options that you will most likely need to change.
  45.  
  46.           A. "SysopFirst" for this option, put your first name.
  47.  
  48.           B. "SysopLast" ... Put your last name.
  49.  
  50.           C. "BBSType" This is the most critical (and most complicated)
  51.              part of setting up the door. You'll need to specify the
  52.              type of BBS software and type of door file that you wish to
  53.              create (for systems that CAN create more than one type
  54.              of door file like Tag, Telegard or Omega BBS).
  55.  
  56.              I recommend using the RBBS (DORINFOx.DEF) method if possible.
  57.              The door support for RBBS has been tested the most and is
  58.              known to be the most compatible of the door formats supported
  59.              by the CDR-Door.  Part of the reason for this is that the
  60.              door format for RBBS does not change often and as such can
  61.              usually be counted on to work without any problems.
  62.  
  63.              Even if your BBS package does not support RBBS type doors
  64.              internally, it is possible to use a door conversion type
  65.              program like QuickDoor (usually found as QKDOOR2C.ZIP).
  66.              Quickdoor can convert to and from many popular BBS systems.
  67.  
  68.              1. Setting up with DORINFOx.DEF (RBBS format)
  69.  
  70.                 a) The line you'll need to put in the .CTL file is
  71.                    "BBSTYPE RBBS".
  72.  
  73.                 b) If your software creates a DORINFOx.DEF file
  74.                    automatically, then you will simply need to copy
  75.                    that file into the DORINFOx.DEF directory.
  76.  
  77.                        - - - Otherwise - - -
  78.  
  79.                 c) Call CDRDOOR with NO PARAMETERS if your software
  80.                    created a DORINFO.DEF file. If your software created
  81.                    a DORINFO1.DEF, DORINFO2.DEF, etc, then run CDR-DOOR
  82.                    with the node number as a parameter. (i.e. "CDRDOOR 1")
  83.  
  84.              2. Setting up with other software.
  85.  
  86.                 a) Put the "BBSTYPE xxx" line in the .CTL file where xxx
  87.                    is one of the bbs types listed in the .ctl file.
  88.                    Internal support is included for Wildcat!, PC Board,
  89.                    QuickBBS, Phoenix, and WWIV.
  90.  
  91.                 b) When you activate CDR-DOOR, you'll probably need to
  92.                    copy whatever door file your software creates into the
  93.                    CDR-Door directory. This may be PCBOARD.DAT for
  94.                    PCBoard, CALLINFO.BBS for Wildcat!, CHAIN.TXT for
  95.                    WWIV etc.  For example, if you were running Wildcat! 2.5
  96.                    you would create batch file that would be similar to this.
  97.  
  98.  
  99.              @ECHO OFF
  100.              C:
  101.              CD C:\WILDCAT
  102.              COPY CALLINFO.BBS C:\WILDCAT\DOORS\CDREAD
  103.              CD C:\WILDCAT\DOORS\CDRDOOR
  104.              CDRDOOR
  105.              CD C:\WILDCAT
  106.              CAT.BAT
  107.  
  108.  
  109.              Consult your bbs software manual for further information.
  110.  
  111.  
  112.  
  113.           D. "INTERNAL". If you are not using a fossil driver then you will
  114.              have to uncomment this line. Doordriver works best with
  115.              a fossil, (BNU and X00 are two of the most common) and use
  116.              of one is strongly recommended.  If you do not have a
  117.              fossil, use the "INTERNAL" option to activate doordriver's
  118.              internal communication routines.
  119.  
  120.           E. "MONO". If you have a monochrome monitor, your display will
  121.              be better with this option.
  122.  
  123.       III. Set up your bbs software to activate CDR-Door. This usually
  124.            involves creating some sort of batch file used to start the
  125.            reader. Your bbs software manual should explain how it
  126.            works.
  127.  
  128.        IV. Add any Carrier Detect issues that you have. (described below)
  129.  
  130.  
  131.      COMMAND LINE PARAMETERS
  132.      -----------------------
  133.  
  134.      "/L"    will log you on in local mode.
  135.  
  136.      "/S"    sysop fast logon - uses username in the .CTL file.
  137.  
  138.      "/Nx"   node number. (for DORINFOx.DEF users. i.e. /N2 for node 2, etc)
  139.  
  140.      "/Pyyy" specifies path to drop files. (i.e. DOOR.SYS, DORINFOx.DEF,
  141.              etc.). For example, /PC:\BBS would tell CDRDOOR that the
  142.              drop file is in C:\BBS.
  143.  
  144.      ADDING ISSUES
  145.      -------------
  146.  
  147.              Carrier Detect Journals are currently produced bimonthly.
  148.              Issues can be "accumulated" by the door to appear as
  149.              one big issue.  It is important to note that there are
  150.              two versions of Carrier Detect.  One edition is a straight
  151.              text file intended for readers to download a copy and then
  152.              print out on their printers.  The other edition is the one
  153.              that is for use with the CDR-Door.  These files are cannot
  154.              be read and can only be used with the CDR-door for online
  155.              viewing.  As a sysop running the CDR-door you will need to
  156.              download new copies of the journal when they are made avail-
  157.              able if want your door to contain the latest articles.
  158.  
  159.              As of September 1991 both the straight text edition and the
  160.              CDR-door edition are distributed in the same archive.  When
  161.              searching for new editions of Carrier Detect look for a file
  162.              called CD0xxxxx.ZIP where the 0x represents the volume number
  163.              and the final three or four places are shortened forms of the
  164.              month published.  E.G.
  165.  
  166.              CD01MAY.ZIP  - Carrier Detect, Vol 1, May 91
  167.  
  168.              In each CD archive you will find the files listed below:
  169.  
  170.              CD0xxxxx.CDR - Carrier Detect Door Issues used by door.  Each
  171.                   time a new edition is released these will be included
  172.                   inside the ZIP files described above.  The "xxxxxx"
  173.                   indicate the volume and month of the journal.
  174.  
  175.              DOFIRST.CDR - This file is included with each of the .CDR files.
  176.                    When unzipping, you MUST tell PKZIP to OVERWRITE
  177.                    the older version when it asks you.  This file contains
  178.                    indexing information that is required for the door to
  179.                    operate properly.  It will be updated with each edition.
  180.  
  181.              CD0xxxxx.DOC - Text edition of Carrier Detect intended for
  182.                    traditional reading and printing.
  183.  
  184.              Bonus Files  - Various "bonus" files may be included in any issue
  185.                    of Carrier Detect.  Typically they relate to software
  186.                    featured in that issue.
  187.  
  188.              When you Unzip an issue, simply Unzip all *.CDR files into your
  189.              your CDRDOOR directory.  CDRDOOR will automatically take notice
  190.              of it and update the displays to include the new articles!
  191.              Please note that the *.TXT files and bonus files are not required
  192.              for door operation.  However, if you make Carrier Detect avail-
  193.              able to your callers for download, do not add or delete files
  194.              from the original -AV archive.  In other words, be sure both the
  195.              text AND door files are kept intact.
  196.  
  197.       The LOG file
  198.       ------------
  199.              If you specify the LOG parameter in CDRDOOR's control file, then
  200.              CDRDOOR will keep a log of the users who enter the door. It will
  201.              log what they read, what topics they searched for, etc.
  202.  
  203.              To keep it's size down, the log file uses a special coded format.
  204.              The first character of a line indicates what the line is. Below
  205.              is a listing of the codes:
  206.  
  207.              # ... Specifies user name
  208.  
  209.              ! ... Specifies date and time of entry
  210.  
  211.              - ... Specifies filename, department name, and topic name of
  212.                    article displayed.
  213.  
  214.              + ... Specifies user has invoked an action (i.e. search,
  215.                    browse, etc)
  216.  
  217.              For example, observe the following LOG file portion:
  218.  
  219.              #Michael Crosson
  220.              !05 Nov 91  15:23:18
  221.              +BROWSE
  222.              -CD01NOV   Writer's Roundup               Reflections 1
  223.              -DOFIRST   Bonus Files                    Bonus File Information
  224.              -DOFIRST   The Learning Center            The Learning Center In
  225.              +SEARCH    SCOTT
  226.              -CD01SEPT  Welcome                        Welcome to Issue #3
  227.              -CD01NOV   Product Evaluations            Solar Realms Elite Ver
  228.              +REGNOTE
  229.              +SCRSIZE   43
  230.              +BROWSE
  231.              -CD01NOV   The Learning Center            Writing a BBS Door (Pa
  232.  
  233.              This indicates that Michael Crosson entered the door on 11-5-91.
  234.              He then used the "browse articles" command to read three
  235.              articles, then he used the search command to search for "SCOTT"
  236.              of which he read two more articles.
  237.  
  238.              Then he read the registration notice, set his screen size to 43
  239.              lines, and used the browse command again to read another
  240.              article.
  241.  
  242.              This format may seem somewhat cryptic, but the log file is not
  243.              intended to be read in this form.  We are working on a LOG
  244.              ANALIZER which will parse the log and display some useful
  245.              statistical information.
  246.  
  247.  
  248.       Revision History
  249.       ----------------
  250.  
  251.            Version 1.00 - First public release
  252.  
  253.            Version 1.10 - Added an ANSI format menu for the main menu
  254.                           display. The file is CDREADER.ANS if you wish
  255.                           to modify it.
  256.  
  257.                           New high-efficiency compressed storage method
  258.                           for the Carrier Detect Journal. .CDX files
  259.                           are now used instead of .CDR files.
  260.  
  261.                           Added some color here-and-there.
  262.  
  263.                           Registration system has been modified slightly.
  264.  
  265.            Version 1.11 - Reduced memory requirements by more than 80k!
  266.  
  267.                           A few corrections in our .CDX files.
  268.  
  269.            Version 1.20 - Added support for the DOOR.SYS format used in
  270.                           Wildcat 3.0, Gap and other BBS systems.
  271.  
  272.                         - Added support of SFDOORS.DAT used in Spitfire
  273.                           BBS systems.
  274.  
  275.                         - Added LOG file support.
  276.  
  277.                         - Fixes bug where very long articles appeared
  278.                           garbled toward the end.
  279.  
  280.                         - Now supports REVISION 1 .CDX files.
  281.  
  282.  
  283.       REGISTRATION
  284.       ------------
  285.  
  286.                 The Carrier Detect Reader Door is distributed as shareware.
  287.            It is not freeware or placed in the public domain.  If you are
  288.            a sysop who runs the CDR-Door and finds it useful you are asked
  289.            to send in a registration fee of $15 dollars.  Upon registration
  290.            you will receive a KEY that identifies your door as properly
  291.            registered and the latest version.  Although CDR-Door is not
  292.            crippled in any way, future registered versions may contain
  293.            enhancements not found in this shareware release.  To register
  294.            your CDR-Door send in the enclosed REGISTER.FRM to the address
  295.            below:
  296.                         CDR-Door Registration
  297.                         c/o Michael Crosson
  298.                         640 Avenida Princesa
  299.                         Tucson, AZ 85748-6858
  300.  
  301.            Your registration material may be downloaded off of Symmetry
  302.            BBS at (602)296-2248 or sent to you on a 5 1/4 360K floppy.
  303.            Please allow 4-6 weeks shipping and handling if ordering
  304.            through the mail or 7-10 days if electing to take advantage of
  305.            the Download option.
  306.  
  307.  
  308.      SUPPORT
  309.      -------
  310.  
  311.                 If you are having trouble with CDRdoor or discover a
  312.            problem in its operation, please contact Scott Baker at:
  313.  
  314.            The Not-Yet-Named BBS
  315.            (602) 577-3650 (node 1)  1200-9600 bps V.32, 24hrs
  316.            (602) 577-3419 (node 2)  2400-14400 bps Dual Std, 24hrs
  317.  
  318.            or Michael Crosson at:
  319.  
  320.            Symmetry BBS - The Home Carrier Detect
  321.            (602) 296-2248           1200-9600 bps V.32, 24hrs
  322.  
  323.            Registered Users will get priority support in all cases.
  324.  
  325.  
  326.       Thank you for trying out The Carrier Detect Reader Door!  If you have
  327.       suggestions on ways to improve it please let either of us know and we
  328.       will consider them for inclusion in future releases.
  329.  
  330.