home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / CDMX2DOR.ZIP / CDMX2DOR.DOC < prev    next >
Text File  |  1993-09-06  |  122KB  |  2,505 lines
  1.  
  2.  
  3. =============================================================================
  4. "Whatsoever we ask, we receive of him, because we keep his commandments, and
  5.  do those things that are pleasing in his sight."  1 John 3:22
  6. =============================================================================
  7.                                 CDMX2DOR
  8.                               Release v1.10
  9.                 The "Next Generation CDRom-Access BBS Door"
  10.                         (c)1993 Robert E. Lee
  11.                               (309)797-6027
  12.                                   U.S.A.
  13.                            1:232/31  8:7002/3005
  14.                               New Century BBS
  15.  
  16.                    See end of file for Revisions History
  17. =============================================================================
  18.   A special "Thanks" to Chris Kuefler @1:3402/22@Fidonet for his suggestions
  19.                   and assistance in beta-testing CDMX2DOR.
  20.      Thanks also go to Samson Luk 6:700/8 and to Dave DeGear 1:351/220 /300
  21.     for their help in testing and making suggestions to improve CDMX2DOR.
  22. =============================================================================
  23.  
  24. [1.0] Introduction
  25.  
  26.         So long, ROMBRAIN, Hello CDMX2DOR!!!
  27.  
  28.         In the beginning there was CDMAXDOR, and it worked ok on some
  29.         boards but was not capable of doing some things that it should
  30.         and gave some folks fits.  As a result of many suggestions from
  31.         CDMAXDOR users and other sysops, here is CDMX2DOR, a CDRom-BBS
  32.         interface door that, I believe, you'll find to be a superior
  33.         product.  The latest version of CDMX2DOR is available for F'Req
  34.         at 1:232/31 as well as are a number of other doors we've written.
  35.  
  36.   [1.1] WHAT WILL CDMX2DOR DO?
  37.  
  38.         In a word.... EVERYTHING.
  39.  
  40.         Some features:
  41.  
  42.         o       it will work with ANY BBS software (not just MAXIMUS) that
  43.                 is capable of writing a long-style (52 line) DOOR.SYS
  44.                 drop-file, e.g., WILDCAT, PCB, GAP, etc.  If your system
  45.                 can't write a long-style DOOR.SYS, then you may still
  46.                 use this software via a door conversion program that
  47.                 makes long-style DOOR.SYS files.
  48.  
  49.         o       it will allow you to control the number of KBytes that
  50.                 a user may access from your CD's in a given day so as
  51.                 to prevent file leaching regardless of BBS software type.
  52.  
  53.         o       it will allow viewing of textfiles and will unarchieve
  54.                 zips for viewing as well.
  55.  
  56.         o       it will automatically update MAXIMUS BBS user's files
  57.                 to reflect their CDRom downloads.  Other boards' auto-
  58.                 updating of user's download stats is not yet supported
  59.                 but will be (for registered users).
  60.  
  61.                 If you are a Maximus BBS sysop, it will:
  62.  
  63.                         o       end the need to re-SILT when you
  64.                                 change CD's
  65.  
  66.                         o       end the need to FB your CD's
  67.  
  68.                         o       end putting your CD's files.bbs's on your
  69.                                 HD and save you a lot of HD space
  70.  
  71.                         o       automatically write its own door.sys
  72.                                 of the type necessary
  73.  
  74.                         o       make using CD's on Max a piece of cake!
  75.  
  76.         o       Configuration is done by a standard ASCII text editor
  77.                 of your choice, e.g., QEdit, so it is very easy to
  78.                 set up.  Extensively documented installation instructions.
  79.  
  80.         o       it will allow users to download files from your CD or
  81.                 HD with ease, search for files or text, and allow your
  82.                 users to unzip files on the CD for reading text files
  83.                 and other docs in zipped files.
  84.  
  85.         o       it will add your BBS comment/advertisement on outgoing
  86.                 files.
  87.  
  88.         o       it will also allow you to put your C: drive (HD) files
  89.                 within its structure for use, so CDMX2DOR can even be
  90.                 used as a complete drop-in files-transfer system working
  91.                 with CDRom drives and Hard Drives.  Tape drive interfacing
  92.                 may be supported in future versions to registered users.
  93.                 If you want to squeeze every possible drive for online
  94.                 files for your users, you can even have CDMX2DOR access
  95.                 files off your B:\ drive for an additional 1.44 meg of
  96.                 files online.
  97.  
  98.         o       it has beautiful ansi graphics and also supports non-ansi
  99.                 use.
  100.  
  101.         o       it will allow you to have as many as 34 CD's online, each
  102.                 in its own drive, from which users may select
  103.  
  104.         o       it will support CD's with as many as 238 subdirectories
  105.                 and you can break down a CD that has more than 238
  106.                 subdirectories into 2 or more sub-sets (thereby making
  107.                 CDMX2DOR capable of handling any CD regardless of its
  108.                 number of subdirectories).
  109.  
  110.         o       it is fully configureable.  It will work with:
  111.  
  112.                         o       CD's with files.bbs in separate
  113.                                 subdirectories on the CD.
  114.  
  115.                         o       CD's with dirx.lst in separate
  116.                                 subdirectories on the CD.
  117.  
  118.                         o       You can even specify what file it should
  119.                                 look for to find subdirectory listings,
  120.                                 e.g., files.bbs, dirx.lst, files.lst,
  121.                                 DIR, or whatever you have.
  122.  
  123.                         o       CD's that have their files.bbs's or
  124.                                 whatever, in a single subdirectory on
  125.                                 the CD instead of having them in each
  126.                                 subdirectory.
  127.  
  128.                         o       It will even work with CD's that don't
  129.                                 even have a files.bbs or other subdirectory
  130.                                 listing at all -- you can create a list
  131.                                 on your HD and call it whatever you like
  132.                                 (but it must be in a files.bbs- or dirx.
  133.                                 lst-like structure).  A utility for making
  134.                                 skeleton files.bbs-like structures is
  135.                                 included in this archieve.
  136.  
  137.                         o       If you wish you can copy your CD's files.bbs-
  138.                                 like lists to the HD for fast file searches
  139.                                 or leave them on the CD to save HD space.
  140.                                 It is entirely up to you.
  141.  
  142.                         o       you can even incorporate your HD files
  143.                                 into CDMX2DOR if you desire.
  144.  
  145.         o       Detects online/offline files automatically.
  146.  
  147.         o       Supports X, Y, 1K, and Z-modem downloads via DSZ.COM
  148.  
  149.         o       Supports file-tagging, instant downloading, global search
  150.                 and a host of other features.
  151.  
  152.         Not bad, eh?  Well, it will do much more.  It will keep track of
  153.         a user's downloads so that you can specify a "daily limit" of
  154.         download Kbytes off the CD(s).  It will keep track of how much
  155.         time it will take to download files (based on baudrates) and not
  156.         allow a slow modem to download a huge file and eclipse their
  157.         time-allotted limit.  It will even allow you to lock out certain
  158.         files from being downloaded if you don't want nasty gifs to be
  159.         available to your users.  There's even more...
  160.  
  161.         o       Supports having certain files requiring a "key" that
  162.                 a user must know in order to process these files.
  163.  
  164.         o       a whole lot more!
  165.  
  166.                 The following sysop functions are available while awaiting
  167.                 keyboard input :
  168.  
  169.                    F5     -  Shell to DOS.
  170.                    F8     -  Twit user and return to BBS.
  171.                   F10     -  Initiate chat with user.
  172.              <CTL>F10     -  Answer user's page.
  173.                   Home    -  Main user stats.
  174.                   End     -  Displays sysop keys available.
  175.                   PgDn    -  Secondary user stats.
  176.                 Up Arrow  -  Increase user's time remaining.
  177.                 Dn Arrow  -  Decrease user's time remaining.
  178.  
  179.  
  180.         o       Utilities for making dirx.lst's for CD's that have no
  181.                 files.display strutures and for making dirx.lsts from
  182.                 your files.bbs files on your HD.
  183.  
  184.         o       Utilities for translating files.bbs files into dirx.lst-
  185.                 like structure files.
  186.  
  187.         o       full control over IRQ's and HEXport addressing of COM
  188.                 ports.
  189.  
  190.         o       Sysop paging, chat with user, etc.
  191.  
  192.         Interested? <g> Let's look at how to install it.
  193.  
  194. [2.0] DEFINITIONS
  195.  
  196.         A "DSP" is a file in which is contained the files list of a
  197.         paraticular subdirectory.  Typical DSPs are "files.bbs" or
  198.         "dirx.lst" or some other type of list.  Henceforth, reference
  199.         to "DSP" or "files display structure" is referring to a
  200.         file like this.
  201.  
  202.         A "Files.bbs" DSP does not usually contain the file size and
  203.         file date for the files it describes; a "dirx.lst" usually
  204.         DOES contain that information.  CDMX2DOR requires that your
  205.         DSP have the size/date information present.  If you have a
  206.         files.bbs DSP that does, in fact, have the size/date information
  207.         in it, then your displays in CDMX2DOR will be just fine; if they
  208.         do not and there is no alternative DSP available on your CD then
  209.         you should make a "dirx.lst" DSP using utilities included herein.
  210.  
  211.         More about all of this as we continue...
  212.  
  213. [3.0] INSTALLATION
  214.  
  215.         Unzip CDMX2DOR.ZIP into a subdirectory of your choice.  In your
  216.         subdirectory you should find these files:
  217.  
  218.   FILE          Function
  219. FILES    TXT    A directory-listing of files in this package.
  220.  
  221. DOOR     SYS    A sample door.sys
  222.  
  223. BBSSTAT  ASC    ASCII/Non-Ansi display files
  224. CDSONLIN ASC    "
  225. DIRECTS  ASC    "
  226. DOWNSCR  ASC    "
  227. FILEH    ASC    "
  228. DOWNIT   ASC    "
  229. FIN      ASC    "
  230. HELPSCR  ASC    "
  231. MAIN     ASC    "
  232. MORE     ASC    "
  233. STAG     ASC    "
  234. TAGEDIT  ASC    "
  235. OPSC     ASC    "
  236. FORB     ASC    "
  237. LOCKEY   ASC    "
  238.  
  239. CDSONLIN ANS    Ansi display files
  240. BBSSTAT  ANS    "
  241. DIRECTS  ANS    "
  242. DOWNIT   ANS    "
  243. DOWNSCR  ANS    "
  244. FILEH    ANS    "
  245. FIN      ANS    "
  246. HELPSCR  ANS    "
  247. MAIN     ANS    "
  248. MORE     ANS    "
  249. STAG     ANS    "
  250. TAGEDIT  ANS    "
  251. OPSC     ANS    "
  252. FORB     ANS    "
  253. LOCKEY   ANS    "
  254.  
  255. CDTEMP   LST    CDMX2DOR-operation list file
  256. NO8CBOB  LST    CDMX2DOR CD menu-control file for NightOwl 8 CD
  257. PBCBOB   LST    " (for PowerBox v1.00 CD)
  258. PPCBOB   LST    " (for PowerPak Gold '92 CD)
  259.  
  260. CDSONLIN LST    CDMX2DOR-operation CD/Door/Menu interface file
  261. LOCK     LST    CDMX2DOR-operation locked/keyed file interface file
  262.  
  263. AHELP    TXT    CDMX2DOR-operation text files for remote door users
  264. CHELP    TXT    " (Note these are not "DOC" files
  265. VHELP    TXT    "  but are used by CDMX2DOR)
  266. SHELP    TXT    "
  267. YHELP    TXT    "
  268. DHELP    TXT    "
  269. HHELP    TXT    "
  270. THELP    TXT    "
  271. PHELP    TXT    "
  272. ZHELP    TXT    "
  273.  
  274. TAGLIST  DAT    CDMX2DOR-operation data files
  275. USERS    DAT    "
  276.  
  277. NGDL     LOG    CDMX2DOR-operation log files
  278. BADSEND  LST    " (written if necessary)
  279.  
  280. NCB      ADV    Sample BBS advertisement file
  281.  
  282. CDMX2DOR MEC    Maximus BBS-specific files
  283. CDMX2DOR BBS    "
  284. FIXMAX   EXE    "
  285.  
  286. FLYDIRX.EXE     A utility for creating dirx.lst-type structures for CD's
  287.                 that have no files.bbs/dirx.lst or other file-display
  288.                 structures.  FlyDirx will work on any drive, A,B,C,D,E,
  289.                 etc.  You can do individual directories by running
  290.                 FLYDIRX.EXE via a command line call or recursively
  291.                 through an entire CDRom by using FLYENGIN.EXE.  FLYDIRX.EXE
  292.                 can handle subdirectories with up to 300 files.  FLYDIRX
  293.                 will also import files' descriptions from existing files.
  294.                 bbs files (if it finds them in the directory your are
  295.                 trying to convert to a dirx.lst AND if they are normal
  296.                 files.bbs files).
  297.  
  298. FLYDIRX.CFG     Works with FLYDIRX.EXE and FLYENGIN.EXE to do massive
  299.                 creations of skeleton dirx.lst files (in the case of
  300.                 working with CD's that have no files-display structures,
  301.                 e.g., files.bbs's or anything else
  302. FLYENGIN.EXE    Mass-driver for FLYDIRX.EXE.
  303. KUEFLER.EXE     For converting odd files.bbs files to dirx.lsts
  304.  
  305.  
  306. DIRXMAKE.EXE    A utility for translating your files.bbs structures
  307.                 into dirx.lsts so you can display your C: drive (HD) files
  308.                 on CDMX2DOR. (Particularly useful for Maximus sysops in
  309.                 incorporating Max's files into CDMX2DOR services.
  310. DIRXMAKE.CFG    Configuration file for DIRXMAKE.EXE
  311.  
  312. FASTFREQ.BAT    A batfile to drive INSTFREQ.EXE in copying files and
  313.                 driving FLYDIRX.EXE to make "innies"
  314. INSTFREQ.EXE    A utility to copy any file(s) from any drive to any other
  315.                 drive while being in a third drive.  INSTFREQ will
  316.                 use wildcards, e.g., *.zip, fa*.arj, cat*.*, or *.*
  317.  
  318. CDMX2DOR CNF    CDMX2DOR-operation CNF file
  319.  
  320. CDMX2DOR CFG    CDMX2DOR-operation CFG file
  321.  
  322. CDMX2GO  BAT    CDMX2DOR-operation BAT file
  323.  
  324. CDMX2DOR ERR    CDMX2DOR-operation Error report file
  325.  
  326. CDMX2DOR EXE    CDMX2DOR
  327.  
  328.      Ok, now that you have identified these files and they are unzipped
  329.      in a subdirectory of your choice, then you must:
  330.  
  331. =============================================================================
  332. [3.1] Fix CDMX2DOR.CNF file.  In it you will find the following:
  333. ---------                                                             Line #
  334. c:\cdbob                   <-----  your door's subdirectory                 1
  335. New Century BBS            <-----  your board's name                        2
  336. 0                          <-----  leave this as a zero so to read door.sys 3
  337. 3                          <-----  your IRQ number                          4
  338. 02F8                       <-----  your Comport's HEX address               5
  339. 3                          <-----  your IRQ number again                    6
  340. cdmx2dor.cfg               <-----  the name of your *.CFG file              7
  341. ---------
  342.         Fixes:  Change line (1) to that of the subdirectory in which you
  343.                 have unzipped CDMX2DOR.ZIP.  Be sure to have the DRIVE
  344.                 and a colon and a backslash and the subdirectory name.
  345.  
  346.                 Change line (2) to the name of your BBS
  347.  
  348.                 Leave line (3) as a 0.
  349.  
  350.                 Change line (4) to reflect your IRQ #  (Com2 is 02F8, and
  351.                                 IRQ 3.  See a list in this doc file (below)
  352.                                 for other IRQ numbers based on ports, etc.)
  353.  
  354.                 Change line (5) to your HEXport address.  Default is at
  355.                 COM2.  See below for other HEXport addresses for other
  356.                 ports besides COM2.
  357.  
  358.                 Change line (6) to the same value as that in line (4).
  359.  
  360.                 For line (7), please specify the *.CFG file that you
  361.                 are using for your particular node.  If you are running
  362.                 just one node, you can call your file by the name I
  363.                 have included here and just edit the cdmx2dor.CFG file
  364.                 to reflect your particular situation.  If you are
  365.                 multinoded, you'll likely need additional *.CFG files
  366.                 (particularly if you are running Maximus): there is more
  367.                 on this below.
  368.  
  369.         You will eventually use this *.CFG file in a command-line argument
  370.         to start the door up via a bat file, e.g.,
  371.  
  372.                                 /---   see here...  a command-line argument.
  373.                               /               to start the door up is found
  374.         C:\cd2>cdmx2dor cdmx2dor.cnf          in your startup BAT, e.g.,
  375.                                               CDMX2DOGO.BAT
  376.  
  377.         Leave no blank lines at the end of this file after editing.
  378.  
  379. =============================================================================
  380.  [3.2]  Fix CDMX2DOR.CFG file.  (Note: you can have multiple copies of
  381.         this file (with changed names) for multinode; or you can rename
  382.         this file to whatever you please if you like (as long as you
  383.         reflect the changed name in your *.CNF file).
  384.  
  385.         This file is highly commented so you can follow instructions there.
  386.         Do not remove the ";" commentline markers on the left margins.
  387.  
  388.         Leave no blank lines at the end of this file after editing.
  389.  
  390.         Note that this file can be renamed to whatever you like it to be
  391.         called or your can have multiple *.CFG files to support multinode
  392.         situations.  You will place tha name of this file in your
  393.         CDMX2DOR.CNF file (see above).
  394.  
  395. =============================================================================
  396.  [3.3a] IF you are NOT using MAXIMUS BBS software, then you should
  397.         set your system up so that it will write a 52-line door.sys which
  398.         CDMX2DOR can use.  If your particular BBS software won't write a
  399.         52-line door.sys, then you can use a conversion program, e.g.,
  400.         QKDOOR2B.ZIP, to make a 52-line door.sys from your BBS's own
  401.         unique dropfile (e.g., dorinfo1.def, callinfo.bbs, or whatever your
  402.         BBS might write).  Door.sys MUST eventually be copied to or written
  403.         directly in the subdirectory in which CDMX2DOR files reside.  That
  404.         copying may be accomplished in a *.bat file, e.g.,
  405.  
  406.         --sample.bat--
  407.                 @echo off
  408.                 C:
  409.                 cd \bbs
  410.                 cd \<cdmx2dor subdirectory>
  411.                 copy c:\bbs\door.sys
  412.                 cdmx2dor cdmx2dor.cnf
  413.                 cd \bbs
  414.         ---------------
  415.  
  416.         You note that the above *.bat copies door.sys to CDMX2DOR's sub-
  417.         directory and starts up CDMX2DOR.  If there is not a door.sys
  418.         in CDMX2DOR's subdirectory, then the door will not work.
  419.  
  420.  [3.3b] IF you ARE using MAXIMUS.BBS software, then you should make an
  421.         edit to your MENUS.CTL file in the FILES section thusly:
  422.  
  423.         Display_File   \cdbob\cdmx2dor         Normal   "2CDRoms"
  424.  
  425.         Now note that you should change the "\cdbob\cdmx2dor" so that
  426.         the "\cdbob\" part states the subdirectory in which CDMX2DOR
  427.         is actually residing.  You can also change the part after the
  428.         "Normal," i.e., the "2Cdroms" to be whatever you'd like.  You
  429.         must however, have this in your FILE section of your MENUS.CTL
  430.         somehow else your users won't be able to access your CD's.
  431.  
  432.         Make sure you now re-SILT Maximus so that the change you made
  433.         is incorporated into your FILES area.  You will not have to
  434.         SILT Max ever again for this door.
  435.  
  436.         This change will allow users to activate the cdmx2dor.bbs that
  437.         is in CDMX2DOR's subdirectory.  Cdmx2dor.bbs will do 2 things:
  438.         (1) it will write the appropriate door.sys for you and it will
  439.         start the door up.  You will need to make some edits to this
  440.         cdmx2dor.bbs, so included is the cdmx2dor.mec file that
  441.         you can change as needed.  Particularly, you will find in the
  442.         cdmx2dor.mec file a need to change the door.sys directory
  443.         lines, e.g.,
  444.  
  445. -------- excerpt of cdmx2dor.mec -------
  446. [comment  %Z        Translates to the user's full name, in caps.]
  447.  
  448. [comment install the door.sys in the right subdirectory]
  449. [delete]c:\cdbob\door.sys       <-----  change this line
  450. [open]c:\cdbob\door.sys         <-----  change this line
  451. [write]COM%P:[comment                                         Com Port ]
  452. [write]%b[comment                                             baud rate]
  453. ------- end of cdmx2dor.mec excerpt ----
  454.  
  455.         Change the lines with the door.sys statements in them to reflect
  456.         the placement of your CDMX2DOR files.  The objective is to have
  457.         a door.sys written in the subdirectory where CDMX2DOR is.
  458.  
  459.         You should also make a change in the following section of this *.mec
  460.         file, i.e.,
  461.  
  462. -------- excerpt of cdmx2dor.mec -------
  463. [comment quit comment          And we're done!                ]
  464.  
  465. [comment  start up cdmx2dor.exe with an extern run to re-read the lastuser.bbs]
  466.  
  467. [xtern_dos]@c:\cdbob\cdmx2dgo.bat        <------ change this line
  468. -------- end of excerpt ----------------
  469.  
  470.         The last line is where you should make the change.  Change the
  471.         subdirectory line to reflect the subdirectory where you have placed
  472.         CDMX2DOR files.  Make sure you have CDMX2DGO.BAT (or another similar
  473.         bat) in CDMX2DOR's subdirectory.  Also make ABSOLUTELY SURE that
  474.         you do not forget to put the "@" character right after the
  475.         [xtern_dos] command else Maximus user.bbs will not be updated and
  476.         will not show users' downloads off your CDs.
  477.  
  478.         After you have made your changes, you should go to your MAX sub-
  479.         directory and and MECCA your CDMX2DOR.MEC file so as to create
  480.         a CDMX2DOR.BBS file.  If you don't then it won't work <g>.  After
  481.         you have SILTed your changes into MAX,  MECCA'ed your cdmx2dor.mec
  482.         and have the *.bat file in your CDMX2DOR subdirectory you're all
  483.         set to go.
  484.  
  485.         The *.bat file should look like so:
  486.  
  487. --------- *.bat statup file example --------
  488. @echo off
  489. C:
  490. cd \cdbob
  491. cdmx2dor cdmx2dor.cnf
  492. cd \max
  493. --------------------------------------------
  494.         Make sure the last line switches back to MAX, i.e., "cd \max"
  495.         or whereever.  Adjust as necessary, of course.  MAXIMUS is
  496.         GREAT!!! software for BBS's BTW.  If you aren't using
  497.         MAX, then you really should <g>.  Thanks Scott Dudley!
  498.  
  499.  
  500. =============================================================================
  501. [4.0]   CD PREPARATION
  502.  
  503.         If you have the following CDs:
  504.  
  505.                 NightOwl 8
  506.                 PowerBox v1.00
  507.                 PowerPak '92
  508.  
  509.         then you can use the following files in CDMX2DOR's sub-
  510.         directory with minimal edits:
  511.  
  512.         NO8CBOB  LST      1751 07-27-93   1:11p
  513.         PBCBOB   LST      1163 07-14-93   2:02p
  514.         PPCBOB   LST      1626 07-14-93   2:01a
  515.  
  516.         These files are the control menus where CDMX2DOR interfaces with
  517.         these particular CD's.  You can use these files as is without
  518.         changes (unless you are on running them on some other drives then
  519.         those specified - take a look at 'em).
  520.  
  521.         Note: If you have done the above changes and have no other CD's
  522.         than the ones above, then the door is ready to go.  Before you
  523.         run it however, you probably should read on...
  524. =============================================================================
  525. [5.0]   PREPARING CONTROL MENU (*.LST) FILES
  526.  
  527.         If you have CD's other than the one's above (as you probably do)
  528.         then you will have to make your *.LST file(s).
  529.  
  530.         [5.1] HOW TO MAKE A CD MENU-CONTROL *.LST:
  531.  
  532.         Your construction of your CD menu-control *.LST will be
  533.         governed by the type of setup your CD has (as regards its
  534.         subdirectories, files' list types, etc.).  You'll have to
  535.         examine your CD to determine which of the below configurations
  536.         suits your particular CD and then build a CD menu-control
  537.         *.LST file for it.
  538.  
  539.         You will build your *.LST file(s) with a standard text editor,
  540.         e.g., QEdit.  Some sample lists are included in this archieve
  541.         for NightOwl 8 (no8cbob.lst), PowerBox v1.00 (pbcbob.lst), and
  542.         PowerPak Gold '92 (ppcbob.lst) that can serve as examples.
  543.  
  544.         ===============
  545.         Making "INnies"
  546.         ===============
  547.  
  548.         Here's an excerpt sample *.LST for your consideration:
  549.  
  550. -------------------------------------------
  551.                   Fig. 1
  552. ----------- ppcbob.lst excerpt ------------  LINE #
  553. PowerPak Gold '92:dirx.lst:in                  1
  554. ACCOUNT:Accounting-related files               2
  555. ANIMAT:Animation, FLI, Autocad                 3
  556. ANTI_VIR:Antivirus-related files               4
  557. ARCHIVE:Archievers, ARJ, ZIP, etc.             5
  558. BACKUP:File/Disk Backup Utilities              6
  559. -------------------------------------------
  560.  
  561.         The rest of ppcbob.lst is like the last 5 lines above.  The really
  562.         important line is the first line.  In the above (Fig. 1), in the
  563.         first line, we see 3 data items:
  564.  
  565.         (1) the name of the CD, (2) the file structure, and (3) where the
  566.         file lives (either "in" its own subdirectory with the rest of its
  567.         files or "out" in some other subdirectory.  So, in creating a *.LST
  568.         for your CDrom you must know the name, the file structure of the
  569.         files display (DSP), and where the file display structure (DSP)
  570.         lives.
  571.  
  572.         On the PowerPak Gold CD, the DSP is a dirx.lst and it lives IN the
  573.         subdirectories where its files are.
  574.  
  575.         Graphically: (showing another CD for example)
  576.  
  577.                     /--- CD's name
  578.                   /            /--- DSP file name
  579.                 /            /      /--- DSP residence is IN the subdirec-
  580.               /            /      /      tories it is describing
  581.         PowerBox V1.00:files.bbs:in
  582.  
  583.         The next lines after the first line contain 2 data items, (1) the
  584.         actual name of the subdirectory on the CD itself, and (2) the
  585.         description of the files in that subdirectory.
  586.  
  587.  
  588.         Graphically:
  589.  
  590.                     /--- actual subdirectory name on the CD that the DSP
  591.                   /      is describing.
  592.                 /
  593.               /              /--- user description for the subdirectory
  594.             /              /                  (What the user will see
  595.         ACCOUNT:Accounting-related files       as a description)
  596.  
  597.         You may have up to 328 subdirectories per *.LST.  If your CD has
  598.         more than that just make another *.LST and include the rest in
  599.         the second *.LST (the 2nd LST must also have a config line #1 with
  600.         a second name, e.g., *.LST #1 may have SUPERSHARE Pt.I, and the
  601.         2nd .LST may have SUPERSHARE Pt. II or whatever your please.
  602.         For example:
  603.  
  604.         PowerZing Part 1:dirx.lst:in  <- first line of *.LST #1
  605.         ACCOUNT:Accounting-related files
  606.         (etc. up to 238 subdirectories)
  607.  
  608.         PowerZing Part 2:dirx.lst:in  <- first line of *.LST #2
  609.         MARKET:Farming-related files
  610.         (etc. to end of CD's subs)
  611.  
  612.         So, you see, you can accomodate any CD regardless of number of
  613.         subdirectories.
  614.  
  615.         Now, what if it is not a dirx.lst for the file display structure?
  616.         Here ya go:
  617. -------------------------------------
  618.                 Fig. 2
  619. ---------- pbcbob.lst excerpt -------    Line #
  620. PowerBox V1.00:files.bbs:in                1
  621. 001:ASP Software                           2
  622. 002:BBS Related - CDROM                    3
  623. 003:BBS Related - General                  4
  624. 004:BBS Related - PCBoard                  5
  625. 005:BBS Related - Other                    6
  626. ---------- end of excerpt -----------
  627.  
  628.         The 2nd through the end line in the excerpt above is just like
  629.         the first example (Fig. 1) we saw immediately above.  The difference
  630.         in this example (Fig. 2) is in the very first line.  It is not a
  631.         "dirx.lst" but is a "files.bbs."  Note that it still lives "IN" the
  632.         subdirectory of files which it displays.
  633.  
  634.         So, we now can accomodate either a dirx.lst or files.bbs that
  635.         live "in" the subdirectories they report on.
  636.  
  637.                               /--- files.bbs and not a dirx.lst
  638.                             /
  639.         PowerBox V1.00:files.bbs:in
  640.  
  641.         This particular CD's "files.bbs" DSP DOES have the size and date
  642.         information in it so I can use it just fine and CDMX2dOR will
  643.         display it just fine.  If it were a normal files.bbs that did not
  644.         have the size/date information in it, then I would need to either
  645.         find an alternative DSP (e.g., a dirx.lst) on the CD or make
  646.         a dirx.lst DSP using utilities included and put the DSP for that
  647.         CD on my HD.
  648.  
  649.         What if it is not a dirx.lst OR a files.bbs but it still lives
  650.         "in."  Easy.  Just call it it's name, whatever it may be, e.g.,
  651.         if it is a files.lst file IN the subdirectory describing the
  652.         files in that subdirectory, then just have the following:
  653.  
  654.  
  655.                               /--- a files.lst and not a files.bbs or
  656.                             /        a dirx.lst.
  657.                           /
  658.         BizarreGifs:files.lst:in    <- first line of the *.lst for this CD.
  659.  
  660.         As long as this "files.lst" DSP has the size/date information and
  661.         conforms to normal DSP style then CDMX2DOR will handle it just
  662.         fine.
  663.  
  664.         The rest of the structure (lines 2 to X) of the menu command *.LST
  665.         would be just like the first one shown above.  So, you see, CDMX2DOR
  666.         can work with ANY display file structure that has any name (provided
  667.         that it approximates the typical files.bbs/dirx.lst structure.
  668.  
  669.         ---------------------------------------------------------
  670.         Leave no blank lines at the end of your CD menu-control
  671.         *.LST files else you will get an "Illegal function" error.
  672.         ----------------------------------------------------------
  673.  
  674.         ================
  675.         Making "OUTties"
  676.         ================
  677.  
  678.         BUT I HAVE A CD WHERE THE DIRX.LST is NOT a live "in."  Now what?
  679.         Easy <g>.  If it's not an "innie" it's an "outtie," e.g.,
  680.  
  681. --------------------------------------------
  682.                   Fig. 3
  683. -------- excerpt from NightOwl 8 -----------  Line #
  684. NightOwl 8:dirx.lst:out:text                    1
  685. DIR1:001A:Apogee Games                          2
  686. DIR2:002A:Software Creations                    3
  687. DIR3:003A:Gamer's Edge                          4
  688. DIR4:004A:Epic MegaGames                        5
  689. --------------------------------------------
  690.  
  691.         Notice that we have now, not three, but 4 (FOUR) pieces of data
  692.         on the first line in the menu-command LST file.  (1) the CD name,
  693.         e.g., NightOwl 8, (2) the display file structure, e.g., dirx.lst,
  694.         (3) that it is OUT (meaning that dirx.lst is not living in the
  695.         subdirectories that it describes, and (4), the subdirectory where
  696.         the all the dirx.lsts live :-).
  697.  
  698.         Graphically:
  699.  
  700.                      /--- CDrom's name
  701.                    /         /--- display file [DSP] format
  702.                  /         /      /--- where the DSP lives (not in the
  703.                /         /      /      subdirectories it describes)
  704.              /         /      /    /--- the subdirectory on the CD where
  705.         NightOwl 8:dirx.lst:out:text    DSP does live.
  706.  
  707.  
  708.         Notice that the last 4 lines in the example above have 3 (three)
  709.         bits of information rather than just the 2 we've seen so far.  The
  710.         3 data pieces are (1), the name of the out-living file-display
  711.         file, (2) the subdirectory that it is describing, and (3) a
  712.         description of the files in that subdirectory.
  713.  
  714.         Graphically:
  715.  
  716.                 /--- The name of the DSP for subdirectory 1 on the CD
  717.               /    /--- the name of the subdirectory on the CD being described
  718.             /    /       /--- a description of the subdirectory for users to
  719.           /    /       /      see
  720.         DIR1:001A:Apogee Games
  721.  
  722.         ----------------------------------------------------------
  723.         Leave no blank lines at the end of your CD menu-control
  724.         *.LST files else you will get an "Illegal function" error.
  725.         ----------------------------------------------------------
  726.  
  727.         Note that if your DSP is several subdirectories deep in this
  728.         current situation (an outtie) you can have the name of the
  729.         DSP prefaced by subdirectories which are under the head
  730.         subdirectory "\text".  For example, let's assume
  731.         that DIR1 (in the above DSP) is in the subdirectory \text\lists
  732.         rather than in just \text.  We would then have our 2nd through
  733.         Nth lines in our menu-command LST specifying this, i.e.,
  734.  
  735.                                                  LINE #
  736.         OddOwl 11:dirx.lst:out:text                1
  737.         lists\DIR1:001A:Apogee Games               2
  738.         twists\DIR2:002A:Mega Games                3
  739.         lists\boxes\DIR3:003A:Super Gams           4
  740.         etc.                                       N
  741.  
  742.         Note that in this situation, the DSP in line 2 is name DIR1 with
  743.         no extension; line 3's is DIR2.  Some CD's have DSP's of that
  744.         name, e.g., the NightOwl CD's particularly.
  745.  
  746.         Whereever the DSP is under the major subdirectory, you can
  747.         specify the path to it under the major subdirectory.  So, in
  748.         the above case the path to the first DSP (in line 2) is:
  749.  
  750.         \text\lists\DIR1  (note this is not the format to use to state this
  751.                           in your control menu... this is just an inter-
  752.                           pretation of what it means.  Use the format to
  753.                           state this as is indicated in line 2 above.)
  754.  
  755.         For the 4th line it is:
  756.  
  757.         \text\lists\boxes\DIR3   (also not the correct format; only an
  758.                                   interpretation of what it means)
  759.  
  760.         ------------------------------
  761.         Summary: A recap to this point
  762.         ------------------------------
  763.  
  764.         So, in the NightOwl 8 example (Fig. 3 above), we see for NightOwl 8
  765.         that it has:
  766.  
  767.                 out-living description files, located in a subdirectory
  768.                 called "text" on the CDrom and that the display file for
  769.                 the first subdirectory is living in subdirectory "text"
  770.                 and is called "DIR1." In it is a description of the files
  771.                 found in subdirectory "001A" (Apogee Games) on the CD.
  772.                 The second description file is called "DIR2" and describes
  773.                 files found in subdirectory "002A" (Software Creations)
  774.                 on the CD, etc.
  775.  
  776.         As long as you tell it OUT and where the display file structure
  777.         lists [the DSP's] live (a subdirectory) and what their names are
  778.         then all will be well.  You could have:
  779.  
  780.         a files.bbs living in
  781.         a files.bbs living out in \whatnot
  782.         a dirx.lst living in
  783.         a dirx.lst living out in \whatnot
  784.         a files.lst living in
  785.         a files.lst living out in \whatnot
  786.         a *.* living in
  787.         a *.* living out in \whatnot
  788.  
  789.         ======================
  790.         LIVING IN, LIVING OUT?
  791.         ======================
  792.  
  793.         LIVING IN (see more on innies further down):
  794.  
  795.         If the files-description file lives "IN" then the first line of the
  796.         *.LST will have 3 data items:
  797.  
  798.                 (1) CD Name, (2) files-description file name, (3) IN
  799.  
  800.         Graphically:
  801.  
  802.                     /--- CD's name
  803.                   /            /--- DSP file name
  804.                 /            /      /--- DSP residence is IN the subdirec-
  805.               /            /      /      tories it is describing
  806.         PowerBox V1.00:files.bbs:in
  807.  
  808.  
  809.         The remaining lines will have two (2) data items:
  810.  
  811.                 (1) the subdirectory where it is, and (2) a description
  812.                 of the subdirectory for the user.
  813.  
  814.         Graphically:
  815.  
  816.                     /--- actual subdirectory name on the CD
  817.                   /
  818.                 /
  819.               /              /--- user description for the subdirectory
  820.             /              /
  821.         ACCOUNT:Accounting-related files
  822.  
  823.  
  824.         LIVING OUT (reprise):
  825.  
  826.         If the files-description files live "OUT" then the first line of the
  827.         *.LST will have 4 data items:
  828.  
  829.                 (1) CD Name, (2) files-description file type, (3), OUT, and
  830.                 (4) subdirectory where the files-descriptions all live.
  831.  
  832.         Graphically:
  833.  
  834.                       /--- CD's name
  835.                     /        /--- files-description file [the DSP] type
  836.                   /        /     /--- the DSP lives OUTside of the subs they
  837.                 /        /     /      describe
  838.               /        /     /    /--- they all live in this subdirectory on
  839.         NightOwl 8:dirx.lst:out:text    the NightOwl 8 CD.
  840.  
  841.  
  842.         The remaining lines will have three (3) data items:
  843.  
  844.                 (1) the name of the file-description file, (2) what
  845.                 subdirectory it is describing, and (3) a description of
  846.                 the subdirectory for the user.
  847.  
  848.         Graphically:
  849.  
  850.                   /--- the DSP's name for the first subdirectory
  851.                 /
  852.               /     /---  the subdirectory name on the CD the DSP describes
  853.             /     /      /--- a description for the user of this subdirectory
  854.           /     /      /
  855.         DIR1:001A:Apogee Games
  856.  
  857.  
  858.         You get the idea.  As long as your first line is set up properly
  859.         and your remaining lines are correct then CDMX2DOR will work just
  860.         fine.  Now as long as your CD's have these simple situations you
  861.         can handle building your menu-control *.lst file with the above
  862.         information.  However, as there is no standardization with how
  863.         CD's are constructed (i.e., their subdirectory structure and their
  864.         DSP's) you may need additional configuration options.  Here they
  865.         are:
  866.  
  867.         =====================================================
  868.         SPECIAL CASE!  CD's with no dirx.lst, files.bbs, etc.
  869.         =====================================================
  870.  
  871.         ==============================
  872.         Not "INnies" and not "OUTties"
  873.         ==============================
  874.  
  875.         HEY, MY CD doesn't even have a files list display at all... nothing.
  876.         No dirx.lst, no files.lst, no files.bbs... nothing.  Now what?
  877.         Fairly easy. :-)
  878.  
  879.         In this situation, you will have to make a files.bbs- or a
  880.         dirx.lst-type display file structure for your CD and put it on
  881.         your HD.  You can use FLYDIRX.EXE to make your file display
  882.         structures [DSP's] that is included in this archieve.  This
  883.         situation would be known as a "double-outtie" (the files.bbs/
  884.         dirx.lst's do not live IN the subdirectories on the CD that they
  885.         describe and do not even live on the CD at all (because there were
  886.         none and you had to construct them)).  Use FLYENGIN.EXE
  887.         and FLYDIRX.CFG to make dirx.lsts for entire CD's automatically
  888.         (see FLYDIRX.CFG for more explanation).  See caveat on FLYDIRX.EXE
  889.         later on in these docs.
  890.  
  891.         The control menu *.LST first line in an example menu for this
  892.         case would looks as so:    (note: this is a "double outtie")
  893.  
  894. ------------------------------------------------------
  895.                         Fig. 4
  896. ------ excerpt of a "no-nothing" CD *.LST setup ------    Line #
  897. IBM Networking:dirx.lst:out:max\file\twerp:C:               1
  898. 001N.LST:001N:LANS                                          2
  899. 002N.LST:002N:Networks of fun                               3
  900. 003N.LST:003N:Networking games                              4
  901. 004N.LST:004N:Nets & OS/2                                   5
  902. 005N.LST:005N:Net Arcanum                                   6
  903. ------------------------------------------------------
  904.  
  905.         In the above situation, you'll have to use FLYDIRX.EXE to make
  906.         your dirx.lsts for yourself.  See info on FLYDIRX.EXE
  907.         below for contructing skeleton files.bbs/dirx.lsts.
  908.  
  909.         Your CD's menu control *.LST structure now is slightly different
  910.         in the first line then previous menu *.LST structures, i.e., there
  911.         are not 3, not 4, but now FIVE (5) bits of data:
  912.  
  913.                          /--- Name of your CD
  914.                        /          /--- display file structure (DSP) format
  915.                      /          /      /--- the DSP doesn't live in the
  916.                    /          /      /      CD's subs it describes
  917.                  /          /      /       /--- it lives in this subdirectory
  918.                /          /      /       /          /--- and on C: drive
  919.         IBM Networking:dirx.lst:out:max\file\twerp:C:
  920.  
  921.  
  922.         (1) the CD name, (2) the displayfile structure type, (3) OUT,
  923.         (4) the path on your HD where these displayfile structures will
  924.         be found, and (5), the DRIVE on your HD where they are.  So,
  925.         we see in the above example (where there are no files.bbs's or
  926.         other display file structures on the IBM Networking CD) that:
  927.  
  928.                 there are dirx.lst-type structures, living OUT, on C:
  929.                 drive, in subdirectory "max\file\twerp" and that
  930.                 the first dirx.lst-type structure for the first
  931.                 subdirectory is called "DIR1" and that it is describing
  932.                 files in subdirectory 001N (actual subdirectory on
  933.                 the CD).  Finally, we see this subdirectory of files
  934.                 described for users as "LANS."
  935.  
  936.              ----------------------------------------------------------
  937.              Leave no blank lines at the end of your CD menu-control
  938.              *.LST files else you will get an "Illegal function" error.
  939.              ----------------------------------------------------------
  940.         --------------------------------------------------------------
  941.                                A Caveat on FlyDirx
  942.         --------------------------------------------------------------
  943.         Use FLYDIRX.EXE to make these dirx.lst-type structures for
  944.         yourself.  FLYDIRX.EXE will automatically make a display-file
  945.         structure for each of your CD's subdirectories that is compatible
  946.         to the door's display structure requirement and these dirx.lsts
  947.         will have included in them the following:
  948.  
  949.         Filename        File Size       File Date
  950.  
  951.         You would now then have to edit these subdirectory list structures
  952.         to include descriptions if you want them, yech!@, in your
  953.         dirx.lst-formatted file display structure that FLYDIRX.EXE makes
  954.         for you.
  955.  
  956.         FLYDIRX works on a commandline basis, e.g., to make a skeleton
  957.         dirx.lst for a CD that has no files.bbs's or to make dirx.lsts
  958.         for any other Drive\Subdirectory you desire.  For spot fixes,
  959.         just use FLYDIRX.EXE itself.  For longer jobs, use FLYENGIN.EXE
  960.         to complete a large number of subdirectories with ease.  If the
  961.         subdirectory you desire to make a dirx.lst for already has a
  962.         files.bbs, then FLYDIRX.EXE will import the files' descriptions
  963.         from the files.bbs into the newly created dirx.lst.  FLYDIRX.EXE
  964.         is started thusly (an example):
  965.  
  966.         flydirx d:\001N IN <dlc#>
  967.  
  968.         where d:\001N is the subdirectory for which I mean to make a
  969.               skeleton dirx.lst
  970.         where IN (or OUT) is the placement of this skeleton dirx.lst
  971.               upon its creation.  Use OUT when working on CD's
  972.         where <dlc#> is the number of spaces to adjust to the right(+#)
  973.               or to the left(-#) to accomodate the importing of files
  974.               descriptions from previously existing files.bbs in the
  975.               d:\001N subdirectory.  If FLYDIRX.EXE finds a files.bbs
  976.               in the subdirectory for which you are making a dirx.lst,
  977.               it will import the files.bbs descriptions automatically.
  978.               If no file.bbs is to be found, then you may just enter a
  979.               "0" on this parameter.
  980.  
  981.               NOTE: IF your subdirectory DOES have files.bbs files from
  982.               which to import descriptions, you will need to adjust the
  983.               cut-line for the importing of files.bbs descriptions into
  984.               the newly created dirx.lsts depending on the layout of the
  985.               files.bbs.  Use <dlc#> to adjust the cutline as needed.  You
  986.               will likely need to play a bit to get it right so experiment
  987.               on a single directory before you start a large job employing
  988.               FLYENGIN.EXE.  IF your files.bbs files are not the normal
  989.               structure for files.bbs files, then you will need to employ
  990.               KEUFLER.EXE rather than FLYDIRX.EXE.
  991.  
  992.         You could then place all these newly-created dirx.lsts in their
  993.         own singular subdirectory on your HD (where you are running
  994.         FLYDIRX) in the case of a CD that has no files.bbs/dirx.lsts
  995.         (thereby making a "double outtie" out a a CD that couldn't otherwise
  996.         be displayed to your users for downloading).  You could also place
  997.         these newly-created dirx.lsts within the subdirectory they are
  998.         describing in the event these subdirectories are on a writeable
  999.         drive (thereby making "innies" possible).
  1000.  
  1001.         You may wish to employ INSTFREQ.EXE/FASTFREQ.BAT in combination with
  1002.         FLYDIRX.EXE in certain situations (see below).
  1003.  
  1004.         If FLYDIRX.EXE finds a normal files.bbs in the subdirectory you
  1005.         are converting to a dirx.lst listing, it will automatically import
  1006.         those files descriptions into the dirx.lst from the files.bbs it
  1007.         finds.  This is provided that the files.bbs is of this nature:
  1008.  
  1009.         BUFFALO.GIF  (320*200*256) A buffalo on the range
  1010.         CATFISH.GIF  (400*177*256)Your very own catfish!
  1011.         DEER.JPG     A nice deer
  1012.         DOGNCAT.GIF  (320*200*256) Bulldog and kitty
  1013.  
  1014.         IF your file.bbs is an odd-type structure that looks like this:
  1015.  
  1016.         MICKEY.ARJ MAC.pic of Mickey Mouse
  1017.         MINK.GIF (320*200*256) A mink in a tree
  1018.         RACCOON.GIF (320*200*256) A raccoon
  1019.         SPUDS.ARJ MAC.pic of the party animal, Spuds.
  1020.  
  1021.         then you must use Keufler.exe to achieve your goal of making a new
  1022.         dirx.lst with imported files.bbs descriptions.  KEUFLER.EXE is
  1023.         just like FLYDIRX.EXE with the only difference being its handling
  1024.         of files.bbs list structure.  With KEUFLER.EXE, you will have to
  1025.         manually do each subdirectory; FLYENGIN.EXE will not work with
  1026.         KEUFLER.EXE.   KEUFLER.EXE command line entry is exactly like
  1027.         that of FLYDIRX.EXE, so it is possible to drive KEUFLER.EXE using
  1028.         a bat file (that you would create) to do mass conversions.
  1029.  
  1030.         =========================================
  1031.         Special Case: The "Double Outtie"
  1032.         =========================================
  1033.         The appropriate format to access this type of "double outtie"
  1034.         special case (as it would be displayed in your control menu *.LST
  1035.         file) is as follows:
  1036.  
  1037. --------------------------------------------------------
  1038.                         Fig. 5
  1039. ------ excerpt of a "no-files.bbs" CD *.LST setup ------ LINE #
  1040. IBM Networking:dirx.lst:out:max\file\twerp:C:              1
  1041. 001N.LST:001N:LANS                                         2
  1042. 002N.LST:002N:Networks of fun                              3
  1043. 003N.LST:003N:Networking games                             4
  1044. 004N.LST:004N:Nets & OS/2                                  5
  1045. 005N.LST:005N:Net Arcanum                                  6
  1046. --------------------------------------------------------
  1047.  
  1048.         The list files in lines 2-6 above (Fig. 5), e.g., in the 2nd line,
  1049.         001N.LST, are those list files made by FLYDIRX.EXE for use in
  1050.         double-outties.
  1051.  
  1052.                   /--- these *.LSTs are made using FLYDIRX.EXE
  1053.                 /      /--- actual subdirectory name on your CD
  1054.               /      /        /--- Description for users of subdirectory
  1055.             /      /        /
  1056.         002N.LST:002N:Networks of fun
  1057.  
  1058.         ---------------------------------------------------------------
  1059.         Make sure you leave no blank lines at the end of the control
  1060.         menu *.LST files else you will get an "illegal function" error.
  1061.         ---------------------------------------------------------------
  1062.  
  1063.         What is Fig. 5, line 1 telling us?  Living OUT in drive C: in
  1064.         subdirectory max\file\twerp are a collection of DSP's for our
  1065.         CD that are all dirx.lst-like files.
  1066.  
  1067.         From lines 2-6 in Fig. 5, we see these dirx.lst-like files are
  1068.         called 001N.LST, 002N.LST, etc.  Though they are all on
  1069.         c:\max\file\twerp, they are each describing different subdirectories
  1070.         on the CD.  On line 2 of Fig. 5, we see that 001N.LST (though on
  1071.         c:\max\file\twerp) is describing files on our CD's subdirectory
  1072.         called \001N. (Note: the drive letter to our CD is set in a file
  1073.         called CDSONLIN.LST discussed later -- don't worry about that just
  1074.         yet).
  1075.  
  1076. Well, now you can do simple innies, simple outties, make a double-outtie
  1077. from a "nottie" CD.  We can work with files.bbs's, dirx.lst's, and *.*
  1078. display file structures.  That ought to handle your basic situations <g>.
  1079. There are, however, other "special cases" that we'll discuss here shortly.
  1080. As a caveat, however, check this out:
  1081.  
  1082.         ----------------------------------------------------------------
  1083.         Playing with configs and making your own special cases
  1084.         ----------------------------------------------------------------
  1085.  
  1086.         Leave no blank lines at the end of any of the configuration
  1087.         files you create yourself or edit else it is likely that you
  1088.         will get an "Illegal function" error.
  1089.  
  1090.         The key to getting any CDrom to work on CDMX2DOR is having things
  1091.         appropriately configured.  If things are not working for you,
  1092.         then you probably have not configured things rightly.  Check to
  1093.         make sure you have things configured appropriately.
  1094.  
  1095.         For the expert user: you can play with configs as you please as
  1096.         regards to where files.bbs-like structures live.  For example,
  1097.         I put CDMX2DOR on a Drive B: subdirectory, copied NightOwl 8's
  1098.         DIR files to a Drive A: subdirectory, had NightOwl 8 CD in Drive
  1099.         D:, and had a subdirectory in Drive C: as my scratch directory.
  1100.         This worked quite nicely as a "Double Outtie" accessing all my
  1101.         drives.  You can do your innies, outties, notties, or whatever
  1102.         wherever you please as long as you have things configured
  1103.         appropriately.  The advantage of a "double outtie" is just faster
  1104.         file searches (i.e., the CD's directories are on the HD -- but
  1105.         they take up about 1 Meg so it is a tradeoff between speed and
  1106.         HD space).  Of course if your CD has no file-display structures
  1107.         you'll HAVE to use a double outtie configuration.
  1108.  
  1109.         ----------------------------------------
  1110.         Special case: DRIVE B: use as an "innie"
  1111.         ----------------------------------------
  1112.  
  1113.         Included in this archieve is a little control-menu for my Drive
  1114.         B: called "tbcbob.lst" which I have configured as an "innie."
  1115.         Drive B: was originally a "nottie," i.e., there was no file.bbs
  1116.         or dirx.lst on B:\tiny nor any in B:\ or anywhere else.
  1117.  
  1118.         I used FLYDIRX.EXE to set up its skeleton dirx.lst (which
  1119.         FLYDIRX.EXE named as TINY.LST and put on Drive C:), used
  1120.         QEdit to finish up the dirx.lst, renamed it "dirx.lst" and
  1121.         copied to Drive B:\tiny.  I then told CDSONLIN.LST that this
  1122.         was an innie.  So, you can squeeze an extra 1.44 bytes out of
  1123.         your B: drive for users if you so desire.  I could just as
  1124.         easily configured my B: drive as an outtie or a double outtie
  1125.         if I so chose...  it depends on where you place the dirx.lst
  1126.         and what you call the dirx.lst as to whether it is an innie,
  1127.         outtie.
  1128.  
  1129.         Now back to the special cases...
  1130.  
  1131.         More on innies...
  1132.         =============================================================
  1133.         YET ANOTHER SPECIAL CASE:  The "buried innie"
  1134.         =============================================================
  1135.  
  1136.         ------------------
  1137.         Weird-named Innies
  1138.         ------------------
  1139.  
  1140.         Let's assume a situation in which your files directory lists
  1141.         are "in" the subdirectories that they describe but that they
  1142.         are not all named the same, e.g., for one directory the
  1143.         files display structure is GAMESA-L.LST and for another
  1144.         subdirectory the files display structure is GAMESM-Z.LST.
  1145.         A simple innie using a common name, e.g., dirx.lst, won't
  1146.         work.  You will have a special case here known as a "buried
  1147.         weird named-innie."  Here is an example:
  1148.  
  1149. ----------------------------------------------------------------------------
  1150.                                   Fig. 6
  1151. ----------------------------------------------------------------------------
  1152.                  /-- CD name
  1153.                /         /-- display file structure type
  1154.              /         /     /-- location is "in" the subdirectories it
  1155. Line#      /         /     /     describes
  1156.   1     SIMTEL 8:dirx.lst:IN
  1157.   2     filesg\001A\games@DIR1:Games A-P
  1158.   3     filesg\002A\arcane@DIR2:Games Q-Z<---- description for user of subdir
  1159.             \     \    \   \  \--------------dirx.lst's real NAME whatever
  1160.               \     \    \   \-- NOTE: see this "@" sign??? It is critical
  1161.                 \     \    \-- two subs deep                in the config!
  1162.                   \     \-- one sub deep
  1163.                     \-- main root subdirectory of all files off of X: drive
  1164. ----------------------------------------------------------------------------
  1165.  
  1166.         To do a "buried innie" you must put the root subdirectory off the
  1167.         X: drive (whatever it is as specified in your CDSONLIN.LST),
  1168.         followed by the remaining subs, followed by a "@" to denote the
  1169.         end of the complete path; next you place the name of the files
  1170.         display structure (whatever it may be, e.g., DIR, GAMESA-P.LST,
  1171.         whatever it may be.  Follow that with a colon (:) and then the
  1172.         description of the subdirectory that the user will see.
  1173.  
  1174.         The first line (e.g. starting with SIMTEL, above) is exactly like
  1175.         any other innie; the difference is in the remaining lines.
  1176.  
  1177.         What is Fig. 6 telling us about our CD?   Living IN buried subs
  1178.         on our CD are some DSP's.  In line 2 (Fig. 6) we see that
  1179.         our DSP (called DIR1 on the CD) lives in the \filesg\001a\games
  1180.         subdirectory.  Line 3 (Fig. 6) states our DSP (called DIR2 on
  1181.         the CD) lives in \filesg\002A\arcane subdirectory.
  1182.  
  1183.         So, with this setup, we can go subdirectories deep into a
  1184.         CD and find different named DSPs if we need to and still do an
  1185.         "innie" situation.
  1186.  
  1187.         -------------------
  1188.         Normal-named Innies
  1189.         -------------------
  1190.  
  1191.         My DSP's are all called the same name (e.g., dirx.lst) but they
  1192.         are buried subdirectories deep on my CD.  Now what?
  1193.  
  1194.         NOTE: You can have a "not-weird named-buried innie" simply by
  1195.         having something like the following:
  1196.  
  1197. ----------------------------------------
  1198.                 Fig. 7
  1199. ----------------------------------------
  1200. Line#
  1201.   1     The Back Door:dirx.lst:in
  1202.   2     max\file\amiga:Fun stuff for you
  1203.   3     max\file\apple:More fun stuff
  1204.   4     max\file\bbsstuf:BBS stuff
  1205. -----------------------------------------
  1206.  
  1207.         The only difference between this "normal" buried innie and the
  1208.         weird-named innie is that there is no "@whatver.lst" in the
  1209.         second thru the 4th lines.  This means that, though buried, each
  1210.         one is called "dirx.lst."  The difference between this "not-
  1211.         weird named-buried innie" and a simple "innie" (discussed way
  1212.         up at the start of this section) is that this type handles buried
  1213.         innies; the other's discussion (above) does not really detail this
  1214.         special case as is detailed here.
  1215.  
  1216.         =====================================================
  1217.         SPECIAL CASE!  Variable subdirectory-depth Innies
  1218.         =====================================================
  1219.  
  1220.         I have a case on my CD where sometimes the DSP's are only 1
  1221.         subdirectory deep and sometimes 3 subs deep.  Now what?
  1222.  
  1223.         -------------------------------------------
  1224.         (Variable stacked-deep normal-named Innies)
  1225.         -------------------------------------------
  1226.         You can have combinations of stacked-deep buried innies also, e.g.,
  1227.  
  1228. ---------------------------------------------
  1229.                     Fig. 8
  1230.         (Variable stacked-deep normal innies)
  1231. ---------------------------------------------
  1232. Line#
  1233.   1     The Side Door:dirx.lst:in
  1234.   2     max\:Fun stuff for you
  1235.   3     max\file\:More fun stuff
  1236.   4     max\file\bbsstuf:BBS stuff
  1237. ---------------------------------------------
  1238.  
  1239.         See how I have different subdirectories-deep locations for my
  1240.         dirx.lsts?  Keep this in mind if you encounter a CD such as this.
  1241.         Remember, though, they are all named "dirx.lst."  What if they
  1242.         are not??
  1243.  
  1244. --------------------------------------------------
  1245.                       Fig. 9
  1246.         (Variable stacked-deep weird-named innies)
  1247. --------------------------------------------------
  1248. Line#
  1249.   1     RAMTEL 10:dirx.lst:IN
  1250.   2     backup\games@squid.lst:Apogee Games
  1251.   3     backup\001\arcane@DIR1:Arcanum  <---- description for user of subdir
  1252. --------------------------------------------------
  1253.  
  1254.         Note that in line 2 (Fig. 9) I only have 2 subs deep to get to
  1255.         my squid.lst (DSP) for that files display structure that is living
  1256.         "in."  For the 3rd line, I have 3 subs deep to get to the DIR1
  1257.         display file list.  Therefore, I can go differing subdirectories
  1258.         deep on a CD to look for "innie" files-display structures (DSPs) and
  1259.         their associated "in" files and identify the DSP's by name.
  1260.  
  1261.         ========================================
  1262.         COMBINATIONS
  1263.         ========================================
  1264.  
  1265.         Combo Innies
  1266.  
  1267.         You have a CD that has some of the files display structures 2
  1268.         levels deep, some only one deep, some 3 deep and some have
  1269.         3 files descriptions (3 DSPs) in some single subdirectories each of
  1270.         which only describe part of the files that are in the entire
  1271.         subdirectory...  eeeek!  Now what?  No problem!
  1272.  
  1273.         -----------------------------------------------------------
  1274.                                 Fig. 10
  1275.         -----------------------------------------------------------
  1276.  
  1277.         CATBOX CD:dirx.lst:IN
  1278.         fleas\chiggers\gnats\flies@Stimpy.lst:CATS on the Roof
  1279.         fleas@rin.LST:Chihuahua Dancing
  1280.         fleas@hairball.lst:Hairballs for you
  1281.         fleas@notnow.lst:The Great Escape
  1282.         fleas\bees\bats\rats\mats\scats\fats@insect.lst:Zowee Bugs!
  1283.  
  1284.         -----------------------------------------------------------
  1285.  
  1286.         The above combo will allow us to look IN on different subs-deep
  1287.         levels for different named DSP's.  These above special cases
  1288.         of subs-deep, normal vs weird named DSP, INnies ought to catch
  1289.         about 99.5% of your CD cases.
  1290.  
  1291.         -------------
  1292.         Combo Outties
  1293.         -------------
  1294.  
  1295.         Yeah, but I want to put 'em on my Hard Drive and bury 'em in
  1296.         subdirectories on my HD.  Can you do that?  Sure.
  1297.  
  1298.         --------------------------------------------
  1299.                             Fig. 11
  1300.         --------------------------------------------
  1301.  
  1302.         IBM Lantastics:dirx.lst:out:car\file\0023:F:
  1303.         001N.LST:001N:LANS
  1304.         NETFUN.LST:002N\077A\BOX2:Networks of fun
  1305.         003N.LST:003N\088A:Networking games
  1306.         COWSOUP.LST:004N:Nets & OS/2
  1307.         005N.LST:005N\099A:Net Arcanum
  1308.  
  1309.         --------------------------------------------
  1310.  
  1311.         Translating the above situation, Living OUT on F:\car\file is
  1312.         a collection of DSP's that are different named, describing
  1313.         subdirectories on the CD that are several subs deep off the
  1314.         main drive letter.  Some are only 1 sub deep; some are 3 subs
  1315.         deep on the CD.
  1316.  
  1317.         You get the picture.  Don't you wish that CD makers would figure
  1318.         a standard way of indexing their products?!?  :*)
  1319.  
  1320.  
  1321. Let's recap before we move on to step 6 (so you don't get totally mind-
  1322. boggled :*).  It really is much simpler to DO then to explain making menu
  1323. control LST files, so take heart!  Most cases these days tend to be CD's
  1324. that are already set up for easy BBS display (if they are shareware).
  1325.  
  1326. So far you have:
  1327.  
  1328.         o       seen how to configure the *.CNF and *.CFG files
  1329.         o       seen how to get the *.BAT set up (and the *.BBS/*.MEC
  1330.                 if your Maximus)
  1331.         o       seen how to set up CD control menu *.LST files for all
  1332.                 kinds of circumstances, i.e., innies, outties, and notties.
  1333.         o       seen how to work with files.bbs, dirx.lst, or even *.*
  1334.                 display file lists.
  1335.         o       talked about "double outties" and advanced configurations
  1336.         o       talked about a utility (FLYDIRX.EXE) for making skeleton
  1337.                 files-display structures for CDs that have none.
  1338.         o       talked about incorporating your HD (Drive C:) and even your
  1339.                 B:\ drive for files use via CDMX2DOR.
  1340.         o       talked about normal- and weird-named innies.
  1341.         o       discussed variable-depth innies
  1342.         o       discussed combination innies and combination outties
  1343.  
  1344. =============================================================================
  1345. [6.0]   Now you'll have to edit the file called CDSONLIN.LST to include
  1346.         your *.LST menus of your CD's.  This file looks so:
  1347.  
  1348. ------------------------------------------
  1349.                 Fig. 12
  1350. -------- excerpt of CDSONLIN.LST ---------      Line #
  1351. PowerPak '92,30,ppcbob.lst,OK,D:,*                 1
  1352. NightOwl 8,50,no8cbob.lst,OK,E:,nite8ok.nam        2
  1353. PowerBox v1.00,30,pbcbob.lst,OK,G:,*               3
  1354. Pier 1,30,p1cbob.lst,-,F:,pier1ok.nam              4
  1355. NightOwl 7,30,no7cbob.lst,-,H:,*                   5
  1356. NightOwl 6,10,no6cbob.lst,-,I:,*                   6
  1357. SuperShare v1.00,50,sscbob.lst,-,M:,suprshok.nam   7
  1358. -------- end of excerpt ------------------
  1359.  
  1360.         CDSONLIN.LST structure
  1361.  
  1362.         NOTE: your CD's name cannot exceed 15 characters maximum else
  1363.         the door will not work appropriately.  Stick with something like
  1364.         "PowerPak '92" rather than "PowerPak Online '92 SuperDuper CDROM."
  1365.  
  1366.         Note that each line in Fig. 12 has 6 pieces of data: (1) the CD's
  1367.         name, (2) the CD's security/privlege level, (3) the CD's *.LST file
  1368.         (a directory structure - see below), (4), an OK if it is online
  1369.         and a - if it is not online, (5), the DRIVE: where this CDRom
  1370.         is located, and (6), the special privileger.
  1371.  
  1372.         In the above, you can see I have 3 CD's online and 4 offline.
  1373.         The first 3 are online in drives D:, E:, and G: and the last 4 are
  1374.         offline.  Users may select at will which of the 3 they wish to
  1375.         work with on their own in either drives D:, E:, or G:.  The online
  1376.         drives (D:, E:, and G:) have a security level of 30, 50, and 30,
  1377.         respectively.  A user with a security level of 30 will only see
  1378.         2 of the 3 drives as available to them.  You can see that NightOwl8,
  1379.         Pier1, and SuperShare have a ".nam" file in the special privileger
  1380.         slot and the others just have a "*" in the special privileger slot.
  1381.  
  1382.         -------------------------------------------
  1383.         A Caveat on "special privileged CDs
  1384.         -------------------------------------------
  1385.  
  1386.         What is the special privileger anyway??
  1387.  
  1388.                 The *.NAM files in the special privileger slot above (data
  1389.         item 6 on each line) contains a list of users' names that have
  1390.         access to a disk IF their security level meets the requirement.
  1391.         Others, who's security level meets the requirement for that CD
  1392.         but who's names are NOT in this list will be told by the door that
  1393.         this CD is "offline."  They can't get to the CD even if their
  1394.         security level is sufficient to do so because their name is not
  1395.         in the *.NAM list for that CD.  If you only care to have a CD's
  1396.         access governed by the security level alone, then just have a
  1397.         star (*) in the special privilege slot.  If you want to keep
  1398.         users out of a CD, though they are qualified by security level
  1399.         to see it, then use the .NAM file to control that disk.  ONLY
  1400.         people with adequate security AND their name in the .NAM file
  1401.         for that CD will be able to get into it.  You can call these
  1402.         *.NAM files whatever you please as long as you put that name in
  1403.         the CDSONLIN.LST.
  1404.  
  1405.         ---------------------------------------------------------------
  1406.  
  1407.         Let's look at Line #1 (Fig. 12) graphically:
  1408.  
  1409.         Graphically:
  1410.                       /--- the CD's name
  1411.                     /       /--- a security level of 30
  1412.                   /       /   /--- the CD's *.LST you made in step 5 above.
  1413.                 /       /    /
  1414.               /       /    /        /--- it is online and ready to be used
  1415.         PowerPak '92,30,ppcbob.lst,OK,E:,*
  1416.          +---------------------------/     \
  1417.          |                                   \
  1418.          +-the drive where the CD lives        \--- special privilege slot
  1419.  
  1420.         Here's one that is offline:
  1421.  
  1422.                     /--- the CD's name
  1423.                   /    /--- security level 50
  1424.                 /    /   /--- the CD's *.LST menu
  1425.               /    /   /
  1426.             /    /   /        /--- it is offline
  1427.         Pier 1,50,p1cbob.lst,-,G:,* <------------- accessible to anyone with
  1428.                                 \                    a security level of 50
  1429.                                   \--- if it were online, it would be in
  1430.                                        drive G:
  1431.  
  1432.  
  1433.         Here's some changes so you can see what happens
  1434.  
  1435.                     /--- the CD's name
  1436.                   /    /--- I reduced the security level to 30
  1437.                 /    /   /--- the CD's *.LST menu
  1438.               /    /   /
  1439.             /    /   /        /--- it is now online
  1440.         Pier 1,30,p1cbob.lst,OK,H:,pier1ok.nam <---- accessible ONLY to users
  1441.                                /                     with a security level of
  1442.                                |                     30 AND their name appears
  1443.                                |                     in pier1ok.nam.
  1444.                                 \
  1445.                                   \--- it is online in drive H:
  1446.  
  1447.      The function of this list is to provide you and your users a
  1448.      selection of CD's upon which to work.  You may display some, all, or
  1449.      none of your CD's to users based on their privelege level and whether
  1450.      you put their names in a special privilege list or not.  This
  1451.      privilege/security level is that one which is written in the door.sys
  1452.      file.
  1453.  
  1454.      To initiate the special privilege controls, you have to have a file
  1455.      with names in it; if not special privilege controls, then just have a
  1456.      "*" in that slot.  Note: it MUST be an asterisk/star there if no
  1457.      special privilege controls are used for a CD.
  1458.  
  1459.      ------------------------------------------------------------
  1460.      Leave no blank lines at the end of any of the configuration
  1461.      files you create yourself or edit else it is likely that you
  1462.      will get an "Illegal function" error.
  1463.      ------------------------------------------------------------
  1464.  
  1465.      Maximus BBS-only sysop information:
  1466.  
  1467.      If you are a Maximus BBS sysop, this privelege level is set in the
  1468.      cdmx2dor.mec/.bbs files included herein.  If you are not a Maximus
  1469.      BBS software sysop then your door.sys will write a privelege level
  1470.      for you based on your own particular software.
  1471.  
  1472.                   CDMX2DOR.MEC/BBS defaults for Maximus users
  1473.                Maximus setup on privilege levels/security levels
  1474.                      Privilege Level         Security Value
  1475.                          Sysop                    100
  1476.                      AsstSysop                     80
  1477.                          Clerk                     70
  1478.                          Extra                     60
  1479.                        Favored                     50
  1480.                     Privileged                     40
  1481.                         Worthy                     35
  1482.                         Normal                     30
  1483.                        Limited                     25
  1484.                       Disgrace                     20
  1485.                           Twit                      5
  1486.  
  1487.      You can change these security values if you wish, but, if so, then
  1488.      you will need to change your CDMX2DOR.MEC and re-MECCA.
  1489.  
  1490.      All BBS Systems sysop information:
  1491.  
  1492.      You may have up to 34 CD's online with this door from which your users
  1493.      may select.  The following lines have a particular structure that you
  1494.      must follow to make the door work appropriately.  An explanation of
  1495.      the structure follows by example:
  1496.  
  1497.                 /---- CD's name.  Keep it at 12 or less characters, please.
  1498.               /           /--- User's privelege level
  1499.             /           /       /---CD's control menu
  1500.           /           /       /    /--- online status "OK" for online, "-"
  1501.        /           /       /    /        for not online.
  1502.     PowerPak '92,40,ppcbob.lst,-,D:* <--- no special privilege controls
  1503.                                    \
  1504.                                      \--- CD's actual drive location
  1505.                                           (put the : at the end, e.g.,
  1506.                                            C:, X:, Q: or whatever)
  1507.  
  1508.      Explanation: The CD is PowerPak '92 and users with a security level
  1509.      of 40 or greater have access to it.  The CD's control menu is
  1510.      ppcbob.lst (see this one and others in this archieve), it is currently
  1511.      offline, but would, if online, be in Drive D:  There is no special
  1512.      access required via a *.NAM file to get at this CD, you only need to
  1513.      have the right security level.
  1514.  
  1515.      Changing your door' actions on this list is as easy as using a text
  1516.      editor to change this list.  I can increase/decrease security for
  1517.      a particular CD by just changing the security/privilege level value
  1518.      that a user must have as a minimum to access it via using Qedit or
  1519.      whatever text editor, OR, by initiating special privilege controls
  1520.      an putting their name in a *.NAM list for that particular CD.
  1521.  
  1522.      I can change the online/offline status by changing the "-" above to
  1523.      an "OK" and, voila, it is now online.  I can change the actual drive
  1524.      that the CD lives in in similar fashion.  In less than a minute I can
  1525.      bring an offline, high-security-level CD on drive G: to online, low-
  1526.      security-level CD on drive D: by just using a text editor and changing
  1527.      a very few things.
  1528.  
  1529.      Note that if you just have one (1) CD drive, you can only have one
  1530.      CD list available online for users <g>.  This door will unfortunately
  1531.      not physically remove and replace your CD's in your drive :*)  If you
  1532.      have 34 CD Drives, then you can have 34 CD's online... one per drive.
  1533.      You can also put your HD files on CDMX2DOR if you like so a user
  1534.      would have full access to ALL your files everywhere via CDMX2DOR.
  1535.  
  1536.         ======================
  1537.         Support up to 34 CD's
  1538.         ======================
  1539.  
  1540.         You may have up to 34 CD's online if you want to <g>.  Each CD
  1541.         needs a line in the CDSONLIN.LST.  Edit your CDSONLIN.LST
  1542.         as necessary.  Each CD requires a *.LST menu as described in
  1543.         step 5 above (innies, outties, notties, etc.).  You can call your
  1544.         *.LSTs whatever you please but you must tell CDMX2DOR what they
  1545.         are via CDSONLIN.LST.  Just for novices: You have to have a
  1546.         different drive for each list for each drive you have online.
  1547.         You can't have 4 drives online with only one CD driver :*)
  1548.         unless you're REAL QUICK in changing CD's (joke).
  1549.  
  1550. =============================================================================
  1551. [7.0]   Well, now, after we've gotten this far, the rest is pretty
  1552.         simple.  CDMX2DOR needs to have access to the following
  1553.         files to have it work rightly:
  1554.  
  1555.         (a)     PKZIP.EXE
  1556.         (b)     PKUNZIP.EXE
  1557.         (c)     DSZ.COM
  1558.  
  1559.         Put these on your PATH for best results.  You can get these
  1560.         files off of almost any BBS if you don't already have them.
  1561.         (I know for sure you've got pkunzip.exe :-))  Be sure to
  1562.         use DSZ.COM and not DSZ.EXE.  These files are for online
  1563.         unzipping and viewing files, for putting your BBS Add in out-
  1564.         going files, and for download, of course.  BE SURE TO PUT
  1565.         YOUR BBS ADVERTISEMENT IN YOUR SCRATCH/TEMPORARY SUBDIRECTORY
  1566.         (you will specify this subdirectory in CDMX2DOR.CFG).  I've
  1567.         included NCB.ADV as an example BBS advertisement.
  1568.  
  1569.         You will want to adjust your autoexec.bat with DSZ statements
  1570.         so as to get it to write a DSZ.log for you.  In my autoexec.bat
  1571.         I have the following for DSZ:
  1572.  
  1573.         set dszlog=c:\max\log\dsz.log
  1574.  
  1575.         You will want to adjust this above line to suit your system.
  1576.  
  1577.         Now copy your BBS advertisement file, e.g., NCB.ADV into your
  1578.         scratch directory (as configured in CDMX2DOR.CFG) so this can
  1579.         be appended to outgoing zips.
  1580.  
  1581. =============================================================================
  1582. [8.0]   Well....  if you've done everything above appropriately then
  1583.         it is now time to let the users have a go at it.  You can try
  1584.         it out on your own offline if you have the first line in your
  1585.         DOOR.SYS set to COM0: , making sure your ANSI driver is loaded,
  1586.         and then, at the prompt, type:
  1587.  
  1588.         cdmx2dor cdmx2dor.cnf
  1589.  
  1590.         When you are on locally, the door will not do the DSZ downloading
  1591.         nor will it add BBS Advertisements to files.  This only happens
  1592.         when a user is on.  However, you will see locally what the user
  1593.         will see remotely when they are on it.  When users are running
  1594.         it, the display will appear to mess up when pkzip and dsz are
  1595.         doing their thing but this is only on the local screen so don't
  1596.         get worried - users don't see this stuff.   Running it locally
  1597.         will let you see what the users will see (i.e., no distortions
  1598.         by pkzip and dsz).
  1599.  
  1600.         You will note that if you are unregistered, there is a message
  1601.         to that effect on starting the door and there will be a brief
  1602.         delay for users on the main menu along with a message that
  1603.         the door is not registered.  You can fix that <g> if you register
  1604.         the door and get your KEY which will turn off the delays and
  1605.         the unregistered messages.  See below for registration information.
  1606.  
  1607. =============================================================================
  1608. [9.0]   OK, I got it setup and I saw it locally and it looks good.  What's
  1609.         all the files and stuff?
  1610.  
  1611.         It is likely that you'll find a few extra *.lst, *.nam, or *.bats
  1612.         in this archieve that are not listed above.  They are just various
  1613.         sample files that will help you in configuring/controlling CDMX2DOR.
  1614.         If it is not listed above, take a peek at the file and see what it
  1615.         is and how it might help you in setting things up.
  1616.  
  1617.         (a)     CDMX2DOR will write a NGDL.LOG recording user's downloading
  1618.                 activity.  All files successfully transferred will have
  1619.                 a record of same made here.  You'll know who downloaded
  1620.                 what, when, and with what protocol.
  1621.  
  1622.         (b)     BADSEND.LST is a record of all unsuccessful transfers.
  1623.                 You can find out who is screwing up.
  1624.  
  1625.         (c)     USERS.DAT is a record of who has been on the door lately
  1626.                 and keeps track of how many Kbytes a body downloaded
  1627.                 today.  It will prevent a user from downloading more than
  1628.                 the daily Kbyte allotment in a given day.  This record
  1629.                 also gives you info on who was in the door and when
  1630.                 they were last on the door.
  1631.  
  1632.         (d)     LOCK.LST is a file where you put the names of the
  1633.                 files you'd like to control users' access to particular
  1634.                 files.  The format of lock.lst entries is as follows:
  1635.  
  1636.                 filename.ext, key$
  1637.  
  1638.                                   /- file to lock
  1639.                                 /
  1640.                               /        /-key for this file
  1641.                 example: cindy.gif, foxxy
  1642.  
  1643.                 If you choose to prevent users from ever downloading
  1644.                 a particular file, then just put the filename.ext and
  1645.                 leave out the "," and have no key for it.  For example
  1646.                 a totally forebidden file entry in lock.lst would appear
  1647.                 as follows:
  1648.  
  1649.                 filename.exe
  1650.                                   /- file forbidden to all users and
  1651.                                 /         there is no key.
  1652.                               /
  1653.                 example: cindy.gif
  1654.  
  1655.                 Some good CD's have GIFS on them that are near-to-porn
  1656.                 and prevent family-oriented boards from using them.  Any
  1657.                 file name you put in here without a key will be forbidden
  1658.                 and users won't be able to download it.  If you don't want
  1659.                 to forbid anything, then don't enter any filenames or just
  1660.                 have an empty file.  Note that any filename placed in
  1661.                 this list WITHOUT A KEY is inaccessible to all your users.
  1662.  
  1663.                 If you'd like some of your users to get access to a file
  1664.                 but prevent others from downloading that file, then put
  1665.                 the filename.ext in the list and have a key to it.  You
  1666.                 would then share or not share this key with whomever you
  1667.                 choose.  Those that have the key can process the file for
  1668.                 viewing/downloading -- those that don't can't.  You can
  1669.                 change this key with a standard text-editor at will, so
  1670.                 you can re-lock to formerly un-locked users by simply
  1671.                 changing the key.
  1672.  
  1673.         (e)     CDTEMP.LST is a file that the user will employ to
  1674.                 access your CD's.  Up to 34 CD's are supported via
  1675.                 CDMX2DOR.  The file is volatile and changes based
  1676.                 on users activity.
  1677.  
  1678.         (f)     FIXMAX.EXE is a utility for MAXIMUS (TM) BBS sysops
  1679.                 that will automatically adjust Max's users.bbs files
  1680.                 for you.  If you're not using Maximus then this file
  1681.                 does nothing.  This file must be in CDMX2DOR's
  1682.                 subdirectory.
  1683.  
  1684.         (g)     FLYDIRX.EXE is a utility for making dirx.lst/files.bbs
  1685.                 type structures for your CD's that have no dirx.lst/
  1686.                 files.bbs's on them or for making dirx.lsts for your
  1687.                 writeable drives.     With this utility you can take
  1688.                 virtually any CD and run it on CDMX2DOR after you've
  1689.                 got the display-file structures (dirx.lst/files.bbs)
  1690.                 made.  FLYDIRX.EXE will make these structures for you
  1691.                 and name them by the name of the subdirectory they
  1692.                 came from, e.g., 001A.LST, or BOOKS.LST or whatever.
  1693.                 You can then use these *.LST file structures on your
  1694.                 HD so that a user can download anything from your
  1695.                 CDs.  If you have a situation like this, just run
  1696.                 FLYDIRX.EXE and follow instructions.  Use a text editor
  1697.                 to edit the resulting products of FLYDIRX.EXE to your
  1698.                 liking (e.g., adding file descriptions and cleaning
  1699.                 up the structure to suit your needs).
  1700.  
  1701.                 In this case, where your CD's have no files-display
  1702.                 structures, you would have a "Special Case" so see
  1703.                 that information above for assistance.
  1704.  
  1705.                 See FASTFREQ.BAT as an associate of flydirx.exe.
  1706.  
  1707.                 KEUFLER.EXE is a type of FLYDIRX.EXE that is for the
  1708.                 purpose of dealing with odd-structured files.bbs files'
  1709.                 description importation into newly created dirx.lsts.
  1710.  
  1711.         (h)     DIRXMAKE.EXE is a utility that will make dirx.lst structures
  1712.                 from your files.bbs files.  You need to place the name of
  1713.                 the subdirectories where your files.bbs's live on your
  1714.                 c: drive in DIRXMAKE.CFG as well as the full path to the
  1715.                 subdirectory where all the subdirectories where the
  1716.                 files.bbs's live.  See DIRXMAKE.CFG for more information
  1717.                 on running this utility.  Please refer to the control-
  1718.                 menu *.LST file called SSCBOB.LST as an example of how
  1719.                 to set up your HD (C:\bbs\files drive) to run through
  1720.                 CDMX2DOR.
  1721.  
  1722.                 DIRXMAKE will make and place dirx.lsts in each of your
  1723.                 files.bbs's subdirectories on your HD, so your HD is
  1724.                 configured as an "dirx.lst innie."  The reason for DIRXMAKE
  1725.                 exists in that oft times files.bbs files have no file
  1726.                 size/date stamp in them (e.g., Maximus is like this)
  1727.                 and therefore makes these type of files.bbs files
  1728.                 unusable to CDMX2DOR.  DIRXMAKE, however, translates
  1729.                 these type of files.bbs's into dirx.lsts that can be
  1730.                 used by CDMX2DOR.  DIRXMAKE will incorporate your
  1731.                 already-existing files descriptions (as found in
  1732.                 files.bbs files) into the new dirx.lst files.
  1733.  
  1734.         (i)     INSTFREQ.EXE and FASTFREQ.BAT
  1735.  
  1736.                 Instfreq.exe will quickly copy any files meeting a wild-
  1737.                 card parameter from any drive to any drive.  FastFreq.BAT
  1738.                 is an example of employing INSTFREQ and FLYDIRX together
  1739.                 to quickly copy a set of files meeting a definition to
  1740.                 a particular drive/subdirectory and then quickly making
  1741.                 a dirx.lst of those files copied.  This utility comes
  1742.                 in handy if a user requests certain files and you want
  1743.                 them to get at them immediately.  For example, a user
  1744.                 requests QModem files...  you just edit your FASTFREQ.BAT
  1745.                 appropriately and then run it and the user now has these
  1746.                 files in a preconfigured download area called "Requests."
  1747.                 They now have immediate access to those files via
  1748.                 CDMX2DOR.  The "Request" area might have a special
  1749.                 privilege control file on it where ONLY this particular
  1750.                 user's name is.  Only HIM and no one else can then get
  1751.                 these requested files.
  1752.  
  1753.         (j) A Special Note on security:
  1754.  
  1755.                 CDMX2DOR could give you these levels of security on
  1756.                 your CDs/files:
  1757.  
  1758.                 Example of super-strict security
  1759.  
  1760.                 o   a user has to have a security level of, say 40, to
  1761.                     even know that a particular CD exists on the system.
  1762.                     Assume he does have a security level of 40 and sees
  1763.                     that a particular CD exists.  You set this one up
  1764.                     with a special privilege file.  He must have his name
  1765.                     in the special privilege *.NAM list for that CD else it
  1766.                     will appear to him that it is offline.  Assume he
  1767.                     has his name in the list and the CD is online for him.
  1768.                     He must now know the keyword for each different file
  1769.                     that he finally gets to see
  1770.  
  1771.                     In this above example, a user would need to pass 3
  1772.                     levels of security to access a given file.
  1773.  
  1774.                 Example of lowest-level security
  1775.  
  1776.                 o   a CD has a security level of 5, no special privilege
  1777.                     file, and no keys.  Virtually anyone gets access to
  1778.                     every file on that CD.  Everyone knows it is there.
  1779.  
  1780. =============================================================================
  1781. [10.0]  Still Problems???
  1782.  
  1783.         If you've still not gotten it going correctly after double
  1784.         checking, then drop me some e-mail at 1:232/31 or call my
  1785.         board at (309) 797-6027.  Here's a few tips just in case:
  1786.  
  1787.         It shows garbage and no colors.  Why?
  1788.  
  1789.                 Do you have ANSI running?  Did you do a DVANSI if
  1790.                 you are running DV/QEMM?
  1791.  
  1792.         It barfs and says "illegal function call."  Why?
  1793.  
  1794.                 You have not got it configured correctly.  Please
  1795.                 recheck your configs.  The problem most likely
  1796.                 rests in your CD *.LST files not being set up
  1797.                 correctly.  Check to be sure your configuration
  1798.                 files, cd-menu-control files, and other configuration
  1799.                 files do NOT have any blank lines at the end of
  1800.                 them.  If they do, then the program will die
  1801.                 and say "Illegal function call."  Remember, NO
  1802.                 empty lines at the end of any configuration file
  1803.                 (or for that matter, at the end of any file that
  1804.                 CDMX2DOR allows you to setup or edit).
  1805.  
  1806.  
  1807.         I can't figure out how to configure my CD!  What now?
  1808.  
  1809.                 Send me a copy of:
  1810.  
  1811.                 (a) your CD's directories
  1812.                 (b) your CDSONLIN.LST
  1813.                 (c) your menu-control *.LST file
  1814.  
  1815.                 I'll have a go at it and put the results in a
  1816.                 file that I will put on HOLD for you to pick up
  1817.                 via a F'Req.  I HAVE to have a COMPLETE listing
  1818.                 of your CD's directories, you COMPLETE CDSONLIN.LST,
  1819.                 and your COMPLETE menu-control *.LST file to be
  1820.                 able to figure out what you are trying to do.  ALSO
  1821.                 tell me if you are wanting it to be an "innie" or
  1822.                 and "outtie."  After a few days, call my system
  1823.                 and pick up your configs; they will be in a file
  1824.                 named thusly:
  1825.  
  1826.                                  Yourlastname.INF
  1827.  
  1828.                 so F'Req that particular file on your return call to
  1829.                 get your info.
  1830.  
  1831.         I get a QEMM exception 13... what gives?
  1832.  
  1833.                 You probably don't have it configured correctly.
  1834.                 Again, the problem is likely in your CD Menu
  1835.                 control *.LST files.  Maybe you don't have
  1836.                 enough memory in this DV window??
  1837.  
  1838.         The door runs for a while and then gives me some really
  1839.         weird looking hi-ansi/IBM characters and then seems to
  1840.         die.  What gives?
  1841.  
  1842.                 You have likely either (1) gotten your CD's name
  1843.                 in your CDSONLIN.LST too long (keep it around
  1844.                 15 characters maximum), or (2) gotten your
  1845.                 menu-control lists inappropriately configured.
  1846.  
  1847.         I can't get it to run locally.  How come?
  1848.  
  1849.                 Do you have a door.sys in CDMX2DOR's directory?
  1850.                 Is the first line set to COM0:  ??  Gotta have
  1851.                 both to run locally.  Got your ANSI driver
  1852.                 running?
  1853.  
  1854.         User's see garbage when they get on and loose control of
  1855.         the program.  How come?
  1856.  
  1857.                 If you are using Maximus it is likely due to
  1858.                 the fact that you've not set the "-s" parameter
  1859.                 (lockedbaud rate) in your spawnbbs.bat file, e.g.,
  1860.                 Max Max -b%2 -p%3 -t%4 -s38400
  1861.  
  1862.                 If you are not using Maximus it is due to not
  1863.                 telling the door.sys that the port is locked.
  1864.                 Adjust as necessary.
  1865.  
  1866.                 Do you have your port locked at a fast baud
  1867.                 (if you are using a high speed modem)?  If not,
  1868.                 then lock it.
  1869.  
  1870.                 Gotta have CDMX2DOR start up with COM2 if users
  1871.                 are using COM2.  Don't expect a COM1 startup of
  1872.                 CDMX2DOR to handle callers on COM2.  Check your
  1873.                 CDMX2DOR.CNF against your DOOR.SYS.  Door.sys
  1874.                 first line should read COM2: for com2 and the
  1875.                 CDMX2DOR.CNF should have 02F8 in the Hexport
  1876.                 line.  Adjust as necessary depending on your
  1877.                 port/IRQs.  Got your IRQs set up correctly?
  1878.                 Gotta have that else it won't send out the
  1879.                 right comport (if you are using any port higher
  1880.                 than COM2).
  1881.  
  1882.         It doesn't lock out users from downloading a file I had set it
  1883.         up to have a key.  How come?
  1884.  
  1885.                 Did you have the filename and key in your lock file?
  1886.  
  1887.         A user is online and, bam!, the are sudden back in the BBS with
  1888.         no apparent warning.  What happened?
  1889.  
  1890.                 CDMX2DOR encountered some type of error that would
  1891.                 have crashed the program but rather than to do that,
  1892.                 it made note of the error in CDMX2DOR.ERR and then
  1893.                 kicked the user back to the BBS.  It is likely that
  1894.                 you have misconfigured something.  Check your CDSONLIN.LST
  1895.                 and your menu-control structures to be certain they are
  1896.                 correct.  Look at CDMX2DOR.ERR:  if it says something
  1897.                 about "write protection" it is likely that you told it
  1898.                 to find something that is not there, e.g., are your
  1899.                 CDSONLIN.LST entries REALLY there...  you aren't sending
  1900.                 CDMX2DOR out to look at a wrong CD by accident are you?
  1901.  
  1902.         It won't forbid my file I told it to.  Why not?
  1903.  
  1904.                 Did you enter the filename.ext in lock.lst?  Make
  1905.                 sure!
  1906.  
  1907.         It won't download files to users.  Why?
  1908.  
  1909.                 Is DSZ.COM on your PATH?  IF not you need to
  1910.                 get it there.  Is your port locked correctly?  Does
  1911.                 the remote user have his act together?  Is your
  1912.                 BBS Advertisement in your scratch subdirectory?
  1913.                 Is PKUNZIP on your PATH?  Are you using a recent
  1914.                 version of DSZ.COM?  Should have a DSZ.COM that
  1915.                 is at least a 1991 edition.
  1916.  
  1917.         It quits and says there is a "Path not found" error.  What's
  1918.         up?
  1919.  
  1920.                 You have either not configured your CDSONLIN.LST correctly
  1921.                 or have not configured your control-menu *.LST files
  1922.                 correctly.  Double check these to be sure you've specified
  1923.                 the right drives and paths.  If the problem persists,
  1924.                 drop me some Email with the address location of the error
  1925.                 in module CDROMBOB (or perhaps in module CDBOMB).
  1926.  
  1927.         It won't allow users to view zips online.  Why?
  1928.  
  1929.                 PKZIP.EXE and PKUNZIP.EXE are likely
  1930.                 not on your PATH.  Put them there.  If you don't
  1931.                 have these on your PATH then don't expect things
  1932.                 to work appropriately.  Do you have at least 750 Kbytes
  1933.                 available diskspace on your HD for unzipping files?
  1934.                 Users might want to view a big file and if there's no
  1935.                 room for unpacking it, there may be problems.
  1936.  
  1937.         It won't add my BBS comments to outgoing BBS files.  Why?
  1938.  
  1939.                 Gotta put your BBS.ADV file in your scratch/temporary
  1940.                 subdirectory.  Gotta have PKZIP.EXE on your path.
  1941.  
  1942.         It won't work right on multinode.  Why?
  1943.  
  1944.                 Have you adjusted your HEX port address (line 5)
  1945.                 in your *.CNF files?  Are you starting CDMX2DOR.EXE
  1946.                 with the right command line *.CNF in your *.BAT file?
  1947.                 Have you adjusted your IRQ # (line 4 and 6) in your *.CNF
  1948.                 files, e.g., in CDMX2DOR.CNF?  You HAVE to make sure
  1949.                 your HEX port addresses and your IRQs are rightly
  1950.                 configured for proper operation in a multinode
  1951.                 environment.
  1952.  
  1953.         I'm a MAXIMUS BBS sysop and it won't work.  Why?
  1954.  
  1955.                 Did you SILT Maximus after making the changes in your
  1956.                 FILE section of your MENUS.CTL file?  Did you edit
  1957.                 CDMX2DOR.MEC to have the door.sys written in CDMX2DOR's
  1958.                 subdirectory?  Did you MECCA your CDMX2DOR.MEC after
  1959.                 making the changes?  Did you leave the "@" character
  1960.                 after the [xtern_dos] in your CDMX2DOR.MEC file?  Gotta
  1961.                 have it.
  1962.  
  1963.         It won't update Maximus's USERS.BBS.  Why?
  1964.  
  1965.                 Did you tell it where to find your LASTUSER.BBS correctly?
  1966.                 Gotta do it.  Do ya have the "@" in your CDMX2DOR.MEC
  1967.                 file right after the [xtern_dos] to start the door?
  1968.  
  1969.         It won't lock out certain files from user download.  Why?
  1970.  
  1971.                 Do you have a LOCK.LST in CDMX2DOR's home directory?  If
  1972.                 you want a lockout, you have to have LOCK.LST.  If you
  1973.                 want some users to get access to this file, then you
  1974.                 HAVE to have a comma and a key$ after the filename.exe.
  1975.                 If you don't have a key, DON'T have a comma!
  1976.  
  1977.  
  1978.         A last word on installation:
  1979.  
  1980.                 You have to fix cdmx2dor.cnf, cdmx2dor.cfg, cdsonlin.lst,
  1981.         cdmx2dgo.bat, and make your cd menu-control *.lst files to get
  1982.         the door working appropriately.  Make sure you've done all these
  1983.         changes.
  1984.  
  1985.         Flow of files in running the door:
  1986.  
  1987.                 Your users activate a command off of your BBS to start
  1988.         the door (a bat file if not Maximus or a BBS file if Maximus),
  1989.         this procedure writes a door.sys file that must end up in the
  1990.         subdirectory where CDMX2DOR exists and also starts the door.
  1991.         CDMX2DOR reads its *.cnf file and starts up based on the parameters
  1992.         contained in its *.cnf and *.cfg files.  If it is not going out
  1993.         the port as it should, check your HEXport addressing and IRQ's
  1994.         as well as your lockport baud settings.
  1995.  
  1996.  
  1997.         If you send your questions to me via netmail, I'll help ya! :-)
  1998.         IF you have found a bug in the program, I will fix it for you
  1999.         and send you a fixed copy on my dime.  Just let me know via
  2000.         NetMail @ 1:232/31 or call my BBS at (309)797-6027 (USA).
  2001. =============================================================================
  2002. [11.0]  What about Multinode operation?  Easy....
  2003.  
  2004.         To run the door multinode, you will need to have a different
  2005.         CDMX2DOR.CNF for each node and make these changes:
  2006.  
  2007. ------------------------------------------
  2008.                   Fig. 13
  2009. -------------- *.CNF excerpt -------------                          LINE #
  2010. c:\cdbob                                                               1
  2011. New Century BBS                                                        2
  2012. 0                                                                      3
  2013. 3                                          <--- this line (see below)  4
  2014. 02F8                                       <--- this line (see below)  5
  2015. 3                                          <--- this line (see below)  6
  2016. cdmx2dor.cfg                               <--- this line (see below)  7
  2017. --------------- end of file --------------
  2018.  
  2019.         The "02F8" line (line 5) is the Hex address for COM2. The "3" line
  2020.         (line 4 and 6) is the IRQ number for COM2. Here is a list of other
  2021.         settings for other ports and IRQ's:
  2022.  
  2023.         Here's a chart with the STANDARD IRQs
  2024.         and addresses for the PS/2s and IBM PCs:
  2025.                                 Non PS/2
  2026.                 Com port       IRQ     Address     CDMX2DOR address
  2027.                    1             4       &H3F8          03F8
  2028.                    2             3       &H2F8          02F8
  2029.                    3             4       &H3E8          03E8
  2030.                    4             3       &H2E8          02E8
  2031.                   5-8            4       &H3F8          03F8
  2032.  
  2033.                                 PS/2
  2034.                 Com port       IRQ     Address
  2035.                    1             4       &H3F8          03F8
  2036.                    2             3       &H2F8          02F8
  2037.                    3             3       &H3220         3220
  2038.                    4             3       &H3228         3228
  2039.                    5             3       &H4220         4220
  2040.                    6             3       &H4228         4228
  2041.                    7             3       &H5220         5220
  2042.                    8             3       &H5228         5228
  2043.  
  2044.         Set your HEX address's and IRQ's for each different node
  2045.         appropriately based on this information.
  2046.  
  2047.         Line 4 of the configuration file is the IRQ for the port.
  2048.         Line 5 of the configuration file is the Base Address for the port.
  2049.  
  2050.         If the user is using COM 1 or COM 2, then you may enter
  2051.         a zero (0) on both of these lines, as the default port
  2052.         assignments are always used for COM 1 and COM 2.
  2053.  
  2054.         The IRQ (line 4) must be in the range of 1 - 7.
  2055.     
  2056.         The Base Address (line 5) must be a Hexadecimal number in the
  2057.         format of:
  2058.  
  2059.         02E8
  2060.         03E8
  2061.         etc.
  2062.  
  2063.         Clear enough? :-)
  2064.  
  2065.         Note that DSZ may use some odd HEXPort addresses and IRQ's
  2066.         for Comports 5 and above...  check the DSZ docs and adjust
  2067.         your Hexport address and IRQ's as is appropriate in these
  2068.         cases (COM 5-8 usually).
  2069.  
  2070.         You can rename CDMX2DOR.CNF to whatever you please so you can
  2071.         have multiple *.CNF files to start the door based on ports/
  2072.         com settings/IRQs.  For example, if you want to run CDMX2DOR
  2073.         in shared mode (all nodes accessing one program), your
  2074.         *.CNF's would be as follows:
  2075.  
  2076.         CDMX2D1.CNF is for node 1
  2077.         CDMX2D2.CNF is for node 2
  2078.         CDMX2D3.CNF is for node 3, etc.
  2079.  
  2080.         These files might look something like this:
  2081.  
  2082.         CDMX2D1.CNF: (For Node 1 on Com2)
  2083.         ------------ sample *.cnf on multinode ---------------------
  2084.         c:\cdbob
  2085.         New Century BBS
  2086.         0
  2087.         3                     <---------------- IRQ 3
  2088.         02F8                  <---------------- HEXport address 02F8
  2089.         3                     <---------------- IRQ 3 (again)
  2090.         cdmx2do1.cfg          <---------------- config data for this node
  2091.         ------------------------------------------------------------
  2092.  
  2093.         CDMX2D2.CNF: (For Node 2 on Com4)
  2094.         ------------ sample *.cnf on multinode ---------------------
  2095.         c:\cdbob
  2096.         New Century BBS
  2097.         0
  2098.         3                     <---------------- IRQ 3
  2099.         02E8                  <---------------- HEXport address 02E8
  2100.         3                     <---------------- IRQ 3 (again)
  2101.         cdmx2do2.cfg          <---------------- config data for this node
  2102.         ------------------------------------------------------------
  2103.  
  2104.         CDMX2D3.CNF: (For Node 3 on Com3)
  2105.         ------------ sample *.cnf on multinode ---------------------
  2106.         c:\cdbob
  2107.         New Century BBS
  2108.         0
  2109.         4                     <---------------- IRQ 4
  2110.         03E8                  <---------------- HEXport address 03E8
  2111.         4                     <---------------- IRQ 4 (again)
  2112.         cdmx2do3.cfg          <---------------- config data for this node
  2113.         ------------------------------------------------------------
  2114.  
  2115.         Make sure to adjust your *.BAT files for each node so that
  2116.         you've incorporated the command-line calling of the differing
  2117.         .CNF files for each node.
  2118.  
  2119.         You get the idea....
  2120.  
  2121.         If your data is NOT different in your *.CFG files across nodes
  2122.         then you may just continue to specify the same filename.  If there
  2123.         is a difference, particular for multinodal MAXIMUS users, then
  2124.         you must make the changes required and have differently named
  2125.         *.CFG files.
  2126.  
  2127.         CDMX2DOR.EXE must be started with a command line which includes
  2128.         the *.CNF filename so you will have to make adjustments as
  2129.         necessary to your *.BAT files that start the door up to incorporate
  2130.         these different *.CNF filenames.  Be sure that SHARE is installed
  2131.         to run all nodes off of one copy of CDMX2DOR.EXE.
  2132.  
  2133.         CDMX2DOR is written such that all files are "shared" files, i.e.,
  2134.         any node can access any file without problem.  To set up CDMX2DOR
  2135.         on multinode, however, I would do the following (just to be safe
  2136.         and sure and, particularly, if I have HD space to spare):
  2137.  
  2138.                 (1)     have a different subdirectory on my HD for
  2139.                         each node used
  2140.                 (2)     have complete copies of CDMX2DOR files in
  2141.                         these different node-specific subdirectories
  2142.                 (3)     edit the *.CNF file for each node to have the
  2143.                         correct Hex port address (see above) for that
  2144.                         node.
  2145.                 (4)     have the *.bat run the right *.CNF for the
  2146.                         specific node.
  2147.                 (5)     have the *.CNF for each node specifying the
  2148.                         correct *.CFG (if different info) for that node.
  2149.  
  2150.         This takes a little more space on your HD, but will absolutely
  2151.         prevent any file-sharing conflicts.  If you're short on HD
  2152.         space then you probably should do it all in one directory in
  2153.         shared mode.  This is entirely up to you, of course.
  2154.  
  2155.         If you're a risk-taker, you might want to try running CDMX2DOR
  2156.         in shared mode...  all on one directory with different *.CNF's
  2157.         starting it based on node...  you're on your own here <g>.  If
  2158.         your short on HD space, you might want to do it this way.  No
  2159.         promises <g>. Do it my way (different copies for each node) and
  2160.         all should be well.  As CDMX2DOR only reads a "door.sys" drop
  2161.         file, you'll likely have to have different copies of CDMX2dOR
  2162.         in diffrent directories.  Future versions will be able to
  2163.         read node-aware dropfiles.
  2164.  
  2165. =============================================================================
  2166.  
  2167. [12.0]  OTHER THINGS you can do with CDMX2DOR... possibilities plus!
  2168.  
  2169.         o       Meeting users' special file requests in an instant.
  2170.  
  2171.                 A user requests certain files and wants them online
  2172.                 right away.  The files are offline.  How to get them
  2173.                 online FAST?  Check out INSTFREQ.EXE, FASTFREQ.BAT, and
  2174.                 FLYDIRX.EXE working in combination...
  2175.  
  2176.                         I edit FASTFREQ.BAT and then run it.  FASTFREQ.BAT
  2177.                         tell INSTFREQ.EXE to:
  2178.  
  2179.                         copy these requested files to a subdirectory on
  2180.                         your harddrive.  FASTFREQ.BAT then runs FLYDIRX.EXE
  2181.                         for that subdirectory that you have previously
  2182.                         configured as an "innie."  You previously made
  2183.                         a control menu for that subdirectory and edited
  2184.                         CDSONLIN.LST with Qedit. (See the reqbob.lst and
  2185.                         its associated entry in CDSONLIN.LST for an example
  2186.                         of this preconfiguration)
  2187.  
  2188.                         Time required to put the user's file request
  2189.                         online using FASTFREQ.BAT is less than 1 minute.
  2190.  
  2191.                         For example.  A user requests these files:
  2192.  
  2193.                         MAPBBS.CNF       1870 01-18-89
  2194.                         MAPDOS.DAT        127 01-18-89
  2195.                         MAPLBDR.BI      18288 10-12-92
  2196.                         MAPLBDR.LIB     69471 10-03-92
  2197.                         MAPLBDR.QLB     43513 10-03-92
  2198.                         MAPLBDR.TXT    122613 10-03-92
  2199.  
  2200.  
  2201.                         (1) I have a preconfigured FILES REquest control
  2202.                             menu set up (e.g., see reqbob.lst this
  2203.                             archieve).  This file is in my CDMX2DOR
  2204.                             subdirectory.  The file looks like this:
  2205.  
  2206.                             Requested Files:dirx.lst:in
  2207.                             backup:"Files" You Requested
  2208.  
  2209.  
  2210.                         (2) I have preconfigured my CDSONLIN.LST to
  2211.                             add this line:
  2212.  
  2213.                             Requested Files,30,reqbob.lst,OK,C:,reqst.lck
  2214.  
  2215.                         (3) I use FASTFREQ.BAT to copy the MAPL*.* files
  2216.                             from a given subdirectory to my "c:\backup"
  2217.                             drive.  FASTFREQ.BAT calls FLYDIRX.EXE and
  2218.                             ultimately makes a dirx.lst for the MAPL*.*
  2219.                             files and puts it in c:\backup.  Make sure
  2220.                             you edit FASTFREQ.BAT appropriately before
  2221.                             running it.
  2222.  
  2223.                         (4) I let the user know his files are ready.
  2224.                             Time required: Less than 1 minute.  User
  2225.                             can now download his request.
  2226.  
  2227.                         (5) If the user left a message and isn't online
  2228.                             when he made the request, I fill his request
  2229.                             as above and put his name in reqst.lck (a
  2230.                             special privilege NAM file.lst) as
  2231.                             follows:
  2232.  
  2233.                             Matt Timion
  2234.  
  2235.                             and it is available ONLY to him.  If I have
  2236.                             several requests, I add the files to my
  2237.                             c:\backup drive using FASTFREQ.BAT, add the
  2238.                             additional user's names to the reqst.lck file
  2239.                             so they can get into the drive, and also put a
  2240.                             special keyword (see LOCK.LST) on the files for
  2241.                             each particular user.  I leave email for them
  2242.                             all telling them their files are ready and their
  2243.                             special access key for their files is XXXXX.
  2244.                             (If you do this procedure, make sure to edit
  2245.                             FASTFREQ.BAT so it does not delete the files
  2246.                             it finds in C:\backup from previous user's
  2247.                             requests).
  2248.  
  2249.         o       Having all my 1.44meg B: floppies formatted for instant
  2250.                 use on the BBS.
  2251.  
  2252.                         (1) copy my BBS's new upload directory's files.bbs
  2253.                             to my B:\subdirectory drive
  2254.  
  2255.                         (2) copy the selected files of my choice to my
  2256.                             B:\subdirectory drive from off the BBS's new
  2257.                             uploads directory
  2258.  
  2259.                         (3) run flydirx.exe as an innie, e.g.,
  2260.  
  2261.                             flydirx.exe b:\subdirectory IN <dlc#>
  2262.  
  2263.                         (4) delete the files.bbs off of B:\subdirectory
  2264.  
  2265.                         (5) make a control-display menu for a B:\subdirectory
  2266.                             innie and include it CDMX2DOR's directory, e.g.,
  2267.  
  2268.                                 TINY B Drive:dirx.lst:in
  2269.                                 TINY:Miscellaneous Stuff
  2270.  
  2271.                         (6) adjust CDMX2DOR's CDSONLIN.LST to include the
  2272.                             b:\tiny subdirectory, e.g.,
  2273.  
  2274.                                 Tiny B,30,tbcbob.lst,OK,B:
  2275.  
  2276.                         (7) From now on, every B: drive that I copy files
  2277.                             to from off of the BBS will have a subdirectory
  2278.                             called the same, e.g., B:\TINY, and I repeat
  2279.                             steps 1-4 with that B: drive.  Steps 5-6 only
  2280.                             need to be done once.
  2281.  
  2282.                         (8) To change the files available to users on the
  2283.                             tiny B: drive, I just change the disk.  That's
  2284.                             it!
  2285.  
  2286.                 I can do all of the above or, alternately, run FASTFREQ.BAT
  2287.                 to do the copying/dirx.lsts for me.  Try out FASTFREQ.BAT
  2288.                 and see what it does.
  2289.  
  2290.  
  2291.         o       Putting EVERY drive online for downloading.  I can use
  2292.                 all my drives for files for user-downloads with CDMX2DOR
  2293.                 e.g., A:, B:, C:, D:...Z:   everything! (and, of course,
  2294.                 all my CDRoms).  Hard-drives, floppies, CD's...  future
  2295.                 versions of CDMX2DOR will have Colorado tape supports.
  2296. =============================================================================
  2297.  
  2298. [13.0]  Well...  I think you've got enough info to get your door running.
  2299.         You can run it right away locally for testing if you've got
  2300.         the CD's I have.  Explore!
  2301.  
  2302.         If you like it and need further help or questions before
  2303.         registration, drop me some netmail.  We've been online since 1991
  2304.         and will be here for the duration :-).  I think you'll be very
  2305.         happy with this door.  Multinodal 34-CD's per node plus your
  2306.         HD files...  not bad, eh?
  2307.  
  2308.         Be sure to have things configured rightly.  There's a bit of
  2309.         busy work with configuration, but it is pretty simple to do and
  2310.         it's all done on a text editor like QEdit.  If you've got the CD's
  2311.         I've got then you'll be up and going in a very short time and
  2312.         there won't be much configuration to do.
  2313.  
  2314.         Make sure when you start the door up in local mode that you add
  2315.         the commandline$, i.e., the *.cnf file name, e.g.,
  2316.  
  2317.         C:\BBS\DR>cdmxdor2 cdmx2dor.cnf
  2318.  
  2319.         else your door will not work.
  2320.  
  2321.         If you've got any suggestions, pass'em along...
  2322.  
  2323. =============================================================================
  2324. [14.0]  Legal stuff
  2325.  
  2326.         The program is guaranteed to do nothing at all except to take up
  2327.         space on your HD.  Your first run of the program is your implied
  2328.         consent to hold no torts, suits, or other legal action against
  2329.         the author for any problems to your hardware or software.  If you
  2330.         do not agree with these terms then don't run the software.
  2331.  
  2332. =============================================================================
  2333. [15.0]  Registration
  2334.  
  2335.         CDMX2DOR has taken a lot of time and money to develop.  Please
  2336.         support the shareware concept and you will see this door continually
  2337.         improved.
  2338.  
  2339.         Thank you for your support!
  2340.  
  2341.         Until you receive your registration "key," CDMX2DOR will show
  2342.         "Please register" messages periodically and will pause occassionally
  2343.         as a reminder to register.  Upon receipt of a key, registered
  2344.         user's versions will no longer have these reminder messages and
  2345.         program pauses.  Additionally, registered users will receive a
  2346.         selection of a number of other doors I have written and will
  2347.         have access to any updated versions of CDMX2DOR via New Century
  2348.         BBS (309)797-6027.  If you find CDMX2DOR useful, please consider
  2349.         registration so as to support further enhancements.  I will need
  2350.         your first and last name and your BBS's name to send you a working
  2351.         key.
  2352.  
  2353.         Your registration now will entitle you to future updates as they
  2354.         are made without cost.  You registration fee is for all future
  2355.         versions of CDMX2DOR which will be made available for download
  2356.         or FReq at New Century BBS 1:232/31 (309)797-6027.
  2357.  
  2358.         The registration fee is $20.00 [cheap!!! :-)] and is payable by
  2359.         cash, check, or money order to:
  2360.  
  2361.         New Century BBS
  2362.         c/o Robert Lee
  2363.         1812 36th Street
  2364.         Moline, Illinois   61265
  2365.         USA
  2366.  
  2367.         Please include the below information in your registration
  2368.         request:
  2369.  
  2370.  
  2371.         Name: (First/Last)____________________________________________
  2372.  
  2373.         Name you are using on your system as the Sysop:
  2374.  
  2375.         Firstname:_____________________ Lastname:_____________________
  2376.  
  2377.         Your key will be based on this firstname/lastname information
  2378.         as it appears on your BBS so please check to be sure your names
  2379.         here match your board names.
  2380.  
  2381.         Street Address: ______________________________________________
  2382.  
  2383.                         ______________________________________________
  2384.  
  2385.         City: ________________________________________________________
  2386.  
  2387.         State: ______________
  2388.  
  2389.         Country: ___________________
  2390.  
  2391.         Zip: ________________ (if applicable)
  2392.  
  2393.         BBS Name: ____________________________________________________
  2394.  
  2395.         Your key will be based on your board's name as it appears on
  2396.         your BBS so please check to be sure your board name you specify
  2397.         here matches your board's name.
  2398.  
  2399.         BBS phone # where you can be reached: ________________________
  2400.  
  2401.         FIDONET Address (Z:N/#) if appropriate: ______________________
  2402.  
  2403.         Where did you get CDMX2DOR? __________________________________
  2404.  
  2405.         Comments/Suggestions: ________________________________________
  2406.  
  2407.         ______________________________________________________________
  2408.  
  2409.         ______________________________________________________________
  2410.  
  2411.  ===========================================================================
  2412. [16.0]  Revisions History
  2413.  
  2414.         - V.099 First BETA Release; several minor revisions along the
  2415.                 way to fix buglets.  Finally resulting in a version
  2416.                 worth putting out for inspection.  Seems to be capable
  2417.                 of looking at all drives.
  2418.         - V.100 Fixed bug in display of CD subdirectories, added several
  2419.                 suggestions from Chris Keufler (1:3402/22) for CD security
  2420.         - V.101 Fixed bug when a HD was full and CDMX2DOR tried to copy
  2421.                 a file from a CD to a fullup HD.  Now reports HD full
  2422.                 and instructs user to alert sysop.  Fixed buglet in
  2423.                 finding location of an ansi file.
  2424.         - V.102 Changed coding for CDMX2DOR's *.CFG file so as to allow
  2425.                 multiple *.CFG's to accomodate multinodal Maximus
  2426.                 situations.  Maximus multinodes must still put separate
  2427.                 copies of CDMX2DOR files into separate directories pending
  2428.                 code changes associated with door.sys naming.
  2429.         -V.103  CDMX2DOR would not handle deep-buried odd-named innies.
  2430.                 This is fixed in version 1.03.  Tweaked the subdirectories
  2431.                 display to allow back/forward intelligence with just an
  2432.                 "ENTER" from the user.  Version also fixed to handle
  2433.                 variable subdirectory-depth finding of "innie" files
  2434.                 display structures.  Added error trapping so that in
  2435.                 the event a problem occurs, program will report error
  2436.                 in file called CDMX2DOR.ERR and then exit normally so
  2437.                 that it does not hang anymore awaiting a sysop "Press
  2438.                 any key."  Updated doc file.
  2439.         - V.104 Fixed the zipviewer to better format the fileschoice
  2440.                 list; cosmetic.  Changed the "please register" display
  2441.                 to only occur at first logon and not after every command.
  2442.                 Will now pause 20 secs. for unregistered users and that's
  2443.                 all.  Added a help section for the "Download files"
  2444.                 section to explain to users what a "protocol" is.
  2445.         - V.105 Fixed the zipviewer to better format the fileschoice
  2446.                 list (again; v1.04 change disturbed numbering; v1.05
  2447.                 fixed this).  Fixed a bug in the zipviewer when unzipping
  2448.                 multiple subdirectories-deep zips to only allow viewing
  2449.                 of first level deep subdirectory textfiles; preventing
  2450.                 viewing of zip -rp packed zips past the first subdirectory.
  2451.                 Serves as a security protect to prevent viewing nested
  2452.                 subdirectory zips.  (Thanks, Samson Luk 6:700/8)
  2453.         - V.106 Fixed a bug in searches and displaying file DSP when
  2454.                 configured on a double outtie with many subdirectories
  2455.                 deep on the HD and on the CD.  (Thanks, again, Samson
  2456.                 Luk 6:700/8).  Also fixed zipviewer so that in a zip
  2457.                 archieve that has been archieved via a zip -rp command
  2458.                 the subdirectories within the zip are not showed to
  2459.                 users at all.  Only the first level files in the zip
  2460.                 are showed to users for possible extraction and viewing.
  2461.         - V.107 Added KEUFLER.EXE utility to archieve.  KEUFLER.EXE will
  2462.                 import the files' descriptions from odd-structured and
  2463.                 non-capitalized files.bbs files into newly made dirx.lsts.
  2464.                 (Thanks to: Chris Keufler 1:3402/22)
  2465.         -V.108  Fixed code in the routines to display subdirectories
  2466.                 available on a particular CD.  Did only display up to 99
  2467.                 subdirectories per control-menu.  V1.08 displays up to
  2468.                 238 subdirectories per control-menu.  Also fixed a bug
  2469.                 that prevented "intelligent" fowarding in the subdirectories-
  2470.                 available routines.  Now will auto-advance through all
  2471.                 available directories with only an "ENTER" and when it
  2472.                 reaches end of list, will automatically go back to start
  2473.                 of list - supporting up to 238 subdirectories.  (Thanks
  2474.                 to: Samson Luk, 6:700/8).
  2475.         -V.109  "Previous page" was broken in the subdirectories selection
  2476.                 menu.  Fixed via deletion of previous/next functions in
  2477.                 lieu of an ENTER looping routine.  (Thanks, Samson Luk,
  2478.                 6:700/8).
  2479.         -V1.10  Improved the Search performance by a speed factor of about
  2480.                 3 using an entirely different algorithm.  (Thanks, Chris
  2481.                 Keufler, 1:3402/22).
  2482.  
  2483.                 Samson Luk (6:700/8) reported that when using Maximus and
  2484.                 a user logs on CDMX2DOR more than once in one session that
  2485.                 the user's time-spent-on-board variable is distorted in
  2486.                 Maximus BBS time accounting.  CDMX2DOR does not change nor
  2487.                 even write to this variable during its operation.  There
  2488.                 may be a bug in Maximus in interpretting re-read lastuser.
  2489.                 bbs files in multiple uses in a single session.  I am at
  2490.                 a loss as to how to fix this as it is not CDMX2DOR's
  2491.                 changing that is distorting Maximus's time-spent-on-board
  2492.                 variable.  All other Maximus variables work as they should.
  2493.  
  2494.                 Changed the naming of the 3 log files that CDMX2DOR keeps so
  2495.                 that their names can be configured by the user via
  2496.                 CDMX2DOR.CFG file.  These files can each be named
  2497.                 differently or all named with the same name for logfile
  2498.                 simplicity. (Thanks Dave DeGear, 1:351/300)
  2499.  
  2500.  ===========================================================================
  2501.     "For God so loved the world that He gave His Only Begotten Son that
  2502.          whosoever believeth in Him shall not perish but shall have
  2503.                         everlasting life." John 3:16
  2504.  ===========================================================================
  2505.