				  CDROMS.TXT

	CDROMS.WCX, copyright 1994 by Wade Maxfield, all rights reserved, 
is free.  It may be copied, used, or given away.  It may not be sold, or 
bundled with another product which is being sold for profit, without prior 
permission from Wade Maxfield except as noted in the following text.  
Shareware disk vendors may include it on their disks without restrictions.  
It may be included in any shareware collection, even if that shareware 
collection is sold for profit, or bundled with another product sold for 
profit.

	There is no support for CDROMS.WCX.  You assume all liabilities
and responsibilities for its use. CDROMS.WCX is not guaranteed to do 
anything.  It may even malfunction and break something.  If it does, 
it is your responsibility.  TEST IT BEFORE USING IT IN A PRODUCTION 
ENVIRONMENT.

	You may purchase the CDROMS source code for $35.00 (Texas 
Residents add 8.25% sales tax), + 3.00 shipping and handling by sending
a check to:

	Central Telecommunications, Inc
	4734 Hwy 377 South, Suite 22
	Fort Worth, TX 76116.


	You will receive a disk containing the CDROMS source code.  For $10
more, you will receive the *currently in development* WCC VB LIB project.  
This project runs under VB for Windows, and provides a "shell" that allows 
you to do 70% to 80% of your code debugging in the VB for Windows environment.  
(A great time saver!).  

	Early orderers of the wcc vb lib will get the full project sent at
completion.  It will be finished when most of the wcCode calls can be 
modeled well enough for the 70% to 80% debug purposes.

	This CDROMS.WCX file was developed using the wcc vb lib project.
It is SO NICE to be able to find out what that variable really is without
having to print debug statements!  The ability to re-run statements until
you get them right is great too.,

Enjoy!
Wade Maxfield

-----------------------------------------------------------------------------
				Brief overview

HOW TO SET UP.................................line 57
HOW THIS PROGRAM OPERATES.....................line 148
COMMAND LINE OPTIONS..........................line 259
FINAL NOTES...................................line 273
EXAMPLES......................................line 285
PACKING LIST..................................line 487
FEATURES......................................line 495
----------------------------------------------------------------------------
'  cdrom program
HOW TO SET UP:
	1.  Using C:\Wildcat as the example wildcat operations directory.

	2.  Make a subdirectory called CDROM inside C:\Wildcat.
		Dos command line: md c:\wildcat\cdrom.  
		(note: "CDROM" is my personal preference.  You may use
		any name you wish.)

	3.  Make a subdirectory for each CDROM you are going to display
		to the BBS user.
	    	Dos command lines:	md c:\wildcat\cdrom\pier1
					md c:\wildcat\cdrom\pier2
					md c:\wildcat\cdrom\pier3
					md c:\wildcat\cdrom\pier4
					md c:\wildcat\cdrom\pier5
					md c:\wildcat\cdrom\nowl13
				 	
	4.  Use wcDraw and create cdroms.bbs, listing all of the
		cd roms you have made a directory for, with a number
		beside each: (MAXIMUM 18)
	for example see *CDROMS.BBS EXAMPLE START* later in this document.

	5.  Use a text editor (Dos Edit, for example), and create a file
		named cdroms.dir that contains the directory names in the 
		same order they	are listed in the cdroms.bbs file.  
		IE: pier1 first, pier2 second, pier3 third, etc.  

		pier1
		pier2
		pier3
		pier4
		pier5
		nowl13

		NOTE: YOU MAY LIST A MAXIMUM OF 18 CD ROMS!

		Each name must be on a line by itself, and must start in
		the first column (column 1, all the way to the left).  There
		must not be any spaces in this file after the names.

	6.  Use wcDraw to create or modify a directory listing for each
		of the directories on each cd rom. Call that listing dirs1.bbs,
		and place in the appropriate cd rom directory (ie:pier1)
		Place a number in front of each directory, starting at 1,
		and going up to 99.

    	for example see  *DIRS1.BBS EXAMPLE START* later in this document

	7.  use a text editor, and create paths.dir in that directory 
		(ie: pier1).

		1.  The first line in this file contains the number of 
			dirsx.bbs files (up to 9) in this directory.
		2.  The second line contains the number of directories total
			in this listing (up to 99)  (ie:50)
		3.  Lines 3 through xx contain the drive and directory to 
			find the directorie's files in.  This can be any
			drive, any directory.
		4.  Lines starting with // are ignored and not counted

	for example: see *PATHS.DIR EXAMPLE START* later in this document.

	8.  Create or obtain an industry standard compatible directory 
		listing, based on the PC Board format for each and
		every directory.  Strip out any	header information at 
		the beginning of the file.
		The first directory listing file must be named DIR001,
		the second DIR002, and so forth (up to DIR099).

		Format usage:
			columns 1-12  = file name or SPACES!!! (important)
			columns 13-80 = ignored, except for:
			the '|' must be used to continue the file listing
			from line to line!!!  Otherwise the line is 
			considered a file name!!!

	for example see *DIR001 EXAMPLE START* later in this document

	9.  Use MakeMenu to add the appropriate command to your menu system.
		Make it execute CDROMS.WCX		

	10. Modify your cat.bat file in each subdirectory to include
		"SET CDROMDIR=x:\WILDCAT\CDROM" before running wildcat.
		This initializes the environment variable so CDROM 
		knows where to look for	its operational files. replace x:
		with your drive letter:
	11. Copy CDROMS.WCX into your wildcat directory. 
	
	12. Test!  Have fun!		


