home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / cdcr206a.zip / CDCAR.DOC < prev    next >
Text File  |  1995-10-29  |  37KB  |  796 lines

  1. /*                           CD Carousel                                   */
  2. /*                         by Bill Esposito                                */
  3. /*                              v2.06                                      */  
  4. /*                       The Cereal Port BBS                               */
  5. /*                            1:132/152                                    */
  6. /*                          (603)899-3335                                  */
  7. /*                    bill.esposito@cereal.mv.com                          */
  8. /*                         Magic name 'CDCAR'                              */
  9. /*                         for latest version                              */
  10. /*                                                                         */
  11. /* *********************************************************************** */
  12. /* DISCLAIMER:  This software is provided "AS IS" without any warranty of  */
  13. /* any kind, either expressed or implied.  USE IT AT YOUR OWN RISK.        */
  14. /*                                                                         */
  15. /* Copyright 1993, 1994, 1995 by Bill Esposito.  This program is SHAREWARE.*/
  16. /* Please read the file SHAREWRE.TXT included in this archive.             */
  17. /*                                                                         */
  18. /* CD Carousel and it's support programs are not to be modified or         */
  19. /* distributed in modified form without the express written permission of  */
  20. /* The author, Bill Esposito.                                              */
  21. **********************************************************************
  22.  
  23. What this archive contains:
  24.  
  25.   CDCar.doc      This file.
  26.   CDMenu.cmd     The CD Carousel Local menu program.
  27.   CDCar.cmd      The CD Carousel Door REXX program.
  28.   CDCar01.cfg    The CD Carousel configuration file.
  29.   CDCar.mec      A door 'drop' file which contains privs and keys
  30.   CDMaint.cmd    The CD Carousel File/msg maintenance REXX program.
  31.   CDConvrt.cmd   The CD Carousel Files.bbs conversion REXX program.
  32. * CDUpdate.cmd   The CD Carousel File Area Maintenance/Update REXX program.
  33. * CDPurge.cmd    Purges the file request area of old files by age or user name. 
  34. * CDOklst.cmd    Creates an "Okfile.lst" for your Online CD's 
  35.   CDCar.ico      PM Icon for CD Carousel
  36.   Seticon.cmd    REXX script to create a desktop Icon for CD Carousel.
  37.   CDBull.txt     Sample bulletin file.
  38.   CDhelp.txt     CD Carousel's help file.
  39.   Sharewre.txt   Registration information.
  40.   History.txt    Revision information.
  41.   Whats.new      New features/fixes for this release.
  42. * Allfiles.cmd   File List Utility
  43.   Rxmsgapi.dll   The SQUISH/REXX DLL written by Colin Adams.
  44.   SRI.zip        The complete SQUISH/REXX archive written by Colin Adams.
  45.  
  46. * Registered version only
  47.                         -----------------------
  48.  
  49. What is CD Carousel?
  50.  
  51.     CD Carousel is a collection of REXX programs which when used together
  52. provide a fairly simple means for making multiple CD Roms available on single
  53. CDROM drive Maximus/2 BBS's.  With this release, CD Carousel can now be
  54. used in a multiline environment as well as configured with privilege and lock
  55. control.  CD Carousel can also as for "stand-alone" operation, for those who 
  56. don't run a BBS.  You can use CD Carousel as a front-end for all CD's that are
  57. "BBS" ready.  CD Carousel fully supports the Pioneer CD Changers.
  58.  
  59.     Basically CD Carousel provides the user with a listing of all your
  60. data CD's from which he can "request" offline files.  The Sysop can then, once 
  61. a day, once a week, or whatever, manually run the CDMenu program which will 
  62. prompt for the required data CD's, and automatically copy the requested files 
  63. to a predefined file area for download by the user.  All user privileges and the
  64. numeric keys are fully supported. The CDMenu program will also generate a 
  65. message in either squish or *.msg format acknowledging that the "request" has 
  66. been successfully fulfilled.  In the "stand-alone" mode, CD Carousel's operation
  67. differs only in that messages are not generated.
  68.                   *  Registered version only *
  69. Once the user has downloaded his file, CDUpdate.cmd will clean up the file
  70. areas.  If a file has more than one request against it, CD Carousel will keep
  71. track of them, finally deleting the file, and it's entry in the files.bbs,
  72. when all requests have been satisfied.  CDUpdate.cmd also now features down-
  73. load counting and "Uploaded by" options.
  74.  
  75.                         ----------------------
  76.  
  77.     CD Carousel is not designed for real time access to your CDROM.
  78. However, you can configure CD Carousel to treat your Online CD as an
  79. Offline CD.  Everything will work the same except instead of generating
  80. a request, CD Carousel will copy the files to your request directory for
  81. immediate download.  This provides for a very fast search and browse
  82. function.
  83.  
  84.     If you want to have access to your CDROM like a normal Max/2 file area then
  85. you must set up MAX/2 File Areas for your online disk.
  86.  
  87.  
  88. Installation.
  89.  
  90. REXX must be installed.  If it is not, use the "Selective Install" function in
  91. your OS/2 "Setup" folder.
  92.  
  93. ***** The CD must already be "BBS Ready" with Files.bbs type files.
  94. *****
  95. ***** Here's some examples:
  96. *****
  97. *****       \ Root
  98. *****           IBMPC
  99. *****             Utility
  100. *****                files.bbs
  101. *****                filename.ext
  102. *****                etc.
  103. *****              Graphics
  104. *****                files.bbs
  105. *****                filename.ext
  106. *****                etc.
  107. *****              GIFS
  108. *****                files.bbs
  109. *****                *.gif
  110. *****                etc
  111. ***********************************************************************
  112. *****       \ Root
  113. *****           IBMPC
  114. *****             Utility
  115. *****                00_index.txt
  116. *****                filename.ext
  117. *****                etc.
  118. *****              Graphics
  119. *****                00_index.txt
  120. *****                filename.ext
  121. *****                etc.
  122. *****              GIFS
  123. *****                00_index.txt
  124. *****                *.gif
  125. *****                etc
  126. ***********************************************************************
  127. *****       \ Root
  128. *****           IBMPC
  129. *****             Utility
  130. *****                utility.txt
  131. *****                filename.ext
  132. *****                etc.
  133. *****              Graphics
  134. *****                graphics.txt
  135. *****                filename.ext
  136. *****                etc.
  137. *****              GIFS
  138. *****                gifs.txt
  139. *****                *.gif
  140. *****                etc
  141. ***********************************************************************
  142. *****       \Root
  143. *****          Utility
  144. *****             filename.ext
  145. *****             etc
  146. *****          Graphics
  147. *****             filename.ext
  148. *****             etc
  149. *****          Gifs
  150. *****             Filename.ext
  151. *****             etc
  152. *****          Lists
  153. *****             utility.lst
  154. *****             graphics.lst
  155. *****             gifs.lst
  156. *****             etc
  157. *****
  158. ***********************************************************************
  159.  
  160. 1.  Create a directory for CD Carousel.  Since all the file lists of
  161.     your CD's will be stored on this disk, make sure you have plenty
  162.     of space.  Figure on about 1 meg for each CD.
  163.  
  164. 2.  Unzip the CDCAR.ZIP archive into this directory.
  165.     a. Move the Rxmsgapi.dll to your \OS2\DLL directory.
  166.   * b. Move the CDUpdate.cmd to your Maximus/2 directory.
  167.  
  168. * Registered version only
  169.  
  170. ******  Don't forget the trailing backslashes in the pathnames *****
  171.  
  172. 3.  Edit the variables in CDCar.CFG to suit your needs.
  173.     BE SURE TO SEPARATE YOUR COMMENTS FROM THE VARIABLES WITH A SEMICOLON ";"
  174.  
  175. TechTool               ;1st line - Select a name that will represent
  176.                        ;           the default disk that will shown to
  177.                        ;           the user when he enters CD
  178.                        ;           Carousel. This should match the
  179.                        ;           name you pick for this disk when
  180.                        ;           you run CDConvrt.cmd. See section
  181.                        ;           on privs and keys.
  182.                        ;
  183. 0                      ;2nd line - Menu Style. 0 for default and
  184.                        ;           1 for Maximus/2 style.
  185.                        ;
  186. j:\cd\                 ;3rd line - Drive:\path\ where CD Carousel
  187.                        ;           resides. (cdcar.cmd)
  188.                        ;
  189. e:\max\                ;4th line - Drive:\path\ to LastusXX.bbs file.
  190.                        ;
  191. i:\max\file99\         ;5th line - Drive:\path\ to file area where requested
  192.                        ;           files are to be placed.  In the Unregistered
  193.                        ;           version, CD Carousel does not delete these
  194.                        ;           files after User download, The Sysop must
  195.                        ;           perform the house cleaning.
  196.                        ;
  197. 99                     ;6th line - File area number or name (ex. 99, CD_Carousel)
  198.                        ;
  199. SQUISH                 ;7th line - Enter the type of message base that is being
  200.   ^                    ;           used to receive msgs from CD Carousel to the
  201.   |                    ;           USER.(ie. The area defined by next parameter)
  202.   |                    ;           SQUISH or .MSG
  203.   |                    ;           SQUISH  = Squish format area
  204.   |__Must be in UPPER CASE ;       SDM     = *.msg format area
  205.                        ;           SDMECHO = *.msg format echomail
  206.                        ;           (1.msg as a highwater mark)
  207.                        ;
  208. E:\max\msg\msg1        ;8th line - Message area where acknowledgments
  209.                        ;           go.  This will either point to a
  210.                        ;           directory for *.msg bases or a
  211.                        ;           areaname for SQUISH bases.
  212.                        ;
  213. 1:132/152.0            ;9th line - To Node complete address including
  214.                        ;           point (1:132/152.0)
  215.                        ;
  216. 1:132/152.0           ;10th line - From Node complete address
  217.                       ;            including point (1:132/152.0).
  218.                       ;            Normally the same as the TO node.
  219.                       ;
  220. Bill Esposito         ;11th line - Sysops Name
  221.                       ;
  222. SQUISH                ;12th line - Enter the type of message base that is
  223.   ^                   ;            being used to receive msgs from CD Carousel
  224.   |                   ;            to the SYSOP. (ie. The area defined next)
  225.   |                   ;            SQUISH or .MSG
  226.   |                   ;            SQUISH  = Squish format area
  227.   |__Must be in UPPER CASE ;       SDM     = *.msg format area
  228.                       ;            SDMECHO = *.msg format echomail
  229.                       ;            (1.msg as a highwater mark)
  230.                       ;
  231.                       ;
  232. E:\max\msg\sysop      ;13th line - Message area where the SYSOP will receive
  233.                       ;            messages from CD Carousel.  This will either
  234.                       ;            point to a directory for *.msg bases or a
  235.                       ;            areaname for SQUISH bases.
  236.                       ;
  237. 1                     ;14th line - Public or Private message to users.
  238.                       ;            Enter either "1" for Private or "0" for
  239.                       ;            Public. (private recommended)
  240.                       ;            * This is new to v1.1
  241.                       ;
  242. 0                     ;15th line - 0 for priv/lock control and non-standard
  243.                       ;            files.bbs. 1 for no priv/lock and standard
  244.                       ;            files.bbs
  245.                       ;
  246. e:\max\max.log        ;16th line - Drive:\path\filename of your Max log file
  247.                       ;
  248. 0                     ;17th line - 0 for BBS mode, 1 for Stand-alone mode
  249.                       ;
  250. 0                     ;18th line - 0 to generate a message to the Sysop for 
  251.                       ;            EACH request, 1 for only message. 
  252.                       ;
  253. 0                     ;19th line - 0 for long file descriptions, 1 for 1 line.
  254.                       ;            Long will result in 10 files being displayed
  255.                       ;            per page, short will give 20 files.  See the
  256.                       ;            I)nfo menu option.
  257.                       ;            
  258. 0                     ;20th line - 0 for original file dates, 1 for todays date.
  259.                       ;            Selecting 1 will touch each copied file with
  260.                       ;            the current date, and thus make it easier to
  261.                       ;            clean up the files which were requested but
  262.                       ;            never downloaded. Future versions will do this
  263.                       ;            automatically
  264.                       ;
  265. 5                     ;21st Line - Number of days files are kept online. Enter
  266.                       ;            0 to disable (non-registered enter 0)    
  267.                       ;
  268. Future Expansion      ;22nd line -  Be sure you keep these lines in your 
  269. Future Expansion      ;23rd line -  CDCAR??.CFG for place holders.
  270. Future Expansion      ;24th line - /
  271.                       ;
  272.                       ;                    
  273. Simtel20              ;*25th line - Name of the CD normally installed in CDROM
  274.                       ;            If you do not want CD Carousel to copy files
  275.                       ;            from your Online CD, delete the entire 25th
  276.                       ;            line of the .cfg file.
  277.                       ;
  278.                       ;26th line - Enter the rest of your installed CD's, 1 per
  279.                       ;            line.  No limit.  If you have 6 online CD 
  280.                       ;            players, than the CD's will be entered on
  281.                       ;            lines 25 thru 30.
  282.                                   
  283.       * Just to clarif things, if you dont want to use the online CD function
  284.         then LINE 24 should be the last line in your Cdcar.cfg file.
  285.         
  286. 4.  Now run CDMenu.cmd.
  287.  
  288.     a.  Select the option S)et-up a new cd.
  289.  
  290.     b.  CDConvrt.cmd will be executed and will prompt you for a name
  291.         to be given to the data CD.  This name should be descriptive,
  292.         and be no more than 8 characters long. (mark the cd with the
  293.         name for future use)
  294.  
  295.         Example:  Simtel20
  296.  
  297.     c.  You will also be asked for the CDrom drive letter. For the
  298.         example below, "L" would be entered.
  299.  
  300.             Simtel20 CD
  301.                L:\msdos\4DOS
  302.                L:\msdos\ABC
  303.                L:\msdos\ADA
  304.                L:\msdos\AI
  305.                L:\msdos\AIJOURNL
  306.                   etc...
  307.                  
  308.     CD Carousel should support CD's with files.bbs in each subdirectory, a
  309.     files.bbs-like file in each subdirectory (be they all the same name or
  310.     named after the directory) or all the files.bbs-like files in one directory.
  311.  
  312.     If configured properly, it will read the files.bbs off your CDROM,
  313.     add size and date info, and copy the new file into a subdirectory
  314.     corresponding to the name you entered for this disk.
  315.  
  316.     Example: Given the paths listed in 4 above, CDConvrt will read
  317.     the CD in L:.  It will scan all the file areas and copy each
  318.     files.bbs, with the new size/date info into a subdirectory under
  319.     j:\cd\ named after the disk, Simtel20.
  320.  
  321.      creates:  j:\cd\simtel20
  322.                      4DOS.BBS
  323.      contains the    ABC.BBS
  324.      files.bbs's     ADA.BBS
  325.                      AI.BBS
  326.                      AIJOURNL.BBS
  327.  
  328.  
  329.     In order to provide for compatibility with many different CD
  330.     directory layouts, CDConvrt must search your CD for directories
  331.     which contain Files.BBS.  This process is time consuming (unless
  332.     you have one of those new triple speed drives!), so be patient.
  333.     CDConvrt must search the disk twice, once to find all the
  334.     directories, and the second pass to convert all the Files.BBS's
  335.     into the new format.
  336.  
  337.  
  338.     The CDConvrt.cmd utility converts standard Max-type files.bbs
  339.     files like this:
  340.  
  341.     AR15.ZIP       Run a program from an ARC file
  342.     ARCINDX2.ZIP   Create a catalog of archived data
  343.     ARCRUNER.ZIP   Run COM and EXE files in archives
  344.  
  345.  
  346.     Into this format with size and date info added, and the
  347.     description truncated to result in a line length of 254 characters:
  348.  
  349.     AR15.ZIP        39323 11/10/88  Run a program from an ARC file
  350.     ARCINDX2.ZIP    42633  7/23/88  Create a catalog of archived data
  351.     ARCRUNER.ZIP     8096  8/29/88  Run COM and EXE files in archives
  352.     
  353.     New to version 2.3, CDConvrt.cmd will now convert file list with multi-
  354.     line descriptions. (ex. Pier? series, So Much Shareware series)
  355.  
  356.     You may manually edit non-standard files.bbs or index lists to
  357.     conform to the above if you don't have the standard type which is
  358.     needed for CDConvrt.cmd to work.
  359.  
  360.     If your disk contains files.bbs which already have date/size info, then
  361.     answer 'Y' to the prompt "Do the files.bbs already contain date/size
  362.     information? (y,n)"
  363.  
  364.     You will be asked if you want CD Carousel to prompt you at each directory
  365.     for it's inclusion.  This may be helpful if you want to make only some
  366.     of the directories available to the user.  Once selected, you may abort the
  367.     prompting by typing 'a' at the prompt.
  368.  
  369.     You will also be asked if you want to sort the directories.  This may be
  370.     helpful with disks that contain multiple subdirectories with the same
  371.     name. (ex. Hobbes)
  372.  
  373.     Speaking of multiple subdirectories with the same name, CD Carousel will
  374.     prompt you for a new name when this occurs.  Lets say for the sake of
  375.     argument that there are three subdir's with the same name:
  376.  
  377.      l:\os2\comm
  378.      l:\os2\1x\comm
  379.      l:\os2\2x\comm
  380.  
  381.     You will be prompted at the second and third occurrence of the subdir "comm"
  382.     for a new name.  Keep track of the new name so you know what you've used
  383.     when the third occurrence rolls around.  CD Carousel will not let you enter
  384.     the same name twice.
  385.                                      Privledges
  386.  
  387.    You will Also be prompted to enter a Privilege level for the disk.  You must
  388.    enter the first letter of a valid Maximus Privilege.  Acceptable entries are:
  389.    S, A, C, F, P, W, N, L, D, and T.  Be sure that the disk that you make as
  390.    your 'Default CD' is available to all.  The reason for this is because the
  391.    'Default CD' is not checked for privilege of keys, so if you have say an
  392.    adult CD as default, and a 12 year old enters CD Carousel, the adult CD will
  393.    be displayed to him as default.
  394.  
  395.    **  If all Disks require the same access level, and that level is not
  396.        available to all users, then set the menu privilege for CD Carousel to
  397.        that level in the menus.ctl file. Otherwise, when the user enters CD
  398.        Carousel, he will be presented with the 'Default CD'.
  399.  
  400.                                       And Locks
  401.  
  402.    Next, you will be prompted for a lock.  You may enter any number between
  403.    1 and 8.  If you do not wish to set a lock, enter the percent sign "%"
  404.    for the lock.  The same rule applies to locks as it did to privileges.
  405.    Make sure that your 'Default CD' is available to all.
  406.  
  407.  
  408. 5.  If everything ran right, a file called DISK.LST was created in
  409.     your homedir.  This file contains the names of the disks, as you
  410.     entered them in CDConvrt.  You may OPTIONALLY add CD disk descriptions
  411.     as you did for the file areas.
  412.  
  413.     If you ever delete a disk, you will have to edit this file.  If you want
  414.     to add a disk, this file is automatically updated.  Also created was a
  415.     directory with the same name as you gave the CD, and it will contain all
  416.     the *.BBS files as well as a list of area names (name.lst).
  417.     
  418.     New to version 2.3, a work directory, tmp, was created under the CD 
  419.     Carousel directory.  You may delete this, or not, after setting up all your
  420.     CD's.  It will be created again if you add a CD. 
  421.  
  422. 6.  One other file was created and placed in the same directory as
  423.     the files.bbs.  The file, NAMES.LST, contains the CD file area names
  424.     and also the full drive:\path of all the CD directories.  You may
  425.     OPTIONALLY add File Area descriptions to this file.
  426.  
  427.     example: Here's the first 3 lines of the NAMES.LST as it was
  428.              generated by S)etup (CDConvrt.cmd).
  429.  
  430.                          4DOS L:\MSDOS\4DOS
  431.                          ABC L:\MSDOS\ABC
  432.                          ADA L:\MSDOS\ADA
  433.  
  434.              If you want to add File Area Descriptions, use an ASCII
  435.              editor to make it look like this:
  436.  
  437.                          4DOS L:\MSDOS\4DOS Great Command Processor
  438.                          ABC L:\MSDOS\ABC Strange Programming Language
  439.                          ADA L:\MSDOS\ADA ADA Programming Language
  440.  
  441.  
  442. 7.  Repeat steps 4, and 5 for each CD you wish to install.
  443.  
  444. 8.  To make CD Carousel available to your users, add these FOUR lines to your
  445.     menus.ctl like this:
  446.  
  447. NoDsp Display_file c:\max\cddel*         normal "+"    <------Add this line
  448.                   -------------^
  449.  the mecca token '*' will substitute the task number when the file is displayed
  450.  
  451. Nodsp Display_file c:\max\misc\cdcar     normal "+"    <------Add this line
  452.                       ^             
  453.                       |             
  454.  Full path & filename of cdcar.bbs drop file. 
  455.  
  456. Xtern_run maxpipe_%P_cmd_/c_j:\cd\cdcar.cmd_j:\cd\_%K_%g_0_%b_%n normal "+CD Carousel" <------Add this line
  457.                                    ^          ^     ^  ^ ^  ^  ^
  458.  Full Path & filename of CDCAR.CMD |          |     |  | |  |  |
  459.                                                                 
  460.                  Path to CDCAR.CFG ___________|     |  | |  |  |
  461.          Task Number(upper case K) _________________|  | |  |  |
  462.                      Graphics Mode ____________________| |  |  |
  463.                       Place holder ______________________|  |  |
  464.                               Baud _________________________|  |
  465.                          User Name ____________________________| 
  466. NoDsp Display_file    c:\max\cdload*      normal   "+"  <------Add this line
  467.                   -----------------^
  468.  the mecca token '*' will substitute the task number when the file is displayed
  469.  
  470. *******
  471. So to recap, these four lines should be in your menus.ctl, in this order:
  472.  
  473. NoDsp Display_file c:\max\cddel*        normal "+"    
  474. Nodsp Display_file c:\max\misc\cdcar    normal "+"    
  475. Xtern_run maxpipe_%P_cmd_/c_j:\cd\cdcar.cmd_j:\cd\_%K_%g_0_%b_%n normal "+CD Carousel" 
  476. NoDsp Display_file c:\max\cdload*       normal "+"    
  477.  
  478.  
  479.  
  480.  
  481.  
  482. 9.  You must now edit the CDCar.mec file to point to your CD Carousel 
  483.     directory.  Once you've done that, you must compile them  to create a .bbs 
  484.     file using the program, meccap.exe, which came with Max/2 and should be in 
  485.     your Max/2 directory.
  486.  
  487.     Syntax
  488.     meccap cdcar
  489.  
  490.     That will create a file called CDCar.bbs, which should be moved to
  491.     the disk/dir defined by the first line you added to your menus.ctl file.
  492.     This can be any directory, and is often the \max\misc directory
  493.  
  494. 10. If you elect to use the priv/lock control, by setting line 15 in CDCar??.cfg
  495.     to '0', then you must make the following modification to your Max.ctl
  496.     file.
  497.  
  498.     No FilesBBS Download  Normal
  499.     ^^^^^^^^^^^^^^^^^^^^    ^
  500.              |              |
  501. Max.ctl parameter           |
  502. Set this priv to the lowest allowed for any CD download.
  503.  
  504.     This parameter allows the user to download any file in the file area, even
  505.     though it's not listed in the files.bbs.  Since the files.bbs is non-
  506.     standard, Max doesnt read it, and therefore wont allow the user whose priv
  507.     is lower than defined to download the file.
  508.  
  509. 11. Edit your filearea.ctl to add a file area for the requested files.
  510.  
  511. 12. * Registered version only *
  512.     Edit your SpawnBBS.cmd file (ie. the batch file used to start Max/2) to
  513.     include these two lines:
  514.   -----
  515.     cd\max  ;Change to your BBS directory
  516.  
  517.     cdupdate j:\cd\ 01 1 2 k c
  518.   -----  
  519.  
  520.     ** Dont forget the Trailing Backslashes on all pathnames **
  521.  
  522. The syntax is:  <>=Required, []=Optional 
  523.  
  524. CDUpdate <CD Carousel Dir> <task(in HEX)> <down count> <up by> [CD drive] [Alternate drive]
  525.  
  526. CDUpdate i:\cdcar\ 01 1 2 k c
  527.  
  528.  
  529. <Download Counter> = 0 for no download counting, 1 for download counting
  530.  
  531.      At this time it only supports 3 place counts, and only () as the brackets.
  532.  
  533. <Uploaded by> = 0 for none
  534.                 1 for "(Uploaded by USERNAME)" appended to file description.
  535.                 2 for "-              (Uploaded by USERNAME)" on the next line.
  536.                 
  537. If you select 1 the Uploaded by will be permenantly attached to the file
  538. description. Selecting 2 will cause it to be located as a comment on the next
  539. line of the files.bbs.  This comment will not be moved by MFM when/if the file
  540. is ever moved to another area.
  541.  
  542. [CD Drive leter] = Drive letter (without colon) of your CD Drive
  543.  
  544. [Alt Drive Letter] = Drive letter (without colon) of the drive where your
  545. files.bbs for your CD are located.  If you create the same directory structure
  546. on a HD, and copy the files.bbs from your installed CD's into them, and modify
  547. your Filearea.ctl to point to that disk, then CDUpdate will be able to modiify
  548. those files.bbs and enter the download count.  If these optional entries are
  549. omitted, then CDUpdate.cmd will try to write to the files.bbs on the CD, which
  550. of course will create an error message, but will not affect CDUpdate's 
  551. operation.
  552.  
  553.  
  554.     CDUpdate.cmd will scan your max.log to look for downloads.  If it finds a
  555.     download of a requested file, it will either decrement the request counter,
  556.     or if it was the only/last request of that file, delete the file and it's
  557.     files.bbs entry.  CDUpdate will also put an '*' at the end of each line in
  558.     the log that represents a download, so that it will not be checked/counted
  559.     again.  CDUpdate also creates a small file in your Max directory where it
  560.     keeps user names and the files that they requested.  This list is used by
  561.     CDUpdate abd compared with the download log.  Only if all the names and
  562.     files match, will CDUpdate take action.
  563.  
  564.     To speed CDUpdate, delete your log every day. I copy mine to a backup file, 
  565.     then delete it.
  566.  
  567. 13  * Registered version only * 
  568.  
  569.     CDPurge.cmd is a utility that can be run once a day, or once a week.  It 
  570.     will purge the file request file area of old files where were never picked
  571.     up.
  572.     
  573.     CDCar??.cfg parameter #20 must be set to "1" (touch file dates) in order for
  574.     CDPurge.cmd to work.
  575.     
  576. The syntax is:  <>=Required, []=Optional 
  577.  
  578.     CDPurge <CD Carousel Dir> <task(in HEX)> <# of Days old> [Username]
  579.        or
  580.     CDPurge i:\cdcar\ 01 10
  581.     
  582.     The above command line will delete all files that have been around more than
  583.     10 days.  CD Carousel "touches" the file date each time someone requests a
  584.     file.  A file already awaiting download, will be "touched" again if another
  585.     user requests it, thus starting the clock again for that file.
  586.     
  587.     You will notice that if you request files locally for your own use, that the 
  588.     files.bbs is also updated, but unless you actually download the file, it
  589.     never gets deleted from the file area.  CDPurge can also be used to delete
  590.     all files requested by a specific user.
  591.     
  592.     CDPurge i:\cdcar\ 01 10 bill esposito
  593.     
  594.     The above line will delete all files, no matter how old, which were 
  595.     requested by Bill Esposito.
  596.     
  597.     CDPurge i:\cdcar\ 01 10 bill esposito
  598.                          ^^
  599.                          ||
  600. *** Even though the # of days parameter is ignored when a username is supplied, 
  601.     it is still required in the command line.
  602.    
  603.  
  604.  
  605. 14. Edit the BULLETIN.TXT file to your liking. Use an ASCII editor and
  606.     keep the line length to 79 or fewer characters per line.
  607.  
  608.  
  609. 15. To install CD Carousel on the desktop;
  610.  
  611.     a. From your CD Carousel Directory, type "Seticon"
  612.     b. When prompted, enter the full drive and pathname for your CD Carousel Dir
  613.     
  614.     The CD Carousel Icon should have appeared on your desktop.
  615.     
  616.     Click on the icon to run CD Carousel in the local mode for F)illing
  617.     requests, or searching for and retriving files for yourself.
  618.  
  619.  
  620.  
  621.                                OPERATION
  622.  
  623. The BBS User will be presented with the following options:
  624.  
  625. C)hange Disk
  626. F)ile Area
  627. S)earch by Filename/Text
  628. B)ulletins
  629. ?)Help
  630. Q)uit Back to BBS
  631.  
  632. "Change Disk" will present the User with all available CD's from which he can
  633. choose.
  634.  
  635. "File Area" will present the User with a list of all the file areas available
  636. on the selected disk.
  637.  
  638.     Once a file area is selected, the user will be presented with a list of
  639.     files, and the selection options "More, file# (Y,n,#,i,?):"
  640.  
  641.     'Y' = Yes, display the next page.(default)
  642.     'n' = No, quit to main menu.
  643.     '#' = Enter the file number of the file you wish to tag. (ex. 3)
  644. *   'i' = Info; selecting this will prompt you for a file number.  Entering
  645.           the number will display the unabbreviated file description.
  646.     '?' = Help      
  647.  
  648. * by setting configuration parameter 19 to "0" for short file descriptions, the
  649.   user see 20 files/page - thus speeding up his browsing of the file lists.  He
  650.   can then use the I)nfo command to expand any file descriptions that he is 
  651.   interested in.
  652.  
  653. "Search by Filename/Text" is a string search of all the filenames and
  654. descriptions for the selected CD.  If you set up CD Carousel to work with your
  655. ONLINE CD by entering it's name as line 18 in Cdcar.cfg, your Users will have a
  656. very fast file lookup available to them, much faster than from the Max/2 file
  657. menu.
  658.  
  659. "Bulletins" displays the file CDbull.txt, in which you can put anything you
  660. want.
  661.  
  662. "?Help" displays the file CDhelp.txt.
  663.  
  664. "Quit back to BBS" sends the user back to your BBS.  If you set up your ONLINE
  665. CD by entering it's name as parameter line 18 in CDcar.cfg, then those files
  666. will be copied to your file request directory for immediate download.
  667.  
  668.                                         ---------------------------
  669.  
  670.     At the end of the day, or at whatever frequency you want, you must
  671. manually run CDMenu.cmd by issuing the command "CDmenu <task Number>".  If you 
  672. have set parameter #18 to "1", you will be notified by CD Carousel in the msg
  673. area defined by config parameter 13 when there is at least one (1) pending 
  674. request. You will not receive another message until after you have filled the 
  675. requests, then the first time there is a new request, you will again receive a
  676. message. This is helpful if you have a lot of activity, and duplicate messages
  677. would just clutter your message base.  If you set parameter #18 to "0" then
  678. you will receive a message EACH time a user makes a request. When you receive 
  679. this message, run CDMenu.cmd.  When the menu comes up, select F)ill file 
  680. requests.  This will run CDMaint.cmd.  When run, it will prompt you for each 
  681. disk that has an outstanding request against it. If enabled it will also ask 
  682. you if you want to change the file's priv or key, then offering you the option 
  683. of doing so.  If priv/lock is not enabled, it will offer you the chance to mark
  684. the file as a free download. If a file already appears in the files.bbs no 
  685. change will actually occur.  After copying the files, it will send a message to
  686. the user telling him/her that their request has been fulfilled. 
  687.      If for some reason an error while copying occurs, the error will be entered
  688. in a file called 'errors.log'.  This file can be reviewed and/or deleted by 
  689. selecting "R)eview logs" at the main menu, then selecting "E)rror log".  If the
  690. error was caused by having the wrong disk in your drive, CD Carousel will let
  691. you try again.  You must select from the "R)eview logs" menu the option "F)ill
  692. from error log".  This will step through the error.log and offer you the choice
  693. of trying again.  If you answer yes to the propmp "Do you want to fill this
  694. request?", a .req file will be generated.  When you're finished reviewing the 
  695. log, return to the main menu, and select "F)ill file requests".  CD Carousel
  696. will behave as if nothing had happened and again try to fill the request. 
  697.  
  698.  
  699.     a.  To run the CD Carousel door in the local mode select L)ocal CD
  700.         Carousel from the CDMenu menu.
  701.  
  702.     b.  You can also run the door from the command line by typing:
  703.  
  704.               cdcar default_dir graphics 0 first last
  705.                       which works out to
  706.               cdcar j:\cdcar\ 01 1 0 Bill Esposito
  707.  
  708.     c.  You can run CDMaint.cmd from the command line by typing
  709.         "cdmaint <task number>".
  710.  
  711.     d.  You can run CDConvrt.cmd from the command line by typing
  712.         "cdconvrt <task number>".
  713.  
  714. 16. Review of CDMenu.cmd.
  715.  
  716.     S)et-up a new cd    - Runs CDConvrt.cmd.  Creates new .BBS files on
  717.                           your hard disk.
  718.  
  719.     F)ill file requests - Runs CDMaint.cmd.  Copies files from your CD
  720.                           to a Max/2 file area.
  721.  
  722.     L)ocal CD Carousel  - Runs the door, CDCar.cmd, in the local mode.
  723.  
  724.     R)eview logs        - Displays another menu allowing you to display either
  725.                           the error log or a log of user requests and fill 
  726.                           requests from the error log. The error log contains a
  727.                           list of requests that were not filled because of some
  728.                           file copying error, usually the incorrect disk in the
  729.                           CD player at the time of the fill.
  730.  
  731.  
  732. 17.  * Registered versions only. - Allfiles.cmd  
  733.  
  734.      Allfiles.cmd is a simple utility to create file lists of your CD's. 
  735.      To use it just type:
  736.      allfiles dir output_filename
  737.      
  738.      Dir is the full path to the file area that contains all the .bbs files.  
  739.      Output_filename is the name you want to use for the output.
  740.      
  741.      Lets say that we have the Hobbs 94 CD setup.  CD Carousel would have created a 
  742.      directory under it's directory with the name you gave the disk when you 
  743.      installed it.  Lets say we called it Hobbs, and we want the output file
  744.      to be named Hobbs94.lst.  You would then enter, from the CD Carousel Dir:
  745.      
  746.      allfiles i:\cdcar\hobbs\ hobbs94.txt
  747.      
  748.      The file Hobbs94.txt will be created in the CD Carousel Directory.
  749.      
  750.      Why use this utility?  Because you may have had to rename some directories
  751.      (if you installed Hobbs, I know you did) or you may have elected not to
  752.      include some directories.  Allfiles.cmd will only list what's available
  753.      from CD Carousel.
  754.      
  755. 18.  * Registered versions only. CDOklst.cmd
  756.  
  757.      CDOklist.cmd will create a file called CDOK.LST which can be appended to
  758.      your normal OKFILE.LST.  Since you now may have a bunch of Online CD's
  759.      you may want to make the files available for Freq.
  760.      
  761. The syntax is:  <>=Required, []=Optional 
  762.  
  763.     CDOklst <CD Carousel Dir> <task(in HEX)> 
  764.        or
  765.     CDOklst i:\cdcar\ 01 
  766. **********************************************************************
  767.  
  768.                       Maximus/2 2.01wb CDROM BUG
  769.  
  770. If you already have a working Max/2 CDROM setup, then don't bother
  771. reading this, you've already applied the patch.
  772.  
  773. You MUST patch Max/2 v2.01wb in order for your CDROM to be found by
  774. both Max/2 and Siltp. The error manifests itself you producing Siltp
  775. errors trying to create the file areas on you CDROM, and then Max/2
  776. cant locate the CD.  Here's the patch.
  777.  
  778. Patch Maxp and Siltp at the following locations:
  779.  
  780. MAXP.EXE:  at offset 299430 (0x491a6), change 06 to 00
  781. SILTP.EXE: at offset 31859 (0x7c73), change 06 to 00
  782.  
  783. You can use Patch.EXE located in your OS/2 directory.
  784.  
  785.  
  786. Bug Reports
  787.  
  788.   Please send all bug reports to Bill Esposito at:
  789.  
  790. FidoNet   1:132/152
  791.  
  792. Internet  bill.esposito@cereal.mv.com
  793.  
  794. End.
  795. 
  796.