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