HOW THIS PROGRAM OPERATES:                                        

	Assuming this directory setup:
		C:\Wildcat\CDROM\Pier1
		C:\Wildcat\CDROM\Pier2
		C:\Wildcat\CDROM\Pier3
		C:\Wildcat\CDROM\Pier4
		C:\Wildcat\CDROM\Pier5
		C:\Wildcat\CDROM\cdrom6
	
	where Wildcat is your Mustang Software operations directory,
	and  CDROM is the name of the directory you chose to put
	the cdrom stuff in, and Pier1 through cdrom6 are the 
	subdirectories for each individual CDROM you have listed.



1. It shows the user the list of cd roms, and allow him to select
'  the cd rom of choice:
'
' file shown is cdroms.bbs, in the cdrom main directory
'---------------------------------
'|  1.  pier 1    4.  pier 4     |
'|  2.  pier 2    5.  pier 5	 |
'|  3.  pier 3    6.  Night owl13|
'---------------------------------
'  Select cdrom, D to download marked files, or Q to quit [Q]:

'--------------------------------------------------------------
' directory tree:         files:
'  \wildcat
'    |
'    |--\cdrom  ========= cdroms.bbs, cdroms.dir
'        |
'        |--\pier1 ====== dirs1.bbs, dirs2.bbs, paths.dir, dir001, dir002,...
'        |
'        |--\pier2 ====== dirs1.bbs, paths.dir, dir001, dir002, dir003...
'        |
'        |--\pier3 ====== dirs1.bbs, paths.dir, paths.dir, dir001, dir002, dir003...
'        |
'        |--\pier4 ====== dirs1.bbs, paths.dir, dir001, dir002, dir003...
'        |
'        |--\pier5 ====== dirs1.bbs, paths.dir,  dir001, dir002, dir003...
'        |
'        |--\cdrom6 ====== dirs1.bbs, paths.dir, dir001, dir002, dir003...

'  once the cd rom is chosen, the directory pointed to by that choice is
'  entered.  The file looked at for the cd rom directory is
'  cdroms.dir:
'    this file contains the directories in natural # order.
' in this example, pier1 is choice #1, pier2 choice #2, etc.

'  pier1
'  pier2
'  pier3
'  nowl13
'....................................................


'....................................................

'  inside that directory is the file  dirsxx.bbs (ie:dirs1.bbs).
' It is shown to the
' user, and the directory he wishes to look at is chosen, or a search
' option is given him.
'
'   1.  Games and Entertainment   4. os/2 programs
'   2.  misc                      5. word processor
'   3.  windows programs          6. who knows
'
'   Enter Directory Number, P to change
'   to previous menu, N for next menu, or Q to quit:[]
'
' the file 'paths.dir' is looked at.
' line #1 is the number (xx) of directory menu files (dirxx.bbs)
' line #2 is the number (xxx) of dirxxx files (ie: dir001)
' line #3 through end is a 1 to 1 correspondence to the dir files,
'         and contains the path to the files in that directory
'          ie: line 3 is dir001 path.  eg: w:\dir001
'              line 4 is dir002 path.  eg: w:\dir002

' Note: this allows you to put directories anywhere, even on a hard drive,
'       or to merge files between cd's to look as if they were on on cd,
'       just in separate directories
'....................................................
'  If the user chooses the directory number, the file that represents
'  that directory is opened, and shown to the user.  The user is allowed
'  to choose file #'s from that file to download, or to Q (quit), or enter
'  to continue the listing.  A list of marked files is built.
' 1.  foo.zip  3/24/93  This is a test listing
' 2.  foo1.zip 3/24/93  This is a test listing
' 3.  foo2.zip 3/24/93  This is a test listing
' 4.  foo3.zip 3/24/93  This is a test listing
' 5.  foo4.zip 3/24/93  This is a test listing
'  Enter # of file, D to download marked files, 
' S to search, Q to quit, enter to continue:
'
'  If the user chooses 'search', then he will be asked for a string
'  of words to search for.  The program will look through the current
'  dirxxx file for the files that match, then will display the list of 
' discovered  files to the user one at a time.  The user will be able to 
'  mark the file for download, or Q to quit, or enter to continue.
'
'....................................................'
' if the user chooses a file number, the file name is placed in the 
' Wildcat download queue, and copied to the temporary directory 
'....................................................'
'  If the user chooses to download marked files, the standard Wildcat
' the list is shown, and the user is allowed normal download commands
'==================================================================
	
