home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / vdocs.zip / VC6B < prev    next >
Text File  |  1993-12-20  |  19KB  |  383 lines

  1. .TOPIC:                                           
  2. E-Mail Functions
  3.                                            VBBS 6.12 Documentation -- 6-B-1
  4.  
  5.          ╔════════════════════════════════════════════════════════════════╗
  6.          ║ CHAPTER SIX ANNEX B    E-MAIL FUNCTIONS                        ║
  7.          ╚════════════════════════════════════════════════════════════════╝
  8.  
  9.          See also:  File Attachments  E-Mail Forwarding
  10.                     Carbon Copies     Multi-Mail
  11.                     DIRECTmail        FREQing
  12.  
  13.                 E-mail is the "private" version of messaging, and many of
  14.          the functions within E-mail are very similar to their messaging
  15.          counterparts.
  16.                 The VBBS mail functions are quite powerful.  When a user
  17.          logs onto your system, VBBS will do a mailbox scan.  If the user
  18.          has new mail waiting, he or she will be informed of the new mail
  19.          and prompted to access the mailbox at that time.  The VBBS E-mail
  20.          prompt offers choices to present a queue of new and unread mail,
  21.          ALL mail, or to search for mail from a specific user by name or
  22.          partial name.  Users may also access mail that has been sent and 
  23.          not yet read by a local addressee, or not yet bundled into an 
  24.          outgoing network packet for a network addressee.
  25.                 VBBS also offers the sysop a means for dealing with users
  26.          who abuse E-mail privileges; all it requires is dropping the
  27.          guilty user's SL below the minimum required to be able to send
  28.          E-mail.
  29.  
  30.          Main Menu Commands and What They Do -- E-Mail
  31.          ═════════════════════════════════════════════
  32.  
  33.          [M] Mailbox Scan       Manually check mailbox for mail -- new,
  34.                                  ALL, or by author search
  35.          [Y] Mail You've Sent   Check mail you've sent BEFORE you log off;
  36.                                  once you log off, network mail is bundled
  37.                                  into the outgoing net packet.  If the re-
  38.                                  cipient is local and has not read it, you 
  39.                                  may still access it.
  40.          [E] Write E-Mail       Write an E-mail to another user, network
  41.                                  or local.
  42.          [F] Feedback to        Automatically directs mail to the sysop.
  43.               Sysop
  44.          [G] Multi-Mail         Users with an appropriate SL may store up
  45.                                  to 9 separate "mailing lists" which may
  46.                                  include a number of local, FidoNet,
  47.                                  VirtualNET, and/or WWIVNet/WWIVLink ad-
  48.                                  dresses.  It is important that respon-
  49.                                  sible network usage of this feature is
  50.                                  maintained.
  51.          Addressing E-mail
  52.          ═════════════════
  53.                 VBBS has several methods of addressing E-mail; even if
  54.          you're not sure of the recipient's name, handle, or user number,
  55.          there's usually a way to get E-mail to him/her.
  56.  
  57.          1) If you're E-mailing a local user, you may send the mail to
  58.             the user's handle, or user number.  If you're not sure of any 
  59.             of this, you can type in a partial name; VBBS will prompt you 
  60.  
  61.                                            VBBS 6.12 Documentation -- 6-B-2
  62.  
  63.  
  64.             for additional information.  If, for example, you were logged 
  65.             onto VirtualNET node @6160 and wanted to E-mail "John Some-
  66.             thing-or-other", you could type in JOHN as the addressee; VBBS
  67.             would prompt back
  68.  
  69.                 John Bok (John Bok) User #1?  (Yes/No/Enter=Yes)
  70.  
  71.             If the name rang a bell, you could simply press [Enter] and
  72.             the E-mail process would be underway.  If not, and there were
  73.             any other users with the handle "John ______", you'd be
  74.             prompted for each one until you either got the right one or
  75.             ran out of users.
  76.  
  77.             Note that it DOES make a difference if the board you're on
  78.             allows handles; if you type in a user's real name and that
  79.             user uses an alias, you WON'T be prompted for the correct
  80.             name.
  81.  
  82.          2) If you're E-mailing over VirtualNET, you may address your
  83.             E-mail to any user on any VirtualNET system, either by name
  84.             or by user number.  If, for example, you were E-mailing
  85.             "The Mighty Quinn" at VirtualNET node @2057, but weren't sure
  86.             of his user number on that system, you could address the
  87.             mail to "The Mighty Quinn @2057", and it would get there.
  88.             You could also mail "1 @2057" with equal success.
  89.  
  90.             Note that if the addressee doesn't have an account on the
  91.             system you sent the mail to, it's lost; there's no way for
  92.             you as a user to re-route the mail to its proper recipient.
  93.             There IS a provision for mail forwarding -- that will be 
  94.             discussed shortly.
  95.  
  96.  
  97.          Oneliners
  98.          ═════════
  99.  
  100.                 Whenever an E-mail is received by the addressee (local or
  101.          network), the user that sent the mail receives a one-line "return
  102.          receipt" that informs the sender that his/her E-mail was read and
  103.          when it was read.  Oneliners are also sent to inform a user who
  104.          has uploaded a file that the file has been downloaded by another
  105.          user (local and network).
  106.                 On multi-user installations, if a user has written E-mail
  107.          to another user who is on the system at the same time, that user
  108.          will receive a real-time oneliner informing him/her that E-mail
  109.          has just been sent to his/her mailbox.  If the user sending the
  110.          E-mail was unaware that the other user was online, VBBS will in-
  111.          form him/her that the addressee was online and a oneliner has
  112.          been sent.
  113.  
  114.  
  115.          Prepared Text Uploading
  116.          ═══════════════════════
  117.  
  118.                 As in the messaging functions, the VBBS full-screen edi-
  119.         
  120.  
  121.                                            VBBS 6.12 Documentation -- 6-B-3
  122.  
  123.          tor [VFSE] will allow the insertion of prepared text through up-
  124.          loading.  To upload text remotely, press "/U" or "[Esc][Esc] U"
  125.          after positioning the cursor at the desired insertion point with-
  126.          in the E-mail or post.
  127.                 Local uploads are simply pathed to the directory and file
  128.          you would like to include.
  129.  
  130. .TOPIC:
  131. File Attachments
  132.          Attached Files to E-Mail
  133.          ════════════════════════
  134.  
  135.                 VBBS features the ability to attach a file to an
  136.          E-mail.  The sysop may choose to make this feature available to
  137.          users by defining its minimum security level in VCONFIG.  If a
  138.          user has been given an appropriate security level, VBBS will ask
  139.          whether he/she would like to attach a file to the current mail
  140.          before saving.  If the user selects "yes", then the upload prompt
  141.          appears and the user may attach a file of any size.
  142.  
  143.          ╔═╗    This feature works across VirtualNET, as well; currently,
  144.          ╚═╝    the generally accepted size limit for network attached
  145.                 files is around 30K.  Anything larger than that definitely
  146.                 nitely raises a few eyebrows on the systems through which
  147.                 the E-mail must pass, and may even be stopped in transit.
  148.  
  149.                 When an attached file is "received" by a user in E-mail,
  150.          the existence of the file is shown at the bottom of the message
  151.          header giving the name of the file and file size; the user is
  152.          prompted to press [T] to transfer (download) the file from the
  153.          BBS.
  154.                 The local sysop may attach a file from anywhere on the
  155.          system by simply providing the path and filename at the prompt
  156.          after choosing "yes". The default path is the main VBBS directory
  157.          if a full path is not supplied.
  158. .TOPIC:
  159. E-Mail Forwarding
  160.          E-Mail Forwarding
  161.          ═════════════════
  162.  
  163.                 According to security level, a user may forward a piece
  164.          of mail he or she has either sent or received to another user.
  165.          Mail forwarding may be done both locally and through any net-
  166.          work in which the BBS participates.  If a piece of mail is mis-
  167.          directed to the correct system but the wrong user, the sysop
  168.          (or the user himself, if allowed) may forward the mail to the
  169.          correct user, if the correct address is known.
  170.  
  171. .TOPIC:
  172. Carbon Copies
  173.          Carbon Copies
  174.          ═════════════
  175.                 According to SL, a user may send carbon copies (CC:s) of
  176.          an unsaved E-mail to other users, both locally and across the
  177.          network.  When that E-mail is received by each CC:d user, it
  178.          shows each network address that received a carbon-copy.
  179.                 If the sysop allows users carbon copies but not multi-
  180.   
  181.                                            VBBS 6.12 Documentation -- 6-B-4
  182.  
  183.          mail functions (see below), this feature may be used as a "poor
  184.          man's multi-mail"; the primary difference is that the mailing
  185.          list for carbon copies is not saveable.
  186.  
  187. .TOPIC:
  188. Multi-Mail
  189.          Multi-Mail and Mailing Lists
  190.          ════════════════════════════
  191.  
  192.                 According to SL (and generally restricted to higher se-
  193.          curity levels), a user can maintain up to 9 separate "mailing
  194.          lists", which can include an unlimited number of entries, both
  195.          local and on any networks in which the BBS participates.
  196.                 This feature can be quite useful if you're involved in
  197.          a project involving many users, such as an online role-playing
  198.          game, political activity, or writers' roundtable; once again,
  199.          the importance of responsible use of this feature CANNOT be
  200.          overstated.  Using multi-mail for networked "junk mail" will
  201.          be brought to the Network Coordinator's attention; he will take
  202.          whatever action he deems appropriate.
  203.  
  204.  
  205.          Account Forwarding
  206.          ══════════════════
  207.  
  208.                 If you have a network address that you write to regularly,
  209.          you might decide to create a local account for that user and then
  210.          configure that user's mailbox (in [D]efaults) to forward mail 
  211.          sent to it to the proper network address.  That way, you can use 
  212.          "Mike" or "24" (or whatever the local ID is) in place of entering 
  213.          the whole network address each time you initiate E-mail.
  214.  
  215.  
  216.          Automatic New-User E-Mail
  217.          ═════════════════════════
  218.  
  219.                 Each time a new user logs onto your system, VBBS sends him
  220.          a "welcome" E-mail that automatically appears in his mailbox.  
  221.          The name of this file is NEWUMAIL.TXT, and it should be placed
  222.          in your \TXT directory.  You may edit this file according to your 
  223.          needs.
  224.  
  225.  
  226.          Form Letters
  227.          ════════════
  228.  
  229.                 Form letters can be used anywhere you are sending mail --
  230.          from feedback, from regular E-mail, from replying to E-mail,
  231.          and also from multi-mail.
  232.                 When prompted for the title, the sysop enters "\" (a back-
  233.          slash, without the quotes), followed by a number from 1 to 99.
  234.          An example would be
  235.  
  236.                 \31
  237.  
  238.          In the above example, VBBS would then look for a file named
  239.  
  240.                                            VBBS 6.12 Documentation -- 6-B-5
  241.  
  242.          FORM.31 in your \TXT directory.  The real message title is pul-
  243.          led from the first line of the file; the rest of the file becomes
  244.          the message text.  It should be noted that the filename should
  245.          NOT have any leading zeroes in the extension (e.g., FORM.4 is
  246.          okay, but FORM.004 is not); this is similar to the filename ex-
  247.          tension rule for taglines (see "System Taglines" for details).
  248.                 When you've given the form letter a filename, follow the
  249.          prompts for attached file and CC:s, and it is saved.  Quick,
  250.          clean, and a minimum of keystrokes.
  251.  
  252. .TOPIC:
  253. DIRECTmail
  254.          VBBS DIRECTmail Interface
  255.          ═════════════════════════
  256.  
  257.                 Using the VBBS DIRECTmail interface, any VBBS sysop may
  258.          send E-mail, with or without attached file, to another VBBS
  259.          sysop.  When you want to use this feature, select [D]IRECTmail
  260.          at the E-mail prompt; then enter the full data phone number of
  261.          the system you wish to send mail to.  You will get an "Unknown
  262.          System" message back; ignore it and go on with the process.
  263.          Multiple DIRECTmail to different destinations may be sent during
  264.          the same session.
  265.  
  266.                 Once you've written the DIRECTmail, drop to WFC and use
  267.          the [N] command to force a callout to that system by selecting
  268.          option 0.  If the line is busy, VBBS will retry as many times
  269.          as you have specified in VCONFIG.
  270.  
  271.                 The beauty of this system is that when the other system
  272.          answers, your computer sends the DIRECTmail and hangs up imme-
  273.          diately.  Again, it's quick and clean.
  274.  
  275.          --> IMPORTANT NOTE: To use DIRECTmail, BOTH sysops must have 
  276.                              this feature enabled in VCONFIG.
  277.  
  278.          Directmail functions are handled by the VDM.EXE executeable.
  279.          VDM.EXE is automatically called as needed by VBBS/VME. VDM
  280.          has the following command line switches:
  281.  
  282.          VDM <ch> /DIRECTIN     Handle Incoming Call in Progress
  283.          VDM <ch> /DIRECTOUT:x  Call System x=Mail Slot #
  284.        
  285.          Up to 99 direct mail slots are available, and slots are auto-
  286.          matically assigned as needed.  If DIRECTmail is pending to be
  287.          sent to a node, for example, any subsequent DIRECTmail to that
  288.          same node are automatically processed together.
  289.        
  290.  
  291.                                         VBBS 6.12 Documentation -- 6-B-6
  292.  
  293. .TOPIC:
  294. FREQing
  295.          File Requesting - FREQing
  296.          ═════════════════════════
  297.  
  298.                 VBBS also has the ability to request files in conjunction
  299.          with the DIRECTmail function.  To request files, simply enter the
  300.          appropriate information on the title line of e-mail sent by
  301.          DIRECTmail using the following format:
  302.  
  303.          Title:  FREQ  <filename.ext> <filename.ext> <filename.ext>
  304.  
  305.                 FREQ must be the first word entered on the line, followed
  306.          by one space, and then the complete name of the file requested,
  307.          including the extension.  Multiple files may be requested as long
  308.          as there is one space between each of the filenames. For FREQing
  309.          to be successful, the board you call must have its file databases
  310.          flagged as FREQable and DIRECTmail must be turned on in VConfig.
  311.  
  312.  
  313.  
  314.                                            VBBS 6.12 Documentation --6-B-7
  315.  
  316.          E-Mail Sub-Menu
  317.          ═══════════════
  318.  
  319.                 Below is the hard-coded E-mail sub-menu; again, altering
  320.          this menu requires a source-code modification.
  321.  
  322.          [Enter] Next E-Mail            Advances to next E-mail.                                        
  323.            [R]   Reply to E-Mail        Reply to the E-mail you're cur-
  324.                                          rently reading.
  325.            [A]   Re-Read E-Mail         Redisplays the current E-mail.
  326.            [D]   Delete E-Mail          Delete the current E-mail.  It's
  327.                                          a good idea to encourage users
  328.                                          to delete their E-mail once
  329.                                          they've read and/or replied to
  330.                                          it, because old E-mail DOES
  331.                                          take up hard-drive space.
  332.            [Q]   Quit Reading E-mail    Quits to communications menu.
  333.            [T]   Download Attached      If a file is attached, this will
  334.                   File                   allow the remote user to down-
  335.                                          load the attached file.
  336.  
  337.  
  338.  
  339.           [###]  Read Mail Number ###   Jump to E-mail number entered.
  340.  
  341.          ──────── Sysop ─────────
  342.  
  343.          [X]  Extract Text              Allows sysop to save message as a
  344.                                          text file.  Again, it's a good
  345.                                          idea to NOT use the .TXT exten-
  346.                                          sion on E-mail.
  347.          [F]  Forward                   Forward E-mail to another user,
  348.                                          either locally or across any
  349.                                          networks in which the BBS par-
  350.                                          ticipates.
  351.          [V]  Validate User             Jumps to the author's account in-
  352.                                           ormation in the user editor.
  353.                                           Useful when reading new-user
  354.                                           feedback.
  355.  
  356.  
  357.                 Just a few parting words about E-mail -- sysops should
  358.          encourage their users to take advantage of this feature of VBBS
  359.          (or any networked BBS system, for that matter), especially if
  360.          the BBS does not charge for its services.  The communications
  361.          potential here is enormous but, sadly, is one of the most under-
  362.          utilized features of BBS software.
  363.  
  364.                                          VBBS 6.12 Documentation --6-B-8
  365.  
  366.  
  367.  
  368.  
  369.          ╔═╗    Another important use of E-mail that is seldom addressed
  370.          ╚═╝    in reference manuals (until now) is in resolving "flame
  371.                 wars".  On occasion, discussions in local and networked
  372.                 message bases will deteriorate into name-calling and
  373.                 "bashing"; on such occasions, the issue is best resolved
  374.                 in E-mail, rather than on public message bases.  Please
  375.                 encourage your users to not engage in flaming, and if
  376.                 they happen to become involved in a flame war, please
  377.                 instruct them to take it into E-mail, rather than con-
  378.                 tinuing to spew vitriolic garbage across the network,
  379.                 where it can have detrimental effects on the message subs
  380.                 (these are strong words, but having seen the effects of
  381.                 flaming on more than one message base, I wanted to get
  382.                 your attention).
  383.