home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / MAXIMUS / CDCAR_13.ZIP / CDCAR.DOC < prev    next >
Text File  |  1994-02-18  |  18KB  |  440 lines
  1.                       
  2.                            CD Carousel Door
  3.                                  v1.3
  4.                            by Bill Esposito
  5.                           The Cereal Port BBS
  6.                                1:132/152
  7.                              (603)899-3335
  8.                    bill.esposito@f152.bytepb.byte.com
  9.  
  10.                           Magic name 'CDCAR'
  11.                           for latest version
  12.  
  13. **********************************************************************
  14. DISCLAIMER:  This software is provided "AS IS" without any warranty of
  15. any kind, either expressed or implied.  USE IT AT YOUR OWN RISK.
  16.  
  17. Copyright 1993 by Bill Esposito.  This program is SHAREWARE.    Please
  18. read the file SHAREWRE.TXT included in this archive.
  19. **********************************************************************
  20.  
  21. What this archive contains:
  22.  
  23.   CDCar.doc      This file.
  24.   CDMenu.cmd     The CD Carousel Local menu program.
  25.   CDCar.cmd      The CD Carousel Door REXX program.
  26.   CDCar.cfg      The CD Carousel configuration file.
  27.   CDMaint.cmd    The CD Carousel File/msg maintenance REXX program.
  28.   CDConvrt.cmd   The CD Carousel Files.bbs conversion REXX program.
  29. * CDUpdate.cmd   The CD Carousel File Area Maintenance/Update REXX program.
  30.   Rxmsgapi.dll   The REXX/SQUISH DLL written by Colin Adams.
  31.   CDBull.txt     Sample bulletin file.
  32.   CDhelp.txt     CD Carousel's help file.
  33.   Sharewre.txt   Registration information.
  34.   History.txt    Revision information.
  35.   Whats.new      New features/fixes for this release.
  36.  
  37. * Registered version only
  38.             -----------------------
  39.  
  40. What is CD Carousel?
  41.  
  42.     CD Carousel is a collection of REXX programs which when used
  43. together provide a fairly simple means for making multiple CD Roms
  44. available on single CDROM drive Maximus/2 BBS's.
  45.  
  46.     Basically CD Carousel provides the user with a listing of all your
  47. data CD's from which he can "request" offline files.  The Sysop can
  48. then, once a day, once a week, or whatever, manually run the CDMenu
  49. program which will prompt for the required data CD's, and
  50. automatically copy the requested files to a predefined file area for
  51. download by the user.  The CDMenu program will also generate a
  52. message in either squish or *.msg format acknowledging that the
  53. "request" has been successfully fulfilled.
  54.                   *  Registered version only * 
  55. Once the user has downloaded his file, CDUpdate.cmd will clean up the file
  56. areas.  If a file has more than    one request against it, CD Carousel will keep
  57. track of them, finally deleting the file, and it's entry in the files.bbs,
  58. when all requests have been satisfied.
  59.  
  60.             ----------------------
  61.  
  62.     CD Carousel is not designed for real time access to your CDROM.  
  63. However, you can configure CD Carousel to treat your Online CD as an 
  64. Offline CD.  Everything will work the same except instead of generating
  65. a request, CD Carousel will copy the files to your request directory for
  66. immediate download.  This provides for a very fast search and browse
  67. function. 
  68.          
  69.     If you want to have access to your CDROM like a normal Max/2 file area then
  70. you must set up MAX/2 File Areas for your online disk.
  71.  
  72.  
  73. Installation.
  74.  
  75. REXX must be installed.  If it is not, use the "Selective Install" function in
  76. your OS/2 "Setup" folder.
  77.  
  78. ***** The CD must already be "BBS Ready" with Files.bbs files contained
  79. *****
  80. ***** in each directory.  Here's an example:
  81. *****
  82. *****       \ Root
  83. *****           IBMPC
  84. *****             Utilities
  85. *****                files.bbs
  86. *****                filename.ext
  87. *****                etc.
  88. *****              Graphics
  89. *****                files.bbs
  90. *****                filename.ext
  91. *****                etc.
  92. *****              GIFS
  93. *****                files.bbs
  94. *****                *.gif
  95. *****                etc
  96. *****
  97. ***********************************************************************
  98.  
  99. 1.  Create a directory for CD Carousel.  Since all the file lists of
  100.     your CD's will be stored on this disk, make sure you have plenty
  101.     of space.  Figure on about 1 meg for each CD.
  102.  
  103. 2.  Unzip the CDCAR.ZIP archive into this directory.
  104.     a. Move the Rxmsgapi.dll to your \OS2\DLL directory.
  105.     b. Move the CDUpdate.cmd to your Maximus/2 directory.
  106.     
  107.  
  108. ******  Don't forget the trailing backslashes in the pathnames *****
  109.  
  110. 3.  Edit the variables in CDCar.CFG to suit your needs.
  111.  
  112. TechTool                1st line - Select a name that will represent
  113.                                    the default disk that will shown to
  114.                                    the user when he enters CD
  115.                                    Carousel. This should match the
  116.                                    name you pick for this disk when
  117.                                    you run CDConvrt.cmd.
  118.  
  119. 0                       2nd line - Menu Style. 0 for default and
  120.                                    1 for Maximus/2 style.
  121.  
  122. j:\cd\                  3rd line - Drive:\path\ where CD Carousel
  123.                                    resides. (cdcar.cmd)
  124.  
  125. e:\max\                 4th line - Drive:\path\ to LastusXX.bbs file.
  126.  
  127. i:\max\file99\          5th line - Drive:\path\ to file area where requested 
  128.                                    files are to be placed.  CD Carousel does
  129.                                    not delete these files after User download,
  130.                                    The Sysop must perform the house cleaning.
  131.                                    To aid in this, a download counter is
  132.                                    recommended.
  133.  
  134. 99                      6th line - File area number (ex. 99)
  135.  
  136. SQUISH                  7th line - Enter the type of message base that is being
  137.   ^                                used to receive msgs from CD Carousel to the
  138.   |                                USER.(ie. The area defined by next parameter)
  139.   |                                SQUISH or .MSG
  140.   |                                SQUISH  = Squish format area
  141.   |__Must be in UPPER CASE         SDM     = *.msg format area
  142.                                    SDMECHO = *.msg format echomail
  143.                                    (1.msg as a highwater mark)
  144.  
  145. E:\max\msg\comments     8th line - Message area where acknowledgments
  146.                                    go.  This will either point to a
  147.                                    directory for *.msg bases or a
  148.                                    areaname for SQUISH bases.
  149.  
  150. 1:132/152.0             9th line - To Node complete address including
  151.                                    point (1:132/152.0)
  152.  
  153. 1:132/152.0            10th line - From Node complete address
  154.                                    including point (1:132/152.0).
  155.                                    Normally the same as the TO node.
  156.  
  157. Bill Esposito          11th line - Sysops Name
  158.  
  159. SQUISH                 12th line - Enter the type of message base that is
  160.   ^                                being used to receive msgs from CD Carousel
  161.   |                                to the SYSOP. (ie. The area defined next)
  162.   |                                SQUISH or .MSG
  163.   |                                SQUISH  = Squish format area
  164.   |__Must be in UPPER CASE         SDM     = *.msg format area
  165.                                    SDMECHO = *.msg format echomail
  166.                                    (1.msg as a highwater mark)
  167.  
  168.  
  169. E:\max\msg\comments    13th line - Message area where the SYSOP will receive
  170.                                    messages from CD Carousel.  This will either
  171.                                    point to a directory for *.msg bases or a
  172.                                    areaname for SQUISH bases.
  173.  
  174. 1                      14th line - Public or Private message to users.
  175.                                    Enter either "1" for Private or "0" for
  176.                                    Public. (private recommended)
  177.                                    * This is new to v1.1
  178.  
  179. Simtel20               15th line - Name of the CD normally installed in CDROM
  180.                                    If you do not want CD Carousel to copy files
  181.                                    from your Online CD, delete the entire 15th
  182.                                    line of the .cfg file.
  183.                                    * New to v1.2
  184.  
  185. 4.  Now run CDMenu.cmd.
  186.  
  187.     a.  Select the option S)et-up a new cd.
  188.  
  189.     b.  CDConvrt.cmd will be executed and will prompt you for a name
  190.         to be given to the data CD.  This name should be descriptive,
  191.         and be no more than 8 characters long. (mark the cd with the
  192.         name for future use)
  193.  
  194.         Example:  Simtel20
  195.  
  196.     c.  You will also be asked for the CDrom drive letter. For the
  197.         example below, "L" would be entered.
  198.  
  199.             Simtel20 CD
  200.                L:\msdos\4DOS
  201.                L:\msdos\ABC
  202.                L:\msdos\ADA
  203.                L:\msdos\AI
  204.                L:\msdos\AIJOURNL
  205.                   etc...
  206.  
  207.     If configured properly, it will read the files.bbs off your CDROM,
  208.     add size and date info, and copy the new file into a subdirectory
  209.     corresponding to the name you entered for this disk.
  210.  
  211.     Example: Given the paths listed in 4 above, CDConvrt will read
  212.     the CD in L:.  It will scan all the file areas and copy each
  213.     files.bbs, with the new size/date info into a subdirectory under
  214.     j:\cd\ named after the disk, Simtel20.
  215.  
  216.      creates:  j:\cd\simtel20
  217.                      4DOS.BBS
  218.      contains the    ABC.BBS
  219.      files.bbs's     ADA.BBS
  220.                      AI.BBS
  221.                      AIJOURNL.BBS
  222.  
  223.  
  224.     In order to provide for compatibility with many different CD
  225.     directory layouts, CDConvrt must search your CD for directories
  226.     which contain Files.BBS.  This process is time consuming (unless
  227.     you have one of those new triple speed drives!), so be patient.
  228.     CDConvrt must search the disk twice, once to find all the
  229.     directories, and the second pass to convert all the Files.BBS's
  230.     into the new format.
  231.  
  232.  
  233.     The CDConvrt.cmd utility converts standard Max-type files.bbs
  234.     files like this:
  235.  
  236.     AR15.ZIP       Run a program from an ARC file
  237.     ARCINDX2.ZIP   Create a catalog of archived data
  238.     ARCRUNER.ZIP   Run COM and EXE files in archives
  239.  
  240.  
  241.     Into this format with size and date info added, and the
  242.     description truncated to result in a line length of 79 characters:
  243.  
  244.     AR15.ZIP        39323 11/10/88  Run a program from an ARC file
  245.     ARCINDX2.ZIP    42633  7/23/88  Create a catalog of archived data
  246.     ARCRUNER.ZIP     8096  8/29/88  Run COM and EXE files in archives
  247.  
  248.     You may manually edit non-standard files.bbs or index lists to
  249.     conform to the above if you don't have the standard type which is
  250.     needed for CDConvrt.cmd to work.
  251.  
  252.     If your disk contains files.bbs which already have date/size info, then
  253.     answer 'Y' to the prompt "Do the files.bbs already contain date/size
  254.     information? (y,n)"
  255.  
  256.     You will also be asked if you want to sort the directories.  This may be
  257.     helpful with disks that contain multiple subdirectories with the same
  258.     name. (ex. Hobbes)
  259.  
  260.     Speaking of multiple subdirectories with the same name, CD Carousel will
  261.     prompt you for a new name when this occurs.  Lets say for the sake of
  262.     argument that there are three subdir's with the same name:
  263.  
  264.      l:\os2\comm
  265.      l:\os2\1x\comm
  266.      l:\os2\2x\comm
  267.  
  268.     You will be prompted at the second and third occurrence of the subdir "comm"
  269.     for a new name.  Keep track of the new name so you know what you've used when
  270.     the third occurrence rolls around.  CD Carousel will not let you enter the
  271.     same name twice.
  272.     
  273.  
  274. 5.  If everything ran right, a file called DISK.LST was created in
  275.     your homedir.  This file contains the names of the disks, as you
  276.     entered them in CDConvrt.  You may OPTIONALLY add CD disk descriptions
  277.     If you ever delete a disk, you will have to edit this file.  If you want
  278.     to add a disk, this file is automatically updated.  Also created was a
  279.     directory with the same name as you gave the CD, and it will contain all
  280.     the *.BBS files as well as a list of area names (name.lst).
  281.  
  282. 6.  One other file was created and placed in the same directory as
  283.     the files.bbs.  The file, NAMES.LST, contains the CD file area names
  284.     and also the full drive:\path of all the CD directories.  You may
  285.     OPTIONALLY add File Area descriptions to this file.
  286.  
  287.     example: Here's the first 3 lines of the NAMES.LST as it was
  288.              generated by S)etup (CDConvrt.cmd).
  289.  
  290.                          4DOS L:\MSDOS\4DOS
  291.                          ABC L:\MSDOS\ABC
  292.                          ADA L:\MSDOS\ADA
  293.  
  294.              If you want to add File Area Descriptions, use an ASCII
  295.              editor to make it look like this:
  296.  
  297.                          4DOS L:\MSDOS\4DOS Great Command Processor
  298.                          ABC L:\MSDOS\ABC Strange Programming Language
  299.                          ADA L:\MSDOS\ADA ADA Programming Language
  300.  
  301.  
  302. 7.  Repeat steps 4, and 5 for each CD you wish to install.
  303.  
  304. 8.  To make CD Carousel available to your users, add a line to your
  305.     menus.ctl like this:
  306.  
  307. Xtern_run maxpipe_%P_j:\cd\cdcar.cmd_j:\cd\_%g_0_%n normal "+CD Carousel"
  308.                                  ^     ^     ^ ^  ^
  309. Full Path & filename of CDCAR.CMD|     |     | |  |
  310.                 Path to CDCAR.CFG _____|     | |  |
  311.                     Graphics Mode ___________| |  |
  312.                      Place holder _____________|  |
  313.                         User Name ________________|
  314.  
  315. 9.  Edit your filearea.ctl to add a file area for the requested files.
  316.  
  317. 10  * Registered version only *
  318.     Edit your SpawnBBS.cmd file (ie. the batch file used to start Max/2) to
  319.     include these two lines:
  320.     
  321.     cd\max  ;Change to your BBS directory
  322.     
  323.     cdupdate e:\max\ e:\max\max.log i:\max\file99\
  324.                  ^            ^           ^
  325. full path to BBS_|            |           |
  326. full path\filename of Max.log_|               |
  327. full path to file request area_____________|
  328.     
  329.     ** Dont forget the Trailing Backslashes on all pathnames **
  330.     
  331. 11. Edit the BULLETIN.TXT file to your liking. Use an ASCII editor and
  332.     keep the line length to 79 or fewer characters per line.
  333.  
  334.                                OPERATION
  335.  
  336. The BBS User will be presented with the following options:
  337.  
  338. C)hange Disk
  339. F)ile Area
  340. S)earch by Filename/Text
  341. B)ulletins
  342. ?)Help
  343. Q)uit Back to BBS
  344.  
  345. "Change Disk" will present the User with all available CD's from which he can
  346. choose.
  347.  
  348. "File Area" will present the User with a list of all the file areas available
  349. on the selected disk.
  350.  
  351. "Search by Filename/Test" is a string search of all the filenames and
  352. descriptions for the selected CD.  If you set up CD Carousel to work with your
  353. ONLINE CD by entering it's name as line 15 in Cdcar.cfg, your Users will have a
  354. very fast file lookup available to them, much faster than from the Max/2 file
  355. menu.
  356.  
  357. "Bulletins" displays the file CDbull.txt, in which you can put anything you want.
  358.  
  359. "?Help" displays the file CDhelp.txt.
  360.  
  361. "Quit back to BBS" sends the user back to your BBS.  If you set up your ONLINE
  362. CD by entering it's name as parameter line 15 in CDcar.cfg, then those files
  363. will be copied to your file request directory for immediate download.
  364.  
  365.                     ---------------------------
  366.                     
  367.     At the end of the day, or at whatever frequency you want, you must
  368. manually run CDMenu.cmd.  You will be notified by CD Carousel in the msg
  369. area defined by config parameter 13 when there is at least one (1) pending
  370. request.  When you receive this message, run CDMenu.cmd.  When the menu comes
  371. up, select F)ill file requests.  This will run CDMaint.cmd.  When run, it will
  372. prompt you for each disk that has an outstanding request against it.  It will
  373. also ask you if you want to set the file(s) for a free download by offering you
  374. the options of adding either /t, /b, or /tb to the files.bbs.  After copying
  375. the files, it will send a message to the user telling him/her that their request
  376. has been fulfilled.  If for some reason an error while copying occurs, the
  377. error will be entered in a file called 'errors.log'.  This file can be reviewed
  378. and/or deleted by selecting R)eview error log at the main menu.
  379.  
  380.     a.  To run the CD Carousel door in the local mode select L)ocal CD
  381.         Carousel from the CDMenu menu.
  382.  
  383.     b.  You can also run the door from the command line by typing:
  384.  
  385.               cdcar default_dir graphics 0 first last
  386.                       which works out to
  387.               cdcar j:\cdcar\ 1 0 Bill Esposito
  388.  
  389.     c.  You can run CDMaint.cmd from the command line by typing
  390.         "cdmaint".
  391.  
  392.     d.  You can run CDConvrt.cmd from the command line by typing
  393.         "cdconvrt".
  394.  
  395. 10. Review of CDMenu.cmd.
  396.  
  397.     S)et-up a new cd    - Runs CDConvrt.cmd.  Creates new .BBS files on
  398.                           your hard disk.
  399.  
  400.     F)ill file requests - Runs CDMaint.cmd.  Copies files from your CD
  401.                           to a Max/2 file area.
  402.  
  403.     L)ocal CD Carousel  - Runs the door, CDCar.cmd, in the local mode.
  404.  
  405.     R)eview error log   - Displays the error log containing a list of
  406.                           requests that were not filled because of some
  407.                           file copying error.
  408.  
  409. **********************************************************************
  410.  
  411.                       Maximus/2 2.01wb CDROM BUG
  412.  
  413. If you already have a working Max/2 CDROM setup, then don't bother
  414. reading this, you've already applied the patch.
  415.  
  416. You MUST patch Max/2 v2.01wb in order for your CDROM to be found by
  417. both Max/2 and Siltp. The error manifests itself you producing Siltp
  418. errors trying to create the file areas on you CDROM, and then Max/2
  419. cant locate the CD.  Here's the patch.
  420.  
  421. Patch Maxp and Siltp at the following locations:
  422.  
  423. MAXP.EXE:  at offset 299430 (0x491a6), change 06 to 00
  424. SILTP.EXE: at offset 31859 (0x7c73), change 06 to 00
  425.  
  426. You can use Patch.EXE located in your OS/2 directory.
  427.  
  428.  
  429. Bug Reports
  430.  
  431.   Please send all bug reports to Bill Esposito at:
  432.  
  433. FidoNet   1:132/152
  434.  
  435. Internet  bill.esposito@f152.bytepb.byte.com
  436.  
  437. UUCP      bytepb.byte.com!f152!bill_esposito
  438.  
  439. End.
  440.