COMMAND LINE OPTIONS

You may pass the following command line options to this program:
       '-?'  --- print this help

       '-D' --- print debugging statements while running
		      - note: this is invaluable in tracing down
		      -      those pesky directory problems!

       '-DIR=dirname' - use directory name after = instead of path statement.
                      - note: no spaces allowed! ie: -DIR=c:\wildcat\cdrom
			      THIS COMMAND LINE OPTION CAN BE USED INSTEAD
			      OF THE "SET CDROMDIR=" ENVIRONMENT VARIABLE.
 
FINAL NOTES

   dirlist.txt contains a listing of the files for the example.  Study
this listing to see exactly how the files are located in the sub directories.







EXAMPLES
----------------------------------------------------------------------------
---------------------examples-----------------------------------------------
*CDROMS.BBS EXAMPLE START*************************************************
@07@ @1E@ Ŀ @07@
@07@ @1E@     @1A@             DFW ValueLine Information Service@1E@                         @07@
@07@ @1E@                             CDROM Main Menu                                @07@
@07@ @1E@    --------------------------------------------------------------------    @07@
@07@ @1E@    1.  Pier 1                         10.                                  @07@
@07@ @1E@    2.  Pier 2                         11.                                  @07@
@07@ @1E@    3.  Pier 3                         12.                                  @07@
@07@ @1E@    4.  Pier 4                         13.                                  @07@
@07@ @1E@    5.  Night Owl #13                  14.                                  @07@
@07@ @1E@    6.                                 15.                                  @07@
@07@ @1E@    7.                                 16.                                  @07@
@07@ @1E@    8.                                 17.                                  @07@
@07@ @1E@    9.                                 18.                                  @07@
@07@ @1E@    --------------------------------------------------------------------    @07@
@07@ @1E@    @11@Enter the # of the CD ROM you wish to peruse, or S to search for files,@1E@ @07@
@07@ @1E@  @1A@  @11@D to Download marked files, or Q to quit [Q]:                          @1E@ @07@
@07@ @1E@                                                                            @07@
@07@ @1E@  @07@
*CDROMS.BBS EXAMPLE END*************************************************



