home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / CDMX2206.ZIP / CDMXFILZ.ZIP / CDMX2DOR.DOC < prev    next >
Text File  |  1995-02-24  |  164KB  |  3,205 lines
  1. =============================================================================
  2. "Whatsoever we ask, we receive of him, because we keep his commandments, and
  3.  do those things that are pleasing in his sight."  1 John 3:22
  4. =============================================================================
  5.                                 CDMX2DOR
  6.                               Release v2.06
  7.                 The "Next Generation CDRom-Access BBS Door"
  8.                         (c)1993 Robert E. Lee
  9.                               (309)797-6027
  10.                                   U.S.A.
  11.                            1:232/31  8:7002/3005
  12.                               New Century BBS
  13.  
  14.                  -- OVER 140+ HAPPY REGISTERED USERS! --
  15.  
  16.                            -------------------
  17.                                IMPORTANT!!
  18.                            -------------------
  19.              UPGRADERS: See end of file for Revisions History
  20.                    and how to install your CDMX2 upgrade
  21. =============================================================================
  22.   A special "Thanks" to Chris Kuefler @1:3402/22@Fidonet for his suggestions
  23.                   and assistance in beta-testing CDMX2DOR.
  24.      Thanks also go to Samson Luk 6:700/8 and to Dave DeGear 1:351/220 /300
  25.     for their help in testing and making suggestions to improve CDMX2DOR.
  26. =============================================================================
  27.  
  28. [1.0] Introduction
  29.  
  30.         So long, ROMBRAIN, Hello CDMX2DOR!!!
  31.  
  32.         In the beginning there was CDMAXDOR, and it worked ok on some
  33.         boards but was not capable of doing some things that it should
  34.         and gave some folks fits.  As a result of many suggestions from
  35.         CDMAXDOR users and other sysops, here is CDMX2DOR, a CDRom-BBS
  36.         interface door that, I believe, you'll find to be a superior
  37.         product.  The latest version of CDMX2DOR is available for F'Req
  38.         at 1:232/31 as well as are a number of other doors we've written.
  39.  
  40.         Be sure to check the version HISTORY at the end of this doc so
  41.         as to see what has changed as CDMX2DOR has matured.
  42.  
  43.   [1.1] WHAT WILL CDMX2DOR DO?
  44.  
  45.         In a word.... EVERYTHING.
  46.  
  47.         Some features:
  48.  
  49.         o       it will work with ANY BBS software (not just MAXIMUS) that
  50.                 is capable of writing a long-style (52 line) DOOR.SYS
  51.                 drop-file, e.g., WILDCAT, PCB, GAP, etc.  If your system
  52.                 can't write a long-style DOOR.SYS, then you may still
  53.                 use this software via a door conversion program that
  54.                 makes long-style DOOR.SYS files.
  55.  
  56.         o       it will allow you to control the number of KBytes that
  57.                 a user may access from your CD's in a given day so as
  58.                 to prevent file leaching regardless of BBS software type.
  59.  
  60.         o       it will allow viewing of textfiles and will unarchieve
  61.                 zips for viewing as well.
  62.  
  63.         o       it will automatically update MAXIMUS BBS user's files
  64.                 to reflect their CDRom downloads.  Other boards' auto-
  65.                 updating of user's download stats is not yet supported
  66.                 but will be (for registered users).
  67.  
  68.                 If you are a Maximus BBS sysop, it will:
  69.  
  70.                         o       end the need to re-SILT when you
  71.                                 change CD's
  72.  
  73.                         o       end the need to FB your CD's
  74.  
  75.                         o       end putting your CD's files.bbs's on your
  76.                                 HD and save you a lot of HD space
  77.  
  78.                         o       automatically write its own door.sys
  79.                                 of the type necessary
  80.  
  81.                         o       make using CD's on Max a piece of cake!
  82.  
  83.         o       Configuration is done by a standard ASCII text editor
  84.                 of your choice, e.g., QEdit, so it is very easy to
  85.                 set up.  Extensively documented installation instructions.
  86.  
  87.         o       it will allow users to download files from your CD or
  88.                 HD with ease, search for files or text, and allow your
  89.                 users to unzip files on the CD for reading text files
  90.                 and other docs in zipped files.
  91.  
  92.         o       it will add your BBS comment/advertisement on outgoing
  93.                 files.
  94.  
  95.         o       it will also allow you to put your C: drive (HD) files
  96.                 within its structure for use, so CDMX2DOR can even be
  97.                 used as a complete drop-in files-transfer system working
  98.                 with CDRom drives and Hard Drives.  Tape drive interfacing
  99.                 may be supported in future versions to registered users.
  100.                 If you want to squeeze every possible drive for online
  101.                 files for your users, you can even have CDMX2DOR access
  102.                 files off your B:\ drive for an additional 1.44 meg of
  103.                 files online.
  104.  
  105.         o       it has beautiful ansi graphics and also supports non-ansi
  106.                 use.
  107.  
  108.         o       it will allow you to have as many as 102 CD's online, each
  109.                 in its own drive, from which users may select
  110.  
  111.         o       it will support CD's with as many as 238 subdirectories
  112.                 and you can break down a CD that has more than 238
  113.                 subdirectories into 2 or more sub-sets (thereby making
  114.                 CDMX2DOR capable of handling any CD regardless of its
  115.                 number of subdirectories).
  116.  
  117.         o       it is fully configureable.  It will work with:
  118.  
  119.                         o       CD's with files.bbs in separate
  120.                                 subdirectories on the CD.
  121.  
  122.                         o       CD's with dirx.lst in separate
  123.                                 subdirectories on the CD.
  124.  
  125.                         o       You can even specify what file it should
  126.                                 look for to find subdirectory listings,
  127.                                 e.g., files.bbs, dirx.lst, files.lst,
  128.                                 DIR, or whatever you have.
  129.  
  130.                         o       CD's that have their files.bbs's or
  131.                                 whatever, in a single subdirectory on
  132.                                 the CD instead of having them in each
  133.                                 subdirectory.
  134.  
  135.                         o       It will even work with CD's that don't
  136.                                 even have a files.bbs or other subdirectory
  137.                                 listing at all -- you can create a list
  138.                                 on your HD and call it whatever you like
  139.                                 (but it must be in a files.bbs- or dirx.
  140.                                 lst-like structure).  A utility for making
  141.                                 skeleton files.bbs-like structures is
  142.                                 included in this archieve.
  143.  
  144.                         o       If you wish you can copy your CD's files.bbs-
  145.                                 like lists to the HD for fast file searches
  146.                                 or leave them on the CD to save HD space.
  147.                                 It is entirely up to you.
  148.  
  149.                         o       you can even incorporate your HD files
  150.                                 into CDMX2DOR if you desire.
  151.  
  152.         o       Supports Carousel CDRom Readers (e.g., Pioneer 6 CDs)
  153.  
  154.         o       Detects online/offline files automatically.
  155.  
  156.         o       Supports X, Y, 1K, and Z-modem downloads via DSZ.COM
  157.  
  158.         o       Supports FOSSIL X, Y, 1K and Z-modem downloads via FDSZ.EXE
  159.  
  160.         o       Supports file-tagging, instant downloading, global search
  161.                 and a host of other features.
  162.  
  163.         Not bad, eh?  Well, it will do much more.  It will keep track of
  164.         a user's downloads so that you can specify a "daily limit" of
  165.         download Kbytes off the CD(s).  It will keep track of how much
  166.         time it will take to download files (based on baudrates) and not
  167.         allow a slow modem to download a huge file and eclipse their
  168.         time-allotted limit.  It will even allow you to lock out certain
  169.         files from being downloaded if you don't want nasty gifs to be
  170.         available to your users.  There's even more...
  171.  
  172.         o       Supports having certain files requiring a "key" that
  173.                 a user must know in order to process these files.
  174.  
  175.         o       a whole lot more!
  176.  
  177.                 The following sysop functions are available while awaiting
  178.                 keyboard input :
  179.  
  180.                    F5     -  Shell to DOS.
  181.                    F8     -  Twit user and return to BBS.
  182.                   F10     -  Initiate chat with user.
  183.              <CTL>F10     -  Answer user's page.
  184.                   Home    -  Main user stats.
  185.                   End     -  Displays sysop keys available.
  186.                   PgDn    -  Secondary user stats.
  187.                 Up Arrow  -  Increase user's time remaining.
  188.  
  189.                 Dn Arrow  -  Decrease user's time remaining.
  190.                  <ESC>    -  Exit Chat
  191.  
  192.         o       Utilities for making dirx.lst's for CD's that have no
  193.                 files.display structures and for making dirx.lsts from
  194.                 your files.bbs files on your HD.
  195.  
  196.         o       Utilities for translating files.bbs files into dirx.lst-
  197.                 like structure files.
  198.  
  199.         o       full control over IRQ's and HEXport addressing of COM
  200.                 ports.
  201.  
  202.         o       Sysop paging, chat with user, etc.
  203.  
  204.         Interested? <g> Let's look at how to install it.
  205.  
  206. [2.0] DEFINITIONS
  207.  
  208.         A "DSP" is a file in which is contained the files list of a
  209.         particular subdirectory.  Typical DSPs are "files.bbs" or
  210.         "dirx.lst" or some other type of list.  Henceforth, reference
  211.         to "DSP" or "files display structure" is referring to a
  212.         file like this.
  213.  
  214.         A "Files.bbs" DSP does not usually contain the file size and
  215.         file date for the files it describes; a "dirx.lst" usually
  216.         DOES contain that information.  CDMX2DOR requires that your
  217.         DSP have the size/date information present.  If you have a
  218.         files.bbs DSP that does, in fact, have the size/date information
  219.         in it, then your displays in CDMX2DOR will be just fine; if they
  220.         do not and there is no alternative DSP available on your CD then
  221.         you should make a "dirx.lst" DSP using utilities included herein.
  222.  
  223.         More about all of this as we continue...
  224.  
  225. [3.0] INSTALLATION
  226.  
  227.         AFTER you have read these docs, there is an installation utility
  228.         called CDMX2INS.ZIP that is in this subdirectory that you can
  229.         unzip and run to aid in your installation.  PLEASE, however, READ
  230.         THESE DOCS before you use the CDMX2INS installation utility.
  231.  
  232.         Unzip CDMX2DOR.ZIP into a subdirectory of your choice.  In your
  233.         subdirectory you should find these files:
  234.  
  235.   FILE          Function
  236. FILES    TXT    A directory-listing of files in this package.
  237.  
  238. DOOR     SYS    A sample door.sys
  239.  
  240. BBSSTAT  ASC    ASCII/Non-Ansi display files
  241. CDSONLIN ASC    "
  242. DIRECTS  ASC    "
  243. DOWNSCR  ASC    "
  244. FILEH    ASC    "
  245. DOWNIT   ASC    "
  246. FIN      ASC    "
  247. HELPSCR  ASC    "
  248. MAIN     ASC    "
  249. MORE     ASC    "
  250. STAG     ASC    "
  251. TAGEDIT  ASC    "
  252. OPSC            "
  253. FORB     ASC    "
  254. LOCKEY   ASC    "
  255.  
  256. CDSONLIN ANS    Ansi display files
  257. BBSSTAT  ANS    "
  258. DIRECTS  ANS    "
  259. DOWNIT   ANS    "
  260. DOWNSCR  ANS    "
  261. FILEH    ANS    "
  262. FIN      ANS    "
  263. HELPSCR  ANS    "
  264. MAIN     ANS    "
  265. MORE     ANS    "
  266. STAG     ANS    "
  267. TAGEDIT  ANS    "
  268. OPSCG           "
  269. FORB     ANS    "
  270. LOCKEY   ANS    "
  271.  
  272. NO8CBOB  LST    CDMX2DOR CD menu-control file for NightOwl 8 CD
  273. PBCBOB   LST    " (for PowerBox v1.00 CD)
  274. PPCBOB   LST    " (for PowerPak Gold '92 CD)
  275. Note:           Other CD menu-control files may appear in the archieve
  276.                 as they are added to this system.  If you develop
  277.                 CD menu-control file(s) for CD's not included herein,
  278.                 I will incorporate them into the archieve with a note
  279.                 giving you credit, so send 'em this-a-way :-)
  280.  
  281. CDTEMP   LST    CDMX2DOR-operation list file
  282. CDSONLIN LST    CDMX2DOR-operation CD/Door/Menu interface file
  283. LOCK     LST    CDMX2DOR-operation locked/keyed file interface file
  284.  
  285. AHELP    TXT    CDMX2DOR-operation text files for remote door users
  286. CHELP    TXT    " (Note these are not "DOC" files
  287. VHELP    TXT    "  but are used by CDMX2DOR.  Do not edit them.)
  288. SHELP    TXT    "
  289. YHELP    TXT    "
  290. DHELP    TXT    "
  291. HHELP    TXT    "
  292. THELP    TXT    "
  293. PHELP    TXT    "
  294. ZHELP    TXT    "
  295.  
  296. TAGLIST  DAT    CDMX2DOR-operation data files
  297. USERS    DAT    "
  298.  
  299. NGDL     LOG    CDMX2DOR-operation log files
  300. BADSEND  LST    " (written if necessary)
  301.  
  302. NCB      ADV    Sample BBS advertisement file
  303.  
  304. CDMX2DOR MEC    Maximus BBS-specific files
  305. CDMX2DOR BBS    "
  306. FIXMAX   EXE    "
  307.  
  308. FLYDIRX.EXE     A utility for creating dirx.lst-type structures for CD's
  309.                 that have no files.bbs/dirx.lst or other file-display
  310.                 structures.  FlyDirx will work on any drive, A,B,C,D,E,
  311.                 etc.  You can do individual directories by running
  312.                 FLYDIRX.EXE via a command line call or recursively
  313.                 through an entire CDRom by using FLYENGIN.EXE.  FLYDIRX.EXE
  314.                 can handle subdirectories with up to 300 files.  FLYDIRX
  315.                 will also import files' descriptions from existing files.
  316.                 bbs files (if it finds them in the directory your are
  317.                 trying to convert to a dirx.lst AND if they are normal
  318.                 files.bbs files).
  319. FLYDIRX.CFG     Works with FLYDIRX.EXE and FLYENGIN.EXE to do massive
  320.                 creations of skeleton dirx.lst files (in the case of
  321.                 working with CD's that have no files-display structures,
  322.                 e.g., files.bbs's or anything else
  323. FLYENGIN.EXE    Mass-driver for FLYDIRX.EXE.
  324. FLYSTUFF.DOC    Information on how to employ the FLY utilities for different
  325.                 purposes.
  326. KUEFLER.EXE     For converting odd files.bbs files to dirx.lsts
  327. FASTFREQ.BAT    A batfile to drive INSTFREQ.EXE in copying files and
  328.                 driving FLYDIRX.EXE to make "innies" on your HD.  Read
  329.                 the extensive notation in the bat file for instructions
  330.                 on how to modify and run this bat file.
  331. INSTFREQ.EXE    A utility to copy any file(s) from any drive to any other
  332.                 drive while being in a third drive.  INSTFREQ will
  333.                 use wildcards, e.g., *.zip, fa*.arj, cat*.*, or *.*
  334.  
  335. DIAGNOSE.ZIP    A utility to diagnose your CDRom to get an idea of how you
  336.                 might like to configure your CD using CDMX2DOR.  You will
  337.                 get a file in which is specified each directory of your
  338.                 CDRom along with possible files to use and whether the
  339.                 CD's configuration could be an "INNIE" or an "OUTTIE."
  340.                 See below for discussion of Innies and Outties.
  341.  
  342.                 NOTE THAT this utility only assists in possible
  343.                 configurations and is in no way meant to be able to actually
  344.                 configure your particular CD totally automatically.  You
  345.                 will find DOC files inside diagnose.zip that you should read
  346.                 and be familiar with before running the diagnostic utility.
  347.  
  348. CDMX2DOR CNF    CDMX2DOR-operation CNF file
  349.  
  350. CDMX2DOR CFG    CDMX2DOR-operation CFG file
  351.  
  352. CDMX2GO  BAT    CDMX2DOR-operation BAT file
  353.  
  354. CDMX2DOR ERR    CDMX2DOR-operation Error report file
  355.  
  356. CDMX2DOR EXE    CDMX2DOR part 1
  357.  
  358. CDMX2OLH.EXE    CDMX2DOR part 2
  359.  
  360. CDMXDCN1.EXE    Converts a dorinfoX.def to a 52-line door.sys
  361. CDMXDCN1.DOC    Info on how to run it
  362.  
  363.      Ok, now that you have identified these files and they are unzipped
  364.      in a subdirectory of your choice, then you must:
  365.  
  366. =============================================================================
  367. [3.1] Fix CDMX2DOR.CNF file.  In it you will find the following:
  368. ---------                                                             Line #
  369. c:\cdbob             <-----  your door's subdirectory                    1
  370. New Century BBS      <-----  your board's name                           2
  371. 3                    <-----  your IRQ number for your comport            3
  372. 02F8                 <-----  your Comport's HEX address                  4
  373. STANDARD             <-----  STANDARD, DIGIBOARD, INT14/EBIOS or FOSSIL  5
  374. D000                 <-----  Digiboard info (see below)                  6
  375. 320                  <-----  Digiboard info (see below)                  7
  376. 3                    <-----  Digiboard/IRQ (see below)                   8
  377. 02F8                 <-----  your Comport's HEX address again            9
  378. 3                    <-----  your IRQ number again                      10
  379. cdmx2dor.cfg         <-----  the name of your *.CFG file                11
  380. ---------
  381.         Fixes:  Change line (1) to that of the subdirectory in which you
  382.                 have unzipped CDMX2DOR.ZIP.  Be sure to have the DRIVE
  383.                 and a colon and a backslash and the subdirectory name.
  384.  
  385.                 Change line (2) to the name of your BBS
  386.  
  387.                 Change line (3) to reflect your IRQ #  (Com2 is 02F8, and
  388.                                 IRQ 3.  See a list in this doc file (below)
  389.                                 for other IRQ numbers based on ports, etc.)
  390.  
  391.                 Change line (4) to your HEXport address.  Default is at
  392.                 COM2.  See below for other HEXport addresses for other
  393.                 ports besides COM2.  Same information goes in line (9).
  394.  
  395.                 Leave line (5) as STANDARD if you are using normal ports
  396.                 or, if you are using a DIGIBOARD, change the line to
  397.                 DIGIBOARD, or if you are using INT14/EBIOS calls to your
  398.                 DIGIBOARD then use INT14/EBIOS here.  For most users the
  399.                 line will remain STANDARD.  If you want to run the door
  400.                 via a fossil driver i/o then set this line to FOSSIL.
  401.  
  402.                 Change line (6) IF you are using a DIGIBOARD to the address
  403.                 the card uses as a communications area/memory window.  IF
  404.                 you are using STANDARD, INT14/EBIOS, or FOSSIL then you can
  405.                 change line (6) to a 0 or just left alone.
  406.  
  407.                 Change line (7) IF you are using a DIGIBOARD to the I/O
  408.                 port address that the Board is attached to.  This is only
  409.                 necessary if using and Interface set to DIGIBOARD.  IF
  410.                 you are using STANDARD, INT14/EBIOS, or FOSSIL then this
  411.                 can be changed to a 0 or left alone.
  412.  
  413.                 Change line (8) IF you are using DIGIBOARD to reflect the
  414.                 Channel Number for this port on the Digi.  This is required
  415.                 for DIGIBOARD and INT14/EBIOS interfaces.  This is usually
  416.                 1 - 8 for the DIGIBOARD interface and usually 4 - 11 for
  417.                 the INT14/EBIOS interface.  IF you are running STANDARD or
  418.                 FOSSIL then this number should be left as it is.
  419.  
  420.                 Change line (9) to the same value as you entered in line
  421.                 (4); your comport's Hex Address.
  422.  
  423.                 Change line (10) to the same value as you entered in line
  424.                 (3), your comport's IRQ number.
  425.  
  426.                 For line (11), please specify the *.CFG file that you
  427.                 are using for your particular node.  If you are running
  428.                 just one node, you can call your file by the name I
  429.                 have included here and just edit the cdmx2dor.CFG file
  430.                 to reflect your particular situation.  If you are
  431.                 multinoded, you'll likely need additional *.CFG files
  432.                 (particularly if you are running Maximus): there is more
  433.                 on this below.
  434.  
  435.         You will eventually use this *.CFG file in a command-line argument
  436.         to start the door up via a bat file, e.g.,
  437.  
  438.                                 /---   see here...  a command-line argument.
  439.                               /               to start the door up is found
  440.         C:\cd2>cdmx2dor cdmx2dor.cnf          in your startup BAT, e.g.,
  441.                                               CDMX2DOGO.BAT
  442.  
  443.         Leave no blank lines at the end of this file after editing.
  444.  
  445. =============================================================================
  446.  [3.2]  Fix CDMX2DOR.CFG file.  (Note: you can have multiple copies of
  447.         this file (with changed names) for multinode; or you can rename
  448.         this file to whatever you please if you like (as long as you
  449.         reflect the changed name in your *.CNF file).
  450.  
  451.         This file is highly commented so you can follow instructions there.
  452.         Do not remove the ";" commentline markers on the left margins.
  453.  
  454.         Leave no blank lines at the end of this file after editing.
  455.  
  456.         Note that this file can be renamed to whatever you like it to be
  457.         called or your can have multiple *.CFG files to support multinode
  458.         situations.  You will place the name of this file in your
  459.         CDMX2DOR.CNF file (see above).  If you are a Pioneer Carousel
  460.         CDRom reader user, please refer to information about the special
  461.         configuration below in section 7.1.
  462.  
  463. =============================================================================
  464.  [3.3a] IF you are NOT using MAXIMUS BBS software, then you should
  465.         set your system up so that it will write a 52-line door.sys which
  466.         CDMX2DOR can use.  If your particular BBS software won't write a
  467.         52-line door.sys, then you can use a conversion program, e.g.,
  468.         QKDOOR2B.ZIP, to make a 52-line door.sys from your BBS's own
  469.         unique dropfile (e.g., dorinfo1.def, callinfo.bbs, or whatever your
  470.         BBS might write).  Door.sys MUST eventually be copied to or written
  471.         directly in the subdirectory in which CDMX2DOR files reside.  That
  472.         copying may be accomplished in a *.bat file, e.g.,
  473.  
  474.         --sample.bat--
  475.                 @echo off
  476.                 C:
  477.                 cd \bbs
  478.                 cd \<cdmx2dor subdirectory>
  479.                 copy c:\bbs\door.sys
  480.                 cdmx2dor cdmx2dor.cnf
  481.                 cd \bbs
  482.         ---------------
  483.  
  484.         You note that the above *.bat copies door.sys to CDMX2DOR's sub-
  485.         directory and starts up CDMX2DOR.  If there is not a door.sys
  486.         in CDMX2DOR's subdirectory, then the door will not work.
  487.  
  488.  [3.3b] IF you ARE using MAXIMUS.BBS software, then you should make an
  489.         edit to your MENUS.CTL file in the FILES section thusly:
  490.  
  491.         Display_File   \cdbob\cdmx2dor         Normal   "2CDRoms"
  492.  
  493.         Now note that you should change the "\cdbob\cdmx2dor" so that
  494.         the "\cdbob\" part states the subdirectory in which CDMX2DOR
  495.         is actually residing.  You can also change the part after the
  496.         "Normal," i.e., the "2Cdroms" to be whatever you'd like.  You
  497.         must however, have this in your FILE section of your MENUS.CTL
  498.         somehow else your users won't be able to access your CD's.
  499.  
  500.         Make sure you now re-SILT Maximus so that the change you made
  501.         is incorporated into your FILES area.  You will not have to
  502.         SILT Max ever again for this door.
  503.  
  504.         This change will allow users to activate the cdmx2dor.bbs that
  505.         is in CDMX2DOR's subdirectory.  Cdmx2dor.bbs will do 2 things:
  506.         (1) it will write the appropriate door.sys for you and it will
  507.         start the door up.  You will need to make some edits to this
  508.         cdmx2dor.bbs, so included is the cdmx2dor.mec file that
  509.         you can change as needed.  Particularly, you will find in the
  510.         cdmx2dor.mec file a need to change the door.sys directory
  511.         lines, e.g.,
  512.  
  513. -------- excerpt of cdmx2dor.mec -------
  514. [comment  %Z        Translates to the user's full name, in caps.]
  515.  
  516. [comment install the door.sys in the right subdirectory]
  517. [delete]c:\cdbob\door.sys       <-----  change this line
  518. [open]c:\cdbob\door.sys         <-----  change this line
  519. [write]COM%P:[comment                                         Com Port ]
  520. [write]%b[comment                                             baud rate]
  521. ------- end of cdmx2dor.mec excerpt ----
  522.  
  523.         Change the lines with the door.sys statements in them to reflect
  524.         the placement of your CDMX2DOR files.  The objective is to have
  525.         a door.sys written in the subdirectory where CDMX2DOR is.
  526.  
  527.         You should also make a change in the following section of this *.mec
  528.         file, i.e.,
  529.  
  530. -------- excerpt of cdmx2dor.mec -------
  531. [comment quit comment          And we're done!                ]
  532.  
  533. [comment  start up cdmx2dor.exe with an extern run to re-read the lastuser.bbs]
  534.  
  535. [xtern_dos]@c:\cdbob\cdmx2dgo.bat        <------ change this line
  536. -------- end of excerpt ----------------
  537.  
  538.         The last line is where you should make the change.  Change the
  539.         subdirectory line to reflect the subdirectory where you have placed
  540.         CDMX2DOR files.  Make sure you have CDMX2DGO.BAT (or another similar
  541.         bat) in CDMX2DOR's subdirectory.  Also make ABSOLUTELY SURE that
  542.         you do not forget to put the "@" character right after the
  543.         [xtern_dos] command else Maximus user.bbs will not be updated and
  544.         will not show users' downloads off your CDs.
  545.  
  546.         After you have made your changes, you should go to your MAX sub-
  547.         directory and and MECCA your CDMX2DOR.MEC file so as to create
  548.         a CDMX2DOR.BBS file.  If you don't then it won't work <g>.  After
  549.         you have SILTed your changes into MAX,  MECCA'ed your cdmx2dor.mec
  550.         and have the *.bat file in your CDMX2DOR subdirectory you're all
  551.         set to go.
  552.  
  553.         The *.bat file should look like so:
  554.  
  555. --------- *.bat startup file example --------
  556. @echo off
  557. C:
  558. cd \cdbob
  559. cdmx2dor cdmx2dor.cnf
  560. cd \max
  561. --------------------------------------------
  562.         Make sure the last line switches back to MAX, i.e., "cd \max"
  563.         or wherever.  Adjust as necessary, of course.  MAXIMUS is
  564.         GREAT!!! software for BBS's BTW.  If you aren't using
  565.         MAX, then you really should <g>.  Thanks Scott Dudley!
  566.  
  567.  
  568. =============================================================================
  569. [4.0]   CD PREPARATION
  570.  
  571.         If you have the following CDs:
  572.  
  573.                 NightOwl 8
  574.                 NightOwl 9
  575.                 NightOwl 10
  576.                 PowerBox v1.00
  577.                 PowerPak '92
  578.                 SoMuchShareware III
  579.                 TechArsenal
  580.                 SoundWare Collection
  581.                 Rem CD
  582.                 GameWare Collection
  583.  
  584.  
  585.         then you can use the following files in CDMX2DOR's sub-
  586.         directory with minimal edits:
  587.  
  588.         SMSHWR   LST       779 09-11-93   2:52p
  589.         PPCBOB   LST     1,620 10-15-93   5:30p
  590.         NO9CBOB  LST     1,562 09-11-93   3:15p
  591.         REM      LST       507 10-31-93   6:21p
  592.         SNDWCOL  LST     1,901 09-11-93   2:24p
  593.         PBCBOB   LST     1,163 08-29-93   1:56p
  594.         NO8CBOB  LST     1,751 09-06-93   2:02p
  595.         NO10CBOB LST     1,614 11-26-93   5:06p
  596.         TECHARN  LST       734 11-26-93   5:38p
  597.         SOMUCHSH LST     7,474 11-10-93   4:50p
  598.         GAMEWARE LST     1,419 01-03-94   1:29p
  599.  
  600.         These files are the control menus where CDMX2DOR interfaces with
  601.         these particular CD's.  You can use these files as is without
  602.         changes (unless you are on running them on some other drives then
  603.         those specified - take a look at 'em).  I have a number of other
  604.         CD control menus on New Century BBS, so call and see what's here
  605.         so you might save yourself some work in your setting up a particular
  606.         CD :-)
  607.  
  608.         Note: If you have done the above changes and have no other CD's
  609.         than the ones above, then the door is ready to go.  Before you
  610.         run it however, you probably should read on...
  611. =============================================================================
  612. [5.0]   PREPARING CONTROL MENU (*.LST) FILES
  613.  
  614.         At this point, it might be worth your time to investigate the
  615.         utility called DIAGNOSE.ZIP as it may help you to configure your
  616.         CD's more quickly.  Do, however, read this information here so
  617.         you know what you are doing.
  618.  
  619.         If you have CD's other than the one's above (as you probably do)
  620.         then you will have to make your *.LST file(s).
  621.  
  622.         [5.1] HOW TO MAKE A CD MENU-CONTROL *.LST by hand:
  623.  
  624.         Your construction of your CD menu-control *.LST will be
  625.         governed by the type of setup your CD has (as regards its
  626.         subdirectories, files' list types, etc.).  You'll have to
  627.         examine your CD to determine which of the below configurations
  628.         suits your particular CD and then build a CD menu-control
  629.         *.LST file for it.
  630.  
  631.         You will build your *.LST file(s) with a standard text editor,
  632.         e.g., QEdit.  Some sample lists are included in this archieve
  633.         for NightOwl 8 (no8cbob.lst), PowerBox v1.00 (pbcbob.lst), and
  634.         PowerPak Gold '92 (ppcbob.lst) that can serve as examples.
  635.  
  636.         ===============
  637.         Making "INnies"
  638.         ===============
  639.  
  640.         Here's an excerpt sample *.LST for your consideration:
  641.  
  642. -------------------------------------------
  643.                   Fig. 1
  644. ----------- ppcbob.lst excerpt ------------  LINE #
  645. PowerPak Gold '92:dirx.lst:in                  1
  646. ACCOUNT:Accounting-related files               2
  647. ANIMAT:Animation, FLI, Autocad                 3
  648. ANTI_VIR:Antivirus-related files               4
  649. ARCHIVE:Archievers, ARJ, ZIP, etc.             5
  650. BACKUP:File/Disk Backup Utilities              6
  651. -------------------------------------------
  652.  
  653.         The rest of ppcbob.lst is like the last 5 lines above.  The really
  654.         important line is the first line.  In the above (Fig. 1), in the
  655.         first line, we see 3 data items:
  656.  
  657.         (1) the name of the CD, (2) the file structure, and (3) where the
  658.         file lives (either "in" its own subdirectory with the rest of its
  659.         files or "out" in some other subdirectory.  So, in creating a *.LST
  660.         for your CDrom you must know the name, the file structure of the
  661.         files display (DSP), and where the file display structure (DSP)
  662.         lives.
  663.  
  664.         On the PowerPak Gold CD, the DSP is a dirx.lst and it lives IN the
  665.         subdirectories where its files are.
  666.  
  667.         Graphically: (showing another CD for example)
  668.  
  669.                     /--- CD's name
  670.                   /            /--- DSP file name
  671.                 /            /      /--- DSP residence is IN the subdirec-
  672.               /            /      /      tories it is describing
  673.         PowerBox V1.00:files.bbs:in
  674.  
  675.         The next lines after the first line contain 2 data items, (1) the
  676.         actual name of the subdirectory on the CD itself, and (2) the
  677.         description of the files in that subdirectory.
  678.  
  679.  
  680.         Graphically:
  681.  
  682.                     /--- actual subdirectory name on the CD that the DSP
  683.                   /      is describing.
  684.                 /
  685.               /              /--- user description for the subdirectory
  686.             /              /                  (What the user will see
  687.         ACCOUNT:Accounting-related files       as a description)
  688.  
  689.         You may have up to 328 subdirectories per *.LST.  If your CD has
  690.         more than that just make another *.LST and include the rest in
  691.         the second *.LST (the 2nd LST must also have a config line #1 with
  692.         a second name, e.g., *.LST #1 may have SUPERSHARE Pt.I, and the
  693.         2nd .LST may have SUPERSHARE Pt. II or whatever your please.
  694.         For example:
  695.  
  696.         PowerZing Part 1:dirx.lst:in  <- first line of *.LST #1
  697.         ACCOUNT:Accounting-related files
  698.         (etc. up to 238 subdirectories)
  699.  
  700.         PowerZing Part 2:dirx.lst:in  <- first line of *.LST #2
  701.         MARKET:Farming-related files
  702.         (etc. to end of CD's subs)
  703.  
  704.         So, you see, you can accomodate any CD regardless of number of
  705.         subdirectories.
  706.  
  707.         Now, what if it is not a dirx.lst for the file display structure?
  708.         Here ya go:
  709. -------------------------------------
  710.                 Fig. 2
  711. ---------- pbcbob.lst excerpt -------    Line #
  712. PowerBox V1.00:files.bbs:in                1
  713. 001:ASP Software                           2
  714. 002:BBS Related - CDROM                    3
  715. 003:BBS Related - General                  4
  716. 004:BBS Related - PCBoard                  5
  717. 005:BBS Related - Other                    6
  718. ---------- end of excerpt -----------
  719.  
  720.         The 2nd through the end line in the excerpt above is just like
  721.         the first example (Fig. 1) we saw immediately above.  The difference
  722.         in this example (Fig. 2) is in the very first line.  It is not a
  723.         "dirx.lst" but is a "files.bbs."  Note that it still lives "IN" the
  724.         subdirectory of files which it displays.
  725.  
  726.         So, we now can accomodate either a dirx.lst or files.bbs that
  727.         live "in" the subdirectories they report on.
  728.  
  729.                               /--- files.bbs and not a dirx.lst
  730.                             /
  731.         PowerBox V1.00:files.bbs:in
  732.  
  733.         This particular CD's "files.bbs" DSP DOES have the size and date
  734.         information in it so I can use it just fine and CDMX2dOR will
  735.         display it just fine.  If it were a normal files.bbs that did not
  736.         have the size/date information in it, then I would need to either
  737.         find an alternative DSP (e.g., a dirx.lst) on the CD or make
  738.         a dirx.lst DSP using utilities included and put the DSP for that
  739.         CD on my HD.
  740.  
  741.         What if it is not a dirx.lst OR a files.bbs but it still lives
  742.         "in."  Easy.  Just call it it's name, whatever it may be, e.g.,
  743.         if it is a files.lst file IN the subdirectory describing the
  744.         files in that subdirectory, then just have the following:
  745.  
  746.  
  747.                               /--- a files.lst and not a files.bbs or
  748.                             /        a dirx.lst.
  749.                           /
  750.         BizarreGifs:files.lst:in    <- first line of the *.lst for this CD.
  751.  
  752.         As long as this "files.lst" DSP has the size/date information and
  753.         conforms to normal DSP style then CDMX2DOR will handle it just
  754.         fine.
  755.  
  756.         The rest of the structure (lines 2 to X) of the menu command *.LST
  757.         would be just like the first one shown above.  So, you see, CDMX2DOR
  758.         can work with ANY display file structure that has any name (provided
  759.         that it approximates the typical files.bbs/dirx.lst structure.
  760.  
  761.         ---------------------------------------------------------
  762.         Leave no blank lines at the end of your CD menu-control
  763.         *.LST files else you will get an "Illegal function" error.
  764.         ----------------------------------------------------------
  765.  
  766.         ================
  767.         Making "OUTties"
  768.         ================
  769.  
  770.         BUT I HAVE A CD WHERE THE DIRX.LST is NOT a live "in."  Now what?
  771.         Easy <g>.  If it's not an "innie" it's an "outtie," e.g.,
  772.  
  773. --------------------------------------------
  774.                   Fig. 3
  775. -------- excerpt from NightOwl 8 -----------  Line #
  776. NightOwl 8:dirx.lst:out:text                    1
  777. DIR1:001A:Apogee Games                          2
  778. DIR2:002A:Software Creations                    3
  779. DIR3:003A:Gamer's Edge                          4
  780. DIR4:004A:Epic MegaGames                        5
  781. --------------------------------------------
  782.  
  783.         Notice that we have now, not three, but 4 (FOUR) pieces of data
  784.         on the first line in the menu-command LST file.  (1) the CD name,
  785.         e.g., NightOwl 8, (2) the display file structure, e.g., dirx.lst,
  786.         (3) that it is OUT (meaning that dirx.lst is not living in the
  787.         subdirectories that it describes, and (4), the subdirectory where
  788.         the all the dirx.lsts live :-).
  789.  
  790.         Graphically:
  791.  
  792.                      /--- CDrom's name
  793.                    /         /--- display file [DSP] format
  794.                  /         /      /--- where the DSP lives (not in the
  795.                /         /      /      subdirectories it describes)
  796.              /         /      /    /--- the subdirectory on the CD where
  797.         NightOwl 8:dirx.lst:out:text    DSP does live.
  798.  
  799.  
  800.         Notice that the last 4 lines in the example above have 3 (three)
  801.         bits of information rather than just the 2 we've seen so far.  The
  802.         3 data pieces are (1), the name of the out-living file-display
  803.         file, (2) the subdirectory that it is describing, and (3) a
  804.         description of the files in that subdirectory.
  805.  
  806.         Graphically:
  807.  
  808.                 /--- The name of the DSP for subdirectory 1 on the CD
  809.               /    /--- the name of the subdirectory on the CD being described
  810.             /    /       /--- a description of the subdirectory for users to
  811.           /    /       /      see
  812.         DIR1:001A:Apogee Games
  813.  
  814.         ----------------------------------------------------------
  815.         Leave no blank lines at the end of your CD menu-control
  816.         *.LST files else you will get an "Illegal function" error.
  817.         ----------------------------------------------------------
  818.  
  819.         Note that if your DSP is several subdirectories deep in this
  820.         current situation (an outtie) you can just put the path to the
  821.         DSP in the first line, e.g., \night and the subsequent path
  822.         information to the specific DSP in the remaining lines.  For
  823.         example, let's assume that DIR1 (in the above DSP) is in the
  824.         subdirectory \night\text rather than in just \text.  We would
  825.         then have our 2nd through Nth lines in our menu-command LST
  826.         specifying this, i.e.,
  827.  
  828.                                                  LINE #
  829.         OddOwl 11:dirx.lst:out:night\text          1
  830.         DIR1:001A:Apogee Games                     2
  831.         DIR2:002A:Mega Games                       3
  832.         DIR3:003A:Super Games                      4
  833.         etc.                                       N
  834.  
  835.         Note that in this situation, the DSP in line 2 is name DIR1 with
  836.         no extension; line 3's is DIR2.  Some CD's have DSP's of that
  837.         name, e.g., the NightOwl CD's particularly.
  838.  
  839.         Wherever the DSP is under the major subdirectory, you can
  840.         specify the path to it under the major subdirectory.  So, in
  841.         the above case the path to the first DSP (in line 2) is:
  842.  
  843.         \night\text\DIR1  (note this is not the format to use to state this
  844.                           in your control menu... this is just an inter-
  845.                           pretation of what it means.  Use the format to
  846.                           state this as is indicated in line 2 above.)
  847.  
  848.         For the 4th line it is:
  849.  
  850.         \night\text\DIR3   (also not the correct format; only an
  851.                             interpretation of what it means)
  852.  
  853.         ------------------------------
  854.         Summary: A recap to this point
  855.         ------------------------------
  856.  
  857.         So, in the NightOwl 8 example (Fig. 3 above), we see for NightOwl 8
  858.         that it has:
  859.  
  860.                 out-living description files, located in a subdirectory
  861.                 called "text" on the CDrom and that the display file for
  862.                 the first subdirectory is living in subdirectory "text"
  863.                 and is called "DIR1." In it is a description of the files
  864.                 found in subdirectory "001A" (Apogee Games) on the CD.
  865.                 The second description file is called "DIR2" and describes
  866.                 files found in subdirectory "002A" (Software Creations)
  867.                 on the CD, etc.
  868.  
  869.         As long as you tell it OUT and where the display file structure
  870.         lists [the DSP's] live (a subdirectory) and what their names are
  871.         then all will be well.  You could have:
  872.  
  873.         a files.bbs living in
  874.         a files.bbs living out in \whatnot
  875.         a dirx.lst living in
  876.         a dirx.lst living out in \whatnot
  877.         a files.lst living in
  878.         a files.lst living out in \whatnot
  879.         a *.* living in
  880.         a *.* living out in \whatnot
  881.  
  882.         ======================
  883.         LIVING IN, LIVING OUT?
  884.         ======================
  885.  
  886.         LIVING IN (see more on innies further down):
  887.  
  888.         If the files-description file lives "IN" then the first line of the
  889.         *.LST will have 3 data items:
  890.  
  891.                 (1) CD Name, (2) files-description file name, (3) IN
  892.  
  893.         Graphically:
  894.  
  895.                     /--- CD's name
  896.                   /            /--- DSP file name
  897.                 /            /      /--- DSP residence is IN the subdirec-
  898.               /            /      /      tories it is describing
  899.         PowerBox V1.00:files.bbs:in
  900.  
  901.  
  902.         The remaining lines will have two (2) data items:
  903.  
  904.                 (1) the subdirectory where it is, and (2) a description
  905.                 of the subdirectory for the user.
  906.  
  907.         Graphically:
  908.  
  909.                     /--- actual subdirectory name on the CD
  910.                   /
  911.                 /
  912.               /              /--- user description for the subdirectory
  913.             /              /
  914.         ACCOUNT:Accounting-related files
  915.  
  916.  
  917.         LIVING OUT (reprise):
  918.  
  919.         If the files-description files live "OUT" then the first line of the
  920.         *.LST will have 4 data items:
  921.  
  922.                 (1) CD Name, (2) files-description file type, (3), OUT, and
  923.                 (4) subdirectory where the files-descriptions all live.
  924.  
  925.         Graphically:
  926.  
  927.                       /--- CD's name
  928.                     /        /--- files-description file [the DSP] type
  929.                   /        /     /--- the DSP lives OUTside of the subs they
  930.                 /        /     /      describe
  931.               /        /     /    /--- they all live in this subdirectory on
  932.         NightOwl 8:dirx.lst:out:text    the NightOwl 8 CD.
  933.  
  934.  
  935.         The remaining lines will have three (3) data items:
  936.  
  937.                 (1) the name of the file-description file, (2) what
  938.                 subdirectory it is describing, and (3) a description of
  939.                 the subdirectory for the user.
  940.  
  941.         Graphically:
  942.  
  943.                   /--- the DSP's name for the first subdirectory
  944.                 /
  945.               /     /---  the subdirectory name on the CD the DSP describes
  946.             /     /      /--- a description for the user of this subdirectory
  947.           /     /      /
  948.         DIR1:001A:Apogee Games
  949.  
  950.  
  951.         You get the idea.  As long as your first line is set up properly
  952.         and your remaining lines are correct then CDMX2DOR will work just
  953.         fine.  Now as long as your CD's have these simple situations you
  954.         can handle building your menu-control *.lst file with the above
  955.         information.  However, as there is no standardization with how
  956.         CD's are constructed (i.e., their subdirectory structure and their
  957.         DSP's) you may need additional configuration options.  Here they
  958.         are:
  959.  
  960.         =====================================================
  961.         SPECIAL CASE!  CD's with no dirx.lst, files.bbs, etc.
  962.         =====================================================
  963.  
  964.         ==============================
  965.         Not "INnies" and not "OUTties"
  966.         ==============================
  967.  
  968.         HEY, MY CD doesn't even have a files list display at all... nothing.
  969.         No dirx.lst, no files.lst, no files.bbs... nothing.  Now what?
  970.         Fairly easy. :-)
  971.  
  972.         In this situation, you will have to make a files.bbs- or a
  973.         dirx.lst-type display file structure for your CD and put it on
  974.         your HD.  You can use FLYDIRX.EXE to make your file display
  975.         structures [DSP's] that is included in this archieve.  This
  976.         situation would be known as a "double-outtie" (the files.bbs/
  977.         dirx.lst's do not live IN the subdirectories on the CD that they
  978.         describe and do not even live on the CD at all (because there were
  979.         none and you had to construct them)).  Use FLYENGIN.EXE
  980.         and FLYDIRX.CFG to make dirx.lsts for entire CD's automatically
  981.         (see FLYDIRX.CFG for more explanation).  See caveat on FLYDIRX.EXE
  982.         later on in these docs.
  983.  
  984.         The control menu *.LST first line in an example menu for this
  985.         case would looks as so:    (note: this is a "double outtie")
  986.  
  987. ------------------------------------------------------
  988.                         Fig. 4
  989. ------ excerpt of a "no-nothing" CD *.LST setup ------    Line #
  990. IBM Networking:dirx.lst:out:max\file\twerp:C:               1
  991. 001N.LST:001N:LANS                                          2
  992. 002N.LST:002N:Networks of fun                               3
  993. 003N.LST:003N:Networking games                              4
  994. 004N.LST:004N:Nets & OS/2                                   5
  995. 005N.LST:005N:Net Arcanum                                   6
  996. ------------------------------------------------------
  997.  
  998.         In the above situation, you'll have to use FLYDIRX.EXE to make
  999.         your dirx.lsts for yourself.  See info on FLYDIRX.EXE
  1000.         below for constructing skeleton files.bbs/dirx.lsts.
  1001.  
  1002.         Your CD's menu control *.LST structure now is slightly different
  1003.         in the first line then previous menu *.LST structures, i.e., there
  1004.         are not 3, not 4, but now FIVE (5) bits of data:
  1005.  
  1006.                          /--- Name of your CD
  1007.                        /          /--- display file structure (DSP) format
  1008.                      /          /      /--- the DSP doesn't live in the
  1009.                    /          /      /      CD's subs it describes
  1010.                  /          /      /       /--- it lives in this subdirectory
  1011.                /          /      /       /          /--- and on C: drive
  1012.         IBM Networking:dirx.lst:out:max\file\twerp:C:
  1013.  
  1014.  
  1015.         (1) the CD name, (2) the displayfile structure type, (3) OUT,
  1016.         (4) the path on your HD where these displayfile structures will
  1017.         be found, and (5), the DRIVE on your HD where they are.  So,
  1018.         we see in the above example (where there are no files.bbs's or
  1019.         other display file structures on the IBM Networking CD) that:
  1020.  
  1021.                 there are dirx.lst-type structures, living OUT, on C:
  1022.                 drive, in subdirectory "max\file\twerp" and that
  1023.                 the first dirx.lst-type structure for the first
  1024.                 subdirectory is called "DIR1" and that it is describing
  1025.                 files in subdirectory 001N (actual subdirectory on
  1026.                 the CD).  Finally, we see this subdirectory of files
  1027.                 described for users as "LANS."
  1028.  
  1029.              ----------------------------------------------------------
  1030.              Leave no blank lines at the end of your CD menu-control
  1031.              *.LST files else you will get an "Illegal function" error.
  1032.              ----------------------------------------------------------
  1033.         --------------------------------------------------------------
  1034.                                A Caveat on FlyDirx
  1035.         --------------------------------------------------------------
  1036.         Use FLYDIRX.EXE to make these dirx.lst-type structures for
  1037.         yourself.  FLYDIRX.EXE will automatically make a display-file
  1038.         structure for each of your CD's subdirectories that is compatible
  1039.         to the door's display structure requirement and these dirx.lsts
  1040.         will have included in them the following:
  1041.  
  1042.         Filename        File Size       File Date
  1043.  
  1044.         You would now then have to edit these subdirectory list structures
  1045.         to include descriptions if you want them, yech!@, in your
  1046.         dirx.lst-formatted file display structure that FLYDIRX.EXE makes
  1047.         for you.
  1048.  
  1049.         FLYDIRX works on a commandline basis, e.g., to make a skeleton
  1050.         dirx.lst for a CD that has no files.bbs's or to make dirx.lsts
  1051.         for any other Drive\Subdirectory you desire.  For spot fixes,
  1052.         just use FLYDIRX.EXE itself.  For longer jobs, use FLYENGIN.EXE
  1053.         to complete a large number of subdirectories with ease.  If the
  1054.         subdirectory you desire to make a dirx.lst for already has a
  1055.         files.bbs, then FLYDIRX.EXE will import the files' descriptions
  1056.         from the files.bbs into the newly created dirx.lst.  FLYDIRX.EXE
  1057.         is started thusly (an example):
  1058.  
  1059.         flydirx d:\001N IN <dlc#>
  1060.  
  1061.         where d:\001N is the subdirectory for which I mean to make a
  1062.               skeleton dirx.lst
  1063.         where IN (or OUT) is the placement of this skeleton dirx.lst
  1064.               upon its creation.  Use OUT when working on CD's
  1065.         where <dlc#> is the number of spaces to adjust to the right(+#)
  1066.               or to the left(-#) to accomodate the importing of files
  1067.               descriptions from previously existing files.bbs in the
  1068.               d:\001N subdirectory.  If FLYDIRX.EXE finds a files.bbs
  1069.               in the subdirectory for which you are making a dirx.lst,
  1070.               it will import the files.bbs descriptions automatically.
  1071.               If no file.bbs is to be found, then you may just enter a
  1072.               "0" on this parameter.
  1073.  
  1074.               NOTE: IF your subdirectory DOES have files.bbs files from
  1075.               which to import descriptions, you will need to adjust the
  1076.               cut-line for the importing of files.bbs descriptions into
  1077.               the newly created dirx.lsts depending on the layout of the
  1078.               files.bbs.  Use <dlc#> to adjust the cutline as needed.  You
  1079.               will likely need to play a bit to get it right so experiment
  1080.               on a single directory before you start a large job employing
  1081.               FLYENGIN.EXE.  IF your files.bbs files are not the normal
  1082.               structure for files.bbs files, then you will need to employ
  1083.               KEUFLER.EXE rather than FLYDIRX.EXE.
  1084.  
  1085.         You could then place all these newly-created dirx.lsts in their
  1086.         own singular subdirectory on your HD (where you are running
  1087.         FLYDIRX) in the case of a CD that has no files.bbs/dirx.lsts
  1088.         (thereby making a "double outtie" out a a CD that couldn't otherwise
  1089.         be displayed to your users for downloading).  You could also place
  1090.         these newly-created dirx.lsts within the subdirectory they are
  1091.         describing in the event these subdirectories are on a writeable
  1092.         drive (thereby making "innies" possible).
  1093.  
  1094.         You may wish to employ INSTFREQ.EXE/FASTFREQ.BAT in combination with
  1095.         FLYDIRX.EXE in certain situations (see below).
  1096.  
  1097.         If FLYDIRX.EXE finds a normal files.bbs in the subdirectory you
  1098.         are converting to a dirx.lst listing, it will automatically import
  1099.         those files descriptions into the dirx.lst from the files.bbs it
  1100.         finds.  This is provided that the files.bbs is of this nature:
  1101.  
  1102.         BUFFALO.GIF  (320*200*256) A buffalo on the range
  1103.         CATFISH.GIF  (400*177*256)Your very own catfish!
  1104.         DEER.JPG     A nice deer
  1105.         DOGNCAT.GIF  (320*200*256) Bulldog and kitty
  1106.  
  1107.         IF your file.bbs is an odd-type structure that looks like this:
  1108.  
  1109.         MICKEY.ARJ MAC.pic of Mickey Mouse
  1110.         MINK.GIF (320*200*256) A mink in a tree
  1111.         RACCOON.GIF (320*200*256) A raccoon
  1112.         SPUDS.ARJ MAC.pic of the party animal, Spuds.
  1113.  
  1114.         then you must use Keufler.exe to achieve your goal of making a new
  1115.         dirx.lst with imported files.bbs descriptions.  KEUFLER.EXE is
  1116.         just like FLYDIRX.EXE with the only difference being its handling
  1117.         of files.bbs list structure.  With KEUFLER.EXE, you will have to
  1118.         manually do each subdirectory; FLYENGIN.EXE will not work with
  1119.         KEUFLER.EXE.   KEUFLER.EXE command line entry is exactly like
  1120.         that of FLYDIRX.EXE, so it is possible to drive KEUFLER.EXE using
  1121.         a bat file (that you would create) to do mass conversions.
  1122.  
  1123.         =========================================
  1124.         Special Case: The "Double Outtie"
  1125.         =========================================
  1126.         The appropriate format to access this type of "double outtie"
  1127.         special case (as it would be displayed in your control menu *.LST
  1128.         file) is as follows:
  1129.  
  1130. --------------------------------------------------------
  1131.                         Fig. 5
  1132. ------ excerpt of a "no-files.bbs" CD *.LST setup ------ LINE #
  1133. IBM Networking:dirx.lst:out:max\file\twerp:C:              1
  1134. 001N.LST:001N:LANS                                         2
  1135. 002N.LST:002N:Networks of fun                              3
  1136. 003N.LST:003N:Networking games                             4
  1137. 004N.LST:004N:Nets & OS/2                                  5
  1138. 005N.LST:005N:Net Arcanum                                  6
  1139. --------------------------------------------------------
  1140.  
  1141.         The list files in lines 2-6 above (Fig. 5), e.g., in the 2nd line,
  1142.         001N.LST, are those list files made by FLYDIRX.EXE for use in
  1143.         double-outties.
  1144.  
  1145.                   /--- these *.LSTs are made using FLYDIRX.EXE
  1146.                 /      /--- actual subdirectory name on your CD
  1147.               /      /        /--- Description for users of subdirectory
  1148.             /      /        /
  1149.         002N.LST:002N:Networks of fun
  1150.  
  1151.         ---------------------------------------------------------------
  1152.         Make sure you leave no blank lines at the end of the control
  1153.         menu *.LST files else you will get an "illegal function" error.
  1154.         ---------------------------------------------------------------
  1155.  
  1156.         What is Fig. 5, line 1 telling us?  Living OUT in drive C: in
  1157.         subdirectory max\file\twerp are a collection of DSP's for our
  1158.         CD that are all dirx.lst-like files.
  1159.  
  1160.         From lines 2-6 in Fig. 5, we see these dirx.lst-like files are
  1161.         called 001N.LST, 002N.LST, etc.  Though they are all on
  1162.         c:\max\file\twerp, they are each describing different subdirectories
  1163.         on the CD.  On line 2 of Fig. 5, we see that 001N.LST (though on
  1164.         c:\max\file\twerp) is describing files on our CD's subdirectory
  1165.         called \001N. (Note: the drive letter to our CD is set in a file
  1166.         called CDSONLIN.LST discussed later -- don't worry about that just
  1167.         yet).
  1168.  
  1169. Well, now you can do simple innies, simple outties, make a double-outtie
  1170. from a "nottie" CD.  We can work with files.bbs's, dirx.lst's, and *.*
  1171. display file structures.  That ought to handle your basic situations <g>.
  1172. There are, however, other "special cases" that we'll discuss here shortly.
  1173. As a caveat, however, check this out:
  1174.  
  1175.         ----------------------------------------------------------------
  1176.         Playing with configs and making your own special cases
  1177.         ----------------------------------------------------------------
  1178.  
  1179.         Leave no blank lines at the end of any of the configuration
  1180.         files you create yourself or edit else it is likely that you
  1181.         will get an "Illegal function" error.
  1182.  
  1183.         The key to getting any CDrom to work on CDMX2DOR is having things
  1184.         appropriately configured.  If things are not working for you,
  1185.         then you probably have not configured things rightly.  Check to
  1186.         make sure you have things configured appropriately.
  1187.  
  1188.         For the expert user: you can play with configs as you please as
  1189.         regards to where files.bbs-like structures live.  For example,
  1190.         I put CDMX2DOR on a Drive B: subdirectory, copied NightOwl 8's
  1191.         DIR files to a Drive A: subdirectory, had NightOwl 8 CD in Drive
  1192.         D:, and had a subdirectory in Drive C: as my scratch directory.
  1193.         This worked quite nicely as a "Double Outtie" accessing all my
  1194.         drives.  You can do your innies, outties, notties, or whatever
  1195.         wherever you please as long as you have things configured
  1196.         appropriately.  The advantage of a "double outtie" is just faster
  1197.         file searches (i.e., the CD's directories are on the HD -- but
  1198.         they take up about 1 Meg so it is a tradeoff between speed and
  1199.         HD space).  Of course if your CD has no file-display structures
  1200.         you'll HAVE to use a double outtie configuration.
  1201.  
  1202.         ----------------------------------------
  1203.         Special case: DRIVE B: use as an "innie"
  1204.         ----------------------------------------
  1205.  
  1206.         Included in this archieve is a little control-menu for my Drive
  1207.         B: called "tbcbob.lst" which I have configured as an "innie."
  1208.         Drive B: was originally a "nottie," i.e., there was no file.bbs
  1209.         or dirx.lst on B:\tiny nor any in B:\ or anywhere else.
  1210.  
  1211.         I used FLYDIRX.EXE to set up its skeleton dirx.lst (which
  1212.         FLYDIRX.EXE named as TINY.LST and put on Drive C:), used
  1213.         QEdit to finish up the dirx.lst, renamed it "dirx.lst" and
  1214.         copied to Drive B:\tiny.  I then told CDSONLIN.LST that this
  1215.         was an innie.  So, you can squeeze an extra 1.44 bytes out of
  1216.         your B: drive for users if you so desire.  I could just as
  1217.         easily configured my B: drive as an outtie or a double outtie
  1218.         if I so chose...  it depends on where you place the dirx.lst
  1219.         and what you call the dirx.lst as to whether it is an innie,
  1220.         outtie.
  1221.  
  1222.         Now back to the special cases...
  1223.  
  1224.         More on innies...
  1225.         =============================================================
  1226.         YET ANOTHER SPECIAL CASE:  The "buried innie"
  1227.         =============================================================
  1228.  
  1229.         ------------------
  1230.         Weird-named Innies
  1231.         ------------------
  1232.  
  1233.         Let's assume a situation in which your files directory lists
  1234.         are "in" the subdirectories that they describe but that they
  1235.         are not all named the same, e.g., for one directory the
  1236.         files display structure is GAMESA-L.LST and for another
  1237.         subdirectory the files display structure is GAMESM-Z.LST.
  1238.         A simple innie using a common name, e.g., dirx.lst, won't
  1239.         work.  You will have a special case here known as a "buried
  1240.         weird named-innie."  Here is an example:
  1241.  
  1242. ----------------------------------------------------------------------------
  1243.                                   Fig. 6
  1244. ----------------------------------------------------------------------------
  1245.                  /-- CD name
  1246.                /         /-- display file structure type
  1247.              /         /     /-- location is "in" the subdirectories it
  1248. Line#      /         /     /     describes
  1249.   1     SIMTEL 8:dirx.lst:IN
  1250.   2     filesg\001A\games@DIR1:Games A-P
  1251.   3     filesg\002A\arcane@DIR2:Games Q-Z<---- description for user of subdir
  1252.             \     \    \   \  \--------------dirx.lst's real NAME whatever
  1253.               \     \    \   \-- NOTE: see this "@" sign??? It is critical
  1254.                 \     \    \-- two subs deep                in the config!
  1255.                   \     \-- one sub deep
  1256.                     \-- main root subdirectory of all files off of X: drive
  1257. ----------------------------------------------------------------------------
  1258.  
  1259.         To do a "buried innie" you must put the root subdirectory off the
  1260.         X: drive (whatever it is as specified in your CDSONLIN.LST),
  1261.         followed by the remaining subs, followed by a "@" to denote the
  1262.         end of the complete path; next you place the name of the files
  1263.         display structure (whatever it may be, e.g., DIR, GAMESA-P.LST,
  1264.         whatever it may be.  Follow that with a colon (:) and then the
  1265.         description of the subdirectory that the user will see.
  1266.  
  1267.         The first line (e.g. starting with SIMTEL, above) is exactly like
  1268.         any other innie; the difference is in the remaining lines.
  1269.  
  1270.         What is Fig. 6 telling us about our CD?   Living IN buried subs
  1271.         on our CD are some DSP's.  In line 2 (Fig. 6) we see that
  1272.         our DSP (called DIR1 on the CD) lives in the \filesg\001a\games
  1273.         subdirectory.  Line 3 (Fig. 6) states our DSP (called DIR2 on
  1274.         the CD) lives in \filesg\002A\arcane subdirectory.
  1275.  
  1276.         So, with this setup, we can go subdirectories deep into a
  1277.         CD and find different named DSPs if we need to and still do an
  1278.         "innie" situation.
  1279.  
  1280.         -------------------
  1281.         Normal-named Innies
  1282.         -------------------
  1283.  
  1284.         My DSP's are all called the same name (e.g., dirx.lst) but they
  1285.         are buried subdirectories deep on my CD.  Now what?
  1286.  
  1287.         NOTE: You can have a "not-weird named-buried innie" simply by
  1288.         having something like the following:
  1289.  
  1290. ----------------------------------------
  1291.                 Fig. 7
  1292. ----------------------------------------
  1293. Line#
  1294.   1     The Back Door:dirx.lst:in
  1295.   2     max\file\amiga:Fun stuff for you
  1296.   3     max\file\apple:More fun stuff
  1297.   4     max\file\bbsstuf:BBS stuff
  1298. -----------------------------------------
  1299.  
  1300.         The only difference between this "normal" buried innie and the
  1301.         weird-named innie is that there is no "@whatever.lst" in the
  1302.         second thru the 4th lines.  This means that, though buried, each
  1303.         one is called "dirx.lst."  The difference between this "not-
  1304.         weird named-buried innie" and a simple "innie" (discussed way
  1305.         up at the start of this section) is that this type handles buried
  1306.         innies; the other's discussion (above) does not really detail this
  1307.         special case as is detailed here.
  1308.  
  1309.         =====================================================
  1310.         SPECIAL CASE!  Variable subdirectory-depth Innies
  1311.         =====================================================
  1312.  
  1313.         I have a case on my CD where sometimes the DSP's are only 1
  1314.         subdirectory deep and sometimes 3 subs deep.  Now what?
  1315.  
  1316.         -------------------------------------------
  1317.         (Variable stacked-deep normal-named Innies)
  1318.         -------------------------------------------
  1319.         You can have combinations of stacked-deep buried innies also, e.g.,
  1320.  
  1321. ---------------------------------------------
  1322.                     Fig. 8
  1323.         (Variable stacked-deep normal innies)
  1324. ---------------------------------------------
  1325. Line#
  1326.   1     The Side Door:dirx.lst:in
  1327.   2     max\:Fun stuff for you
  1328.   3     max\file\:More fun stuff
  1329.   4     max\file\bbsstuf:BBS stuff
  1330. ---------------------------------------------
  1331.  
  1332.         See how I have different subdirectories-deep locations for my
  1333.         dirx.lsts?  Keep this in mind if you encounter a CD such as this.
  1334.         Remember, though, they are all named "dirx.lst."  What if they
  1335.         are not??
  1336.  
  1337. --------------------------------------------------
  1338.                       Fig. 9
  1339.         (Variable stacked-deep weird-named innies)
  1340. --------------------------------------------------
  1341. Line#
  1342.   1     RAMTEL 10:dirx.lst:IN
  1343.   2     backup\games@squid.lst:Apogee Games
  1344.   3     backup\001\arcane@DIR1:Arcanum  <---- description for user of subdir
  1345. --------------------------------------------------
  1346.  
  1347.         Note that in line 2 (Fig. 9) I only have 2 subs deep to get to
  1348.         my squid.lst (DSP) for that files display structure that is living
  1349.         "in."  For the 3rd line, I have 3 subs deep to get to the DIR1
  1350.         display file list.  Therefore, I can go differing subdirectories
  1351.         deep on a CD to look for "innie" files-display structures (DSPs) and
  1352.         their associated "in" files and identify the DSP's by name.
  1353.  
  1354.         ========================================
  1355.         COMBINATIONS
  1356.         ========================================
  1357.  
  1358.         Combo Innies
  1359.  
  1360.         You have a CD that has some of the files display structures 2
  1361.         levels deep, some only one deep, some 3 deep and some have
  1362.         3 files descriptions (3 DSPs) in some single subdirectories each of
  1363.         which only describe part of the files that are in the entire
  1364.         subdirectory...  eeeek!  Now what?  No problem!
  1365.  
  1366.         -----------------------------------------------------------
  1367.                                 Fig. 10
  1368.         -----------------------------------------------------------
  1369.  
  1370.         CATBOX CD:dirx.lst:IN
  1371.         fleas\chiggers\gnats\flies@Stimpy.lst:CATS on the Roof
  1372.         fleas@rin.LST:Chihuahua Dancing
  1373.         fleas@hairball.lst:Hairballs for you
  1374.         fleas@notnow.lst:The Great Escape
  1375.         fleas\bees\bats\rats\mats\scats\fats@insect.lst:Zowee Bugs!
  1376.  
  1377.         -----------------------------------------------------------
  1378.  
  1379.         The above combo will allow us to look IN on different subs-deep
  1380.         levels for different named DSP's.  These above special cases
  1381.         of subs-deep, normal vs weird named DSP, INnies ought to catch
  1382.         about 99.5% of your CD cases.
  1383.  
  1384.         -------------
  1385.         Combo Outties
  1386.         -------------
  1387.  
  1388.         Yeah, but I want to put 'em on my Hard Drive and bury 'em in
  1389.         subdirectories on my HD.  Can you do that?  Sure.
  1390.  
  1391.         --------------------------------------------
  1392.                             Fig. 11
  1393.         --------------------------------------------
  1394.  
  1395.         IBM Lantastics:dirx.lst:out:car\file\0023:F:
  1396.         001N.LST:001N:LANS
  1397.         NETFUN.LST:002N\077A\BOX2:Networks of fun
  1398.         003N.LST:003N\088A:Networking games
  1399.         COWSOUP.LST:004N:Nets & OS/2
  1400.         005N.LST:005N\099A:Net Arcanum
  1401.  
  1402.         --------------------------------------------
  1403.  
  1404.         Translating the above situation, Living OUT on F:\car\file\0023 is
  1405.         a collection of DSP's that are different named, describing
  1406.         subdirectories on the CD that are several subs deep off the
  1407.         main drive letter.  Some are only 1 sub deep; some are 3 subs
  1408.         deep on the CD.
  1409.  
  1410.         You get the picture.  Don't you wish that CD makers would figure
  1411.         a standard way of indexing their products?!?  :*)
  1412.  
  1413.  
  1414. Let's recap before we move on to step 6 (so you don't get totally mind-
  1415. boggled :*).  It really is much simpler to DO then to explain making menu
  1416. control LST files, so take heart!  Most cases these days tend to be CD's
  1417. that are already set up for easy BBS display (if they are shareware).
  1418.  
  1419. So far you have:
  1420.  
  1421.         o       seen how to configure the *.CNF and *.CFG files
  1422.         o       seen how to get the *.BAT set up (and the *.BBS/*.MEC
  1423.                 if your Maximus)
  1424.         o       seen how to set up CD control menu *.LST files for all
  1425.                 kinds of circumstances, i.e., innies, outties, and notties.
  1426.         o       seen how to work with files.bbs, dirx.lst, or even *.*
  1427.                 display file lists.
  1428.         o       talked about "double outties" and advanced configurations
  1429.         o       talked about a utility (FLYDIRX.EXE) for making skeleton
  1430.                 files-display structures for CDs that have none.
  1431.         o       talked about incorporating your HD (Drive C:) and even your
  1432.                 B:\ drive for files use via CDMX2DOR.
  1433.         o       talked about normal- and weird-named innies.
  1434.         o       discussed variable-depth innies
  1435.         o       discussed combination innies and combination outties
  1436.  
  1437. =============================================================================
  1438. [6.0]   Now you'll have to edit the file called CDSONLIN.LST to include
  1439.         your *.LST menus of your CD's.  This file looks so:
  1440.  
  1441. ------------------------------------------
  1442.                 Fig. 12
  1443. -------- excerpt of CDSONLIN.LST ---------      Line #
  1444. PowerPak '92,30,ppcbob.lst,OK,D:,*                 1
  1445. NightOwl 8,50,no8cbob.lst,OK,E:,nite8ok.nam        2
  1446. PowerBox v1.00,30,pbcbob.lst,OK,G:,*               3
  1447. Pier 1,30,p1cbob.lst,-,F:,pier1ok.nam              4
  1448. NightOwl 7,30,no7cbob.lst,-,H:,*                   5
  1449. NightOwl 6,10,no6cbob.lst,-,I:,*                   6
  1450. SuperShare v1.00,50,sscbob.lst,-,M:,suprshok.nam   7
  1451. -------- end of excerpt ------------------
  1452.  
  1453.         CDSONLIN.LST structure
  1454.  
  1455.         NOTE: your CD's name cannot exceed 15 characters maximum else
  1456.         the door will not work appropriately.  Stick with something like
  1457.         "PowerPak '92" rather than "PowerPak Online '92 SuperDuper CDROM."
  1458.  
  1459.         Note that each line in Fig. 12 has 6 pieces of data: (1) the CD's
  1460.         name, (2) the CD's security/privileges level, (3) the CD's *.LST file
  1461.         (a directory structure - see below), (4), an OK if it is online
  1462.         and a - if it is not online, (5), the DRIVE: where this CDRom
  1463.         is located, and (6), the special privileger.
  1464.  
  1465.         In the above, you can see I have 3 CD's online and 4 offline.
  1466.         The first 3 are online in drives D:, E:, and G: and the last 4 are
  1467.         offline.  Users may select at will which of the 3 they wish to
  1468.         work with on their own in either drives D:, E:, or G:.  The online
  1469.         drives (D:, E:, and G:) have a security level of 30, 50, and 30,
  1470.         respectively.  A user with a security level of 30 will only see
  1471.         2 of the 3 drives as available to them.  You can see that NightOwl8,
  1472.         Pier1, and SuperShare have a ".nam" file in the special privileger
  1473.         slot and the others just have a "*" in the special privileger slot.
  1474.  
  1475.         -------------------------------------------
  1476.         A Caveat on "special privileged CDs
  1477.         -------------------------------------------
  1478.  
  1479.         What is the special privileger anyway??
  1480.  
  1481.                 The *.NAM files in the special privileger slot above (data
  1482.         item 6 on each line) contains a list of users' names that have
  1483.         access to a disk IF their security level meets the requirement.
  1484.         Others, who's security level meets the requirement for that CD
  1485.         but who's names are NOT in this list will be told by the door that
  1486.         this CD is "offline."  They can't get to the CD even if their
  1487.         security level is sufficient to do so because their name is not
  1488.         in the *.NAM list for that CD.  If you only care to have a CD's
  1489.         access governed by the security level alone, then just have a
  1490.         star (*) in the special privileges slot.  If you want to keep
  1491.         users out of a CD, though they are qualified by security level
  1492.         to see it, then use the .NAM file to control that disk.  ONLY
  1493.         people with adequate security AND their name in the .NAM file
  1494.         for that CD will be able to get into it.  You can call these
  1495.         *.NAM files whatever you please as long as you put that name in
  1496.         the CDSONLIN.LST.
  1497.  
  1498.         ---------------------------------------------------------------
  1499.  
  1500.         Let's look at Line #1 (Fig. 12) graphically:
  1501.  
  1502.         Graphically:
  1503.                       /--- the CD's name
  1504.                     /       /--- a security level of 30
  1505.                   /       /   /--- the CD's *.LST you made in step 5 above.
  1506.                 /       /    /
  1507.               /       /    /        /--- it is online and ready to be used
  1508.         PowerPak '92,30,ppcbob.lst,OK,E:,*
  1509.          +---------------------------/     \
  1510.          |                                   \
  1511.          +-the drive where the CD lives        \--- special privilege slot
  1512.  
  1513.         Here's one that is offline:
  1514.  
  1515.                     /--- the CD's name
  1516.                   /    /--- security level 50
  1517.                 /    /   /--- the CD's *.LST menu
  1518.               /    /   /
  1519.             /    /   /        /--- it is offline
  1520.         Pier 1,50,p1cbob.lst,-,G:,* <------------- accessible to anyone with
  1521.                                 \                    a security level of 50
  1522.                                   \--- if it were online, it would be in
  1523.                                        drive G:
  1524.  
  1525.  
  1526.         Here's some changes so you can see what happens
  1527.  
  1528.                     /--- the CD's name
  1529.                   /    /--- I reduced the security level to 30
  1530.                 /    /   /--- the CD's *.LST menu
  1531.               /    /   /
  1532.             /    /   /        /--- it is now online
  1533.         Pier 1,30,p1cbob.lst,OK,H:,pier1ok.nam <---- accessible ONLY to users
  1534.                                /                     with a security level of
  1535.                                |                     30 AND their name appears
  1536.                                |                     in pier1ok.nam.
  1537.                                 \
  1538.                                   \--- it is online in drive H:
  1539.  
  1540.      The function of this list is to provide you and your users a
  1541.      selection of CD's upon which to work.  You may display some, all, or
  1542.      none of your CD's to users based on their privilege level and whether
  1543.      you put their names in a special privilege list or not.  This
  1544.      privilege/security level is that one which is written in the door.sys
  1545.      file.
  1546.  
  1547.      To initiate the special privilege controls, you have to have a file
  1548.      with names in it; if not special privilege controls, then just have a
  1549.      "*" in that slot.  Note: it MUST be an asterisk/star there if no
  1550.      special privilege controls are used for a CD.
  1551.  
  1552.      ------------------------------------------------------------
  1553.      Leave no blank lines at the end of any of the configuration
  1554.      files you create yourself or edit else it is likely that you
  1555.      will get an "Illegal function" error.
  1556.      ------------------------------------------------------------
  1557.  
  1558.      Maximus BBS-only sysop information:
  1559.  
  1560.      If you are a Maximus BBS sysop, this privilege level is set in the
  1561.      cdmx2dor.mec/.bbs files included herein.  If you are not a Maximus
  1562.      BBS software sysop then your door.sys will write a privilege level
  1563.      for you based on your own particular software.
  1564.  
  1565.                   CDMX2DOR.MEC/BBS defaults for Maximus users
  1566.                Maximus setup on privilege levels/security levels
  1567.                      Privilege Level         Security Value
  1568.                          Sysop                    100
  1569.                      AsstSysop                     80
  1570.                          Clerk                     70
  1571.                          Extra                     60
  1572.                        Favored                     50
  1573.                     Privileged                     40
  1574.                         Worthy                     35
  1575.                         Normal                     30
  1576.                        Limited                     25
  1577.                       Disgrace                     20
  1578.                           Twit                      5
  1579.  
  1580.      You can change these security values if you wish, but, if so, then
  1581.      you will need to change your CDMX2DOR.MEC and re-MECCA.
  1582.  
  1583.      All BBS Systems sysop information:
  1584.  
  1585.      You may have up to 102 CD's online with this door from which your users
  1586.      may select.  The following lines have a particular structure that you
  1587.      must follow to make the door work appropriately.  An explanation of
  1588.      the structure follows by example:
  1589.  
  1590.                 /---- CD's name.  Keep it at 12 or less characters, please.
  1591.               /           /--- User's privilege level
  1592.             /           /       /---CD's control menu
  1593.           /           /       /    /--- online status "OK" for online, "-"
  1594.        /           /       /    /        for not online.
  1595.     PowerPak '92,40,ppcbob.lst,-,D:* <--- no special privilege controls
  1596.                                    \
  1597.                                      \--- CD's actual drive location
  1598.                                           (put the : at the end, e.g.,
  1599.                                            C:, X:, Q: or whatever)
  1600.  
  1601.      Explanation: The CD is PowerPak '92 and users with a security level
  1602.      of 40 or greater have access to it.  The CD's control menu is
  1603.      ppcbob.lst (see this one and others in this archieve), it is currently
  1604.      offline, but would, if online, be in Drive D:  There is no special
  1605.      access required via a *.NAM file to get at this CD, you only need to
  1606.      have the right security level.
  1607.  
  1608.      Changing your door' actions on this list is as easy as using a text
  1609.      editor to change this list.  I can increase/decrease security for
  1610.      a particular CD by just changing the security/privilege level value
  1611.      that a user must have as a minimum to access it via using Qedit or
  1612.      whatever text editor, OR, by initiating special privilege controls
  1613.      an putting their name in a *.NAM list for that particular CD.
  1614.  
  1615.      I can change the online/offline status by changing the "-" above to
  1616.      an "OK" and, voila, it is now online.  I can change the actual drive
  1617.      that the CD lives in in similar fashion.  In less than a minute I can
  1618.      bring an offline, high-security-level CD on drive G: to online, low-
  1619.      security-level CD on drive D: by just using a text editor and changing
  1620.      a very few things.
  1621.  
  1622.      Note that if you just have one (1) CD drive, you can only have one
  1623.      CD list available online for users <g>.  This door will unfortunately
  1624.      not physically remove and replace your CD's in your drive :*)  If you
  1625.      have 102 CD Drives, then you can have 102 CD's online... one per drive.
  1626.      You can also put your HD files on CDMX2DOR if you like so a user
  1627.      would have full access to ALL your files everywhere via CDMX2DOR.
  1628.  
  1629.         ======================
  1630.         Support up to 102 CD's
  1631.         ======================
  1632.  
  1633.         You may have up to 102 CD's online if you want to <g>.  Each CD
  1634.         needs a line in the CDSONLIN.LST.  Edit your CDSONLIN.LST
  1635.         as necessary.  Each CD requires a *.LST menu as described in
  1636.         step 5 above (innies, outties, notties, etc.).  You can call your
  1637.         *.LSTs whatever you please but you must tell CDMX2DOR what they
  1638.         are via CDSONLIN.LST.  Just for novices: You have to have a
  1639.         different drive for each list for each drive you have online.
  1640.         You can't have 4 drives online with only one CD driver :*)
  1641.         unless you're REAL QUICK in changing CD's (joke).
  1642.  
  1643. =============================================================================
  1644. [7.0]   Well, now, after we've gotten this far, the rest is pretty
  1645.         simple.  CDMX2DOR needs to have access to the following
  1646.         files to have it work rightly:
  1647.  
  1648.         (a)     PKZIP.EXE
  1649.         (b)     PKUNZIP.EXE
  1650.         (c)     DSZ.COM  (if you run the door via standard ports)
  1651.         (d)     FDSZ.EXE (if you run the door via fossil ports)
  1652.  
  1653.         You must put these on your PATH for best results.  You can get
  1654.         these files off of almost any BBS if you don't already have them.
  1655.         (I know for sure you've got pkunzip.exe :-))  Be sure to
  1656.         use DSZ.COM and not DSZ.EXE.  These files are for online
  1657.         unzipping and viewing files, for putting your BBS Add in out-
  1658.         going files, and for download, of course.  BE SURE TO PUT
  1659.         YOUR BBS ADVERTISEMENT IN YOUR DOOR'S SUBDIRECTORY so it can
  1660.         be copied to your temporary drive.  I've included NCB.ADV as an
  1661.         example BBS advertisement.
  1662.  
  1663.         You will want to adjust your autoexec.bat with DSZ statements
  1664.         so as to get it to write a DSZ.log for you.  In my autoexec.bat
  1665.         I have the following for DSZ:
  1666.  
  1667.         set dszlog=c:\max\log\dsz.log
  1668.  
  1669.         You will want to adjust this above line to suit your system.
  1670.         This setting will work regardless of whether you use DSZ.COM or
  1671.         FDSZ.EXE (the fossil version of DSZ).
  1672.  
  1673.         Now copy your BBS advertisement file, e.g., NCB.ADV into your
  1674.         scratch directory (as configured in CDMX2DOR.CFG) so this can
  1675.         be appended to outgoing zips.
  1676.  
  1677. [7.1]   IF you are a Pioneer Carousel CDRom Reader user AND you are
  1678.         in a multinode situation, then you will need to place a "lock"
  1679.         filename in the appropriate line in the CDMX2DOR.CFG file.  This
  1680.         "lock" filename is a 0 byte file that will be written to the
  1681.         subdirectory of your choice and serves the purpose of preventing
  1682.         a concurrent reading of your CDRoms as the carousel has only one
  1683.         read-head despite it's having 6 CD's.  If a given user attempts
  1684.         to read something with the carousel and another user is presently
  1685.         reading something from it, that new read will be in a hold until
  1686.         the former read is finished and, once finished, the new read
  1687.         will be allowed.  Therefore, in a multinode situation, the proper
  1688.         configuration is to have each node's configuration file specifying
  1689.         the SAME lock file name and written to the same subdirectory.
  1690.         In so doing, each node will first check to see if a read is already
  1691.         in progress and, if so, then hold or, if not, then lock and read.
  1692.         By example, you would have this line in EACH of your CDMX2DOR.CFG
  1693.         files if multinode and carousel:
  1694.  
  1695.         c:\intercom\lock.fil
  1696.  
  1697.         Hence, every node will look to c:\intercom to see if a "lock.fil"
  1698.         is present and, if so, then wait till it is no longer there and,
  1699.         when not there, then write a lock.fil and commence a read until
  1700.         the read is complete and then delete "lock.fil".  By this method,
  1701.         then, the multinodes will not confuse one another in reading
  1702.         the multiple CD's while sharing a single read-head.
  1703. =============================================================================
  1704. [8.0]   Well....  if you've done everything above appropriately then
  1705.         it is now time to let the users have a go at it.  You can try
  1706.         it out on your own offline if you have the first line in your
  1707.         DOOR.SYS set to COM0: , making sure your ANSI driver is loaded,
  1708.         and then, at the prompt, type:
  1709.  
  1710.         cdmx2dor cdmx2dor.cnf
  1711.  
  1712.         When you are on locally, the door will not do the DSZ downloading
  1713.         nor will it add BBS Advertisements to files.  This only happens
  1714.         when a user is on.  However, you will see locally what the user
  1715.         will see remotely when they are on it.  When users are running
  1716.         it, the display will appear to mess up when pkzip and dsz are
  1717.         doing their thing but this is only on the local screen so don't
  1718.         get worried - users don't see this stuff.   Running it locally
  1719.         will let you see what the users will see (i.e., no distortions
  1720.         by pkzip and dsz).
  1721.  
  1722.         You will note that if you are unregistered, there is a message
  1723.         to that effect on starting the door and there will be a brief
  1724.         delay for users on the main menu along with a message that
  1725.         the door is not registered.  You can fix that <g> if you register
  1726.         the door and get your KEY FILE which will turn off the delays and
  1727.         the unregistered messages.  See below for registration information.
  1728.  
  1729. =============================================================================
  1730. [9.0]   OK, I got it setup and I saw it locally and it looks good.  What's
  1731.         all the files and stuff?
  1732.  
  1733.         It is likely that you'll find a few extra *.lst, *.nam, or *.bats
  1734.         in this archieve that are not listed above.  They are just various
  1735.         sample files that will help you in configuring/controlling CDMX2DOR.
  1736.         If it is not listed above, take a peek at the file and see what it
  1737.         is and how it might help you in setting things up.
  1738.  
  1739.         (a)     CDMX2DOR will write a NGDL.LOG recording user's downloading
  1740.                 activity.  All files successfully transferred will have
  1741.                 a record of same made here.  You'll know who downloaded
  1742.                 what, when, and with what protocol.  You can rename this
  1743.                 NGDL.LOG file to another name if you so choose (see
  1744.                 cdmx2dor.cfg for more information).
  1745.  
  1746.         (b)     BADSEND.LST is a record of all unsuccessful transfers.
  1747.                 You can find out who is screwing up.  Renaming of this
  1748.                 file is allowable (see immediately above).
  1749.  
  1750.         (c)     USERS.DAT is a record of who has been on the door lately
  1751.                 and keeps track of how many Kbytes a body downloaded
  1752.                 today.  It will prevent a user from downloading more than
  1753.                 the daily Kbyte allotment in a given day.  This record
  1754.                 also gives you info on who was in the door and when
  1755.                 they were last on the door.
  1756.  
  1757.         (d)     LOCK.LST is a file where you put the names of the
  1758.                 files you'd like to control users' access to particular
  1759.                 files.  The format of lock.lst entries is as follows:
  1760.  
  1761.                 filename.ext, key$
  1762.  
  1763.                                   /- file to lock
  1764.                                 /
  1765.                               /        /-key for this file
  1766.                 example: cindy.gif, foxxy
  1767.  
  1768.                 If you choose to prevent users from ever downloading
  1769.                 a particular file, then just put the filename.ext and
  1770.                 leave out the "," and have no key for it.  For example
  1771.                 a totally forbidden file entry in lock.lst would appear
  1772.                 as follows:
  1773.  
  1774.                 filename.exe
  1775.                                   /- file forbidden to all users and
  1776.                                 /         there is no key.
  1777.                               /
  1778.                 example: cindy.gif
  1779.  
  1780.                 Some good CD's have GIFS on them that are near-to-porn
  1781.                 and prevent family-oriented boards from using them.  Any
  1782.                 file name you put in here without a key will be forbidden
  1783.                 and users won't be able to download it.  If you don't want
  1784.                 to forbid anything, then don't enter any filenames or just
  1785.                 have an empty file.  Note that any filename placed in
  1786.                 this list WITHOUT A KEY is inaccessible to all your users.
  1787.  
  1788.  
  1789.                 If you'd like some of your users to get access to a file
  1790.                 but prevent others from downloading that file, then put
  1791.                 the filename.ext in the list and have a key to it.  You
  1792.                 would then share or not share this key with whomever you
  1793.                 choose.  Those that have the key can process the file for
  1794.                 viewing/downloading -- those that don't can't.  You can
  1795.                 change this key with a standard text-editor at will, so
  1796.                 you can re-lock to formerly un-locked users by simply
  1797.                 changing the key.
  1798.  
  1799.         (e)     CDTEMP.LST is a file that the user will employ to
  1800.                 access your CD's.  Up to 102 CD's are supported via
  1801.                 CDMX2DOR.  The file is volatile and changes based
  1802.                 on users activity.  The file is node-aware to prevent
  1803.                 multitasking conflicts, so you may find 0CDTEMP.LST or
  1804.                 1CDTEMP.LST (node-prefixed CDTEMP.LST's) on your system
  1805.                 depending on what node is accessing the door.
  1806.  
  1807.         (f)     FIXMAX.EXE is a utility for MAXIMUS (TM) BBS sysops
  1808.                 that will automatically adjust Max's users.bbs files
  1809.                 for you.  If you're not using Maximus then this file
  1810.                 does nothing.  This file must be in CDMX2DOR's
  1811.                 subdirectory.
  1812.  
  1813.         (g)     FLYDIRX.EXE is a utility for making dirx.lst/files.bbs
  1814.                 type structures for your CD's that have no dirx.lst/
  1815.                 files.bbs's on them or for making dirx.lsts for your
  1816.                 writeable drives.  Read the file FLYSTUFF.DOC as to
  1817.                 how to employ the "fly series" of utilitities.  With
  1818.                 the fly-series of utilitities you can take virtually
  1819.                 any CD and run it on CDMX2DOR after you've got the
  1820.                 display-file structures (dirx.lst/files.bbs) made.
  1821.  
  1822.                 FLYDIRX.EXE will make these structures for you
  1823.                 and name them by the name of the subdirectory they
  1824.                 came from, e.g., 001A.LST, or BOOKS.LST or whatever.
  1825.                 You can then use these *.LST file structures on your
  1826.                 HD so that a user can download anything from your
  1827.                 CDs.  If you have a situation like this, just run
  1828.                 FLYDIRX.EXE and follow instructions.  Use a text editor
  1829.                 to edit the resulting products of FLYDIRX.EXE to your
  1830.                 liking (e.g., adding file descriptions and cleaning
  1831.                 up the structure to suit your needs).
  1832.  
  1833.                 In this case, where your CD's have no files-display
  1834.                 structures, you would have a "Special Case" so see
  1835.                 that information above for assistance.
  1836.  
  1837.                 See FASTFREQ.BAT as an associate of flydirx.exe.
  1838.  
  1839.                 KEUFLER.EXE is a type of FLYDIRX.EXE that is for the
  1840.                 purpose of dealing with odd-structured files.bbs files'
  1841.                 description importation into newly created dirx.lsts.
  1842.  
  1843.  
  1844.         (h)     INSTFREQ.EXE and FASTFREQ.BAT
  1845.  
  1846.                 Instfreq.exe will quickly copy any files meeting a wild-
  1847.                 card parameter from any drive to any drive.  FastFreq.BAT
  1848.                 is an example of employing INSTFREQ and FLYDIRX together
  1849.                 to quickly copy a set of files meeting a definition to
  1850.                 a particular drive/subdirectory and then quickly making
  1851.                 a dirx.lst of those files copied.  This utility comes
  1852.                 in handy if a user requests certain files and you want
  1853.                 them to get at them immediately.  For example, a user
  1854.                 requests QModem files...  you just edit your FASTFREQ.BAT
  1855.                 appropriately and then run it and the user now has these
  1856.                 files in a preconfigured download area called "Requests."
  1857.                 They now have immediate access to those files via
  1858.                 CDMX2DOR.  The "Request" area might have a special
  1859.                 privilege control file on it where ONLY this particular
  1860.                 user's name is.  Only HIM and no one else can then get
  1861.                 these requested files.
  1862.  
  1863.         (i) A Special Note on security:
  1864.  
  1865.                 CDMX2DOR could give you these levels of security on
  1866.                 your CDs/files:
  1867.  
  1868.                 Example of super-strict security
  1869.  
  1870.                 o   a user has to have a security level of, say 40, to
  1871.                     even know that a particular CD exists on the system.
  1872.                     Assume he does have a security level of 40 and sees
  1873.                     that a particular CD exists.  You set this one up
  1874.                     with a special privilege file.  He must have his name
  1875.                     in the special privilege *.NAM list for that CD else it
  1876.                     will appear to him that it is offline.  Assume he
  1877.                     has his name in the list and the CD is online for him.
  1878.                     He must now know the keyword for each different file
  1879.                     that he finally gets to see
  1880.  
  1881.                     In this above example, a user would need to pass 3
  1882.                     levels of security to access a given file.
  1883.  
  1884.                 Example of lowest-level security
  1885.  
  1886.                 o   a CD has a security level of 5, no special privilege
  1887.                     file, and no keys.  Virtually anyone gets access to
  1888.                     every file on that CD.  Everyone knows it is there.
  1889.  
  1890. =============================================================================
  1891. [10.0]  Still Problems???
  1892.  
  1893.         If you've still not gotten it going correctly after double
  1894.         checking, then drop me some e-mail at 1:232/31 or call my
  1895.         board at (309) 797-6027.  Here's a few tips just in case:
  1896.  
  1897.  
  1898.     ### I've spent 2 hours configuring the darn thing and I've double
  1899.         checked everything and the bugger still won't even start!  What
  1900.         the heck is wrong?
  1901.  
  1902.                 Did you run TEMPNODE.EXE to make your node-aware tempoary
  1903.                 subdirectories?  You HAVE to do this or the door will never
  1904.                 start.
  1905.  
  1906.     ### I think I have it configured ok, but when it starts up I get
  1907.         to the main menu and when I press "A" for the available list
  1908.         of CD's it immediately exits back to the bbs...  why?
  1909.  
  1910.                 Chances are you have a blank line in your cdsonlin.lst.
  1911.                 Make sure you have no blank lines in your cdsonlin.lst
  1912.                 and then restart.  If problems still persist, it is likely
  1913.                 you have your cdsonlin.lst mis-configured.  Please see
  1914.                 cdsonlin.lst information in this doc.
  1915.  
  1916.     ### I get it started up, press the "A" and the list of CD's comes up
  1917.         just fine and when I press a number to choose a CD, then the
  1918.         door immediately exits back to the bbs...  why?
  1919.  
  1920.                 In all likelihood you either have a blank line in your
  1921.                 CD's *.lst file (there should be no blank lines in your
  1922.                 *.lst files for your CD's) OR you have misconfigured your
  1923.                 CD's *.lst file somehow.  Please check elsewhere herein
  1924.                 for instructions on developing a CD's *.LST file.  You
  1925.                 may wish to use DIAGNOSE.ZIP to assist you.
  1926.  
  1927.     ### I get it started up, press "A" and every thing is fine.  I press
  1928.         the number for my CD and everything is fine.  When I go to look
  1929.         at the subdirectories on my CD, the door acts like it is going to
  1930.         show me this subdirectory list but all that it shows is a blank
  1931.         screen...  no files information, but the door doesn't exit back to
  1932.         the BBS.  What is going on here?
  1933.  
  1934.                 The door is reading your files.bbs/dirx.lst ok, BUT the
  1935.                 files.bbs/dirx.lst or whatever is NOT in the format that
  1936.                 the door is expecting to find.  The door will ONLY work
  1937.                 reliably with files.bbs/dirx.lsts that look like this:
  1938.  
  1939. ---------------------------dirx.lst excerpt-----------------------------------
  1940. BBSSTAT.ASC      1527 07-19-93 Asci text file for bbs statistics on CDMX2
  1941. WHATSNEW.TXT    16962 12-21-93 File description of what's new in CDMX2
  1942. CDSONLIN.ANS     2341 07-19-93 AMSI file for CDMX2 of CD's online
  1943. CDSONLIN.ASC     1717 07-26-93 Asci file for CDMX2 of CD's online
  1944. DOOR.SYS          398 11-16-93 Typical door.sys file used by CDMX2
  1945. --------------------------end of dirx.lst excerpt-----------------------------
  1946.  
  1947.                 If you fix your files.bbs/dirx.lst files to have this typical
  1948.                 format above, then all should be well.
  1949.  
  1950.     ### It tries to start and quits immediately as says something about
  1951.         INITDOOR error in line such and such.  Why?
  1952.  
  1953.                 You don't have your door.sys written correctly.  It is
  1954.                 either too short or the wrong information is in it or
  1955.                 the information in it is incorrectly spaced some how.
  1956.                 Please see the end of this DOC file info on the structure
  1957.                 of the door.sys file.
  1958.  
  1959.     ### The door locked up tighter than a drum...  I have to hard-boot it
  1960.         to get it unstuck.  What?
  1961.  
  1962.                 The door is designed to gracefully exit back to the
  1963.                 BBS on the event of an error.  It should NEVER lock up.
  1964.                 If it does lock up, report this IMMEDIATELY to me along
  1965.                 with a specific description of what was happening when
  1966.                 it did lock up.
  1967.  
  1968.     ### It shows garbage and no colors.  Why?
  1969.  
  1970.                 Do you have ANSI running?  Did you do a DVANSI if
  1971.                 you are running DV/QEMM?
  1972.  
  1973.     ### It starts up just fine when a user calls it but the user drops
  1974.         carrier and says he sees "weird looking garbage" when next on
  1975.         the board.  What is causing that?
  1976.  
  1977.                 You have specified incongruent locked-baud rates between
  1978.                 your fossil and the door's locked-baud rate, e.g.,
  1979.                 you have your door locked baud at 19200 and your fossil
  1980.                 is locked at 38400.  They HAVE to be the same speed else
  1981.                 the door will not work appropriately.
  1982.  
  1983.    ###  It barfs and says "illegal function call."  Why?
  1984.  
  1985.                 You have not got it configured correctly.  Please
  1986.                 recheck your configs.  The problem most likely
  1987.                 rests in your CD *.LST files not being set up
  1988.                 correctly.  Check to be sure your configuration
  1989.                 files, cd-menu-control files, and other configuration
  1990.                 files do NOT have any blank lines at the end of
  1991.                 them and are appropriately structured.
  1992.  
  1993.                 Remember, NO empty lines at the end of any configuration
  1994.                 file (or for that matter, at the end of any file that
  1995.                 CDMX2DOR allows you to setup or edit).
  1996.  
  1997.     ### I can't figure out how to configure my CD!  What now?
  1998.  
  1999.                 There is a utility included in this zip called
  2000.                 DIAGNOSE.ZIP the purpose of which is to assist
  2001.                 you in helping to figure out your CD's setup.
  2002.                 Unzip DIAGNOSE.ZIP and have a look at the docs.
  2003.                 This utility should help you.
  2004.  
  2005.     ### I get a QEMM exception 13... what gives?
  2006.  
  2007.                 You probably don't have it configured correctly.
  2008.                 Again, the problem is likely in your CD Menu
  2009.                 control *.LST files.  Maybe you don't have
  2010.                 enough memory in this DV window??
  2011.  
  2012.     ### The door runs for a while and then gives me some really
  2013.         weird looking hi-ansi/IBM characters and then seems to
  2014.         die.  What gives?
  2015.  
  2016.                 You have likely either (1) gotten your CD's name
  2017.                 in your CDSONLIN.LST too long (keep it around
  2018.                 15 characters maximum), or (2) gotten your
  2019.                 menu-control lists inappropriately configured.
  2020.  
  2021.     ### I can't get it to run locally.  How come?
  2022.  
  2023.                 Do you have a door.sys in CDMX2DOR's directory?
  2024.                 Is the first line set to COM0:  ??  Gotta have
  2025.                 both to run locally.  Got your ANSI driver
  2026.                 running?  Have you made your door's temporary
  2027.                 subdirectory? (You have to have it made before you
  2028.                 run the door.)  Have you got everything appropriately
  2029.                 configured?  Are your OPSC and OPSCG files there
  2030.                 (previous versions had OPSC.ASC and OPSC.ANS; these
  2031.                 files must be renamed to OPSC and OPSCG (respectively)
  2032.                 if you are running an older version of the door.)
  2033.  
  2034.                 DID YOU RUN TEMPNODE.EXE to make your temporary
  2035.                 subdirectories?  If you didn't, the door will not
  2036.                 run if your temporary node-aware subdirectories are
  2037.                 not made.  In any case, the node-aware temporary subs
  2038.                 MUST exist before the door will work rightly.
  2039.  
  2040.     ### User's see garbage when they get on and loose control of
  2041.         the program.  How come?
  2042.  
  2043.                 If you are using Maximus it is likely due to
  2044.                 the fact that you've not set the "-s" parameter
  2045.                 (lockedbaud rate) in your spawnbbs.bat file, e.g.,
  2046.                 Max Max -b%2 -p%3 -t%4 -s38400
  2047.  
  2048.                 If you are not using Maximus it is due to not
  2049.                 telling the door.sys that the port is locked.
  2050.                 Adjust as necessary.
  2051.  
  2052.                 Do you have your port locked at a fast baud
  2053.                 (if you are using a high speed modem)?  If not,
  2054.                 then lock it.
  2055.  
  2056.                 Gotta have CDMX2DOR start up with COM2 if users
  2057.                 are using COM2.  Don't expect a COM1 startup of
  2058.                 CDMX2DOR to handle callers on COM2.  Check your
  2059.                 CDMX2DOR.CNF against your DOOR.SYS.  Door.sys
  2060.                 first line should read COM2: for com2 and the
  2061.                 CDMX2DOR.CNF should have 02F8 in the Hexport
  2062.                 line.  Adjust as necessary depending on your
  2063.                 port/IRQs.  Got your IRQs set up correctly?
  2064.                 Gotta have that else it won't send out the
  2065.                 right comport (if you are using any port higher
  2066.                 than COM2).
  2067.  
  2068.     ### It doesn't lock out users from downloading a file I had set up
  2069.         to have a key.  How come?
  2070.  
  2071.                 Did you have the filename and key in your lock file?
  2072.  
  2073.     ### A user is online and, bam!, they are suddenly back in the BBS with
  2074.         no apparent warning.  What happened?
  2075.  
  2076.                 CDMX2DOR encountered some type of error that would
  2077.                 have crashed the program but rather than to do that,
  2078.                 it made note of the error in CDMX2DOR.ERR and then
  2079.                 kicked the user back to the BBS.  It is likely that
  2080.                 you have misconfigured something.  Check your CDSONLIN.LST
  2081.                 and your menu-control structures to be certain they are
  2082.                 correct.  Look at CDMX2DOR.ERR:  if it says something
  2083.                 about "Error #4" it is likely that you told it
  2084.                 to find something that is not there, e.g., are your
  2085.                 CDSONLIN.LST entries REALLY there...  you aren't sending
  2086.                 CDMX2DOR out to look at a wrong CD by accident are you?
  2087.  
  2088.                 I have found that on the occassion that my CD has a finger
  2089.                 smudge or piece of fuzz or something on it that sometimes
  2090.                 my CD reader will not read the CD.  Try cleaning your
  2091.                 CD.  Windex works just fine.  If that is your problem,
  2092.                 it is likely that you'll get an "Error #11" in your
  2093.                 cdmx2dor.err file.
  2094.  
  2095.                 I have also found that, on occassion, for some reason my
  2096.                 cd-drive will "forget" or not initialize that there is
  2097.                 really a CD in the drive.  I have no idea why it happens,
  2098.                 but it will sometime happen.  If that happens, a user will
  2099.                 loggon and when they try to view a subdirectory, the door
  2100.                 will exit back to the BBS...  if that happens, just pull
  2101.                 out the CD, and put it back in and then cd-drive will
  2102.                 "remember" or find out that there is really a CD in the
  2103.                 drive reader.  The user can then access things just fine.
  2104.  
  2105.     ### It won't start up right...  it gives me a "error in module
  2106.         INITDOOR" error message.  What gives?
  2107.  
  2108.                 This is likely due to (1) your door.sys is not a 52 line
  2109.                 door.sys, (2) your door.sys is corrupted, (3) you have
  2110.                 your cdmx2dor.cnf mis-configured.  On some occassions
  2111.                 it has been found that DV/XTGold combinations will give
  2112.                 the door some problems.  This is under investigation now.
  2113.                 Apparently there may be some conflicting interrupts useage
  2114.                 or something else.  You may also be using IRQ/Hexport
  2115.                 Addresses that are not supported on your board.  It is
  2116.                 believed that this problem of DV/XTGold is fixed with
  2117.                 version 2.03.  If this happens to you, call me.
  2118.  
  2119.     ### It won't forbid my file I told it to.  Why not?
  2120.  
  2121.                 Did you enter the filename.ext in lock.lst?  Make
  2122.                 sure!
  2123.  
  2124.     ### It won't download files to users.  Why?
  2125.  
  2126.                 Is DSZ.COM on your PATH?  IF not you need to
  2127.                 get it there.  Is your port locked correctly?  Does
  2128.                 the remote user have his act together?  Is your
  2129.                 BBS Advertisement in your scratch subdirectory?
  2130.                 Is PKUNZIP on your PATH?  Are you using a recent
  2131.                 version of DSZ.COM?  Should have a DSZ.COM that
  2132.                 is at least a 1992 edition.
  2133.  
  2134.     ### I have it all set up and when I run it, it just stops before
  2135.         anything comes up and returns to the BBS.  How come?
  2136.  
  2137.                 You have got to make sure that the directories you specify
  2138.                 in your cdmx2dor.cfg file actually exist before you try
  2139.                 to run the door.  If they are not actually there, then the
  2140.                 door will exit back to the bbs as it can't find that
  2141.                 subdirectory.  Be sure you temporary directory(ies) ALREADY
  2142.                 is created before you try to fire up the door.  Make sure
  2143.                 your BBS advertisement file you specified is already IN
  2144.                 the door's subdirectory before you try to start up the
  2145.                 door.  Make sure your OPSC and OPSCG files are present.
  2146.                 Try running TEMPNODE.EXE to install your temporary sub-
  2147.                 directories if they are not already made.
  2148.  
  2149.     ### How do I get rid of that annoying delay before the program
  2150.         starts up?
  2151.  
  2152.                 Easy...   send in your registration and I will send you
  2153.                 a key file that will stop it.  Be sure that if you are
  2154.                 running a BBS with a password protection for incoming netmail
  2155.                 that when you send in your registration that you specify
  2156.                 what password I should use when I send you your key.  I
  2157.                 want to get your key to you right away, but don't want
  2158.                 to call Timbuktoo to have a connection terminated because
  2159.                 I don't have a password <G>.  Thanks!  If you haven't
  2160.                 gotten your key in a reasonable time, then call my board
  2161.                 and it is likely that your key is sitting on hold in the
  2162.                 netmail directory (if you are Fido).  If you are not
  2163.                 Fido, then I will leave you a message in the "Sysop
  2164.                 Comments" area on the BBS.  I will, however, make an
  2165.                 effort to send you your key by e-mail.  If you sent your
  2166.                 registration and you haven't gotten your key in a reasonable
  2167.                 time, then CALL my board as it is likely that I could not
  2168.                 get you.  You will likely find your key data on my board
  2169.                 awaiting your pickup.
  2170.  
  2171.  
  2172.     ### It quits and says there is a "Path not found" error.  What's
  2173.         up?
  2174.  
  2175.                 You have either not configured your CDSONLIN.LST correctly
  2176.                 or have not configured your control-menu *.LST files
  2177.                 correctly.  Double check these to be sure you've specified
  2178.                 the right drives and paths.  If the problem persists,
  2179.                 drop me some Email with the address location of the error
  2180.                 in module CDROMBOB.
  2181.  
  2182.     ### It won't allow users to view zips online.  Why?
  2183.  
  2184.                 PKZIP.EXE and PKUNZIP.EXE are likely
  2185.                 not on your PATH.  Put them there.  If you don't
  2186.                 have these on your PATH then don't expect things
  2187.                 to work appropriately.  Do you have at least 750 Kbytes
  2188.                 available diskspace on your HD for unzipping files?
  2189.                 Users might want to view a big file and if there's no
  2190.                 room for unpacking it, there may be problems.
  2191.  
  2192.     ### It won't add my BBS comments to outgoing BBS files.  Why?
  2193.  
  2194.                 Gotta put your BBS.ADV file in your door's subdirectory.
  2195.                 Gotta have PKZIP.EXE on your path.
  2196.  
  2197.     ### It starts and then quits and says to tell the sysop there is
  2198.         not enough disk space to copy a file.  What gives?
  2199.  
  2200.                 This is a DOS problem of some sort.  This is should
  2201.                 not occur in V2.02 and later.  Solution: Upgrade.  It is
  2202.                 possible that your HD may be filled up.
  2203.  
  2204.     ### The door just totally locks up and I need to do a cold boot
  2205.         to get the BBS running again.  What gives here?
  2206.  
  2207.                 This is due to a user tagging more than 70 files for
  2208.                 downloading in a single session.  If this happens, it
  2209.                 is recommended that you set that user's security level
  2210.                 a bit lower.  If you anticipate that users will be
  2211.                 consistently tagging more than 70 files in a single
  2212.                 session, you should install wabird.com in CDMX2DGO.BAT
  2213.                 immediately prior to calling the door and then be sure
  2214.                 to deactivate wabird.com as soon as users exit the door
  2215.                 by specifying that in CDMX2DGO.BAT in the line immediately
  2216.                 after the door was called.  It is unlikely you will ever
  2217.                 have this problem.
  2218.  
  2219.     ### It won't work right on multinode.  Why?
  2220.  
  2221.                 Have you adjusted your HEX port address (line 4)
  2222.                 in your *.CNF files?  Are you starting CDMX2DOR.EXE
  2223.                 with the right command line *.CNF in your *.BAT file?
  2224.                 Have you adjusted your IRQ # in your *.CNF
  2225.                 files, e.g., in CDMX2DOR.CNF?  You HAVE to make sure
  2226.                 your HEX port addresses and your IRQs are rightly
  2227.                 configured for proper operation in a multinode
  2228.                 environment.
  2229.  
  2230.     ### I'm a MAXIMUS BBS sysop and it won't work.  Why?
  2231.  
  2232.                 Did you SILT Maximus after making the changes in your
  2233.                 FILE section of your MENUS.CTL file?  Did you edit
  2234.                 CDMX2DOR.MEC to have the door.sys written in CDMX2DOR's
  2235.                 subdirectory?  Did you MECCA your CDMX2DOR.MEC after
  2236.                 making the changes?  Did you leave the "@" character
  2237.                 after the [xtern_dos] in your CDMX2DOR.MEC file?  Gotta
  2238.                 have it.  You might also want to run it via [xtern_erlvl]
  2239.                 but that is up to you to work out.
  2240.  
  2241.     ### It won't update Maximus's USERS.BBS.  Why?
  2242.  
  2243.                 Did you tell it where to find your LASTUSER.BBS correctly?
  2244.                 Gotta do it.  Do ya have the "@" in your CDMX2DOR.MEC
  2245.                 file right after the [xtern_dos] to start the door?  If
  2246.                 you are using an ALIAS system, change the %n character in
  2247.                 your cdmx2dor.mec to the %r in the line where you specify
  2248.                 the user's name.
  2249.  
  2250.     ### It won't lock out certain files from user download.  Why?
  2251.  
  2252.                 Do you have a LOCK.LST in CDMX2DOR's home directory?  If
  2253.                 you want a lockout, you have to have LOCK.LST.  If you
  2254.                 want some users to get access to this file, then you
  2255.                 HAVE to have a comma and a key$ after the filename.exe.
  2256.                 If you don't have a key, DON'T have a comma!
  2257.  
  2258.     ### Ok, I got the key and put it in and the door still shows this
  2259.         insipid delay.  Did I pay good money for nothing?
  2260.  
  2261.                 You bought a good door <g>.  The problem is likely due
  2262.                 to your giving me incorrect information upon which to
  2263.                 make your key.  I need 2 things for the key to work
  2264.                 correctly: 1) your name you are using as a sysop on your
  2265.                 board (whether that be your real name or an alias or
  2266.                 something), and 2) the full name of your BBS as it has
  2267.                 been configured in your BBS's software.  Without these
  2268.                 2 bits of correct information, your key will not work so
  2269.                 be sure to check this when registering.
  2270.  
  2271.         A last word on installation:
  2272.  
  2273.                 You have to fix cdmx2dor.cnf, cdmx2dor.cfg, cdsonlin.lst,
  2274.         cdmx2dgo.bat, and make your cd menu-control *.lst files to get
  2275.         the door working appropriately.  Make sure you've done all these
  2276.         changes.  MAKE SURE THERE ARE NO BLANK LINES IN YOUR CDMX2DOR.CNF,
  2277.         CDMX2DOR.CFG, CDSONLIN.LST, OR ANY OF YOUR CD'S *.LST FILES ELSE
  2278.         THE DOOR WILL START UP AND IMMEDIATELY EXIT BACK TO THE BBS.
  2279.  
  2280.         Flow of files in running the door:
  2281.  
  2282.                 Your users activate a command off of your BBS to start
  2283.         the door (a bat file if not Maximus or a BBS file if Maximus),
  2284.         this procedure writes a door.sys file that must end up in the
  2285.         subdirectory where CDMX2DOR exists and also starts the door.
  2286.         CDMX2DOR reads its *.cnf file and starts up based on the parameters
  2287.         contained in its *.cnf and *.cfg files.  If it is not going out
  2288.         the port as it should, check your HEXport addressing and IRQ's
  2289.         as well as your lockport baud settings.
  2290.  
  2291.  
  2292.         If you send your questions to me via netmail, I'll help ya! :-)
  2293.         IF you have found a bug in the program, I will fix it for you
  2294.         and send you a fixed copy on my dime.  Just let me know via
  2295.         NetMail @ 1:232/31 or call my BBS at (309)797-6027 (USA).
  2296.  
  2297. =============================================================================
  2298. [11.0]  What about Multinode operation?  Easy....
  2299.  
  2300.         To run the door multinode, you will need to have a different
  2301.         CDMX2DOR.CNF for each node and make these changes:
  2302.  
  2303. ------------------------------------------
  2304.                   Fig. 13
  2305. -------------- *.CNF excerpt -------------                          LINE #
  2306. c:\cdbob                                                               1
  2307. New Century BBS                                                        2
  2308. 3                                          <--- this line (see below)  3
  2309. 02F8                                       <--- this line (see below)  4
  2310.  .
  2311.  .
  2312.  .
  2313. 02F8                                       <--- this line (see below)  9
  2314. 3                                          <--- this line (see below) 10
  2315. cdmx2dor.cfg                               <--- this line (see below) 11
  2316. --------------- end of file --------------
  2317.  
  2318.         The "02F8" line (line 4) is the Hex address for COM2. The "3" line
  2319.         (line 3 and 10) is the IRQ number for COM2. Here is a list of other
  2320.         settings for other ports and IRQ's:
  2321.  
  2322.         Here's a chart with the STANDARD IRQs
  2323.         and addresses for the PS/2s and IBM PCs:
  2324.                                 Non PS/2
  2325.                 Com port       IRQ     Address     CDMX2DOR address
  2326.                    1             4       &H3F8          03F8
  2327.                    2             3       &H2F8          02F8
  2328.                    3             4       &H3E8          03E8
  2329.                    4             3       &H2E8          02E8
  2330.                   5-8            4       &H3F8          03F8
  2331.  
  2332.                                 PS/2
  2333.                 Com port       IRQ     Address
  2334.                    1             4       &H3F8          03F8
  2335.                    2             3       &H2F8          02F8
  2336.                    3             3       &H3220         3220
  2337.                    4             3       &H3228         3228
  2338.                    5             3       &H4220         4220
  2339.                    6             3       &H4228         4228
  2340.                    7             3       &H5220         5220
  2341.                    8             3       &H5228         5228
  2342.  
  2343.         Set your HEX address's and IRQ's for each different node
  2344.         appropriately based on this information.
  2345.  
  2346.         Lines 3/10 of the configuration file is the IRQ for the port.
  2347.         Lines 4/9 of the configuration file is the Base Address for the port.
  2348.  
  2349.         If the user is using COM 1 or COM 2, then you may enter
  2350.         a zero (0) on both of these lines, as the default port
  2351.         assignments are always used for COM 1 and COM 2.
  2352.  
  2353.         The IRQ (lines 3 & 10) must be in the range of 1 - 7.
  2354.  
  2355.         The Base Address (lines 4 & 9) must be a Hexadecimal number in the
  2356.         format of:
  2357.  
  2358.         02E8
  2359.         03E8
  2360.         etc.
  2361.  
  2362.         Clear enough? :-)
  2363.  
  2364.         Note that DSZ may use some odd HEXPort addresses and IRQ's
  2365.         for Comports 5 and above...  check the DSZ docs and adjust
  2366.         your Hexport address and IRQ's as is appropriate in these
  2367.         cases (COM 5-8 usually).
  2368.  
  2369.         You can rename CDMX2DOR.CNF to whatever you please so you can
  2370.         have multiple *.CNF files to start the door based on ports/
  2371.         com settings/IRQs.  For example, if you want to run CDMX2DOR
  2372.         in shared mode (all nodes accessing one program), your
  2373.         *.CNF's would be as follows:
  2374.  
  2375.         CDMX2D1.CNF is for node 1
  2376.         CDMX2D2.CNF is for node 2
  2377.         CDMX2D3.CNF is for node 3, etc.
  2378.  
  2379.         These files might look something like this:
  2380.  
  2381.         CDMX2D1.CNF: (For Node 1 on Com2)
  2382.         ------------ sample *.cnf on multinode ---------------------
  2383.         c:\cdbob
  2384.         New Century BBS
  2385.         0
  2386.         3                     <---------------- IRQ 3
  2387.         02F8                  <---------------- HEXport address 02F8
  2388.         .
  2389.         .       deleted for brevity (see above for full *.CNF file structure)
  2390.         3                     <---------------- IRQ 3 (again)
  2391.         cdmx2dor.cfg          <---------------- door will automatically
  2392.                                                 know what to do with the
  2393.                                                 node-aware subdirectories
  2394.                                                 and files here.  No need
  2395.                                                 to have a different one
  2396.                                                 for each node.
  2397.         ------------------------------------------------------------
  2398.  
  2399.         CDMX2D2.CNF: (For Node 2 on Com4)
  2400.         ------------ sample *.cnf on multinode ---------------------
  2401.         c:\cdbob
  2402.         New Century BBS
  2403.         0
  2404.         3                     <---------------- IRQ 3
  2405.         02E8                  <---------------- HEXport address 02E8
  2406.         .
  2407.         .       deleted for brevity
  2408.         3                     <---------------- IRQ 3 (again)
  2409.         cdmx2dor.cfg          <---------------- config data
  2410.         ------------------------------------------------------------
  2411.  
  2412.         CDMX2D3.CNF: (For Node 3 on Com3)
  2413.         ------------ sample *.cnf on multinode ---------------------
  2414.         c:\cdbob
  2415.         New Century BBS
  2416.         0
  2417.         4                     <---------------- IRQ 4
  2418.         03E8                  <---------------- HEXport address 03E8
  2419.         .
  2420.         .       deleted for brevity
  2421.         4                     <---------------- IRQ 4 (again)
  2422.         cdmx2dor.cfg          <---------------- config data
  2423.         ------------------------------------------------------------
  2424.  
  2425.         Make sure to adjust your *.BAT files for each node so that
  2426.         you've incorporated the command-line calling of the differing
  2427.         .CNF files for each node.
  2428.  
  2429.         You get the idea....
  2430.  
  2431.         If your data is NOT different in your *.CFG files across nodes
  2432.         then you may just continue to specify the same filename.  If there
  2433.         is a difference, particular for multinodal MAXIMUS users, then
  2434.         you must make the changes required and have differently named
  2435.         *.CFG files.
  2436.  
  2437.         CDMX2DOR.EXE must be started with a command line which includes
  2438.         the *.CNF filename so you will have to make adjustments as
  2439.         necessary to your *.BAT files that start the door up to incorporate
  2440.         these different *.CNF filenames.  Be sure that SHARE is installed
  2441.         to run all nodes off of one copy of CDMX2DOR.EXE.
  2442.  
  2443.         CDMX2DOR is written such that all files are "shared" files, i.e.,
  2444.         any node can access any file without problem.  To set up CDMX2DOR
  2445.         on multinode, however, I would do the following (just to be safe
  2446.         and sure and, particularly, if I have HD space to spare):
  2447.  
  2448.                 (1)     have a different subdirectory on my HD for
  2449.                         each node used
  2450.                 (2)     have complete copies of CDMX2DOR files in
  2451.                         these different node-specific subdirectories
  2452.                 (3)     edit the *.CNF file for each node to have the
  2453.                         correct Hex port address (see above) for that
  2454.                         node.
  2455.                 (4)     have the *.bat run the right *.CNF for the
  2456.                         specific node.
  2457.                 (5)     have the *.CNF for each node specifying the
  2458.                         correct *.CFG (if different info) for that node.
  2459.  
  2460.         This takes a little more space on your HD, but will absolutely
  2461.         prevent any file-sharing conflicts.  If you're short on HD
  2462.         space then you probably should do it all in one directory in
  2463.         shared mode.  This is entirely up to you, of course.
  2464.  
  2465.         Multinode Option 2:  You might want to try running CDMX2DOR
  2466.         in shared mode...  all on one directory with different *.CNF's
  2467.         starting it based on node...  The door is built to be automatically
  2468.         node aware and will take advantage of the subdirectories you have
  2469.         set up using TEMPNODE.EXE.  If you're short on HD space, you might
  2470.         want to do it this way.  No promises <g> but I think it will work
  2471.         just fine for you; just be sure to have different .CNF files to
  2472.         start CDMX2Dor for each node and all should be well.
  2473.  
  2474. =============================================================================
  2475.  
  2476. [12.0]  OTHER THINGS you can do with CDMX2DOR... possibilities plus!
  2477.  
  2478.         o       Meeting users' special file requests in an instant.
  2479.  
  2480.                 A user requests certain files and wants them online
  2481.                 right away.  The files are offline.  How to get them
  2482.                 online FAST?  Check out INSTFREQ.EXE, FASTFREQ.BAT, and
  2483.                 FLYDIRX.EXE working in combination...
  2484.  
  2485.                         See information in "flystuff.doc" for how to use
  2486.                         these files to quickly meet user's requests.
  2487.  
  2488.                         The "flystuff" files are designed to quickly
  2489.                         copy these requested files to a subdirectory on
  2490.                         your harddrive.  FASTFREQ.BAT runs FLYDIRX.EXE
  2491.                         for that subdirectory that you have previously
  2492.                         configured as an "innie."  You previously made
  2493.                         a control menu for that subdirectory and edited
  2494.                         CDSONLIN.LST with Qedit. (See the reqbob.lst and
  2495.                         its associated entry in CDSONLIN.LST for an example
  2496.                         of this preconfiguration)
  2497.  
  2498.                         Time required to put the user's file request
  2499.                         online using FASTFREQ.BAT is less than 1 minute.
  2500.  
  2501.                         For example.  A user requests these files:
  2502.  
  2503.                         MAPBBS.CNF       1870 01-18-89
  2504.                         MAPDOS.DAT        127 01-18-89
  2505.                         MAPLBDR.BI      18288 10-12-92
  2506.                         MAPLBDR.LIB     69471 10-03-92
  2507.                         MAPLBDR.QLB     43513 10-03-92
  2508.                         MAPLBDR.TXT    122613 10-03-92
  2509.  
  2510.  
  2511.                         (1) I have a preconfigured FILES REquest control
  2512.                             menu set up (e.g., see reqbob.lst this
  2513.                             archieve).  This file is in my CDMX2DOR
  2514.                             subdirectory.  The file looks like this:
  2515.  
  2516.                             Requested Files:dirx.lst:in
  2517.                             backup:"Files" You Requested
  2518.  
  2519.  
  2520.                         (2) I have preconfigured my CDSONLIN.LST to
  2521.                             add this line:
  2522.  
  2523.                             Requested Files,30,reqbob.lst,OK,C:,reqst.lck
  2524.  
  2525.                         (3) I use FASTFREQ.BAT to copy the MAPL*.* files
  2526.                             from a given subdirectory to my "c:\backup"
  2527.                             drive.  FASTFREQ.BAT calls FLYDIRX.EXE and
  2528.                             ultimately makes a dirx.lst for the MAPL*.*
  2529.                             files and puts it in c:\backup.  Make sure
  2530.                             you edit FASTFREQ.BAT appropriately before
  2531.                             running it.
  2532.  
  2533.                         (4) I let the user know his files are ready.
  2534.                             Time required: Less than 1 minute.  User
  2535.                             can now download his request.
  2536.  
  2537.                         (5) If the user left a message and isn't online
  2538.                             when he made the request, I fill his request
  2539.                             as above and put his name in reqst.lck (a
  2540.                             special privilege NAM file.lst) as
  2541.                             follows:
  2542.  
  2543.                             Matt Timion
  2544.  
  2545.                             and it is available ONLY to him.  If I have
  2546.                             several requests, I add the files to my
  2547.                             c:\backup drive using FASTFREQ.BAT, add the
  2548.                             additional user's names to the reqst.lck file
  2549.                             so they can get into the drive, and also put a
  2550.                             special keyword (see LOCK.LST) on the files for
  2551.                             each particular user.  I leave email for them
  2552.                             all telling them their files are ready and their
  2553.                             special access key for their files is XXXXX.
  2554.                             (If you do this procedure, make sure to edit
  2555.                             FASTFREQ.BAT so it does not delete the files
  2556.                             it finds in C:\backup from previous user's
  2557.                             requests).
  2558.  
  2559.         o       Having all my 1.44meg B: floppies formatted for instant
  2560.                 use on the BBS.
  2561.  
  2562.                         (1) copy my BBS's new upload directory's files.bbs
  2563.                             to my B:\subdirectory drive
  2564.  
  2565.                         (2) copy the selected files of my choice to my
  2566.                             B:\subdirectory drive from off the BBS's new
  2567.                             uploads directory
  2568.  
  2569.                         (3) run flydirx.exe as an innie, e.g.,
  2570.  
  2571.                             flydirx.exe b:\subdirectory IN <dlc#>
  2572.  
  2573.                         (4) delete the files.bbs off of B:\subdirectory
  2574.  
  2575.                         (5) make a control-display menu for a B:\subdirectory
  2576.                             innie and include it CDMX2DOR's directory, e.g.,
  2577.  
  2578.                                 TINY B Drive:dirx.lst:in
  2579.                                 TINY:Miscellaneous Stuff
  2580.  
  2581.                         (6) adjust CDMX2DOR's CDSONLIN.LST to include the
  2582.                             b:\tiny subdirectory, e.g.,
  2583.  
  2584.                                 Tiny B,30,tbcbob.lst,OK,B:
  2585.  
  2586.                         (7) From now on, every B: drive that I copy files
  2587.                             to from off of the BBS will have a subdirectory
  2588.                             called the same, e.g., B:\TINY, and I repeat
  2589.                             steps 1-4 with that B: drive.  Steps 5-6 only
  2590.                             need to be done once.
  2591.  
  2592.                         (8) To change the files available to users on the
  2593.                             tiny B: drive, I just change the disk.  That's
  2594.                             it!
  2595.  
  2596.                 I can do all of the above or, alternately, run FASTFREQ.BAT
  2597.                 to do the copying/dirx.lsts for me.  Try out FASTFREQ.BAT
  2598.                 and see what it does.
  2599.  
  2600.  
  2601.         o       Putting EVERY drive online for downloading.  I can use
  2602.                 all my drives for files for user-downloads with CDMX2DOR
  2603.                 e.g., A:, B:, C:, D:...Z:   everything! (and, of course,
  2604.                 all my CDRoms).  Hard-drives, floppies, CD's...  future
  2605.                 versions of CDMX2DOR will have Colorado tape supports.
  2606. =============================================================================
  2607.  
  2608. [13.0]  Well...  I think you've got enough info to get your door running.
  2609.         You can run it right away locally for testing if you've got
  2610.         the CD's I have.  Explore!
  2611.  
  2612.         If you like it and need further help or questions before
  2613.         registration, drop me some netmail.  We've been online since 1991
  2614.         and will be here for the duration :-).  I think you'll be very
  2615.         happy with this door.  Multinodal 102-CD's per node plus your
  2616.         HD files...  not bad, eh?
  2617.  
  2618.         Be sure to have things configured rightly.  There's a bit of
  2619.         busy work with configuration, but it is pretty simple to do and
  2620.         it's all done on a text editor like QEdit.  If you've got the CD's
  2621.         I've got then you'll be up and going in a very short time and
  2622.         there won't be much configuration to do.
  2623.  
  2624.         Make sure when you start the door up in local mode that you add
  2625.         the commandline$, i.e., the *.cnf file name, e.g.,
  2626.  
  2627.         C:\BBS\DR>cdmxdor2 cdmx2dor.cnf
  2628.  
  2629.         else your door will not work.
  2630.  
  2631.         If you've got any suggestions, pass'em along...
  2632.  
  2633. =============================================================================
  2634. [14.0]  Legal stuff
  2635.  
  2636.         The program is guaranteed to do nothing at all except to take up
  2637.         space on your HD.  Your first run of the program is your implied
  2638.         consent to hold no torts, suits, or other legal action against
  2639.         the author for any problems to your hardware or software.  If you
  2640.         do not agree with these terms then don't run the software.
  2641.  
  2642. =============================================================================
  2643. [15.0]  Registration
  2644.  
  2645.         CDMX2DOR has taken a lot of time and money to develop.  Please
  2646.         support the shareware concept and you will see this door continually
  2647.         improved.
  2648.  
  2649.         Thank you for your support!
  2650.  
  2651.         Until you receive your registration "key," CDMX2DOR will show
  2652.         "Please register" messages periodically and will pause occasionally
  2653.         as a reminder to register.  Upon receipt of a key, registered
  2654.         user's versions will no longer have these reminder messages and
  2655.         program pauses.  Additionally, registered users will receive a
  2656.         selection of a number of other doors I have written and will
  2657.         have access to any updated versions of CDMX2DOR via New Century
  2658.         BBS (309)797-6027.  If you find CDMX2DOR useful, please consider
  2659.         registration so as to support further enhancements.  I will need
  2660.         your first and last name and your BBS's name to send you a working
  2661.         key.
  2662.  
  2663.         Your registration now will entitle you to future updates as they
  2664.         are made without cost.  You registration fee is for all future
  2665.         versions of CDMX2DOR which will be made available for download
  2666.         or FReq at New Century BBS 1:232/31 (309)797-6027.
  2667.  
  2668.         The registration fee is $20.00 [cheap!!! :-)] and is payable by
  2669.         cash, check, or money order to:
  2670.  
  2671.         New Century BBS
  2672.         c/o Robert Lee
  2673.         1812 36th Street
  2674.         Moline, Illinois   61265
  2675.         USA
  2676.  
  2677.         Please include the below information in your registration
  2678.         request:
  2679.  
  2680.  
  2681.         Name: (First/Last)____________________________________________
  2682.  
  2683.         Name you are using on your system as the Sysop:
  2684.  
  2685.         Firstname:_____________________ Lastname:_____________________
  2686.  
  2687.         Your key will be based on this firstname/lastname information
  2688.         as it appears on your BBS so please check to be sure your names
  2689.         here match your board names.  This is your name as it is
  2690.         written in your DOOR.SYS file.
  2691.  
  2692.         Street Address: ______________________________________________
  2693.  
  2694.                         ______________________________________________
  2695.  
  2696.         City: ________________________________________________________
  2697.  
  2698.         State: ______________
  2699.  
  2700.         Country: ___________________
  2701.  
  2702.         Zip: ________________ (if applicable)
  2703.  
  2704.         BBS Name: ____________________________________________________
  2705.  
  2706.         Your key will be based on your board's name as it appears on
  2707.         your BBS so please check to be sure your board name you specify
  2708.         here matches your board's name.
  2709.  
  2710.         What kind of BBS software are you using? _____________________
  2711.  
  2712.         BBS phone # where you can be reached: ________________________
  2713.  
  2714.         FIDONET Address (Z:N/#) if appropriate: ______________________
  2715.  
  2716.         Security Password for me to send you
  2717.         your key via netmail (if appropriate): _______________________
  2718.  
  2719.         Where did you get CDMX2DOR? __________________________________
  2720.  
  2721.         Comments/Suggestions: ________________________________________
  2722.  
  2723.         ______________________________________________________________
  2724.  
  2725.         ______________________________________________________________
  2726.  
  2727. Note: I will make an effort to send you your key via BBS or netmail.  If
  2728.       your BBS has any security passwords required before it will accept
  2729.       incoming netmail, please be sure to give me a security password
  2730.       so I can give you your key.  (see line specified for same above).
  2731.  
  2732.       If I cannot get your key to you via a try or two, I will put your
  2733.       key on hold here within 2-3 days of receipt of your registration
  2734.       fee for you to pickup via netmail.
  2735.  
  2736.       Once you are registered, be sure to call occassionally to see if
  2737.       there is a new version of CDMX2DOR so as to stay current.
  2738.  ===========================================================================
  2739. [16.0]  Appendices
  2740.  
  2741.         DOOR.SYS line variables:
  2742.  
  2743.        DOOR.SYS
  2744.        --------
  2745.        1.  Comm Port - COM0: = LOCAL MODE
  2746.        2.  Baud Rate
  2747.        3.  Parity - 7 or 8
  2748.        4.  Node Number - 1 to 99                    (Default to 1)
  2749.        5.  DTE Rate. Actual BPS rate to use.
  2750.        6.  Screen Display - Y=On  N=Off             (Default to Y)
  2751.        7.  Printer Toggle - Y=On  N=Off             (Default to Y)
  2752.        8.  Page Bell      - Y=On  N=Off             (Default to Y)
  2753.        9.  Caller Alarm   - Y=On  N=Off             (Default to Y)
  2754.        10. User Full Name (First and Last)
  2755.        11. Calling From (City, State)
  2756.        12. Home Phone
  2757.        13. Work/Data Phone
  2758.        14. Password
  2759.        15. Security Level
  2760.        16. Total Times On the BBS
  2761.        17. Last Date Called
  2762.        18. Seconds Remaining THIS call (for those that particular)
  2763.        19. Minutes Remaining THIS call
  2764.        20. Graphics Mode - GR=Graph, NG=Non-Graph, 7E=7,E Caller
  2765.        21. Page Length
  2766.        22. User Mode - Y = Expert, N = Novice
  2767.        23. Conferences/Forums Registered In  (ABCDEFG)
  2768.        24. Conference Exited To DOOR From    (G)
  2769.        25. User Expiration Date              (mm/dd/yy)
  2770.        26. User File's Record Number
  2771.        27. Default Protocol - X, C, Y, G, I, N, Etc.
  2772.        28. Total Uploads
  2773.        29. Total Downloads
  2774.        30. Daily Download "K" Total
  2775.        31. Daily Download Max. "K" Limit
  2776.        32. Caller's Birthdate
  2777.        33. Path to the MAIN directory (where User File is)
  2778.        34. Path to the GEN directory
  2779.        35. Sysop's Name (name BBS refers to Sysop as)
  2780.        36. Alias name
  2781.        37. Event time
  2782.        38. If its an error correcting connection (Y/N)
  2783.        39. ANSI supported & caller using NG mode (Y/N)
  2784.        40. Use Record Locking                    (Y/N)
  2785.        41. BBS Default Color (Standard IBM color code, ie, 1-15)
  2786.        42. Time Credits In Minutes (positive/negative)
  2787.        43. Last New Files Scan Date          (mm/dd/yy)
  2788.        44. Time of This Call                 (hh:mm)
  2789.        45. Time of Last Call                 (hh:mm)
  2790.        46. Maximum daily files available
  2791.        47. Files d/led so far today
  2792.        48. Total "K" Bytes Uploaded
  2793.        49. Total "K" Bytes Downloaded
  2794.        50. User Comment
  2795.        51. Total Doors Opened
  2796.        52. Total Messages Left
  2797.  
  2798.  ===========================================================================
  2799. [17.0]  Registered User's List 9/1/94
  2800.  
  2801. Provided as a service to you so that you may contact registered CDMX2DOR 
  2802. users for assistance or getting already-configured CD *.LST files (and save
  2803. you time in setting up your door).  Please be sure to let everyone know that
  2804. the current version is v2.05.  This version will remain stable for the next
  2805. several months or more.
  2806.  
  2807.                        Registered CDMX2DOR USERS
  2808.  
  2809. NAME                     BBS                 FIDONET ADD  PHONE
  2810. =======================  ==================  ===========  ===================
  2811. Teresa Abbott            Abbott's Place      na           1-205-927-6601
  2812. David Anderson           The Game Connection 1:3400/37    1-406-761-3850
  2813. Robert Andrews           The Decatur Connect 1:233/26     1-217-864-3367
  2814. Steve Bainbridge         Transponder         2:250/220   +44-51-2264631  U.K.
  2815. Joe Baldes               Microgem Incorporat na           1-204-667-1449
  2816. David Bartlett           The Panthers Den    na           1-717-473-1054
  2817. John Belham              Gulfport School's   na           1-601-897-6049
  2818. Darrell Benvenuto        The United Front    1:278/523    1-718-886-6797
  2819. Tom Black                Metal Nations       na           1-703-430-8865
  2820. Dave Blears              Closer To Home BBS  3:640/452    +61-74-976293 Australia
  2821. Paul Bylin               LZ Memories         1:101/215.1  1-508-977-9756
  2822. Randy Carruth            West World          1:138/249    1-206-770-2940
  2823. Jeff Casey               The Center of the U 1:132/233    1-603-435-7771
  2824. Dan Champion             Home BBS            1:228/113    1-616-453-0263
  2825. Thomas Christoph         Digital Experience  1:342/86     1-403-459-6094
  2826. John Cook                Guilford Program E  na           1-910-299-0954
  2827. Darroll Coulston         Slime Time BBS      na           1-309-794-9148
  2828. Laymon Curtis            The Simple BBS      na           1-615-646-4366
  2829. James Darrow             Plucky Duck BBS     na           unlisted
  2830. Don Deakins              Goat Shack          1:362/625    1-615-842-8758
  2831. Jim Dean                 Pacific Communicati 1:153/726    604-980-3946
  2832. Dave DeGear              Brass Bed BBS       1:351/220    1-604-753-2257
  2833. Ivan Drzanic             G-Box               2:381/102    011-385-41-78-38- Croatia
  2834. Tim & Nickie Engle       Down the Rabbit Hol na           1-205-820-0047
  2835. Thomas Gardner           The Electric Castle na           1-714-993-3910
  2836. Jack Gee                 The Dog House       na           1-814-362-1166
  2837. Kip Gies                 The Dog House       1:213/910    1-916-546-0334
  2838. Tim Gillespie            The Symposium BBS   1:2201/25    1-616-649-0428
  2839. Simon Gledhill           Index III BBS       2:2503/203  +44-602-2872422 U.K.
  2840. Ed Goldberg              The Mass Gold Mine  na           1-413-736-0667
  2841. Mark Greenlee            Private Chambers    1:2430/10    1-217-498-7251
  2842. Robert Harris            The Hamshack        na           1-714-825-1685
  2843. Mike Grafft              Norad               na           1-515-221-9715
  2844. John Gravitt             Gravity's Hologram  na           1-404-952-0837
  2845. Eric Greene              Deep-Sky BBS        1:133/208    1-404-321-5904
  2846. William Hall             Willie's World      na           1-919-577-3686
  2847. Heinrich Hansper         Palais BBS          2:243/5916  +49-2395-721    Ger.
  2848. Felix Harrigan           Corby Town BBS      2:2503/403  +44-0536-400195 U.K.
  2849. Ed Hiltenbrandt          The Playpen BBS     1:356/16     1-503-888-4542
  2850. Robert Holmes            The Racers Net      8:919/23     1-916-546-9113
  2851. John Hull                The Rift BBS        1:2430/1701  1-217-522-1937
  2852. Sarge Hultgren           Freedom's Choice    1:101/215.0  1-617-593-2605
  2853. Paul Huneault            Le Dossier          1:167/303    1-514-482-8078
  2854. B.J. Hutchins            The Hutch BBS       1:19/140     1-405-223-2574
  2855. Gregory Inman            Jake's Place        1:3647/19    1-803-481-0684
  2856. William Jennifer         Sons of Glitches    1:114/246    1-602-247-1160
  2857. Adam Katz                Magician's Birthday 1:3670/6     1-205-232-7191
  2858. Robert Kelley            The Star Gazer BBS  na           1-405-920-0137
  2859. Jeff Klug                Spaghetti Man's BBS 1:252/408    1-705-549-6655
  2860. Arne Kransberg           Pi BBS              2:200/705   +46-457-31515   Swd.
  2861. Chris Kuefler            The Twin Towers     1:3402/22    1-403-790-2341
  2862. Romane Land              The LHC BBS         1:344/108    1-509-663-1814
  2863. Kevin Lechner            The Data Triad      1:374/85     1-407-725-6646
  2864. Samson Luk               HK PC User Group    6:700/8     +011-852-390613 H.K.
  2865. Thomas Marsh             The Conundrum       na           1-708-422-6490
  2866. Georgina Martinez        Vesuvius At Home    1:135/318    1-305-252-9415
  2867. Richard Martz            Expiring Mind       1:102/742    1-213-874-9484
  2868. Thrash Master            The Far Side        1:2201/50    1-616-323-0076
  2869. David Megnin             The Evil Dutchman   na           1-510-671-7353
  2870. Kerry Miller             The Pastor's Study!
  2871. Randy Miller             Corporate Ladder    na           1-216-677-1040
  2872. Terry Moody              City Strutters      na           1-315-342-7431
  2873. Peter Niemeyer           Trabbi's Paradise   2:243/7812  +49-202-4781434 Ger.
  2874. Ole Olson                The Orphanage       1:396/86     1-504-348-1412
  2875. Dave Orser               Voices from Within  1:153/220    1-604-942-4864
  2876. Robert Palmer            The Manager BBS     na           1-816-322-7782
  2877. Jerry Parker             The Eyrie           na           1-801-782-6468
  2878. James Parmer             LTL Online          1:3656/150   1-706-882-0120
  2879. Anthony Paulus           Lower Earley BBS    2:250/220.7 +44-0734-867004 U.K.
  2880. Christopher Pelton       Xest                na           1-616-956-1254
  2881. Josh Perfetto            Tidal Wave BBS      na           1-518-861-6645
  2882. Robert Peterson          The Cyrrius BBS     1:366/38     1-904-651-5911
  2883. Mike Phlipsak            The Coffee Clutch   na           1-518-383-3156
  2884. Philip Polstra           The Hangar BBS      1:201/100    1-317-583-0732
  2885. Robin Post               On The Edge BBS     na           1-601-432-9513
  2886. Brad Price               The Rumkeg RBBS     na           1-804-526-4258
  2887. Merle Rudebusch          NeBlink             1:285/101    1-402-471-0897
  2888. David Runion             Animal Kingdom      na           1-518-861-7074
  2889. Kevin Runion             Cow Land            na           1-518-861-8718
  2890. Dustin Runnells          The Escape          na           1-716-265-4921
  2891. John Sakers              Controversial Subj  1:385/25     1-405-355-0322
  2892. Jeff Serafini            Squid Central       na           1-207-259-2128
  2893. Jason Schwarz            Smart Computers     1:3634/36    1-910-868-1214
  2894. Mike Siebern             Walden Pond         1:236/13     1-219-665-8767
  2895. Earl Small               The Osiris Connect  2:244/1660  +49-6033-72134  Ger.
  2896. Jim Smith                The Window Pane     1:130/508    1-817-478-4132
  2897. Larry Speaks             The BatCave BBS     1:19/141     1-405-924-2170
  2898. Drew Sprang              The Polaris BBS     na           1-419-552-1378
  2899. Les Squires              World Systems       na           1-403-248-2183
  2900. Dave Strouse             The New Boondocks   1:332/301    1-207-498-8247
  2901. Wookie Swanson           Talos IV            1:353/290    1-604-765-8517
  2902. Danny Turner             KeyBored RBBS       na           1-412-452-8306
  2903. Santie VandenPlas        The Mutant Pencil's 5:7102/714  +01127219190300 S.A.
  2904. Martin Vanderzwan        The UpAllNite BBS   na           1-519-351-4364
  2905. Irv Wedeking             Aurora Board        na           1-402-694-5302
  2906. Roger Williams           My New BBS          na           1-713-726-0441
  2907. Jack Zeller              Gammatown BBS       1:369/34     1-305-572-7060
  2908.  
  2909.  
  2910. [18.0]  Revisions History
  2911.  
  2912.         - V.099 First BETA Release; several minor revisions along the
  2913.                 way to fix buglets.  Finally resulting in a version
  2914.                 worth putting out for inspection.  Seems to be capable
  2915.                 of looking at all drives.
  2916.         - V.100 Fixed bug in display of CD subdirectories, added several
  2917.                 suggestions from Chris Keufler (1:3402/22) for CD security
  2918.         - V.101 Fixed bug when a HD was full and CDMX2DOR tried to copy
  2919.                 a file from a CD to a fullup HD.  Now reports HD full
  2920.                 and instructs user to alert sysop.  Fixed buglet in
  2921.                 finding location of an ansi file.
  2922.         - V.102 Changed coding for CDMX2DOR's *.CFG file so as to allow
  2923.                 multiple *.CFG's to accomodate multinodal Maximus
  2924.                 situations.  Maximus multinodes must still put separate
  2925.                 copies of CDMX2DOR files into separate directories pending
  2926.                 code changes associated with door.sys naming.
  2927.         -V.103  CDMX2DOR would not handle deep-buried odd-named innies.
  2928.                 This is fixed in version 1.03.  Tweaked the subdirectories
  2929.                 display to allow back/forward intelligence with just an
  2930.                 "ENTER" from the user.  Version also fixed to handle
  2931.                 variable subdirectory-depth finding of "innie" files
  2932.                 display structures.  Added error trapping so that in
  2933.                 the event a problem occurs, program will report error
  2934.                 in file called CDMX2DOR.ERR and then exit normally so
  2935.                 that it does not hang anymore awaiting a sysop "Press
  2936.                 any key."  Updated doc file.
  2937.         - V.104 Fixed the zipviewer to better format the fileschoice
  2938.                 list; cosmetic.  Changed the "please register" display
  2939.                 to only occur at first logon and not after every command.
  2940.                 Will now pause 20-60 secs. for unregistered users and that's
  2941.                 all.  Added a help section for the "Download files"
  2942.                 section to explain to users what a "protocol" is.
  2943.         - V.105 Fixed the zipviewer to better format the fileschoice
  2944.                 list (again; v1.04 change disturbed numbering; v1.05
  2945.                 fixed this).  Fixed a bug in the zipviewer when unzipping
  2946.                 multiple subdirectories-deep zips to only allow viewing
  2947.                 of first level deep subdirectory textfiles; preventing
  2948.                 viewing of zip -rp packed zips past the first subdirectory.
  2949.                 Serves as a security protect to prevent viewing nested
  2950.                 subdirectory zips.  (Thanks, Samson Luk 6:700/8)
  2951.         - V.106 Fixed a bug in searches and displaying file DSP when
  2952.                 configured on a double outtie with many subdirectories
  2953.                 deep on the HD and on the CD.  (Thanks, again, Samson
  2954.                 Luk 6:700/8).  Also fixed zipviewer so that in a zip
  2955.                 archieve that has been archieved via a zip -rp command
  2956.                 the subdirectories within the zip are not showed to
  2957.                 users at all.  Only the first level files in the zip
  2958.                 are showed to users for possible extraction and viewing.
  2959.         - V.107 Added KUEFLER.EXE utility to archieve.  KUEFLER.EXE will
  2960.                 import the files' descriptions from odd-structured and
  2961.                 non-capitalized files.bbs files into newly made dirx.lsts.
  2962.                 (Thanks to: Chris Keufler 1:3402/22)
  2963.         -V.108  Fixed code in the routines to display subdirectories
  2964.                 available on a particular CD.  Did only display up to 99
  2965.                 subdirectories per control-menu.  V1.08 displays up to
  2966.                 238 subdirectories per control-menu.  Also fixed a bug
  2967.                 that prevented "intelligent" fowarding in the subdirectories-
  2968.                 available routines.  Now will auto-advance through all
  2969.                 available directories with only an "ENTER" and when it
  2970.                 reaches end of list, will automatically go back to start
  2971.                 of list - supporting up to 238 subdirectories.  (Thanks
  2972.                 to: Samson Luk, 6:700/8).
  2973.         -V.109  "Previous page" was broken in the subdirectories selection
  2974.                 menu.  Fixed via deletion of previous/next functions in
  2975.                 lieu of an ENTER looping routine.  (Thanks, Samson Luk,
  2976.                 6:700/8).
  2977.         -V1.10  Improved the Search performance by a speed factor of about
  2978.                 3 using an entirely different algorithm.  (Thanks, Chris
  2979.                 Keufler, 1:3402/22).
  2980.  
  2981.                 Samson Luk (6:700/8) reported that when using Maximus and
  2982.                 a user logs on CDMX2DOR more than once in one session that
  2983.                 the user's time-spent-on-board variable is distorted in
  2984.                 Maximus BBS time accounting.  CDMX2DOR does not change nor
  2985.                 even write to this variable during its operation.  There
  2986.                 may be a bug in Maximus in interpretting re-read lastuser.
  2987.                 bbs files in multiple uses in a single session.  I am at
  2988.                 a loss as to how to fix this as it is not CDMX2DOR's
  2989.                 changing that is distorting Maximus's time-spent-on-board
  2990.                 variable.  All other Maximus variables work as they should.
  2991.                 This problem may possibly only occur in Max v2.00.  Your
  2992.                 mileage may vary <g>.  Problem does not seem to exist in
  2993.                 Max v2.01wb.
  2994.  
  2995.                 Changed the naming of the 3 log files that CDMX2DOR keeps so
  2996.                 that their names can be configured by the user via
  2997.                 CDMX2DOR.CFG file.  These files can each be named
  2998.                 differently or all named with the same name for logfile
  2999.                 simplicity. (Thanks Dave DeGear, 1:351/300)
  3000.  
  3001.         -V1.11  Fixed bugglet in the "Edit Taglist" subroutines.  Program
  3002.                 would not display more than 12 files simultaneously tagged
  3003.                 appropriately.  Now handles unlimited tags.  Added an
  3004.                 "Auto Adjust" feature in the "Edit Taglist" module so that
  3005.                 a user's tagged downloads are automatically adjusted to
  3006.                 fit within their Kbyte and Time limits.  Selectable by
  3007.                 user with "A" command on Edit Taglist menu.  Fixed a bugglet
  3008.                 that prevents a file from being tagged twice on the
  3009.                 "Download" option while viewing files.  A file can only be
  3010.                 tagged for download once now, regardless of how it is
  3011.                 selected.  Added menu-control files for the following
  3012.                 CD's: NightOwl 9, SoundWare Collection, and So-Much-
  3013.                 Shareware III.
  3014.  
  3015.         -V1.12  Fixed bugglet on an empty "Search" in the new fast-search.
  3016.                 If user didn't enter a string for search new algorithm
  3017.                 would crash - fixed now; user MUST enter something.  Fixed
  3018.                 bugglet on "View/Extract Zip" module: If user tried to
  3019.                 view a non-supported file, module would crash on a re-
  3020.                 set.  No crash now.  Inadvertently forgot to enable error
  3021.                 trap in V1.11 on compile.  Now reset to error trap.  These
  3022.                 errors reported by Chris Keufler (1:3402/22).  Thanks,
  3023.                 Chris!
  3024.  
  3025.         -V1.13  Revisions in V1.11 concerning the "only-tag-a-file-once"
  3026.                 resulted in messing up the "Download" command on the
  3027.                 file-viewing menu if a taglist was not present.  Fixed.
  3028.  
  3029.         -V1.14  A few users reported that CDMX2DOR would not add comments
  3030.                 to outgoing ZIP files; fixed by adding a line in the
  3031.                 *.CFG file to specify the drive letter of the temporary
  3032.                 scratch directory and by tweaking pkzip commands.  Cleaned
  3033.                 up subdirectory placement of a couple of internal files
  3034.                 used by CDMX2DOR, i.e., dn.bat and ok.fla, which should
  3035.                 now not interfere in using a RAM disk as the temporary
  3036.                 subdirectory (If CDMX2DOR finds the comment file in the
  3037.                 CDMX2DOR home subdirectory, it will copy same to the
  3038.                 temporary subdirectory RAM or not.  One user reported
  3039.                 problems with specifying sysop-defined log names; fixed by
  3040.                 cleaning up the specifications of subdirectories.  NEW: A
  3041.                 sysop can now use CDMX2DOR in local mode to "download" files
  3042.                 off the cdrom, i.e., the files they choose for "downloading"
  3043.                 will be placed in the temporary subdirectory and not
  3044.                 deleted.  Remote downloads that were successful will
  3045.                 continue to have that file deleted; not successful remote
  3046.                 downloads will not be deleted so as to allow the sysop
  3047.                 opportunity time to examine that situation.
  3048.  
  3049.         -V1.15  A CDMX2DOR user with a Pioneer CD-ROM carousel reported that
  3050.                 their carousel has only one read-head though they have 6
  3051.                 CD's.  In multinode situations with a carousel, the
  3052.                 carousel can only read to one user at a time and the
  3053.                 carousel read-head cannot be available to any other users
  3054.                 while any one user is reading something from any of the
  3055.                 CDRoms.  V1.15 has incorporated a "lock" feature that will
  3056.                 prevent multinode concurrent reads from the CD, i.e., only
  3057.                 one user may read data from the CD at a given time and all
  3058.                 other users are locked out of reading the CD until the
  3059.                 present reader is done.  This change is triggered via
  3060.                 the CDMX2DOR.CFG file.  Please check CDMX2DOR.CFG for
  3061.                 more information.  If it is not configured to do so, then
  3062.                 CDMX2DOR WILL do concurrent reads (in the case of muliple
  3063.                 CDRom drives).
  3064.  
  3065.                 NOTE: OPSC.ANS and OPSC.ASC have been renamed to OPSC and
  3066.                       OPSCG for internal door purposes.  Old CDMX2DOR
  3067.                       users can just change OPSC.ANS to OPSCG and OPSC.ASC
  3068.                       to OPSC if they choose.  Older versions with OPSC.ASC
  3069.                       and OPSC.ANS will not work with V1.15 *.exe file
  3070.                       unless these 2 files are renamed and CDMX2DOR.CFG
  3071.                       is fixed to incorporate the carousel/pioneer lock
  3072.                       line (line 17 in the CFG file).
  3073.  
  3074.                 NOTE2:V1.15 of CDMX2DOR has been engineered to copy files
  3075.                       necessary for operation to the temporary drive as
  3076.                       much as possible and to minimize CDROM reader
  3077.                       hogging.  Still, however, CDMX2DOR minimizes use of
  3078.                       HD space by copying to the HD only what it needs
  3079.                       when it needs it and deleting what it doesn't need
  3080.                       immediately on task completion.
  3081.  
  3082.         -v1.16  Just a fix of v1.15.  There were a couple of errors in
  3083.                 ansi/ascii graphics when I edited v1.15 to cut down on
  3084.                 code size.  Now fixed in v1.16
  3085.  
  3086.         -V1.17  There were incorrect instructions for installation of a
  3087.                 many-subdirectory-deep OUTTIE CD.  This is fixed in this
  3088.                 version.  This is the only change from v1.16, i.e., the
  3089.                 doc file is updated to reflect the correct instructions.
  3090.                 Added DIAGCD.EXE, a file to assist in diagnosing simple CDs'
  3091.                 setup and make recommendations for CDMX2DOR configurations.
  3092.                 DIAGCD.EXE may not provide useful information if your CD
  3093.                 you are trying to diagnose is a buried innie or buried
  3094.                 outtie.  It is primarily for simple situations.
  3095.  
  3096.         -v1.18  There was a little bugglet converning displaying the
  3097.                 help file on the download menu when a user selected the
  3098.                 "D"ownload command for a direct download (bypassing a
  3099.                 main menu "D"ownload command) while in the files lists and
  3100.                 then did an "H" command while on the download menu area.
  3101.                 This is now fixed.
  3102.  
  3103.                 One user reported that on occassion maybe one of their
  3104.                 many users would cause the door to hang, i.e., stop but not
  3105.                 exit to the BBS (as it should and is programmed to do).
  3106.                 This is a fluke of some type.  The door is written to
  3107.                 gracefully exit when there is a carrier drop but apparently
  3108.                 on VERY infrequent occassions some few users that have
  3109.                 something in common (but I don't know what yet) made the
  3110.                 door hang.  As a result, V1.18 includes a file called
  3111.                 wabird.com that, when called in the cdmx2go.bat BEFORE
  3112.                 the CDRom door is called gives the sysop the option
  3113.                 of installing an external carrier watcher if they so
  3114.                 choose.  I'd recommend NOT doing so unless there is a
  3115.                 problem (which should generally not be the case for most
  3116.                 sysops).  To see command line arguments for wabird.com
  3117.                 installation, just type "wabird help".  Wabird.com is
  3118.                 freeware not authored by me, but is included as a sample
  3119.                 carrier watcher if needed (and again you will very likely
  3120.                 NOT ever need it as the door is supposed to detect
  3121.                 carrier drops and exit gracefully).
  3122.  
  3123.         -V1.19  Previous versions had a 17 file limit in the tagfile
  3124.                 command and when users tagged 17+ files the door would
  3125.                 lock up and even a carrier drop would not exit gracefully
  3126.                 back to the BBS.  This is fixed now with a 70 file limit.
  3127.                 This problem was what was causing the lockup and was
  3128.                 previously solved (quickfix) via wabird.com.  You should
  3129.                 not need wabird.com unless you expect that users will
  3130.                 be tagging in excess of 70 files in a single door session.
  3131.  
  3132.                 Some users reported that the door would not handle
  3133.                 a byte-checking subroutine that checks to be sure there
  3134.                 is enough space on the HD before copying a file to it.
  3135.                 The routine would return a negative value for bytes free
  3136.                 in this error.  This error is due to DOS's inability to
  3137.                 know whether a logical drive is a true drive or a re-
  3138.                 assigned drive.  CDMX2DOR.EXE will now make this value a
  3139.                 positive value if the function returns a negative value.
  3140.                 For most users this will present no problems.
  3141.  
  3142.                 This version also gives the user an online count of the
  3143.                 number of files they have tagged while in the "browsing"
  3144.                 section of the door -- a cosmetic change.
  3145.  
  3146.         -v2.00
  3147.  
  3148.                 The door was at the 64k program string-space space limit.
  3149.                 As a result, I have started to break the program down
  3150.                 into separate modules to improve memory savings and door
  3151.                 reliability.
  3152.  
  3153.                 NOTE: CDMX2 is now starting to be broken into separate
  3154.                 modules so as to keep memory usage to a minimum.
  3155.                 CDMX2OLH.EXE is the "online help" module section of the
  3156.                 door.  It is called by the user from CDMX2DOR.EXE and
  3157.                 there is no special setup required.  Just be sure it is
  3158.                 located in the same subdirectory as CDMX2DOR.EXE and
  3159.                 all will be well.
  3160.  
  3161.         -v2.01  Fixed a buglet in the download module that resulted from
  3162.                 breaking cdmx2dor into separate modules.  Fixed a buglet
  3163.                 in the "users.dat" record keeping due to modularization.
  3164.  
  3165.         -v2.02  Fixed a compilation buglet which interfered with the
  3166.                 search engine.
  3167.  
  3168.         -v2.03  Added DIGIBOARD and INT14/EBIOS interfacing.
  3169.  
  3170.                 NOTE:  cdmx2dor.CNF is NOW LONGER THAN IT USED TO BE AND
  3171.                 IF YOU ARE UPGRADING YOU WILL NEED TO INSTALL THE NEW
  3172.                 CDMX2DOR.CNF OR EDIT YOUR OLD ONE.
  3173.  
  3174.         -v2.04  Version 2.04 is has a new registration key algorithm so
  3175.                 as to simplify registered users' key installation.  The
  3176.                 key is now installed via a key file and the key file's
  3177.                 name is specified in cdmx2dor.cfg.  All future versions
  3178.                 of the door will use this key algorithm.  This version
  3179.                 also incorporates 2 new features: 1) Offline File
  3180.                 Request module, and, 2) Examine Last 16 files downloaded
  3181.                 module.  The door has been further broken down into various
  3182.                 modules to keep RAM useage to a minimum.
  3183.  
  3184.         -v2.05  Version 2.05 does all of 2.04 and will now support baud-
  3185.                 rates up to 115200 baud AND will support fossils so you
  3186.                 OS/2 people can now use your sio dummy fossil port to send
  3187.                 files.  To support the fossil you must put FDSZ.EXE on your
  3188.                 path. (FDSZ.EXE is Omen Technology's fossil DSZ).  FDSZ.ZIP
  3189.                 is available for DL from New Century if you don't have it.
  3190.  
  3191.         -v2.06  Version 2.06 does all of 2.05 and will also now allow you
  3192.                 to have as many as 102 CDs online (older versions only
  3193.                 allowed up to 34).  Also, files that are now tagged for
  3194.                 downloading but are not actually on-line will have the
  3195.                 tag placed in the "requested files" offline-request module
  3196.                 automatically.  This feature supplements the door's
  3197.                 ability to do offline requests by user-supplied file
  3198.                 name.
  3199.  
  3200. ===========================================================================
  3201.     "For God so loved the world that He gave His Only Begotten Son that
  3202.          whosoever believeth in Him shall not perish but shall have
  3203.                         everlasting life." John 3:16
  3204. ===========================================================================
  3205.