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