----------------------------------------------------------------------------------
                         XCDRom V1.1  ©1998 Reinhard Steinert
----------------------------------------------------------------------------------

An Arexx Programm by:  Reinhard Steinert     Fido: 2:2490/1930.0

                       JumboBBS: 49-911-265627  (V.xx)
                       JumboBBS: 49-911-2779781 (ISDN)
                       JumboBBS: 49-911-2877204 (ISDN)
                       JumboBBS: 49-911-2877204 (V.xx)


Surely there exist a lot of very good CDRom-doors for Xenolink...
Unfortunately most of them are very complicated to configure or
expect even a config for every CD-Rom. It is impossible to insert
a CD-Rom on the fly without making an Index-file first.

This is what my door intends:
The possibility to insert ANY CD-Rom without making an index first.

The drawback of my method is the missing filecomment when using normal CDs.
On the other hand the .readme-files of Aminet-CDs are being read out of
the Files.BBS and thus are available to the user.
That means even Aminet-Cds do not need an index, simply insert your CD and
the Aminet short-description is available for every single file...
Aminet .readme-files can be read online.


Features :
----------

 > Multi-CD-Rom, up to 4 CD-Roms oder other devices

 > No need of index.files

 > no need of a CD-Rom, even Zip-drives, changeable media, or a partition
   of your harddisk can be used.

 > Xeno -like marking of files (done with numbers)

 > changing of directories (done with numbers)

 > Screenlength according to the users adjusts 

 > Different accesslevels for every device, CD-Rom, partition...

 > The possibility to enter a comment for ervery device

 > Easy handling : all configurations can be made online too

 > Aminet CDs are being listed with filecomment, nothing else needed

 > All Aminet .readme-files can be read online

 > The door can be used from all lines at the same time

 > Accesslevel for sysop-menu configurable


Installation:
-------------

Copy the whole directory "StoniCDrom" to doors:

Start XCDRom in a menu of your choice with the following command.

----------------------------->8-------------------------------
CMD = "CD"
   {
      REXX "^10000^Doors:StoniCDrom/XCDRom.rexx ~20"
   }

------------------------------8<-------------------------------


Configuration:
--------------

Edit XCDRom.config with a editor (recommended for the first time),
or change it within the sysop-menu.


 Lines 1-4
-----------

Line 1 : CD0:Aminet/    /* the name of your first CDRom, e.g with an Aminet-CD in it */
Line 2 : CD1:           /* the name of your second CDRom, e.g CD1: */
Line 3 : Work:Pics/     /* the name of your third device, e.g a directory on your hd */
Line 4 :                /* not used, therefore empty... */


>>> Let the lines of unused devices empty

>>> Be sure that the Assign exists and the device is online !

>>> You even can mount a directory of your hd as "device",
    but dont forget the "/" at the end of your path, e.g Work:Pics/ !
    In this special case it is impossible for the user to change to
    another directory. Therefore this is secure to use.


>>>  VERY IMPORTANT !
           
     If you want to use Aminet-CDs then you must enter (your device):Aminet/

     e.g  for drive "CD0:" there must be a line CD0:Aminet/
                                                          ^
          >>> Dont forget the "/" at the end of your path ^


 Lines 5-8
-----------

Here you can enter a short description for every device (max length=30)

e.g.
line 5 : The new Aminet CD
line 6 : Great for DTP, many fonts
line 7 : My only for friends files...
line 8 :                               /* not used, therefore empty... */

>>> If a device is not used make an empty line for it

>>> The visibility of devices and comments depends on the users account !


 Lines 9-12
------------

Here you can enter the accesslevels for every device

e.g.
line  9 : 1   /* device can be used with accesslevel 1 (or higher) */
line 10 : 0   /* device can be used with accesslevel 0 (or higher) */
line 11 : 50  /* device can be used with accesslevel 0 (or higher) */
line 12 :     /* not used therefore empty... */

>>> Be sure to enter numbers between 0 and 255 only !


 Line 13
---------

Here you can enter the language for XCDRom.

>>> E for English or D = for German

 Line 14
---------

Here you can enter the accesslevel for the sysopmenu.

As said before all the configuration be done online,
although I recommend to do this with your editor for the first time...


Thats all.

 Enjoy !


 -------------------
     ShowCD.rexx
 -------------------

ShowCD.rexx displays users which CDs are online.

It takes advantage of the XCDRom.config and displays devices
and comments according to the given accesslevel.

ShowCD.rexx can be started automatically from Login.rexx :

Call 'Doors:StoniCDRom/ShowCD.rexx'

or it can be installed to the menu of your choice :

-----------------------------------------------------
CMD = "WhatSoEver"
   {
      REXX "^10000^Doors:StoniCDrom/ShowCD.rexx ~20"
   }
-----------------------------------------------------


If XCDRom is useful to you please write me a mail.
If you should find a bug feel free to contact me too.

