home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / v611docs.zip / VMAIN611.ZIP / VC6-AC < prev    next >
Text File  |  1993-10-08  |  14KB  |  315 lines

  1.                                            VBBS 6.11 Documentation -- 6-C-1
  2.  
  3.  
  4.      ╔════════════════════════════════════════════════════════════════╗
  5.          ║ CHAPTER SIX ANNEX C    FILE TRANSFER FUNCTIONS                 ║
  6.          ╚════════════════════════════════════════════════════════════════╝
  7.  
  8.         Transferring program and data files over phone lines was
  9.      one of the original reasons for the invention of modems, transfer
  10.      protocols, and BBS softwares; to this day, it remains one of the
  11.      most popular functions of BBSs.
  12.         As a sysop, the number of files (if any) you have avail-
  13.      able for download and their content is your decision and your re-
  14.      sponsibility.  Some BBSs have huge transfer sections with thou-
  15.      sands of files online; others have only a few (or even NO) files
  16.      available for download.  Most boards, however, fall somewhere in
  17.      the middle of the range, with a few dozen to a few hundred files
  18.      in their transfer sections.
  19.         If you prefer to keep your transfer section small, you
  20.      might consider carrying anti-virus software (your users will ap-
  21.      preciate you for it), a communications program or two, and sev-
  22.      eral general utilities.  If you want a "mondo" file section, the
  23.      sky's the limit; there are, however, a few general statements
  24.      that are in order here:
  25.  
  26.        1)  Having commercial programs, such as Lotus 1-2-3 or Word-
  27.            Perfect, available for download is ILLEGAL.  BBS operators
  28.            are responsible/liable for the content of the files they
  29.            offer to the public, and several sysops have been arrested
  30.            for running "pirate boards" offering commercial software.
  31.  
  32.        2)  Adult-oriented files should NOT be made available to users
  33.            under the age of 18; the potential legal hassles over the
  34.            distribution of pornography to minors simply isn't worth
  35.            it.
  36.  
  37.        3)  Practice "safe computing".  Use a virus-scan program on 
  38.            each file that you offer for download and on each file 
  39.            that is uploaded to you.  If a user gets a virused program 
  40.            from your BBS, word WILL get around, and it may cost you 
  41.            several users.
  42.  
  43.  
  44.      Transfer Menu Commands and What They Do
  45.      ═══════════════════════════════════════
  46.  
  47.         Below is a listing of the commands available from the
  48.      Transfer Menu, which is accessed by pressing [T] at the Main
  49.      Menu (in the default setup).
  50.  
  51.      [C] Change Directory        Displays a list of directories in
  52.                      the current topic area and asks
  53.                      the user which one to change to.
  54.      [$] Change Topic Area        Displays a list of available topic
  55.                      areas; also allows user to view
  56.                      an index of the file section, if
  57.                      desired.
  58.  
  59.                                            VBBS 6.11 Documentation -- 6-C-2
  60.  
  61.  
  62.      [L] List Files *.*        Lists all files in the current
  63.                      directory.
  64.      [S] Search All Dirs        Searches for filenames based on
  65.                      the mask entered by the user.
  66.                      If no mask is specified, this
  67.                      will display ALL files in ALL
  68.                      directories.
  69.      [D] Download Files        Download one or more files.
  70.      [R] Review Files        Browse file information in cur-
  71.                      rent directory, in a manner
  72.                      similar to reading messages.
  73.      [N] New Files Scan        Scans for files that have been
  74.                      added since the user's last
  75.                      logon.
  76.      [U] Upload Files        Prompts user for files to upload.
  77.      [B] Batch Functions        Used to mark and then download
  78.                      multiple files.
  79.      [Y] Your Transfer Stats    Displays user's KB uploaded, KB
  80.                      downloaded, and ratio (even if
  81.                      ratios are not enabled on your
  82.                      BBS).
  83.      [P] Popular Downloads        Searches current topic area and
  84.                      compiles a list of the most
  85.                      frequently downloaded files.
  86.          [J] Set New File Scan          Allows user to configure new-files
  87.                                          scan to show new files received
  88.                                          during last x number of days.
  89.      [K] Default File Dir        Directory user defaults to (#1 if
  90.                      not set).
  91.      [F] Find Description        Finds file through keyword sear-
  92.                      ches in file descriptions.
  93.      [>] Next Directory        Also activated by [+]; advances
  94.                      one directory in current topic
  95.                      area.
  96.      [<] Previous Directory        Also activated by [-]; reverses
  97.                      to previous directory.
  98.      [#] Change to Dir #        Entering a directory number will
  99.                      take you to that directory.
  100.      [M] Download Master List    Compiles a master list of files
  101.                      available for download; the list
  102.                      is deleted after download.
  103.      [Q] Quit to Main        Exits to Main Menu.
  104.      [G] Goodbye/Log Off        Exit BBS.
  105.  
  106.      ──────── Sysop ─────────
  107.  
  108.      [X] Sysop Directory        Allows sysop to review new addi-
  109.                      tions to the upload directory.
  110.      [Z] Local Upload        Uploads files from the sysop di-
  111.                      rectory to their proper down-
  112.                      load directories.
  113.  
  114.                                            VBBS 6.11 Documentation -- 6-C-3
  115.  
  116.      Setting Up Topic Areas
  117.      ══════════════════════
  118.  
  119.         As with message bases, file databases may be broken down
  120.      into topic areas.  Typical topic-area arrangements for the file
  121.      section might look like this:
  122.  
  123.      L -- Utilities            T -- Windows Programs
  124.      M -- Games            V -- DOS Programs
  125.      N -- Applications        K -- OS/2 Programs
  126.      O -- Communications        Y -- Untried/untested uploads
  127.  
  128.      Of course, the letters you use for topic areas are up to you;
  129.      it wouldn't be difficult to come up with a different arrangement
  130.      for the topic areas, either ... but you get the idea.  Under the
  131.      "DOS Programs" area mentioned above, you might have the databases
  132.      broken down like this:
  133.  
  134.         1   Utilities
  135.         2   Graphics Games
  136.         3   Text Games
  137.         4   Word Processors/Text Editors
  138.         5   Programmers' Tools
  139.         6   Term Programs & Protocols
  140.         .
  141.         .
  142.  
  143.      Again, the arrangement/breakdown is entirely up to you.  VBBS al-
  144.          lows for one hundred databases within a topic area (and the topic
  145.          area designator needs to be a unique letter).
  146.  
  147.  
  148.      Uploading Files Locally
  149.      ═══════════════════════
  150.  
  151.         When you're setting up your file section, remember that
  152.      file databases need a specific DOS path so that VBBS will know
  153.      where to look for the file.  File databases need to have UNIQUE
  154.      DOS filenames, lest your file descriptions start showing up on
  155.      networked message bases.
  156.         To "load" files into your file section, move them to the
  157.      appropriate DOS directory you've specified for the database in
  158.      VCONFIG.  Log onto the BBS and go to the Transfer Menu, then
  159.      select [Z] -- Local Upload.  If you specify a filename, you may
  160.      upload that ONE file into the database; if you press [Enter] at
  161.      the prompt, you're telling VBBS you want to upload ANY files
  162.      in that directory that aren't currently on display.  You may also
  163.      tell VBBS to upload any new files within the entire topic area,
  164.      if you wish.
  165.         Once you've selected the desired option, VBBS will prompt
  166.      you for a one-line description (and an optional extended de-
  167.      scription).  When the file is uploaded, VBBS will insert a "zip
  168.      comment" to the archive; this comment contains your ZIPCOMNT.TXT
  169.      (found in the \TXT directory).
  170.                 For procedures on uploading files from a CD-ROM into VBBS
  171.          please refer to the CDROM.DOC in the Appendix.
  172.  
  173.                                            VBBS 6.11 Documentation -- 6-C-4
  174.  
  175.         To upload files to specific directories after a remote
  176.      user uploads a file to your \SYSOP directory, simply choose the
  177.      "Copy File" option from the sub-menu to place the file where it
  178.      belongs in your transfer section.  You may then wish to use the
  179.      "Toggle File Online/Offline" option to move the original file
  180.      to a backup diskette, directory, or tape drive.
  181.  
  182.      Remote Transfers
  183.      ════════════════
  184.  
  185.         VBBS comes configured for several transfer protocols.  The
  186.      "de facto" standard protocol is ZModem, a shareware protocol by
  187.      Omen Technologies that is readily available from other BBSs.  
  188.      ZModem allows for the "batch" uploading and downloading of files 
  189.      to and from your BBS (this means that users can upload or down-
  190.      load files in groups, instead of one at a time).  ZModem is also
  191.      faster than the earlier XModem or YModem protocols, particularly
  192.      at a 2400-baud connect rate.  ZModem comes in two "flavors":
  193.      DSZ, which has been the standard for a while, and GSZ, which is
  194.      basically DSZ with a graphical display and is becoming quite
  195.      popular.  If you use GSZ, it is highly recommended that you
  196.      rename that file to DSZ.COM so that it matches the DSZ command
  197.      line already configured within VBBS and is also used by the
  198.      VNET networking software.
  199.                 VBBS comes pre-configured for XModem, YModem, ZModem,
  200.      ZModem Batch, and the developing HS-Link bidirectional proto-
  201.      col (which allows simultaneous uploading and downloading of
  202.      files).  If you're using ZModem and/or HS-Link, the .EXE and/
  203.      or .COM files for these programs need to be in your main VBBS 
  204.      directory to facilitate transfers.
  205.                 VBBS' own standalone VXY.EXE is an integral part of the
  206.          package.  VXY handles XModem, YModem, ZModem, and ZModem
  207.          Batch also and is a fully functional replacement for DSZ. This
  208.          is preconfigured for you in the upload.cfg and download.cfg
  209.          files when you first install VBBS.
  210.         In the case of uploads, the sysop may define in VCONFIG
  211.      whether the user will be prompted for a file description before
  212.      or after the upload (if before, VBBS will check for duplication
  213.      of files).  Another VCONFIG upload option is whether an "upload
  214.          event" (such as a virus scan) will be performed offline after
  215.          the upload. In any case, VBBS checks for compressed file
  216.          integrity following upload (and optionally, at download).  A
  217.          file located in the defined \TXT directory, called REMUPLD.TXT,
  218.          is displayed to the user immediately prior to the upload prompt;
  219.          this file may be edited according to your needs.
  220.         VBBS displays the user's upload/download ratio after each
  221.      transfer.  In VCONFIG, you may opt to have a specific minimum
  222.      ratio to allow downloads; you may also exempt particular users
  223.      (such as visiting sysops) from this ratio in the user editor.
  224.          If you want to make certain files available as "free"
  225.      downloads that will not be charged against a user's ratio, you
  226.      simply need to create a file called FREEDL.TXT in your \TXT
  227.      directory.  This file should contain the names, one per line, of
  228.      the files you wish to have as "free" downloads.  Typical files
  229.      that might fall into this category might include virus-scan pro-
  230.      grams, text files describing your BBS and its features/policies,
  231.  
  232.                                            VBBS 6.11 Documentation -- 6-C-5
  233.  
  234.  
  235.      etc.  It should be noted that if you're running a credit system,
  236.      the user WILL be assessed a credit charge for these files (in
  237.      "default" VBBS, anyway).
  238.  
  239.  
  240.      Files Sub-Menu
  241.      ══════════════
  242.  
  243.      [Enter] Next Entry        Advances to next file or file lis-
  244.                      ting.
  245.        [D]   Download File        Download current file; [?] dis-
  246.                      plays options.
  247.        [B]   Batch Functions    Adds file to "batch queue" for
  248.                      multiple file transfers.
  249.        [A]   List Again        Redisplays the current file's in-
  250.                      formation.
  251.       [###]  Jump to File ###    If you enter a number, VBBS takes
  252.                      you to that file's description.
  253.        [Q]   Quit            Quits to Transfer menu.
  254.        [V]   View Archive        View the contents of the archived
  255.                      file (for details, see section
  256.                      D of the VCONFIG setup instruc-
  257.                      tions).
  258.        [R]   Request File        Allows user to request a file from
  259.                      its networked file listing.  The
  260.                      sysop will be prompted to approve
  261.                      or disapprove a request.  This
  262.                      also works for local files listed
  263.                      as <OFF-LINE>.
  264.        [T]   Test Archive        Allows testing of the current
  265.                      file's archival integrity.
  266.  
  267.      ──────── Sysop ──────────
  268.  
  269.     [O] Move File Online/Offline    Toggles file to/from diskette or
  270.                      tape drive.  It may also be used
  271.                      simply to toggle the file's
  272.                      availability.
  273.     [Z] Add ZIPCOMNT.TXT to ZIP    Manually adds the ZIPCOMNT.TXT to
  274.                      the file archive.
  275.     [X] Remove File            Remove file listing and/or file
  276.                      from the current directory.  Use
  277.  
  278.                                            VBBS 6.11 Documentation -- 6-C-6
  279.  
  280.  
  281.                      with caution.
  282.      [M] Move File            Move file from one directory to
  283.                      another (there have been some
  284.                      reported problems with this
  285.                      command; don't use it to move
  286.                      a file into the first database
  287.                      in the first topic area, and
  288.                      all should work well).
  289.      [E] Edit Description        Allows the sysop to edit the file
  290.                      description.
  291.  
  292.  
  293.         Parting words on files:  The file transfer section can be
  294.      a real joy to work with, or it can be a real pain; it depends on
  295.      how you (and your users) approach it.  Even the most idealistic
  296.      sysop can be driven almost to distraction by persistent file
  297.      leeches -- users who do nothing but download files without ever
  298.      exploring the other areas of the BBS (I speak from personal ex-
  299.      perience here).  Never say "I'll never run a ratio or credit
  300.      system" unless you: a) truly don't care whether your users ever
  301.      use the BBS to communicate with others, or b) like to eat crow
  302.      (perhaps with peppercorn sauce).  :-)
  303.         Of course, NOT having a file section GREATLY reduces your
  304.      system's risk of contracting a virus ... but it can be of great
  305.      comfort if you have the latest anti-virus software when a user
  306.      REALLY needs it!
  307.         Some sysops take a sort of perverse pleasure in seeing
  308.      just how many files they can have online; if you're a beginning
  309.      sysop, don't sweat it.  Have as many files online as you feel
  310.      comfortable with.  Don't get into a "competition" with BBSs
  311.      that have 1.2-gigabyte hard drives or multiple CD-ROM drives
  312.      if you don't want to; it gets REAL expensive, both in hardware
  313.      costs and long-distance charges.
  314.  
  315.