home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 6 / The_Pier_Shareware_Number_6_(The_Pier_Exchange)_(1995).iso / 004 / drmrom13.zip / DREAMROM.DOC < prev    next >
Text File  |  1994-12-04  |  41KB  |  967 lines
  1.  
  2.                                 DreamROM v1.2
  3.                       Copyright (c)1993-94 Andy Stewart
  4.  
  5.                       ALWAYS READ the file WHATS.NEW !!!!!!
  6.  
  7.  
  8.      ***** Welcome to DreamROM, the ULTIMATE CDrom access door! *****
  9.  
  10.    DreamROM works with RemoteAccess, GAP, PCBoard, Wildcat, Spitfire,
  11.    WWIV, TriBBS, RBBS, and any other BBS system that can generate
  12.    a DOOR.SYS, CHAIN.TXT, DORINFO.DEF, CALLINFO.BBS, TRIBBS.SYS,
  13.    SFDOORS.DAT, etc dropfile.  DreamROM is fully multinode compatable.
  14.    DreamROM is also FULLY functional in the unregistered state.  No
  15.    Demo, no crippling, nothing!  The only difference between the
  16.    registered and unregistered versions of DreamROM is that all areas
  17.    that have [UNREGISTERED] are replaced with the Sysopname or BBSname,
  18.    and the 15 second delay when exiting the programs are eliminated.
  19.    EVERYTHING else is identical whether registered or not.
  20.  
  21.  
  22.      * Copyright and Registration Notice
  23.  
  24.      DreamROM is a copyrighted program being distributed under the
  25.      shareware concept.  The only 'difference' between DreamWARE doors
  26.      and shareware is:  Registration is still required, but the trial
  27.      period for the door is virtually indefinate.  You may test the door
  28.      online for as long as you like, and register it when you are sure
  29.      you want it to remain online, and when you can afford to register.
  30.      (I know how running a BBS can get to be a burden on your finances.)
  31.      This policy is retroactive to ALL DreamWARE doors. At any rate, try
  32.      the door until you are absolutely sure you wish the door to remain
  33.      online and can afford to register it, then, at that moment you are
  34.      required to register the door! <g>   Enjoy!
  35.  
  36.      As a shareware program, DreamROM may be freely distributed through a
  37.      BBS.  Shareware distributors may distribute copies of DreamROM on disk
  38.      for a modest disk duplication charge not to exceed $4 per disk.
  39.  
  40.  
  41.      * Warranty
  42.  
  43.      DreamROM is distributed without warranty.  In no event will Andy
  44.      Stewart or DreamWARE Communications be liable to you for damages,
  45.      including any loss of profits, lost savings, or other incidental or
  46.      consequential damages arising out of your use of or inability to use the
  47.      program, even if Andy Stewart, DreamWARE Communications or an authorized
  48.      representative has been advised of the possibility of such damages.
  49.      Andy Stewart and DreamWARE Communications will not be liable for any
  50.      such claim by any other party.
  51.  
  52.  
  53.      * Features
  54.  
  55.      Assembly language serial input/output routines for maximum speed.
  56.  
  57.      Fully supports high speed modems: 16550 FIFO buffering and locked
  58.      serial ports.
  59.  
  60.      Built in ANSI terminal emulator.  No need to have ANSI.SYS loaded
  61.      in memory.
  62.  
  63.      Supports all of the most popular door data file formats: TriBBS,
  64.      PCBoard, GAP, Spitfire, WildCat, RBBS, and WWIV.
  65.  
  66.      (Examples showing how the various EXEs can be run are lower in the
  67.       EXE explanations)
  68.  
  69.      * Configuration file
  70.  
  71.      Line 1:   Door data file type.
  72.      Line 2:   Path to the door data file(s).
  73.      Line 3:   BBS name.
  74.      Line 4:   Sysop's name.
  75.      Line 5:   Locked baud rate.
  76.  
  77.      As illustrated above, the door's data file type is specified in line 1
  78.      and can be PCB for PCBOARD.SYS, GAP for DOOR.SYS, SF for SFDOOR.DAT,
  79.      RBBS for DORINFOx.DEF, WC for CALLINFO.BBS, TRIBBS for TRIBBS.SYS,
  80.      or WWIV for CHAIN.TXT. The locked baud rate is specified in line 5.
  81.      If the sysop doesn't lock his serial port, he must specify 0 for the
  82.      locked baud rate.  NOTE: Although many door formats do pass the
  83.      locked baud rate in the door data files, some older formats such as
  84.      DORINFOx.DEF do not.  For conformity, it is required that you
  85.      specify the locked baud rate in line 5 and ignores any value passed
  86.      in the door data files.
  87.  
  88.      The following is a sample door configuration file:
  89.  
  90.      GAP
  91.      C:\WC\WCWORK\NODE1\
  92.      DreamNET
  93.      Unca Scrooge
  94.      57600
  95.  
  96.      A file called SETUP.EXE is included to aid with writing this config.
  97.      file.  Run it, answer the questions, and let the program do the rest.
  98.  
  99.                  THIS MUST BE RUN BEFORE RUNNING DreamROM!!!
  100.  
  101.  
  102.      DreamROM can be run locally without a door data file (handy for the
  103.      sysop to use the door without logging on to the BBS) by specifying
  104.      /L after the configuration file parameter in the DOS command line.
  105.      DreamROM will request the user to enter his name before running the
  106.      door.
  107.  
  108.      Nonstandard IRQs can be used with DreamROM by specifying the IRQ
  109.      number after the  "config" parameter in the command line used to run
  110.      the door as follows:
  111.  
  112.      door config irq
  113.  
  114.  
  115.      * Special Keys
  116.  
  117.      While a door is running, the sysop can press certain special keys to
  118.      perform a variety of functions. The following is a list of the
  119.      functions that the DreamROM special keys perform:
  120.  
  121.      Key(s)              Function
  122.  
  123.      HOME                Toggles between the user status window and a help
  124.                          display that lists the special keys.
  125.  
  126.      F6                  Takes 5 minutes away from the caller.
  127.                          NOTE:  This will NOT be returned to BBS.
  128.  
  129.      F7                  Gives 5 minutes to the caller.
  130.                          NOTE:  This will NOT be returned to the BBS.
  131.  
  132.      F9                  Quit the door and return the caller to the BBS.
  133.  
  134.      F10                 Enter chat mode.  Pressing the ESC key exits the
  135.                          chat mode.
  136.  
  137.      Alt+D               Drop to DOS.
  138.  
  139.  
  140.  
  141.    * DreamROM requires the following programs:
  142.  
  143.    PKZIP.EXE, PKUNZIP.EXE, and ARJ.EXE in your path for various
  144.    functions.
  145.  
  146.    A protocol driver in your path.  (DSZ.COM, DSZ.EXE, GSZ.COM,
  147.    GSZ.EXE, etc.) If you have an unregistered DSZ/GSZ, the YModem-G
  148.    protocol will NOT function.  Batchfiles to call the protocols should
  149.    be placed in the DreamROM main directory.  Four example batchfiles
  150.    are included.  They are Z.BAT (ZModem), Y.BAT (YModem), G.BAT
  151.    (YModem-G), and X.BAT (XModem).
  152.  
  153.    For example, take Z.BAT:
  154.  
  155. rem ***********  Begin Z.BAT
  156.  
  157. @echo off
  158. goto %1
  159.  
  160. :1
  161. dsz port %1 sz %2
  162. rem   The above line calls dsz on port 1 (as passed by %1) using ZModem.
  163. rem   %2 is the file(s) to send.
  164. goto quit
  165.  
  166. :2
  167. dsz port %1 sz %2
  168. rem   The above line calls dsz on port 2 (as passed by %1) using ZModem.
  169. rem   %2 is the file(s) to send.
  170. goto quit
  171.  
  172. rem  etc, etc, etc.  The reason for the use of batchfiles, is so that
  173. rem  sysops with non-standard comport addresses and irqs can give that
  174. rem  information on the protocol commandline.  (Also, for handshakes, etc.)
  175. rem  For more information on protocols and protocol commandlines, consult
  176. rem  your protocol(s)'s documentation.  Therefore, for each comport, you
  177. rem  should have a :x section (where x is the comport #)  :1 port 1, :2
  178. rem  port 2, :3 port 3, etc...
  179. rem
  180. rem  If you have no non-standard irq, addresses, etc..  you could just use
  181. rem  a batchfile similar to this:
  182. rem
  183. rem  @echo off
  184. rem  dsz port %1 sz %2
  185.  
  186. :quit
  187. exit
  188.  
  189. rem ***********  End Z.BAT
  190.  
  191. The stock *.BAT files ship as follows:
  192.  
  193. rem *****  Begin stock Z.BAT
  194. @echo off
  195. dsz port %1 sz %2
  196. rem *****  End stock Z.BAT
  197.  
  198.  
  199.    * DreamROM Main Functions
  200.  
  201.    [L]ist Files
  202.    Allows you to select one of directories (categories) on the
  203.    current CDRom.  Once you've selected a directory, the following
  204.    options are available:
  205.  
  206.     [M]ark a file(s)
  207.     Add the file name entered to a list to be downloaded later.
  208.     Just type the letter shown to the left of the filename.
  209.  
  210.     [D]ownload file(s)
  211.     Takes you to the download area, and will allow you to download
  212.     all currently marked files, plus allow you to edit the list.
  213.  
  214.     [A]rchive
  215.     View contents of a .ZIP or .ARJ file, Read a file from within
  216.     the .ZIP/.ARJ file, Download a file from within the .ZIP/.ARJ
  217.     file, or Mark the .ZIP/.ARJ file for later download.
  218.  
  219.     [S]earch
  220.     Takes you to the Search menu, Allows you to search for text within
  221.     a directory, the entire online CD, all online CDs, or all CDs, whether
  222.     online or offline.  You may enter all or any part of a word for a
  223.     search. This feature searches filename, date, and description. The
  224.     search feature is not a DOS filename search, therefore the * and ?
  225.     wildcard characters will not work.
  226.  
  227.     Note:  [D]ownload, [A]rchive, and [S]earch are available from the
  228.            Main Menu, and well as the Directory/Category Menu.
  229.  
  230.  
  231.    [C]hange CDROM Volume
  232.    A list of disks will be displayed. The currently active disk(s)
  233.    will be marked as ONLINE.  This means you may download from it
  234.    right away. If a disk is offline, you may request files from it
  235.    by using the mark option. Change to the offline disk, then browse
  236.    the files as you would an online CD.  When you [M]ark a file, you
  237.    are asked if you would like to request the file. The sysop will
  238.    make the file(s) you request available for you at a later time.
  239.  
  240.    [O]ffline requests
  241.    Upon entering the door, you are notified if your requested file(s)
  242.    are available, and asked if you wish to download them.  If you select
  243.    'No', you may enter the Offline Request area and download the files
  244.    later in your session.
  245.  
  246.    [T] Color Toggle
  247.    Switch between ANSI and ASCII.
  248.  
  249.    [P]rotocol Change
  250.    Select the file transfer protocol.
  251.  
  252.  
  253.     * DreamROM Files Included in DRMROMxx.ZIP
  254.  
  255.               DREAMROM.EXE <= DreamROM Main Program
  256.               DREAMROM.DOC <= Sysop's Information
  257.               ORDER.FRM    <= Registration information
  258.               COMPILE.EXE  <= Database (DRF) compiler, sysop
  259.                               setup, Audio CDRom player, etc.
  260.               NEWSEC.EXE   <= DRF Security Level convertor.
  261.               FIX.EXE      <= Rebuilds a DRF file after it has
  262.                               been edited (using any word processor).
  263.               DRMEDIT.EXE  <= Small texteditor used to edit *.LST
  264.                               files.  (Also used internally for
  265.                               a few other functions).
  266.               REQCOPY.EXE  <= Sysop request check and copy program.
  267.               CHECKREQ.EXE <= Nightly event to check for expired
  268.                               requests.
  269.               SETUP.EXE    <= Small utility to create DREAMROM.CFG
  270.               DREAMROM.HLP <= Online User Help.
  271.               G.BAT        <= YModem-G Batchfile.
  272.               X.BAT        <= XModem Batchfile.
  273.               Y.BAT        <= YModem Batchfile.
  274.               Z.BAT        <= ZModem Batchfile.
  275.               WHATS.NEW    <= DreamROM history file.
  276.               FILE_ID.DIZ  <= Description File. (Long)
  277.               DESC.SDI     <= Description File. (Short)
  278.               CATALOG.TXT  <= Catalog of current DreamWARE Doors.
  279.               DISTRIB.TXT  <= Current list of DreamWARE distro sites.
  280.  
  281.    All of these files should be in this ZIP, if they are not, don't
  282.    take a chance! Call DreamNET or a support board and download a good
  283.    copy.
  284.  
  285.  
  286.    Detailed File explanations:
  287.  
  288.    DREAMROM.EXE -  The Main DreamROM executable.  This handled all the
  289.                    caller related functions.  The database files, DRF
  290.                    files, are created with COMPILE.  DRF files are ASCII
  291.                    files that can be edited by any texteditor capable of
  292.                    loaded and editing large textfiles. Do NOT edit the
  293.                    first line!  After you edit a DRF file, run FIX.EXE
  294.                    to rebuild and rescan the file.
  295.  
  296.                    Call DreamROM in the following manner:
  297.  
  298.                    DREAMROM DREAMROM.CFG
  299.  
  300.    COMPILE.EXE  -  This is when ALL the sysop functions are.  This scans
  301.                    and builds the DRF files.  Configures all options in
  302.                    DreamROM.  Plays Audio CDs.  Setups up protocols.  Etc.
  303.  
  304.                    Call Compile in the following manner:
  305.  
  306.                    COMPILE
  307.  
  308.                    TO play an audio CD, while in COMPILE, with the audio
  309.                    CD in your FIRST CDRom drive, press F1 to begin playing,
  310.                    and F1 again to stop playing.
  311.  
  312.    REQCOPY.EXE  -  This is used by the sysop to check for requested files.
  313.                    If requests are available, the sysop is prompted to copy
  314.                    the requested file(s) from the CD(s) to the hard drive.
  315.                    Call this in your logon event.  If no requests are
  316.                    available, or the user is NOT a sysop, the program will
  317.                    be bypassed.
  318.  
  319.                    Call ReqCopy in the following manner:
  320.  
  321.                    REQCOPY DREAMROM.CFG
  322.  
  323.    NEWSEC.EXE   -  Mainly used to convert pre-compiled DRF files downloaded
  324.                    from DreamNET.  Pre-compiled DRF files have all security
  325.                    levels set to 0.  To convert the DRF file to a security
  326.                    level of, say, 30, you would take the following steps.
  327.  
  328.                    Copy the DRF file (example: NOWL13.DRF) into your CDS
  329.                    subdirectory.
  330.  
  331.                    Call NEWSEC in the following manner:
  332.  
  333.                    NEWSEC NOWL13 30
  334.  
  335.                    This will convert NOWL13.DRF to a security level of 30.
  336.  
  337.    FIX.EXE      -  Rebuilds and rescans a DRF file. Use this after you
  338.                    edit a DRF file. (Will also delete any null/blank lines
  339.                    found in the DRF file)
  340.  
  341.                    Make sure the DRF file (example: NOWL13.DRF) is in your
  342.                    CDS subdirectory.
  343.  
  344.                    Call Compile in the following manner:
  345.  
  346.                    FIX NOWL13
  347.  
  348.   CHECKREQ.EXE  -  Nightly event to check for expired requests.  Checks
  349.                    for the above mentioned expirations, empty user
  350.                    directories, etc.
  351.  
  352.                    Place in your nightly event.
  353.  
  354.                    Call Checkreq in the following manner:
  355.  
  356.                    CHECKREQ
  357.  
  358.    * DreamROM Setup
  359.  
  360.    Unzip DRMROMxx.ZIP into the directory you wish it to reside.  Run
  361.    SETUP to create DREAMROM.CFG. Then run COMPILE and the needed
  362.    subdirectories, files, etc will be created.
  363.  
  364.    While in COMPILE, press 'S' to configure DreamROM's Options.
  365.  
  366.    '1':  Update drive letters.  Enter the letters for ALL CD drives in
  367.          your system.  (ie:  E-J or EFGHIJ, etc..).
  368.  
  369.    '2':  Enter default CD drive and drive DR resides on.  The default CD
  370.          drive is usually the first CDRom drive in your system.  This
  371.          is the default bootup CDRom drive, and a CD that ALWAYS has a
  372.          CD in it.  The drive DR resides on is the drive you have
  373.          DreamROM installed upon.
  374.  
  375.    '3':  Sysop Security Level.  Enter your Sysop Security Level here.
  376.          Used for internal security, REQCOPY.EXE, and others.
  377.  
  378.    '4':  Setup Protocols.
  379.  
  380.          'L': List Existing Protocols
  381.          'A': Add a Protocol.  You will be asked for 3 things.  The
  382.               Protocol's Name, Batchfile Name (You're only allowed 4 letters
  383.               for the batchfile name.  Do NOT add the '.BAT' extension!
  384.          'D': Delete a Protocol.
  385.          'Q': Quit back to the Sysop Menu.
  386.  
  387.    '5':  # of days to keep requests.  This is the length of time you wish
  388.          to keep requested files on the HD before they are deleted.  (If
  389.          a person downloads the files, they are then deleted.  This keeps
  390.          forgotten requests from staying on your HD forever.)  Suggested
  391.          length is 7-14 days.  The default it 14 days.
  392.  
  393.    '6':  * DL bytes per day.  This is the limit users are allowed to
  394.            download per day.  (Bytes).
  395.  
  396.          * DL files per day.  This is the limit users are allowed to
  397.            download per day.  (Files).
  398.  
  399.          * Request files per day.  This is the limit users are allowed to
  400.            request per day.  (Files).  (This number isn't reset until the
  401.            user downloads the available requests.)
  402.  
  403.          * Request bytes per day.  This is the limit users are allowed to
  404.            download per day.  (Bytes).  (This number isn't reset until the
  405.            user downloads the available requests.)
  406.  
  407.          What this is for is, if the caller has a security level that isn't
  408.          defined in the Security setup, the files and bytes values will
  409.          default to this.
  410.  
  411.    '7':  Path and name to write online CD bulletins.  (Only written when
  412.          CDs are rescanned and CDINFO.DAT is re-written).
  413.  
  414.          CD bulletins are notices showning what CDs are online.
  415.  
  416.          ie:  C:\WC40\BULL\BULL1.SCR  or  DREAMROM.ANS
  417.               C:\WC40\BULL\BULL1.BBS  or  DREAMROM.ASC
  418.  
  419.    '8':  Setup Security Levels.  You can define different security level
  420.          to have different file/bytes levels.  (Good for pay boards).
  421.  
  422.          'L': List Existing Security Levels and values
  423.          'A': Add a Security.  You will be asked for 3 things.  The
  424.               Security Level, DL Bytes, DL Files, Request Bytes, and Request
  425.               Files.
  426.          'D': Delete a Security Level
  427.          'Q': Quit back to the Sysop Menu.
  428.  
  429.    'A':  Add Comments.  Toggle on/off to add/not add comments to downloaded
  430.          files.  (ZIP and ARJ only).  COMMENT.TXT must be in the main
  431.          DreamROM directory.
  432.  
  433.          Hint:  The first line on the COMMENT.TXT should be a blank line.
  434.                 PKZip doesn't start the comment with a CR/LF like it
  435.                 should.  This'll make the comment look better. (Also, I
  436.                 suggest adding a CR/LF on the line after the comment, PKZip
  437.                 also has a thing about killing the last character on the
  438.                 last line.
  439.  
  440.          Ex Cmt:
  441.  
  442. ╔────────────────────────╦──────────────────────────────────────────────────╗
  443. │  ┌────┐        ┌────┐  │ 28.8  «« DreamNET  ■  1:137/116 Fidonet »»  2400 │
  444. │  │▒▒▒▒│ -----> │▒▒▒▒│  │      You may contact us at (813) 362-9440        │
  445. │ ┌╧════╧┐ <----┌╧════╧┐ │ Home of DreamWARE Communications Doors and Utils │
  446. │ └───═══┘ 28.8 └───═══┘ │ This file tested with the latest version of Scan │
  447. ╚────────────────────────╩──────────────────────────────────────────────────╝
  448.  
  449.  
  450.    'C':  Compresssion.  Toggle on/off to use/not use compression on the
  451.          DRF files.  PKZip/PKUnzip are used for the compression.  This
  452.          will save you a LOT of space, especially if you have a lot of DRF
  453.          files.  Uncompression time depends on your system.  (CPU, Cache,
  454.          etc)
  455.  
  456.    'L':  Auto_Logoff.  Toggle on/off to allow/not allow users to
  457.          automatically logoff after download.
  458.  
  459.    'S':  Spawning.  Toggle on/off to use/not use spawning.  Using it is
  460.          recommended.  Toggle to off if users complain of loss of control
  461.          from remote.  (Happens sometimes under DesqView.  DV doesn't like
  462.          some programs that spawn out.)
  463.  
  464.    'R':  Register DreamROM.   Enter your Registered SysopName, BBSName,
  465.          and Number here, when registered.
  466.  
  467.    'Q':  Quit to main.
  468.  
  469.  
  470.    * How to compile/create a DreamROM Filebase (DRF)
  471.  
  472.    DreamROM needs to know about the files on your CDRom... All the
  473.    data is stored in a single file with an .DRF extension.
  474.  
  475.    Following these steps to compile a DRF:
  476.  
  477.  
  478.    Place the cd-rom into your default drive.
  479.  
  480.    Take a look at the disk, directories, etc.. and see which files
  481.    contain the descriptions of the CDRom files. These are usually
  482.    named FILES.BBS, and are located in each CDRom directory that
  483.    contains files for users to download.  Check the FILES.BBS, and see
  484.    if the file sizes and dates are given.  You will need to know this!
  485.    (If a description file doesn't exist, the file names/sizes/dates are
  486.    read into the DRF, but there will be no descriptions.  These aren't
  487.    very common, but DO show up every now and again.
  488.  
  489.    Now that you have found the names of the description files, you are
  490.    ready to begin the compile.
  491.  
  492.    Run COMPILE.
  493.  
  494.      '1':  Enter your CDRom work drive.  (Whichever CDRom drive your CD
  495.            is in.  Changing this option ONLY affects COMPILE.
  496.  
  497.      '2':  Enter description file.  Usually FILES.BBS.  If you enter
  498.            FILES.BBS, you will be asked if the sizes and dates are given.
  499.            Answer Yes ONLY of both the size AND date are given, otherwise
  500.            the database will be off.  COMPILE reads the actual size and
  501.            date off the file, and ignores the size and date that may have
  502.            been placed in FILES.BBS.  This insures accurate dates and sizes.
  503.            Also, some listings have a [0] or [000] on the first description
  504.            line.  COMPILE will filter these out.
  505.  
  506.      '3':  Create filelists.  You will be prompted for a minimum security
  507.            level.  This the the LOWEST security level that will be able to
  508.            view the directories, files, and download files/filelists on
  509.            this CDRom.  Each directory on the CD has it's own security
  510.            level, but when the database is created, ALL directories will
  511.            have this security level.  Directory security levels will be
  512.            looked at in detail later in this file.
  513.  
  514.            COMPILE now scans the CD and creates 2 files:  FILES.LST and
  515.            DIRS.LST.
  516.  
  517.            FILES.LST:
  518.  
  519.             Each line describes a directory on your CD.  Each line has
  520.             three sections separated by semi-colons (;).  COMPILE does
  521.             not know how to describe each directory/category, so it will
  522.             use the directory name as the description. If you would like
  523.             to edit these descriptions, follow the directions below in
  524.             '4':.  Editing IS recommended for user clarity.
  525.  
  526.            DIRS.LST:
  527.  
  528.              Each line is a path to a directory on your CD.  Follow the
  529.              directions below in '5': for editing purposes.
  530.  
  531.  
  532.      '4':  Edit FILES.LST.  (You may also quit COMPILE and use your
  533.            favorite texteditor to edit this file).
  534.            Below is a sample FILES.LST.
  535.  
  536.             [ROOT];E:\;30;E:\
  537.             001A;E:\001A;30;E:\001A\FILES.BBS
  538.             002A;E:\002A;30;E:\002A\FILES.BBS
  539.             003A;E:\003A;30;E:\003A\FILES.BBS
  540.             004A;E:\004A;30;E:\004A\FILES.BBS
  541.  
  542.             Take out all directories you do NOT want compiled into the
  543.             database.  (ie:  ROOT, empty directories, directories that
  544.             contain filelists only, etc.  REMEMBER what directories you
  545.             delete!  You will need to delete the same ones in DIRS.LST.
  546.  
  547.             To name the directories/categories, edit the first field
  548.             in each line.  (The text preceeding the first semi-colon.
  549.             Do NOT edit the second field.  The third field is the security
  550.             level required to access this directory.  Edit to desired
  551.             level, if the default level isn't correct.  (This is good
  552.             for CDs such as Busty Babes 2, which is 1/2 Adult and 1/2
  553.             shareware.  The fourth field is the path to the description
  554.             file.  Change this if this is NOT the path.  (ie:  Some CDs
  555.             have files such are DIR1.TXT, DIR2.TXT, etc.. in their own
  556.             directory.  For CDs that use this method, edit the fourth
  557.             field to reflect the path and filename of the description
  558.             files.)
  559.  
  560.             After editing, your FILES.LST will look similar to this:
  561.  
  562.             Animations;E:\001A;30;E:\001A\FILES.BBS
  563.             Archivers;E:\002A;30;E:\002A\FILES.BBS
  564.             BBS Doors;E:\003A;30;E:\003A\FILES.BBS
  565.             BBS Programs and Utilities;E:\004A;30;E:\004A\FILES.BBS
  566.  
  567.  
  568.      The first field is the name of the directory/category.
  569.      The second field is the actual directory name/path.
  570.      The third field is the security level for this directory/category.
  571.      Each field is separated by a semi-colon.
  572.  
  573.      '5':  Edit DIRS.LST.  (You may also quit COMPILE and use your
  574.            favorite texteditor to edit this file).
  575.            Below is a sample DIRS.LST
  576.  
  577.             E:\
  578.             E:\001A
  579.             E:\002A
  580.             E:\003A
  581.             E:\004A
  582.  
  583.           Delete the same directories you deleted in FILES.LST.  (You did
  584.           remember which ones, right? <g>)
  585.  
  586.      '6':  Create Filebase.  You will be asked for a name for the DRF file.
  587.            This will then scan your CD, gets files, sizes, dates, locations
  588.            and descriptions.  The time the compile takes depends on your
  589.            system, the CD size, etc.  Most CDs on my 386DX40 with 8Megs
  590.            RAM and a 2 Meg cache take approx. 15 minutes to compile. When
  591.            COMPILE has completed compiling the DRF file, it will let you
  592.            know by playing a song.  :)
  593.  
  594.      '7':  Add CD to database.  This is where you put the CD info into
  595.            DreamROMs database, so DreamROM will know how to determine
  596.            which CD is in which CDRom drive.  You also put the name of
  597.            the CDRom here, along with other info.
  598.  
  599.            This is a screen shot of the CDRom configuration.
  600.  
  601.  
  602.   █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  603.   █ ┌─────────────────[■ DreamROM CDRom Configuration ■]──────────────────┐ ▓
  604.   █ │ █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█ │ ▒
  605.   █ │ █  CD #     CD Title                                              ▓ │ ░
  606.   █ │ █  1    ▄   Night Owl BBS                                       ▄ ▒ │ ░
  607.   █ │ █  ▀▀▀▀▀▀   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ░ │ ▒
  608.   █ │ █  CD Identifier                                                  ░ │ ▓
  609.   █ │ ▓  NOP_BBS;001A;04-17-94;11:08p                                 ▄ █ │ █
  610.   ▓ │ ▒  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ █ │ █
  611.   ▒ │ ░  CD Filename       Access Sec.    Download Sec.    Deleted?     █ │ █
  612.   ░ │ ░   NOWLBBS.DRF  ▄    30        ▄     30        ▄    No        ▄  █ │ █
  613.   ░ │ ▒   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀▀▀▀     ▀▀▀▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀▀▀▀  █ │ █
  614.   ▒ │ █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█ │ █
  615.   ▓ └─────────────────────────────────────────────────────────────────────┘ █
  616.   █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  617.  
  618.      [UP Arrow] Up One Field     [DOWN Arrow] Down One Field     [F2] Save
  619.          [RIGHT Arrow] Up One Record     [LEFT Arrow] Down One Record
  620.      [ESC] Quit Without Saving  [INS] Enter New CD  [DEL] Delete This CD
  621.  
  622.            If this is the first CD you've compiled, this screen will come
  623.            up with bogus information inserted into the fields.  You may edit
  624.            this record.  If this is NOT a new CD, press INSERT to create
  625.            a new record, and edit the new record.
  626.  
  627.            The cursor will begin on the CDRom Name field.  Press Enter
  628.            and enter the CD's name.  (ie: Night Owl 13).  Next hit the
  629.            down arrow to move to the CD Identifier (CDI) field.  First,
  630.            be sure the CD is in the work drive, then press ENTER.
  631.            COMPILE will access the CD and gather some information about
  632.            it.  The CDI will look similar to this:
  633.            VOLUME;FIRST_DIR;DIR_TIME;DIR_DATE
  634.            next, hit the down arrow again, press ENTER and enter in
  635.            the filename you used when you compiled the DRF file.  Do NOT
  636.            add the .DRF or .ZIP extension!  FILENAME.DRF is first searched
  637.            for, then FILENAME.ZIP.  If neither exist, COMPILE will let you
  638.            know and prompt you to enter a new name.  After entering the
  639.            filename, press the down arrow once again, press ENTER, and
  640.            enter the lowest security level allowed to access this CD.
  641.            Then press the down arrow one last time and press ENTER.
  642.            Now enter the lowest security level allowed to download from
  643.            this CD.  After all fields are entered, press F2 to save the
  644.            entry.  That's it!  Press ESCAPE to return to the main menu.
  645.  
  646.    * Editing a DRF file
  647.  
  648.    DRF files are plain straight ASCII text files.
  649.  
  650.    You can edit a DRF file with any texteditor/word processor. Note
  651.    that the editors must be able to load large textfiles!  Do NOT change
  652.    the first line of the DRF file. This stores an index number required
  653.    by DreamROM.
  654.  
  655.    If at any point you feel you have messed up a DRF file, DO NOT PANIC!
  656.    Just run FIX.EXE, and the file will be rebuilt.
  657.  
  658.    * Structure of a DRF file
  659.  
  660.    The first line stores the index number to the starting line number
  661.    of data section of the file.
  662.  
  663.    Each category line starts with a ■ (ALT-254) character such as:
  664.  
  665.    ■BBS Doors;30
  666.  
  667.    The 30 is the security level for this directory/category
  668.  
  669.    File descriptions begin with the filename, path and filename, size,
  670.    and date
  671.  
  672.    DRMSLT15.ZIP;\016A\DRMSLT15.ZIP;93050;02/23/94
  673.  
  674.    Description lines begin with a | character:
  675.  
  676.    | ┌───────────DreamSLOTS──v1.5───────────┐
  677.    | │Θ    The ULTIMATE in Online Slot     Θ│
  678.    | │  ══════════  Machines! ════════════  │
  679.    | │ 100% ANSi Grafix.  Can YOU Become A  │
  680.    | │ Billionaire & Join The Bill' Club??  │
  681.    | │  Supports all the most popular BBS'  │
  682.    | │        Multi-node capable!!          │
  683.    | │  NOT CRIPPLED!!!   $10 Registration  │
  684.    | │Θ   A MUST SEE !!   Read WHATS.NEW   Θ│
  685.    | └───────DreamWARE─Communications───────┘
  686.  
  687.    At the end of the file is the data section:
  688.  
  689.    **END
  690.    PCBoard Programs & Utilities;30;2
  691.    PCBoard PPEs;30;897
  692.    Wildcat!;30;2722
  693.    VBBS;30;3129
  694.    WWIV;30;3209
  695.    RBBS;30;3277
  696.    Remote Access;30;3831
  697.  
  698.  
  699.    The first field in the line is the directory/category name.
  700.    The second field is the security level for the directory/category.
  701.    The last field is the line number the section for this directory/
  702.    category starts on.
  703.  
  704.    The numbers will be rebuilt when you run FIX after an edit,
  705.    so ignore them!
  706.  
  707.    To delete a specific file from the database, set the filesize to 0
  708.  
  709.    You can permanently delete any file, category, or description
  710.    by editing it out of the DRF file.
  711.  
  712.    ***** ALWAYS run FIX.EXE after you edit a DRF File!!!
  713.  
  714.    * NOTE
  715.     Many pre-compiled DRF files are available from DreamNET.  If you
  716.     download a pre-compiled DRF, just unzip it into the CDS subdirectory,
  717.     run NEWSEC from the main DreamROM subdirectory to convert it to the
  718.     desired security level.
  719.  
  720.  
  721.    * Copying Files
  722.  
  723.    DreamROM will create a file named INUSE.$ in the DreamROM main directory.
  724.    When present, other nodes must wait until this file is deleted by
  725.    the node that is accessing the cd-rom drive. If for some reason
  726.    you rebooted the machine before this file is removed, DreamROM
  727.    will not be able to copy files. You will see a notice stating the
  728.    drive is in use. To fix this, simply delete INUSE.$ to restore
  729.    normal operation.  Also, if this happens, or a complete lockup occurs,
  730.    check in the DATA subdirectory for a file names BUSY.$$$ and delete it.
  731.    This will also return normal operation.  (BUSY.$$$ is created when a node
  732.    writes to a datafile.. this prevents conflicts and)
  733.  
  734.    * CDRom List / Scan Mode
  735.  
  736.    Information about all CDs (Online and Offline) are kept in a small
  737.    index file called CDINFO.DAT.  The format is as follows:
  738.  
  739.     Top Drawer;30;ON;9;E
  740.     Night Owl 13;30;ON;2;F
  741.     Night Owl 12;30;OFF;3;
  742.     Night Owl 11;30;OFF;4;
  743.     Night Owl 10.1;30;OFF;5;
  744.     Night Owl 10;30;OFF;6;
  745.     Pier 4;30;OFF;1;
  746.  
  747.     CDName;Seclevel;Status;CDRec#;Drive
  748.  
  749.     CDName   <=  Name of CD as entered in COMPILE
  750.     Seclevel <=  Minimum Security Level allowed to access this CD
  751.     Status   <=  ON = Online  OFF = Offline
  752.     CDRec #  <=  Record # CD is in DREAMROM.DAT.  Faster loading.
  753.     Drive    <=  Drive letter CD is in.  Blank if offline.
  754.  
  755.    DreamROM will only scan the drives if CDINFO.DAT does NOT exist.  To
  756.    force DreamROM to rescan the drives, simply delete CDINFO.DAT.
  757.    (The bulletins will then be created.)
  758.  
  759.  
  760.    * Log File
  761.  
  762.    Logs of DreamROM activity are saved in the LOGS subdirectory, in a
  763.    file called ROMLOG.x, where x is the nodenumber.
  764.  
  765.  *** Errors / Problems / Etc...
  766.  
  767.    If you encounter problems try these suggestions:
  768.  
  769.    * Running PCB and can't find correct dropfile:
  770.  
  771.       - Set line #1 in your *.CFG file(s) to GAP.  DreamROM will then
  772.       - read DOOR.SYS
  773.  
  774.    * Running WildCat! and can't find correct dropfile/doesn't read
  775.      dropfile.
  776.  
  777.       - If running WC 3.x - 4.x, set line #1 in your *.CFG file(s) to GAP.
  778.       - DreamROM will then read DOOR.SYS.  If running WC2.x, set line #1 in
  779.       - your *.CFG file(s) to WC.  DreamROM will then read CALLINFO.BBS.
  780.  
  781.    * Running WWIV and can't read CHAIN.TXT.
  782.  
  783.       - If Running WWIV 4.23+, set line #1 in your *.CFG file(s) to GAP.
  784.       - DreamROM will then read DOOR.SYS.  If running WWIV 4.22-, call
  785.       - WWIV2GAP in your batchfile first (read WWIV2GAP's dox for more info),
  786.       - and use the 4.23+ method.
  787.  
  788.    * Running VBBS and can't read CHAIN.TXT.
  789.  
  790.       - Set line #1 in your *.CFG file(s)
  791.  
  792.    * DreamROM doesn't find the correct CDs.  Marks wrong ones online or
  793.      offline, etc.
  794.  
  795.       - Delete CDINFO.DAT - This forces DreamROM to rescan your drive(s).
  796.  
  797.       - Check the CD letters in COMPILE to make sure all your drives are
  798.       - configured.  Ex:  DEFGHIJK...
  799.  
  800.       - Check your default drive in COMPILE.  Make sure the default CD is
  801.       - the correct letter.
  802.  
  803.       - Check your CDRom drives to insure they are working properly.
  804.  
  805.    * DreamROM locks up upon entering the door.
  806.  
  807.       - Check for INUSE.$ in the main DreamROM directory, and for BUSY.$$$
  808.       - in the DATA subdirectory.  If either of these files exist, delete
  809.       - them.
  810.  
  811.    * Remote users complain about remote lockups.
  812.  
  813.      - Toggle spawning to OFF.  (Happens sometimes under DesqView.
  814.      - DV doesn't like some programs that spawn out.)
  815.  
  816.     * Problems compiling a CD
  817.  
  818.       * If you're having a problem compiling a certain CD, take the
  819.         following steps:
  820.  
  821.         1:  First, call DreamNET or FREQ DRF from 1:137/116 Fidonet to
  822.             get a list of pre-compled DRF files available.  If I don't have
  823.             it available, continue with these steps.
  824.  
  825.             (If you have a DRF that I don't have online, please upload it
  826.              to share with others who may need it.)
  827.  
  828.         2:  Compile the CD normally and fully (if you deleted, or didn't
  829.             fully compile it.)
  830.  
  831.         3:  Zip and copy the DRF file to a 3.5 HD floppy.
  832.  
  833.         4:  Write a note with the following information:
  834.               CD Title
  835.               Problem(s) you're having
  836.               Your return address
  837.               Shipping method (see shipping notes below)
  838.               Any other information you feel important.
  839.  
  840.         5:  Place the offending CD along with the floppy, the note and
  841.             return postage (see shipping notes below) into an mailer
  842.             and mail it off to me at the registration address.  I will then
  843.             do my best to compile a database for the CD(s) and return the
  844.             CD(s) and the floppy with the new database to you ASAP.  Please
  845.             allow at least 2 weeks after your mailing to me to get and
  846.             return the CD(s)  (It might be a good idea to drop me a note
  847.             through Fido, my BBS, etc. about you're mailing the CD, just
  848.             so I know the package is coming.)  If, after the 2 weeks, you
  849.             haven't received it back, nor have you heard from me, feel
  850.             free to contact me through Fido or my BBS to check on the
  851.             status of your CD(s).
  852.  
  853.             *  Note: I cannot and will not be responsible for lost,
  854.                      misdirected, damaged, etc., CD(s) send to me.  You
  855.                      ship your CD(s) at your own risk, and in no way will
  856.                      Andy Stewart or DreamWARE Communications be liable
  857.                      to you for damages, loss, etc. incurred during
  858.                      shipping.
  859.  
  860.             * Shipping Notes:
  861.  
  862.               Please one of the following include:
  863.  
  864.                $25.00 for UPS Overnight shipping, packaging, and insurance.
  865.                $20.00 for Express mail and packaging.
  866.                $15.00 for UPS Ground shipping, packaging, and insurance.
  867.                 $5.00 for Priority Mail and packaging.
  868.                 $3.00 for Third Class Mail and packaging.
  869.  
  870.                 or appropriate amount for any other shipping/insurance
  871.                 method, add $2 for packaging.
  872.  
  873.                 As you can see, the best return shipping method would be
  874.                 $5.00 for Priority Mail, but the choice is yours.
  875.  
  876.    *********
  877.    * If you still have problems, feel free to contact me.  Please give me
  878.    * the following information.
  879.  
  880.         The EXACT problem, not just a generic "it won't compile", "it
  881.         doesn't work", etc...
  882.  
  883.         System info such as CPU, Clock Speed, RAM, etc.
  884.  
  885.         What memory manager do you use?  (QEMM, EMM, etc..)
  886.  
  887.         What OS are you running under, and what version.  (MS-DOS, PC-DOS,
  888.         OS/2, etc..)
  889.  
  890.         Are you using a multi-tasker?  If so, which.  (Windows, DV, etc..)
  891.  
  892.         How many, and what type CDRom drives are you using?
  893.  
  894.  
  895.  
  896.     If you have problems, I will make every attempt to get it running for
  897.     you.
  898.  
  899.     * Support
  900.  
  901.      You may obtain assistance with a DreamWARE Communication programs and
  902.      related problems by calling DreamNET at (813)362-9440 and leave a
  903.      comment to Andy Stewart.  You may also find the latest versions of
  904.      DreamWARE Communications doors here, which are downloadable on
  905.      the first call. Also, they can be found on the support boards found
  906.      in DISTRIB.TXT  You may also email me at 1:137/116 Fidonet.
  907.  
  908.  
  909.      * Registration
  910.  
  911.      Registration of DreamROM is only $25.00.  Please use the form in the
  912.      file ORDER.FRM.   When you register DreamROM, you will receive a
  913.      keycode to turn your copy of DreamROM into a registered version.  More
  914.      information on this is in ORDER.FRM.
  915.  
  916.      This version of DreamROM is NOT a DEMO.  File Transfers and Requests
  917.      are only limited to what the sysop has setup.
  918.  
  919.  
  920.      * Special Thanx
  921.  
  922.       Special thanx go the the following 6 guys.  The tested the 'ell
  923.       outt DreamROM, and without them, I'd still be sitting in from of
  924.       the monitor, with everything from my waist-down asleep, STILL trying
  925.       to find that last bug!  Thanx TONS guys!!!
  926.  
  927.      Dwight Dawson :
  928.        The guy who got be to start on this.  Seems there was ALWAYS
  929.        something wrong with the 'other' package you were running, so
  930.        we HAD to do something about it.  Mr. OS/2.  Runs sweet under
  931.        it, huh!? <g>  Thanx for getting me started on this!
  932.  
  933.      Dan Taylor :
  934.        Dan, Dan the CD Man.  (Now THAT was corny!).  What, 60 CDs and
  935.        counting?  Can't let Dwight catch up with ya!  You can find a bug
  936.        that would only show on the second Tuesday in March, under a full
  937.        moon and a tornado on the horizon! <g>  Thanx for the bugs! ;)
  938.  
  939.      William Morgan :
  940.        Mr. Guinea Pig.  Lets see, how many times did I/we crash your
  941.        machine? <g>.  4 Pioneers, geez, if it'll run there, it'll
  942.        run anywhere. Thanx mon, I promise no more 4am lockups!!
  943.  
  944.      Rob Williams :
  945.        My 'code partner'.  Thanx for all the code you've shipping my
  946.        way, and for answering all my "how the 'ell do you fo this?"
  947.        questions.  How many times did I type WHAT in the dox? <g>
  948.  
  949.      Randy Lewenza :
  950.        My Canadian buddy!  How's it going', eh? <g>  Shaddap, I do NOT
  951.        sleep all the time!! <g>.  Thanx for pushing it up in the Great
  952.        White (Freezin') North!
  953.  
  954.      Ed Georgen :
  955.        The newest beta guy.  Got in on it at the end of the testing.
  956.        It was short, but sweet!  Thanx!  (Thanx for testing Order 1.8
  957.        for me! You were my main tester for it! <g> )
  958.  
  959.  
  960.     Most of all, thanx to Steph!  Yeah, honey, I'm coming to bed tonight!
  961.  
  962.  
  963.                        Thank you for using DreamROM!
  964.                        -----------------------------
  965.  
  966.  
  967.