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!)