home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / vdocs.zip / VC15B < prev    next >
Text File  |  1994-01-12  |  12KB  |  240 lines
  1. .TOPIC:
  2. VBBS CD-Rom Documentation
  3.                                      VBBS 6.12 Documentation -- 15-B-1
  4.  
  5.  
  6.          ╔════════════════════════════════════════════════════════════════╗
  7.          ║  CHAPTER 15 ANNEX B       VBBS CD-ROM DOCUMENTATION            ║
  8.          ╚════════════════════════════════════════════════════════════════╝
  9.  
  10.          VirtualBBS is able to support the use of Compact Disks for it's
  11.          Transfer Files feature. There are many outstanding CD's on the
  12.          market today with hundreds of megabytes of shareware programs on
  13.          each one just waiting to be accessed by your users. This is an
  14.          excellent way to provide thousands of programs and files for
  15.          download with minimal effort and space.
  16.  
  17.  
  18.          Basic Requirements
  19.          ══════════════════
  20.          The basic requirements for utilizing this feature are:
  21.  
  22.          1. A Compact Disk player for computer use.
  23.          2. A Shareware CD
  24.          3. Utilities: VCDROM11.EXE, FBBSCV12.EXE, CKIF610B.EXE
  25.          4. A copy of VirtualBBS of course!
  26.  
  27.  
  28.          Hardware Setup
  29.          ══════════════
  30.  
  31.          It seems to be the consensus of several sysops consulted that
  32.          using D: as the drive letter for your CD-ROM does not always work
  33.          well. It is better to use E: - Z:. Why this is true is not exactly
  34.          known, and it may have to do with the particular device driver
  35.          your brand of CD player uses, most use MSCDEX (Micro Soft Compact
  36.          Disk Device Driver), or just "Weird Iron."
  37.  
  38.          Usually, upon the installation of your CD player, the CD software
  39.          assigns "the next available drive letter" to your CD player. If
  40.          this will assign D: as the drive letter for CD player, this might
  41.          be the perfect opportunity to set up a small RAM drive for your
  42.          BBS. It will not only make your BBS sail faster along and reduce
  43.          Hard Drive searches for menus, function blocks, and scripts, but
  44.          will use D: as it's drive letter, thereby "kicking" the CD player
  45.          down to use E:. You may do this just as a "place holder" for D:
  46.          even if you don't plan to use the RAM drive.
  47.  
  48.          Getting Started
  49.          ═══════════════
  50.          The next step is to get VBBS to read, and somehow upload the info
  51.          on the CD to the VBBS files database so that your users may down
  52.          load from it. There are 2 utilities to do this: VCDROM11.EXE,
  53.          which works with NightOwl's CD's, and PC SIG CD's, (but NOT
  54.          including PC SIG 11), and FBBSCV12.EXE, which will work on all
  55.          CD's that have ASCII directories with descriptions that correspond
  56.          to the directories on the CD containing the files themselves.
  57.  
  58.                                      VBBS 6.12 Documentation -- 15-B-2
  59.  
  60.  
  61.          VCDROM11.EXE will work ONCE with NightOwl's CD, since it creates
  62.          the .dat and .bin files called "DIR1.DAT, DIR1.BIN, DIR2.DAT,
  63.          DIR2.BIN", etc. If you should decide to use an additional NightOwl
  64.          's CD, the .dat and .bin files would need different names. This is
  65.          easily accomplished by using FBBSCV12.EXE.
  66.  
  67.          The basic idea, here, is to 1). Create the .DAT and .BIN files
  68.          required by VBBS to interface with the compact disk, and, 2).
  69.          Upload the CD info to the TRANSFER FILES area.
  70.  
  71.  
  72.          ASCII Description Files
  73.          ═══════════════════════
  74.          There are two components to the CD which require our attention:
  75.          The ASCII descriptions of the programs on the CD, and the
  76.          directories which contain the actual programs.
  77.  
  78.          The ASCII descriptions are the descriptions of the downloadable
  79.          programs written in text that can be read using an ordinary text
  80.          editor or word-processor. Generally, there will be a directory
  81.          containing the descriptions for each directory of programs.
  82.  
  83.  
  84.          The .DAT and .BIN Files
  85.          ═══════════════════════
  86.          You might ask: "What are .dat and .bin files?" These are the
  87.          files which VBBS creates in the \VBBS\DB directory as you put
  88.          information into the message and files databases in VCONFIG.
  89.          VBBS interprets these files as the descriptions and filenames
  90.          you see in your FILES TRANSFER areas. See DATABASE CONFIGURATION.
  91.  
  92.  
  93.          NOTE: Before converting ASCII description files into .dat and .bin
  94.                files, MAKE SURE to remove ALL extraneous information from the
  95.                description files, i.e. headers, CD-Version numbers, CD-Name,
  96.                manufacturer's name, etc.
  97.  
  98.  
  99.  
  100.          Using VCDROM11.EXE
  101.          ══════════════════
  102.          To create .dat and .bin files using VCDROM11.EXE, place it in an
  103.          empty temporary directory on your Hard Drive. Type VCDROM. It will
  104.          prompt you for the drive letter of your CD ROM drive. Let's say,
  105.          for example, your CD ROM drive letter is E:. Type E. It will then
  106.          ask you if you are using PC SIG, or NightOwl's CD. (at present,
  107.          VCDROM.EXE only supports these two). Let's say you are using
  108.          NightOwl's. Select NightOwl's. The program will automatically
  109.          begin creating the .dat and .bin files. Once it has finished, you
  110.          now have a complete set of .dat and .bin files ready for use with
  111.          the CD. Copy these files to the \VBBS\DB directory.
  112.  
  113.                                      VBBS 6.12 Documentation -- 15-B-3
  114.  
  115.  
  116.           NOTE: The NightOwl's 10 CD has a different format than NightOwl's
  117.                 7, 8, and 9. The ASCII descriptions are pathed differently.
  118.                 To create the .dat and .bin files for NightOwl's 10 do the
  119.                 following. Create a \TEXT directory off of your root dir.,
  120.                 usually C:\TEXT. Copy the description files from the Night-
  121.                 Owl's 10 CD \NIGHT\TEXT directory to C:\TEXT, (NOT including
  122.                 DIR0!). Next, use the DOS ASSIGN command to assign the drive
  123.                 letter of your CD player drive to C: (EXAMPLE: Let's say your
  124.                 CD drive letter is E:. At the "C" prompt type ASSIGN E: C:).
  125.                 Now VCDROM will think C:\TEXT is now E:\TEXT! Now, return to
  126.                 your temporary directory where VCDROM is (it's now in E:,
  127.                 remember?), use VCDROM as described before and you will have
  128.                 a set of .dat and .bin files for CD drive letter E:
  129.  
  130.  
  131.          Uploading Files Made with VCDROM11.EXE
  132.          ══════════════════════════════════════
  133.          To upload the programs on the CD to the files database in VBBS,
  134.          go to VCONFIG. In this example, (using VCDROM11.EXE), the FILENAME
  135.          to enter will simply be: DIR1. The PATH will be: E:\ (VCDROM11.EXE
  136.          writes information into the .dat and .bin files which lets VBBS
  137.          know that they are CD ROM files; therefore, *ONLY* the E:\, or
  138.          whatever your CD ROM drive letter is, is necessary). The LONG
  139.          DESCRIPTION will be the name of the first topic on your
  140.          CD which corresponds to DIR1, i.e. "Alternate Op Systems", in the
  141.          case of NightOwl's #7. Do this for each topic you desire to
  142.          upload. Make sure to sort and compile the data after you're
  143.          finished.
  144.  
  145.  
  146.          If you used VCDROM11.EXE to convert a PC-SIG CD, it will have made
  147.          .dat, .bin, and .fdx files. Copy these to your \VBBS\DB directory.
  148.          The upload procedure is the same, due to the particularly nasty
  149.          format of PC-SIG, VCDROM11.EXE converts the entire CD into ONE
  150.          complete database group. You CANNOT split it into topics.
  151.  
  152.          The listing of programs in the Transfer Files area will show up
  153.          with ONLY the name of the program (which will be "Diskxxxxx" which
  154.          tells the user nothing). The description of the program will show
  155.          up in the "extended description". It will be up to you to somehow
  156.          let your users know where and how the descriptions may be found.
  157.                                                           
  158.          I recommend using a door program with PC-SIG since it does not
  159.          have ASCII descriptions. The file descriptions are hard coded into
  160.          a hyper-reader menu format.
  161.  
  162.                                      VBBS 6.12 Documentation -- 15-B-4
  163.  
  164.          Using FBBSCV12.EXE
  165.          ══════════════════
  166.          Another method to use shareware CD's with VBBS is to use the
  167.          utility called FBBSCV12.EXE. Again, make sure your CD has ASCII
  168.          text directories with the descriptions for the programs on the
  169.          actual directories containing the programs on the CD. REMEMBER:
  170.          MAKE SURE to remove ALL extraneous information in the description
  171.          file!
  172.  
  173.          EXAMPLE: DIR1 contains the ASCII descriptions for directory 001A
  174.          on the CD.  DIR2 contains the ASCII descriptions for directory
  175.          001B on the CD.
  176.  
  177.          Where 001A may be "Games" and 001B may be "Recipes", etc.
  178.  
  179.          Copy the ASCII description directories to a temporary directory on
  180.          your Hard Drive. Type FLBCVT. It will prompt you for "Name of file
  181.          to convert:" Type DIR1 (or whatever the ASCII description filename
  182.          is on your CD). Then it will prompt you for "VBBS Database
  183.          Filename:" Type a filename that will be easy to remember and
  184.          different than any others.
  185.  
  186.          Example: For NightOwl's #8 CD, I used "8NOCD1" to convert DIR1,
  187.          which would correspond with directory 001A on my CD.
  188.  
  189.  
  190.          FBBSCV12 then created the .dat and .bin files for that directory.
  191.          They were called 8NOCD1.dat, and 8NOCD1.bin.
  192.  
  193.          Do this for each directory, then copy the .dat and .bin files to
  194.          your \VBBS\DB directory.
  195.  
  196.          Uploading Files Made by FBBSCV12.EXE
  197.          ════════════════════════════════════
  198.          To upload the programs on the CD to the files database in VBBS,
  199.          go to VCONFIG. Continuing with our example above, the FILENAME
  200.          will be: 001A. The PATH will be: E:\8NOCD1. (Note: the path is
  201.          complete, here, not partial as in the case with VCDROM11.EXE). The
  202.          LONG DESCRIPTION would be: Games. Make sure to sort and compile
  203.          the data when you're finished.
  204.  
  205.                                      VBBS 6.12 Documentation -- 15-B-5
  206.  
  207.          Using the CKIF610A.EXE Utility
  208.          ══════════════════════════════
  209.          Not all CD's are the same. Ocasionally, a CD uploaded in the
  210.          manner described above, still will show a "File Missing" message
  211.          when a user tries to download. In almost every case this can be
  212.          corrected by running CKIF610B.EXE. This utility will automatically
  213.          toggle the files on your CD "online". Start CKIF610B.EXE and let
  214.          it run. This will take quite some time since most CD's have up to
  215.          650 Megabytes to toggle online. This would be a good time to grab
  216.          a twinkie, or some other sysop type food!
  217.  
  218.          -->  IMPORTANT NOTE: Some sysops are using a utility called
  219.                               VLOAD56A.EXE to convert ASCII descriptions
  220.                               to VBBS files descriptions.  If you choose
  221.                               to try this you *MUST* run CKIF610B.EXE to
  222.                               toggle files online.
  223.  
  224.  
  225.  
  226.          Good Luck to All!
  227.          ═════════════════
  228.          These methods should work well to get you started using CD-ROM
  229.          drives and shareware compact disks with VirtualBBS, allowing users
  230.          to access and download files straight from your VBBS Transfer
  231.          Files databases. It has been my experience that users as well as
  232.          other SysOps will appreciate your BBS all the more.
  233.  
  234.          Please note that there are other utilities being written almost
  235.          daily by others that will prove to be extremely useful to CD-ROM
  236.          SysOps!
  237.  
  238.  
  239.  
  240.