*DIRS1.BBS EXAMPLE START*************************************************
 [ The cdrom ware disk #2 ]Ŀ 
  1 Animations            18 Fonts                  35 OS/2 Programs/Utils   
  2 Archive Utilities     19 GIF Pictures/Fractals  36 Printer Utilities     
  3 ASP Shareware         20 Gambling               37 Professional          
  4 BBS Doors/Utils       21 Games/Entertainment    38 Programing/Languages  
  5 BBS Programs          22 Genealogy              39 Screen Utils          
  6 Bible/Religious       23 Geoworks               40 Shells/Menus          
  7 CAD Programs/Utils    24 Graphics Programs      41 Sound Blaster Files   
  8 Clipper               25 Ham Radio              42 Sound/MIDI Files      
  9 Communications        26 Hard Disk/Floppy Utils 43 Sound/Music Prgms     
 10 DOS Utils/Helps       27 Health/Medical         44 Spreadsheets/Utils    
 11 DTP/Clipart           28 Kitchen Aids           45 Virus/Security        
 12 Database Programs     29 Legal Prgms/Files      46 Windows Apps. I       
 13 Demos Programs        30 Mail-List/Managers     47 Windows Apps. II      
 14 Desk/Home Programs    31 Mail-Readers/E-Mail    48 Windows Games         
 15 Education Programs    32 Math/Science           49 Word Processing       
 16 File/Directory Utils  33 Multitask/Operating    50 WordPerfect           
 17 Finance/Business      34 Novell/LAN                                      
  
*DIRS1.BBS EXAMPLE END*************************************************

*PATHS.DIR EXAMPLE START**************************************************
//..............................................................
// Notes:
// 1.  Any line beginning with // is a comment.
// 2.  No spaces or tabs after info on a readable line!
// 3.  Blank lines are forbidden.
//		BE SAFE == make blank lines comment lines!
//
// first line is the number of dirsxx.bbs files
// second line is the number of dirs total
//..............................................................
// only 1 dirsxx.bbs (dirs1.bbs)
1
// dir001-dir050
50
//..............................................................
// The following are in the same order as the dirs1.bbs
// ie: directory #1 in dirs1.bbs is Animations Graphics, which 
//     also happens to be in dir 001 on drive o:  It could have
//     been on drive q: in directory \animgra
//..............................................................
// Animations DIR001
o:\001
// Archive Utilities DIR002
o:\002
// ASP Shareware     DIR003
o:\003
// BBS Doors/Utils
o:\004
// BBS Programs
o:\005
// Bible/Religious
o:\006
// CAD Programs/Utils
o:\007
// Clipper
o:\008
// Communications
o:\009
// DOS Utils/Helps
o:\010
// DTP/Clipart
o:\011
// Database Programs
o:\012
// Demos Programs
o:\013
// Desk/Home Programs
o:\014
// Education Programs
o:\015
// File/Directory Utils
o:\016
// Finance/Business
o:\017
// Fonts
o:\018
// GIF Pictures/Fractals
o:\019
// Gambling
o:\020
// Games/Entertainment
o:\021
// Genealogy
o:\022
// Geoworks
o:\023
// Graphics Programs
o:\024
// Ham Radio
o:\025
// Hard Disk/Floppy Utils
o:\026
// Health/Medical
o:\027
// Kitchen Aids
o:\028
// Legal Prgms/Files
o:\029
// Mail-List/Managers
o:\030
// Mail-Readers/E-Mail
o:\031
// Math/Science
o:\032
// Multitask/Operating
o:\033
// Novell/LAN
o:\034
// OS/2 Programs/Utils
o:\035
// Printer Utilities
o:\036
// Professional
o:\037
// Programing Languages
o:\038
// Screen Utils
o:\039
// Shells/Menus
o:\040
// Sound Blaster Files
o:\041
// Sound/MIDI Files
o:\042
// Sound/Music Prgms
o:\043
// Spreadsheets/Utils
o:\044
// Virus/Security
o:\045
// Windows Applications 1
o:\046
// Windows Applications 2
o:\047
// Windows Games
o:\048
// Word Processing
o:\049
// WordPerfect
o:\050
*PATHS.DIR EXAMPLE END**************************************************

*DIR001 EXAMPLE START**************************************************
4FC12.ZIP       25211  09-01-92  4Comment: Extracts file descriptions from
                               | textfile and installs as 4dos comments or as
                               | comments in zip/pak/arj/zoo file.  Also
                               | extracts comments from compressed file to
                               | text file.  4dos ver 3 and 4 compatible.
4MICA26.ZIP     12466  06-25-92  4dos archive shell v2.6 (zip/arj and now lha!
ACZAR100.ZIP   371029  10-11-92  SHEZ ARCMASTER ZIP PAK ARJ LZH ARC ZOO AC
                               | Was SHEZ or ARCMASTER too difficult?  Try
                               | this new archive shell ACZAR.  This is
                               | Version 1.00 (non-beta) with lots of
                               | improvements.  Fearures full mouse support,
                               | state of the art SAA interface, supports
                               | ZIP, ARJ, ARC, LZH, PAK, and ZOO files,
                               | McAfee's virus scanner SCAN.EXE 95b,
                               | built-in high speed file viewer and more...
AM69A.ZIP      197421  01-04-92  ArcMaster v6.9a Shell for Compressed Files
AM70.ZIP       206466  01-31-92  Newlin: ArcMaster v7.0: Ready for PKZIP 2
AM82.ZIP       211845  09-30-92  ArcMaster v8.2 - classic shareware Archives
                               | shell/manager/manipulator program.
AM83.ZIP       218382  10-30-92  ArcMaster v8.3 Archive Program
                               | Interface/Shell - Shareware classic!
APRUNE11.ZIP    11427  02-08-92  ARchive Pruner, freeware from Richard
                               | Whisen, prunes from a ZIP or LZH archive all
                               | files thatdo not match files in source dir
ARCDIRS.ZIP     16517  03-10-92  Allow you to compress (LZH method) all file
                               | in all your directories in one and only
                               | command.  Create a compressed file in each
                               | directory.  Belgian stuff.
*DIR001 EXAMPLE END**************************************************

PACKING LIST:

	cdrwcx1a.zip should contain

	1.  cdroms.wcx
	2.  cdroms.txt
	3.  dirlist.txt  (contains listing of directories for an example)

FEATURES:

	1. Download is seamlessly integrated with the rest of the Wildcat
		System.

	2. CD Roms may be added or removed without shutting down Wildcat.

	3. Sysop Mail Message notification of failed file marking.  
		This allows you to assign offline cd's to a non-existent 
		drive.  You are sent a mail message containing the drive, 
		directory, and file name.  You can then mail the file 
		back to the user, in a mail Reply message.

	4. Free.  No warranties.  No payments (unless you want the source
		code!)
