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

  1.                                            VBBS 6.11 Documentation -- 6-D-1
  2.  
  3.  
  4.          ╔════════════════════════════════════════════════════════════════╗
  5.          ║ CHAPTER SIX ANNEX D    SUBSYSTEMS/MISCELLANEOUS FUNCTIONS      ║
  6.          ╚════════════════════════════════════════════════════════════════╝
  7.  
  8.                 This particular area of a BBS is usually one of the more
  9.          interesting areas, yet it's one of the most under-utilized.  In
  10.          the subsystems area, users can read a list of all the users on
  11.          the BBS, vote on topics of current interest, read textfiles, and
  12.          do several other Neat Things (caps still intended).
  13.  
  14.  
  15.          Main Menu Commands and What They Do -- Subsystems
  16.          ═════════════════════════════════════════════════
  17.  
  18.          [T] File Transfers             We just got through with this one.
  19.          [B] Bulletins/Textfiles        Display menu of general textfiles
  20.                                          available for reading.
  21.          [S] System Info                Provides a display of the BBS'
  22.                                          system statistics.
  23.          [V] Voting Booth               Users are allowed to vote on pol-
  24.                                          ling questions posted by the
  25.                                          sysop.
  26.          [D] Defaults                   Allows user to set his or her de-
  27.                                          fault settings; one of the most
  28.                                          important features a new user
  29.                                          can access.
  30.          [O] Online Programs            Displays menu for games and other
  31.                                          online programs configured in
  32.                                          VCONFIG.
  33.          [A] Autoposts                  Displays autoposts.
  34.  
  35.  
  36.  
  37.          Main Menu Commands and What They Do -- Miscellaneous
  38.          ════════════════════════════════════════════════════
  39.  
  40.          [K] Today's Callers            Displays a list of callers who
  41.                                          have logged on today.
  42.          [U] User Listing               Displays a complete user listing;
  43.                                          sysops also get SL, max time,
  44.                                          and access flags.
  45.          [I] System Info                Shows system usage statistics.
  46.          [C] Page Sysop                 If the console [ScrlLock] or [A]
  47.                                          is set to ON, this will activate
  48.                                          an audible page.
  49.          [W] Who's Online               Shows status of console and each
  50.                                          modem port.
  51.          [Z] Multiuser Teleconference   On multiuser systems, allows the
  52.                                          users to chat between nodes.
  53.          [X] Network Info               Displays network BBSLIST(s).
  54.          [*] Sysop Menu                 Go to sysop function block (dis-
  55.                                          played to 255 SL only).
  56.          [G] Log Off                    Exit the BBS.
  57.  
  58.                                            VBBS 6.11 Documentation -- 6-D-2
  59.  
  60.  
  61.          Bulletins/Textfiles
  62.          ═══════════════════
  63.  
  64.                 The bulletins/textfiles section (also known as "G-files"
  65.          by WWIV sysops) contains text files that users may read at their
  66.          leisure (if they have any).  The types of files that are placed
  67.          here are generally about the BBS' procedures and policies; other
  68.          possibilities include system news files, virus information, game
  69.          scoreboards and news files (a popular feature), or transcripts
  70.          of articles dealing with topics of particular interest (please
  71.          make sure to give proper credit to the author).
  72.                 To install a textfile, place the file in the directory
  73.          you have indicated in VCONFIG, section E.  Go into the textfile
  74.          area and select the [A]dd option; follow the prompts from there.
  75.                 It's a good idea to keep your titles and descriptions
  76.          brief; lengthy titles and descriptions are truncated.  By the
  77.          way, when a USER looks at the titles, he/she does NOT see the
  78.          filename -- only the title.  The filename is displayed to the
  79.          sysop as a means of keeping track of filenames.
  80.  
  81.  
  82.          System Info
  83.          ═══════════
  84.  
  85.                 This is the screen produced by the line "sysinfo" in the
  86.          default START.V.  It shows today's statistics and the total cu-
  87.          mulative statistics for your system.  This screen differs from
  88.          the WFC stats screen in that it also shows active/idle minutes
  89.          and a graphical representation of usage by time of day and modem
  90.          speed.
  91.                 The one statistic most sysops are usually concerned about
  92.          is the "Duty Cycle" statistic; it's the ratio of active minutes
  93.          to total minutes online.  Naturally, you want to keep this num-
  94.          ber as high as possible, since it's the quickest measure of how
  95.          active your system is.  A figure of 50% means that your system
  96.          has been in use half the day -- not a bad total at all -- while
  97.          a figure of 70% or better is cause for rejoicing.  If your duty
  98.          cycle is consistently less than 15-20%, you might want to re-
  99.          examine the way you "do business" -- you may be doing something
  100.          that discourages users from calling your board.  
  101.  
  102.          ╔═╗    There is a VirtualNET sub in which sysops discuss ideas
  103.          ╚═╝    for improving board usage:  "BBS Success (Keeping Your
  104.                 Board Going)".
  105.  
  106.  
  107.          Voting Booth
  108.          ════════════
  109.  
  110.                 Voting questions are an important way to keep your finger
  111.          on the pulse of your user base.  In VCONFIG, you can set VBBS to
  112.          check whether there are new voting questions when a user logs on;
  113.          this is generally a good idea.  Typical voting questions might 
  114.          include:
  115.  
  116.                                            VBBS 6.11 Documentation -- 6-D-3
  117.  
  118.  
  119.          ■  How did you hear about this BBS?
  120.          ■  What's the MAIN reason you call <BBS name here>?
  121.          ■  If you could change ONE thing at <BBS name>, what would it be?
  122.              (Think this one through CAREFULLY -- don't suggest changes
  123.               you aren't willing to implement!)
  124.          ■  Which of the following subs would you MOST like to see added?
  125.  
  126.          Of course, you may tailor the questions to your specific needs.
  127.          It should be noted that this multiple-choice format is not par-
  128.          ticularly suited for "ranking"-type questions, as they allow
  129.          only one answer per question.
  130.                 Another thing to consider when constructing voting ques-
  131.          tions is that you may ask your users' opinion on something; the
  132.          best format for "like/don't like" questions is 
  133.  
  134.          1 -- Really like it            It's GREAT!
  135.          2 -- Like it                   I think it's okay.
  136.          3 -- Don't care                Doesn't make any difference to me.
  137.          4 -- Don't like it             I'm not real crazy about it.
  138.          5 -- Really don't like it      I don't like it very much.
  139.  
  140.          You may "disguise" these choices as shown above, but it has been
  141.          shown to be one of the most statistically reliable formats for
  142.          opinion-type questions.
  143.                 Please see "The Voting Booth" for the "how-to" on setting 
  144.          up voting questions.
  145.  
  146.  
  147.          Defaults
  148.          ════════
  149.  
  150.                 This was addressed earlier in the section on VCONFIG, but
  151.          having users set their own defaults is quite an important matter,
  152.          and they are encouraged to do so automatically after they create
  153.          their account.
  154.  
  155.                 The most important default a new user can set is to enable
  156.          the full-screen editor (if he/she has ANSI capability); other
  157.          commonly-adjusted defaults include screen colors, user macros,
  158.          and mail forwarding (if desired).
  159.  
  160.  
  161.          Autoposts
  162.          ═════════
  163.  
  164.                 Autoposts are like electronic Post-It Notes <tm> that
  165.          may appear in a user's initial login (depending on his/her de-
  166.          fault settings).  Users who have the appropriate security level
  167.          may post a one-, two-, or three-line message for display; the
  168.          four most recent autoposts are displayed.  These are useful for
  169.          announcing upcoming system changes/downtime or alerting users to
  170.          the existence of new/important files or posts.
  171.                 In addition, there are several VSCRIPT-based autopost
  172.          programs (most notably GREMPOST.V) that allow networking of
  173.  
  174.                                            VBBS 6.11 Documentation -- 6-D-4
  175.  
  176.          autoposts over VirtualNET-networked BBSs; note that these ARE
  177.          NOT included with the original VBBS archive.
  178.  
  179.          Sysop Paging and Chat Screens
  180.          ═════════════════════════════
  181.  
  182.                 As stated earlier, either the [Scroll Lock] key or the
  183.          [A] key from WFC will toggle sysop availability, depending on
  184.          how you have things set up in VCONFIG.
  185.                 There are two ways to answer a chat-call; one is with
  186.          the normal [F1] key.  This allows you to converse with the on-
  187.          line user -- your words show up in one color, the user's in
  188.          another.  To exit this chat method, press [F1] again.
  189.                 The fancier way to answer is with the [Shift-F1] key.
  190.          This divides the screen into two halves, with your words at the
  191.          top and the user's at the bottom.  To exit this chat mode, press
  192.          [Esc].
  193.  
  194.          ╔═╗    Chatting, if done properly, can be a great PR builder.
  195.          ╚═╝    Some helpful hints on chatting:
  196.  
  197.                 1) Try to be available for chat at least SOME of the time.
  198.                    It doesn't usually take TOO long.
  199.                 
  200.                 2) Try NOT to "drop in" on a user when they're in the mid-
  201.                    dle of something, unless they're looking totally lost.
  202.                    Try not to startle your users.
  203.  
  204.                 3) As a way of indicating that you're through typing a 
  205.                    sentence, it's usually a good idea to hit [Enter] twice
  206.                    to double space; that lets the user know you're through 
  207.                    typing, kind of like "over" in a radio conversation.
  208.         
  209.                 4) When you leave the console, make sure sysop avail-
  210.                    ability is toggled where you want it.  If you're tog-
  211.                    gled as available when you're really not, users can 
  212.                    become frustrated.
  213.  
  214.                 As with other functions of VBBS, there are a number of
  215.          alternative chat and paging scripts available -- there is even
  216.          an "emergency chat" script that allows users who know a special
  217.          password to bypass the "sysop not available" message and page
  218.          you anyway.  A fully external chat utility called ISYCHAT10
  219.          also allows for the above, global capture of the chat, is
  220.          configureable for multiple sysops, and is Soundblaster capable.
  221.  
  222.  
  223.          Multi-user Teleconference
  224.          ═════════════════════════
  225.  
  226.                 The multi-user teleconference is an inter-node chat fea-
  227.          ture.  From inside the teleconference, two or more users who are
  228.          online simultaneously can page each other to the teleconference,
  229.          send one-line messages to each other to whatever area the other
  230.          user is active in, and broadcast short messages to ALL users on-
  231.          line at the time.  Also, if you send E-mail to a user who is on-
  232.  
  233.                                            VBBS 6.11 Documentation -- 6-D-5
  234.  
  235.  
  236.          line, VBBS will notify that user that you have sent E-mail to
  237.          him/her.
  238.                 Once inside of the teleconference, users can chat with
  239.          each other within teleconferencing "rooms".  If there were four
  240.          users in the teleconference, for example, two users could decide
  241.          to change rooms in order to have an exclusive conversation with
  242.          each other.  There are 99 such rooms within teleconference.
  243.                 Users have the option in teleconference to change their
  244.          handles within the teleconference.  Users who do not wish to be
  245.          available for chatting may access the "hide" function within
  246.          the teleconference in order to be invisible to other users while
  247.          executing other BBS areas on a multi-line system.
  248.  
  249.  
  250.          THE SYSOP MENU
  251.          ══════════════
  252.  
  253.                 The sysop menu, available only to users with a 255 SL, is
  254.          accessed by pressing the star [*] key at the Main Menu (although
  255.          with a function-block modification, you could make it accessible
  256.          at ANY menu (... you know where to look for info on this).
  257.                 The functions available at the sysop menu are:
  258.  
  259.          [M] Read All Mail              Review all E-mail on the system.
  260.                                          Use this with extreme discre-
  261.                                          tion, if you use it at all.
  262.          [E] Edit Any File              Pulls a file into the VBBS FSE for
  263.                                          editing; useful for colorizing
  264.                                          system taglines, among other
  265.                                          things.
  266.          [U] User Editor                Go into the user editor to check
  267.                                          on/edit user information.
  268.          [S] Security                   Displays users with SLs greater
  269.                                          than 150 or who have one or more
  270.                                          access flags set.
  271.          [C] Force Cleanup              Force a daily cleanup.  Note that
  272.                                          this isn't a "hit-and-forget"
  273.                                          command; the screen will pause
  274.                                          when it reaches your default
  275.                                          page length.
  276.          [V] Validate Network           Presents the posts scheduled to
  277.                                          go out over the network from
  278.                                          your system; you will be promp-
  279.                                          ted to [A]pprove or [D]isapprove
  280.                                          each one.  Not easy if you have
  281.                                          a lot of active subs that re-
  282.                                          quire network validation.  This
  283.                                          is also an easy thing to forget
  284.                                          to do on a daily basis.
  285.          [Q] Quit                       Return to main (or previous) menu.
  286.  
  287.                                            VBBS 6.11 Documentation -- 6-D-6
  288.  
  289.          QWK OFFLINE READERS
  290.          ═══════════════════
  291.  
  292.                 VBBS features support for .QWK format offline readers.
  293.          Offline readers are special programs that allow a user to down-
  294.          load message packets from a BBS and read them at her leisure.  
  295.          They also allow users to construct packets containing their 
  296.          replies to messages and upload them in return.
  297.                 Some of the more popular offline readers include SLMR,
  298.          JABBER, BlueWave, OFFLINE, and OLX; in addition, there are .QWK 
  299.          readers available for Windows.
  300.  
  301.                 VBBS' auxiliary program, VQWK.EXE, prompts the user to up-
  302.          load a .REP file that tells VBBS which messages have been pre-
  303.          viously downloaded, as well as which message areas the user
  304.          would like to read.  This is configured either by making use of 
  305.          the [J]oin/Ignore Bases command in the Main Menu, or from within
  306.          the QWK menu:
  307.  
  308.          [D]ownload new message packet (QWK)                              
  309.          [U]pload reply message packet (REP)
  310.          [A]lter maximum # of messages/packet
  311.          [C]hange default compression type
  312.          [P]ick # of days for new file scan
  313.          [S]elect message bases for QWKing
  314.          Show (W)ho's currently online
  315.          [R]eturn to the BBS (exiting QWK)
  316.          [G]oodbye/Log off from the BBS                                      
  317.  
  318.          See Appendix I for VQWK setup instructions.
  319.          
  320.  
  321.          THE VBBS HYPERTEXT HELP SYSTEM (Optional)
  322.          ═════════════════════════════════════════
  323.  
  324.                 The VBBS help system is a fine hypertext help system.
  325.          It can be configured in unlimited ways to meet a variety of
  326.          needs.  The calling sequence is
  327.  
  328.                 VBBS-AUX %1 HELP <help system number>
  329.  
  330.          The <help system number> is used to form a filename of the 
  331.          "lookup" file, which should be placed in your VBBS \DATA direc-
  332.          tory.  For example, for help system number 1, the file name would
  333.          be LOOKUP.1 (not LOOKUP.001).  Help systems from 1 to 999 are
  334.          available; system 0 is reserved for future internal use by VBBS.
  335.             Lookup files have the format -- one entry per line --
  336.  
  337.                 <help filename> <keyword or key phrase>
  338.  
  339.          For example, you might have this as a lookup file:
  340.  
  341.                                            VBBS 6.11 Documentation -- 6-D-7
  342.  
  343.  
  344.                 HELP1   Main Screen
  345.                 HELP2   Primary Topics
  346.                 HELP3   Secondary Topics
  347.                 HELP4   General Information
  348.  
  349.          In the lookup file, do not put in an extension for the help
  350.          filename; .HLP is assumed.  The first entry in your lookup file
  351.          is considered to be the starting point.  The help filename speci-
  352.          fied is displayed, and the user is prompted; continuing or going
  353.          back to the main menu proceeds from there.
  354.  
  355.                 Within each help file, you reference topics in the lookup
  356.          file by bracketing them with [ and ].
  357.                 Using the example LOOKUP file from above, help-file skele-
  358.          tons might look like this:
  359.  
  360.          HELP1.HLP:
  361.          ──────────
  362.  
  363.                         Welcome to the Main Help Screen.
  364.  
  365.                               [Primary Topics]
  366.                              [Secondary Topics]
  367.                             [General Information]
  368.  
  369.          HELP2.HLP
  370.          ─────────
  371.  
  372.                      Welcome to the Primary Topics Screen.
  373.  
  374.                              [Secondary Topics]
  375.                             [General Information]
  376.                                [Main Screen]
  377.  
  378.          HELP3.HLP
  379.          ─────────
  380.  
  381.                     Welcome to the Secondary Topics Screen.
  382.  
  383.                               [Primary Topics]
  384.                             [General Information]
  385.                                [Main Screen]
  386.  
  387.          HELP4.HLP
  388.          ─────────
  389.  
  390.                         Welcome to General Information.
  391.  
  392.                               [Primary Topics]
  393.                              [Secondary Topics]
  394.                                [Main Screen]
  395.  
  396.                                            VBBS 6.11 Documentation -- 6-D-8
  397.  
  398.          --> IMPORTANT NOTE:  Several complete hypertext help files are
  399.                               available from VBBS support boards for
  400.                               easy installation in standard VBBS systems.
  401.  
  402.  
  403.          THE VBBS QUIZ/TEST SYSTEM (Optional)
  404.          ════════════════════════════════════
  405.  
  406.                 The VBBS quiz/test feature can be used to give users tests
  407.          and quizzes online -- trivia quizzes (a great source of competi-
  408.          tion among users), tests on the users' knowledge of the BBS, or
  409.          even (if you can find the time to set it up) an actual test file
  410.          for tests from the local high school, community college, or uni-
  411.          versity (an extremely ambitious project, but unique!).  The cal-
  412.          ling sequence for the test feature is
  413.  
  414.                 VBBS-AUX %1 TEST <test filename>
  415.  
  416.          Test files (and the score files generated) should reside in your
  417.          \DATA directory.  Test files assume a .TST extension (be careful
  418.          typing that extension), and score files have a .SCO extension.
  419.          Score files are simple ASCII files; report generators can ana-
  420.          lyze the score file to produce statistical information.  A report
  421.          generator specifically designed for VBBS (TREPORT.EXE) is avail-
  422.          able for download from the author's BBS.
  423.  
  424.                 Test files are simple ASCII files also.  Each line of a
  425.          test file begins with one of the following prefixes:
  426.  
  427.                 b=   e=   a=   q=   p=
  428.  
  429.                 The "b=" prefix spcifies information displayed to the user
  430.          BEFORE they begin the test; you may have one or more of these at
  431.          the beginning of your test.
  432.                 The "e=" prefix indicates information that is shown to the
  433.          user AFTER they have finished the test; you may have one or more
  434.          of these.
  435.                 The "a=" prefix specifies the correct answer to the ques-
  436.          tion beginning on the next line; it also signals the test proces-
  437.          sor that a new question is beginning.
  438.                 The "q=" prefix contains the actual question (known in
  439.          educational circles as the "stem").  There may be one or more
  440.          lines in a question stem.
  441.                 The "p=" prefix specifies one of up to 20 possible answers
  442.          for the question (although 5 is generally a good number).
  443.          A sample one-question test under the name INTRO.TST might look 
  444.          something like this:
  445.  
  446.                 b=Welcome to this sample test; it only has
  447.                 b=one question.
  448.                 a=3
  449.                 q=Where is the Statue of Liberty located?
  450.                 p=Washington, DC
  451.                 p=Paris, France
  452.                 p=New York City
  453.                 p=Los Angeles
  454.                 e=Thanks for taking this test!
  455.  
  456.                                            VBBS 6.11 Documentation -- 6-D-9
  457.  
  458.  
  459.          You will have to experiment a little to get proper spacing and
  460.          such, but a well-constructed fun quiz is another way of getting 
  461.          users online ...
  462.  
  463.  
  464.          THE VBBS CALLBACK VERIFIER (Optional)
  465.          ═════════════════════════════════════
  466.  
  467.                 The call-back verifier is a means of checking to see whe-
  468.          ther a new user has left a valid phone humber in his/her logon
  469.          information.  It is implemented in VCONFIG; if you choose "yes"
  470.          to the callback verifier, VBBS will look at the two ASCII .CBV
  471.          files you've created in your \DATA directory and establish whe-
  472.          ther the new user is calling from a telephone exchange (accor-
  473.          ding to the sysop's criteria) that will allow callback verifi-
  474.          cation.  If the user is NOT within your defined callback area,
  475.          or leaves a number that you have included in your RESTRICT.CBV
  476.          file (such as 911), the board will not execute the dialout, and
  477.          new-user login will continue normally. The user is allowed to
  478.          complete callback validation successfully up to three times
  479.          before the connection is dropped.
  480.  
  481.          --> IMPORTANT NOTE:  Due to the callout nature of this feature, 
  482.                               its use and proper configuration is the
  483.                               specific responsibility of the individual
  484.                               sysop.
  485.  
  486.                 The callback verifier needs two files to work properly:
  487.          ALLOWED.CBV and RESTRICT.CBV; as mentioned earlier, VBBS will
  488.          look for these in the directory you have configured as your
  489.          \DATA directory in VONFIG.  The two files are discussed below.
  490.  
  491.          ALLOWED.CBV
  492.          ───────────
  493.  
  494.                 ALLOWED.CBV specifies the list of ALLOWED area code/
  495.          prefix combinations.  The format for the file is one entry per
  496.          line, as follows:
  497.  
  498.                 XXX-YYY Z
  499.  
  500.          where XXX is the area code, YYY is the prefix, and Z is a
  501.          "specifier" that tells the callback verifier how to dial this
  502.          area code/prefix combination.  Possible specifiers are given
  503.          below:       
  504.                                   
  505.          Specifier     Type of Call             How Dialed
  506.          ─────────────────────────────────────────────────────────────
  507.              +         Local                    YYY-????
  508.              -         LD within area code      1-YYY-????
  509.              $         LD outside area code     1-XXX-YYY-????
  510.              /         Local outside area code  XXX-YYY-????
  511.  
  512.          It should be noted that the wildcard character "?" is allowed
  513.          when entering prefixes.  For example, the line
  514.  
  515.                                            VBBS 6.11 Documentation -- 6-D-10
  516.  
  517.  
  518.                 205-34? +
  519.  
  520.          in ALLOWED.CBV would enable the BBS to call back ANY phone num-
  521.          ber local to the BBS that began with the digits "34"; in the
  522.          example above, the callback verifier would call Tuscaloosa's
  523.          345, 348, and 349 exchanges as local.  The surest way to han-
  524.          dle proper exchanges is to enter each one manually; while this
  525.          may necessitate a little more work on the sysop's part, it also
  526.          ensures that long-distance numbers that fit the prefix criteria
  527.          won't be called unnecessarily.
  528.  
  529.  
  530.          RESTRICT.CBV
  531.          ────────────
  532.  
  533.                 RESTRICT.CBV specifies the list of restricted phone num-
  534.          bers that may not be dialed by the callback verifier, such as
  535.          local police and/or fire departments, 911, "prank numbers" like
  536.          000-000-0000, or those of previously-known "bad users".
  537.  
  538.  
  539.                 Some final words on optional features:  These are often
  540.          the "something extra" that will keep your users calling back, as
  541.          implementing these features reflects a strong measure of dedica-
  542.          tion on your part.  Sysops are strongly encouraged to make use of
  543.          (and to encourage their users to use) the .QWK-format offline
  544.          readers available; this can significantly reduce the amount of
  545.          time users spend online reading messages, freeing them to explore
  546.          and use other areas of the BBS.
  547.  
  548.