home *** CD-ROM | disk | FTP | other *** search
/ Lion Share / lionsharecd.iso / bbs_oth / qes61.zip / QESSUMRY.DOC next >
Text File  |  1991-02-24  |  64KB  |  2,113 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                      QESSUMRY.EXE
  23.                                          6.1
  24.                           Release Date:  February 22, 1991 
  25.  
  26.  
  27.                                Copyright (c) 1988, 1991
  28.                                     R. Mike Worley
  29.                                      Boise, Idaho
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                   TABLE of CONTENTS
  74.  
  75.  
  76.           WARRANTY & REGISTRATION . . . . . . . . . . . . . . . . . . .   1
  77.  
  78.           PROGRAM SUMMARY and HISTORY . . . . . . . . . . . . . . . . .   2
  79.  
  80.           NEW FEATURES IN QESSUMRY 6.1  . . . . . . . . . . . . . . . .   3
  81.  
  82.           EXAMPLES & FILE EXTENSION SUMMARY . . . . . . . . . . . . . .   3
  83.  
  84.           DEFINING THE QUESTIONS  . . . . . . . . . . . . . . . . . . .   5
  85.  
  86.           RUNNING THE PROGRAM . . . . . . . . . . . . . . . . . . . . .   7
  87.                Open Files . . . . . . . . . . . . . . . . . . . . . . .   7
  88.                Variation 1  . . . . . . . . . . . . . . . . . . . . . .   7
  89.                Variation 2  . . . . . . . . . . . . . . . . . . . . . .   8
  90.                Errors During Execution  . . . . . . . . . . . . . . . .   9
  91.  
  92.           OUTPUT OPTIONS  . . . . . . . . . . . . . . . . . . . . . . .   9
  93.                [A]SCII File . . . . . . . . . . . . . . . . . . . . . .   9
  94.                (D)elimited Data File  . . . . . . . . . . . . . . . .    10
  95.                (P)rinter  . . . . . . . . . . . . . . . . . . . . . .    10
  96.                (Q)uestions & Answers  . . . . . . . . . . . . . . . .    10
  97.                     Supplying "Correct" Answers . . . . . . . . . . .    10
  98.                     Supplying an Explanation to Questions . . . . . .    11
  99.                     Format of <filename>.EXP  . . . . . . . . . . . .    12
  100.                (U)ser Response Statistics . . . . . . . . . . . . . .    12
  101.                (R)esponse Messages to Users . . . . . . . . . . . . .    13
  102.                          Leader Line  . . . . . . . . . . . . . . . .    13
  103.                     Kill Message  . . . . . . . . . . . . . . . . . .    13
  104.                     Security Level of Messages  . . . . . . . . . . .    13
  105.                     Merging the Messages into RBBS-PC . . . . . . . .    14
  106.  
  107.           OVERWRITING OUTPUT FILES  . . . . . . . . . . . . . . . . .    14
  108.  
  109.           EXPLANATION OF APPENDICES . . . . . . . . . . . . . . . . .    14
  110.                Appendix A - Sample Definition File  . . . . . . . . .    15
  111.                Appendix B - Sample Answer Files . . . . . . . . . . .    17
  112.                Appendix C - Sample Explanation File . . . . . . . . .    18
  113.                Appendix D - Sample ASCII Output File  . . . . . . . .    19
  114.                Appendix E - Sample Delimited Database Output File . .    21
  115.                Appendix F - Sample Question & Answer Summary  . . . .    22
  116.                Appendix G - Sample User Response Statistics . . . . .    26
  117.  
  118.           INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . .    28
  119.  
  120.           REGISTRATION FORM . . . . . . . . . . . . . . . . . . . . .    29
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.           QESSUMRY 6.1                  - 1 -             February 22, 1991
  140.           Documentation
  141.           
  142.           
  143.           
  144.  
  145.                                WARRANTY & REGISTRATION
  146.  
  147.                QESSUMRY 6.1 is not warranted in any way, nor is it applica-
  148.           ble to any specific application.  The user is solely responsible
  149.           for any and all consequences resulting from the use of this
  150.           program.  There are no known bugs in the program, but that
  151.           doesn't mean you might not find one.
  152.  
  153.                                      . . . . . .
  154.  
  155.                QESSUMRY 6.1 is offered under the Shareware concept - it is
  156.           not free software.  You may try it for a period of 30 days to
  157.           determine if it will meet your needs, and you are encouraged to
  158.           upload the program and documentation to bulletin boards.  If you
  159.           continue to use this program past the 30 day trial period, you
  160.           must register.  To register, complete the registration form on
  161.           the last page of this documentation and send it to the address
  162.           listed.  The registration fee for QESSUMRY 6.1 is $18.00.
  163.  
  164.  
  165.                BBS Sysops may distribute this program on their systems,
  166.           subject to the following conditions: 
  167.            
  168.                     1 - The program, documentation, and associated files
  169.                     are distributed as a package. 
  170.            
  171.                     2 - No modifications are made to the program or docu-
  172.                     mentation. 
  173.            
  174.                     3 - No fee is charged for distribution. 
  175.            
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.           QESSUMRY 6.1                  - 2 -             February 22, 1991
  206.           Documentation
  207.           
  208.           
  209.           
  210.  
  211.                              PROGRAM SUMMARY and HISTORY
  212.  
  213.                QESSUMRY 6.1 is a program to summarize data from bulletin
  214.           board questionnaires developed for RBBS-PC.  The program will
  215.           ignore questions requiring a text response, provided individual
  216.           the questions are named as outlined below.  It will also skip
  217.           questions for which there have been no responses, as sometimes
  218.           occurs when the questionnaire follows different paths depending
  219.           on answers to previous questions.
  220.  
  221.                QESSUMRY 6.1 will tally the number of responses for multiple
  222.           choice and yes/no questions, and will calculate a response
  223.           percentage for each choice.  The basic tally and percentage can
  224.           be output to a ASCII (Text) File, a Printer, or to a Delimited
  225.           Data File for use with database programs. 
  226.  
  227.                QESSUMRY 6.1 can also create a special text file (Question
  228.           and Answer Summary) which integrates the actual questions from
  229.           the questionnaire .DEF file with the response summaries, along
  230.           with an indication of "correct" answers to questions, if
  231.           appropriate.  QESSUMRY 6.1 provides the additional ability to
  232.           incorporate explanations of "correct" answers to questions,
  233.           either through keyboard input of from a data file.
  234.  
  235.                From the summary files created by the program, QESSUMRY 6.1
  236.           can generate a statistical report of Users' "correct" response
  237.           rate, both individually and as a group.  QESSUMRY 6.1 can also
  238.           create individual text messages to each responding user, detail-
  239.           ing the user's response statistics, for incorporation into RBBS-
  240.           PC messages (Response Messages to Users).
  241.  
  242.                                       . . . . .
  243.  
  244.                QESSUMRY started as QESTALLY, which was released in Febru-
  245.           ary, 1988.  Some users requested improvements to the program to
  246.           make it more versatile in output.  The delimited data file output
  247.           was immediately added, but before the revision was released, we
  248.           noted a need to integrate the actual questions from the <file-
  249.           name>.DEF file with the answer summaries.  This creates a bulle-
  250.           tin which shows the reader the question, the correct answer, and
  251.           the summary of responses.  The revision was major enough to
  252.           warrant renaming the program, and thus QESSUMRY was born.
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.           QESSUMRY 6.1                  - 3 -             February 22, 1991
  272.           Documentation
  273.           
  274.           
  275.           
  276.  
  277.                              NEW FEATURES IN QESSUMRY 6.1
  278.  
  279.  
  280.           *    QESSUMRY now automatically generates a User Response Statis-
  281.                tics file every time the (R)esponse Messages to Users option
  282.                is taken.  This ensures that the <filename>.URS file is
  283.                current.
  284.  
  285.           *    QESSUMRY checks the questionnaire data file for possible
  286.                errors and writes the line number of the error to a file.
  287.  
  288.           *    Minor corrections to the file location error system.
  289.  
  290.  
  291.  
  292.  
  293.                           EXAMPLES & FILE EXTENSION SUMMARY
  294.  
  295.                Throughout this documentation, we will refer to several
  296.           types of files.  Examples of all files, except the .DAT (data)
  297.           file, are listed in the appendices.  We have used an actual
  298.           questionnaire called TRIVIA.DEF.  This questionnaire represents
  299.           the most complex type, one with "correct" answers and explana-
  300.           tions of why those answers are correct. 
  301.  
  302.                The following file extensions are used at various times by
  303.           QESSUMRY 6.1.  All extensions are preceded by the questionnaire
  304.           filename, which is designated in the documentation as <filename>. 
  305.           The <filename> may be any one to eight (1 - 8) character name
  306.           valid with MS-DOS, but must be the same for all questionnaire
  307.           files.
  308.  
  309.  
  310.           <filename>.ANS      File containing "correct" answers to ques-
  311.                          tions.  Optional file - if it is not available,
  312.                          QESSUMRY will prompt for responses.  [Created by
  313.                          sysop following guidelines below or may be created
  314.                          automatically by QESSUMRY]
  315.  
  316.  
  317.           <filename>.DAT      Data file output by RBBS, containing each
  318.                          respondent's name and answers to questions.  [Cre-
  319.                          ated by RBBS - Sysop must supply the data file
  320.                          name during the creation of <filename>.DEF]  
  321.                          NOTE:  This file MUST be present for QESSUMRY 6.1
  322.                          to work.
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.           QESSUMRY 6.1                  - 4 -             February 22, 1991
  338.           Documentation
  339.           
  340.           
  341.           
  342.  
  343.           <filename>.DEF      Questionnaire definition file.  This must be
  344.                          created as specified in the RBBS-PC documentation. 
  345.                          [Must be created by the sysop]
  346.  
  347.  
  348.           <filename>.DIR      Used in QESSUMRY 5.0 but discontinued in this
  349.                          version.
  350.  
  351.  
  352.           <filename>.DTA      File containing total number of responses to
  353.                          each question and the number of responses to each
  354.                          option for each question.  Data is delimited by
  355.                          commas for use with database programs.  [Created
  356.                          by QESSUMRY]
  357.  
  358.  
  359.           <filename>.ERR      File containing possible answer errors and
  360.                          associated line numbers encountered in the <file-
  361.                          name>.DAT file.  [Created by QESSUMRY]
  362.  
  363.  
  364.           <filename>.EXP      File containing explanations for questions. 
  365.                          This may include explanations of "correct" ans-
  366.                          wers, or definition of "most right" responses to
  367.                          opinion polls.  Optional file.  [Created by sysop
  368.                          following guidelines below, or may be created
  369.                          automatically by QESSUMRY]
  370.  
  371.  
  372.           <filename>.MSG      File containing individual personal messages
  373.                          to users regarding their score on a questionnaire
  374.                          utilizing "correct" answers.  This file may be
  375.                          merged into an RBBS message file using a utility
  376.                          such as Darwin Collins SMLMESS.  <filename>.URS
  377.                          must be present for this file to be created. 
  378.                          [Created by QESSUMRY]
  379.  
  380.  
  381.           <filename>.SUM      File created from the Summarize (Q)uestions &
  382.                          Answers option of QESSUMRY.  Contains the text of
  383.                          questions from the <filename>.DEF file and the
  384.                          answer summary for each question.  Can also con-
  385.                          tain a "correct" answer indicator and explanation
  386.                          for each question.  [Created by QESSUMRY]
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.           QESSUMRY 6.1                  - 5 -             February 22, 1991
  404.           Documentation
  405.           
  406.           
  407.           
  408.  
  409.           <filename>.TXT      File containing a summary of each question,
  410.                          the number of responses to each option, and the
  411.                          percentage of respondents choosing each option. 
  412.                          [Created by QESSUMRY]
  413.  
  414.  
  415.           <filename>.URS      File containing each respondent user's name,
  416.                          percentage of correct answers, a listing of ques-
  417.                          tions to which the respondent gave incorrect an-
  418.                          swers, a detail of the number and percentage of
  419.                          responders who selected the "correct" answer to
  420.                          each question, and identifies the top scoring user
  421.                          or users.  <filename>.ANS must be present and
  422.                          properly created for this file to be created. 
  423.                          [Created by QESSUMRY]
  424.  
  425.  
  426.           QESSUMRY.PRM        The Message Security parameter file for the
  427.                          (R)esponse Messages to Users option.  This is a
  428.                          single line ASCII file containing a number repre-
  429.                          senting the default security level for messages to
  430.                          users.  The entry is a single number without
  431.                          quotes or other markings.  If this file is not
  432.                          present on the default drive\subdirectory, QES-
  433.                          SUMRY 6.1 will assign a message security level of
  434.                          5 to the messages.
  435.  
  436.  
  437.  
  438.  
  439.                                 DEFINING THE QUESTIONS
  440.  
  441.                The RBBS-PC questionnaire is developed according to the
  442.           directions in the RBBS-PC documentation.  Each questionnaire is
  443.           named with a filename of up to eight characters with a mandatory
  444.           extension of .DEF.  Questionnaires which will be summarized with
  445.           QESSUMRY 6.1 must follow these guidelines:
  446.  
  447.                     1.  The data file where the questionnaire responses are
  448.                     recorded MUST have an extension of .DAT.  The Questions
  449.                     & Answers and User Response Statistics options of
  450.                     QESSUMRY 6.1 require that both the .DAT and .DEF files
  451.                     have the same file name.  If used, the answer file must
  452.                     also have the same filename.
  453.  
  454.                          Therefore, the data file for TRIVIA.DEF (the ques-
  455.                          tionnaire) would have a data file named TRIVIA.DAT
  456.                          and an optional answer file named TRIVIA.ANS.
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.           QESSUMRY 6.1                  - 6 -             February 22, 1991
  470.           Documentation
  471.           
  472.           
  473.           
  474.  
  475.                     2.  Multiple choice and yes/no questions MUST be desig-
  476.                     nated by the label "QUESTION", followed by a one or two
  477.                     digit question number.  It is preferable, but not
  478.                     necessary, that single-digit question numbers by pre-
  479.                     ceded by a zero.  According to the questionnaire devel-
  480.                     opment criteria for RBBS-PC, labels are indicated by a
  481.                     colon (:).
  482.  
  483.                          Therefore, multiple choice question number 2 would
  484.                          be labeled :QUESTION2  or  :QUESTION02
  485.  
  486.                          To avoid conflicts, questions requiring general
  487.                          text input or those included for general "house-
  488.                          keeping" should have a label other than "QUES-
  489.                          TIONxx".  See Examples.
  490.  
  491.                     3.  QESSUMRY 6.1 will summarize up to 25 multiple-
  492.                     choice or yes/no questions per questionnaire, each with
  493.                     up to 8 choices.  Multiple choice responses must be in
  494.                     the range A-H.  QESSUMRY 6.1 is not case-sensitive to
  495.                     responses, so both upper and lower case responses are
  496.                     acceptable.  Yes/no questions must have the "yes"
  497.                     response listed first.  (Responses must be Y/N - True/-
  498.                     False or T/F responses are not supported by QESSUMRY.)
  499.  
  500.                     4.  For all functions of QESSUMRY 6.1 to work properly,
  501.                     the response line (the one preceded with a "?") should
  502.                     be separate from the question itself.  Although this is
  503.                     not mandatory, if you design questions using the single
  504.                     question/response line, the (Q)uestion & Answer Summary
  505.                     option will not pick up the question.  
  506.  
  507.                               ?Do you own an IBM PC  (Y/N)
  508.  
  509.                          would be better written as:
  510.  
  511.                               *Do you own an IBM PC
  512.                               ?Enter Y or N
  513.  
  514.  
  515.                          Response lines should have the valid responses
  516.                     listed.  The last character should be either the high-
  517.                     est response letter or, in the case of yes/no questions
  518.                     the close-parenthesis is acceptable.
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.           QESSUMRY 6.1                  - 7 -             February 22, 1991
  536.           Documentation
  537.           
  538.           
  539.           
  540.  
  541.                          A proper response line for a 5 answer multiple
  542.                          choice would be:
  543.  
  544.                               ?Enter A, B, C, D or E
  545.  
  546.                          Proper response lines for a yes/no question would
  547.                          be:
  548.  
  549.                               ?Enter Y or N
  550.                                    or
  551.                               ?Enter (Y/N)
  552.  
  553.                See Appendix A for a sample <filename>.DEF file.
  554.  
  555.  
  556.  
  557.  
  558.                                  RUNNING THE PROGRAM
  559.  
  560.                QESSUMRY 6.1 is a stand-alone executable program.  It must
  561.           exist on the same drive/subdirectory as the questionnaire data
  562.           file.  If you wish to use the Questions & Answers option, the
  563.           <filename>.DEF file for the questionnaire must also exist on the
  564.           same drive/subdirectory.  Additionally, <filename> in <file-
  565.           name>.DAT and <filename>.DEF files must be identical. 
  566.  
  567.  
  568.  
  569.           Open Files:
  570.  
  571.                QESSUMRY 6.1 may have as many as seven (7) files open at any
  572.           given time.
  573.  
  574.  
  575.  
  576.           Variation 1:
  577.  
  578.                To start the program, type QESSUMRY at the DOS prompt. 
  579.           QESSUMRY 6.1 will display its intro logo and ask for the name of
  580.           the questionnaire data file.  You may enter either the filename
  581.           alone, or with the extension of .DAT.  If the filename is entered
  582.           without an extension, QESSUMRY 6.1 will append .DAT to the
  583.           filename.
  584.  
  585.                If you are creating more than one output, QESSUMRY 6.1 will
  586.           display the questionnaire in use, after the first pass.  To
  587.           continue to use the same questionnaire for additional outputs,
  588.           just press {ENTER}.  To change questionnaires, enter the new
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.           QESSUMRY 6.1                  - 8 -             February 22, 1991
  602.           Documentation
  603.           
  604.           
  605.           
  606.  
  607.           questionnaire data file name.  To exit QESSUMRY 6.1, enter "X" as
  608.           the data file name and press {ENTER}.
  609.  
  610.                You will then be asked whether you want the output routed to
  611.           a Database file, Text file, Printer or whether you want to
  612.           Summarize the Questionnaire, print User Response Statistics, or
  613.           create individual Response Messages to Users.  The default is to
  614.           print to a text file.  See OUTPUT OPTIONS. 
  615.  
  616.  
  617.  
  618.           Variation 2:
  619.  
  620.                QESSUMRY 6.1 may also be started by placing the output
  621.           selection and/or filename on the command line.  The order of file
  622.           name and output selection is not important; either can be first. 
  623.           Data entered on the command line is not case sensitive.  Two
  624.           criteria are important however:
  625.  
  626.                1.   The output selection is one letter preceded by either
  627.                     "-" or "/".  Thus, valid output selections are: -A, -D,
  628.                     -P, -Q, -R, -U (/A, /D, /P, /Q, /R, /U).  (X is also a
  629.                     valid output selection, but since it terminates the
  630.                     program, it probably would not be used on the command
  631.                     line.)
  632.  
  633.                2.   The data file name must NOT have an extension.  QES-
  634.                     SUMRY 6.1 will automatically append .DAT to the file-
  635.                     name entered on the command line.
  636.  
  637.           Example:  C:> QESSUMRY -D 300BAUD   will output the tally of
  638.                     responses to 300BAUD.DAT to a delimited data file
  639.                     called 300BAUD.DTA.
  640.  
  641.                     C:> QESSUMRY /p upload   will output the tally of
  642.                     responses to
  643.                     UPLOAD.DAT to the printer.
  644.  
  645.                     C:> QESSUMRY upload -P  will also output the tally of
  646.                     responses to UPLOAD.DAT to the printer.  (Command line
  647.                     parameters of filename and output specification may be
  648.                     in either order)
  649.  
  650.                NOTE: If either parameter is omitted from the command line,
  651.           QESSUMRY 6.1 will prompt for the missing information.  It is not
  652.           necessary to put either parameter on the command line - QESSUMRY
  653.           6.1 will prompt for both.
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.           QESSUMRY 6.1                  - 9 -             February 22, 1991
  668.           Documentation
  669.           
  670.           
  671.           
  672.  
  673.  
  674.           Errors During Execution:
  675.  
  676.                Significant errors encountered in the execution of QESSUMRY
  677.           6.1 are written to a file called QESSUMRY.ERR on the default
  678.           drive/subdirectory.  This file contain the date and time the
  679.           error was encountered as well as a brief explanation of the
  680.           error.
  681.  
  682.                QESSUMRY is designed to summarize single-character answers
  683.           to either Yes/No or multiple choice questions.  If QESSUMRY
  684.           encounters an answer longer than a single character, it will
  685.           display an error message and write the error to a file called
  686.           <filename>.ERR.  The form of the error message is:
  687.  
  688.  
  689.           Possible Error in <filename>.DAT data on 00-00-19xx @ 00:00:00    
  690.                for answer to QUESTION # :   DD at Line Number ## 
  691.  
  692.           where:
  693.                <filename>.DAT      is the questionnaire data file
  694.                00-00-19xx          is the date the error was encountered
  695.                00:00:00            is the time the error was encountered
  696.                QUESTION #          is the question number with an erroneous
  697.                                    answer
  698.                DD                  is the actual answer string encountered
  699.                                    in the data file
  700.                Line Number ##      is the physical line number of the data
  701.                                    file where the error was encountered. 
  702.                                    This is useful for editing the data file
  703.                                    using EDLIN or other text editor.
  704.  
  705.  
  706.  
  707.  
  708.                                     OUTPUT OPTIONS
  709.  
  710.                                      [A]SCII File
  711.  
  712.                The default output option is to a text file with the name
  713.           <filename>.TXT.  This will create an ASCII text file on the
  714.           default drive/subdirectory containing the number of responses and
  715.           a percentage breakdown of each response.  (In previous versions,
  716.           this option was labeled "Text [F]ile", and the output was to a
  717.           file with the extension ".FIL".  This has been changed to provide
  718.           more uniformity with other available questionnaire programs.)
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.           QESSUMRY 6.1                  - 10 -            February 22, 1991
  734.           Documentation
  735.           
  736.           
  737.           
  738.  
  739.                                 (D)elimited Data File
  740.  
  741.                If you select this option, QESSUMRY 6.1 will direct its
  742.           output to a file called <filename>.DTA.  There will be one text
  743.           line for each question in the questionnaire.  The file format is:
  744.  
  745.                     1) The word "QUESTION" followed by the question number 
  746.                     2) the total number of responses to that question 
  747.                     3-10) the number of responses to each choice A-H.  If
  748.                     the question is a yes/no, "Y" responses will be in
  749.                     field 3 and "N" responses in field 4.  Fields are
  750.                     delimited by commas.  
  751.  
  752.                NOTE:  This output is NOT of itself in any particular
  753.           database format.  It is merely in the delimited format which can
  754.           be imported by various database programs.
  755.  
  756.  
  757.  
  758.                                       (P)rinter
  759.  
  760.                If you select Printer, QESSUMRY 6.1 will direct its output
  761.           to your default printer.  This output will be in the same form as
  762.           the text file output, but will be formatted to break properly on
  763.           11 inch paper.
  764.  
  765.  
  766.  
  767.                                 (Q)uestions & Answers
  768.  
  769.                If you select Questions & Answers, QESSUMRY 6.1 will tally
  770.           the responses, as it does with the other options, and output the
  771.           results to a text file named <filename>.SUM.  In its basic output
  772.           form, QESSUMRY 6.1 will print each question (those defined by the
  773.           :QUESTION label), followed by a summary of the responses for that
  774.           question.  You will have the options of supplying "correct"
  775.           answers for the questions and/or to provide explanations for the
  776.           questions and answers.
  777.  
  778.  
  779.  
  780.           Supplying "Correct" Answers
  781.  
  782.                QESSUMRY 6.1 will check for the existence of a file called
  783.           <filename>.ANS.  This is the answer file for those questionnaires
  784.           where there is a "correct" answer for each question.  If this
  785.           file is located on the default drive/sub-directory, QESSUMRY 6.1
  786.           will insert the correct answers into the output file.
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.           QESSUMRY 6.1                  - 11 -            February 22, 1991
  800.           Documentation
  801.           
  802.           
  803.           
  804.  
  805.                The answer file may have correct answers on one line,
  806.           delimited by commas, or may have each answer on a separate line. 
  807.           NOTE:  It is your responsibility to ensure that there are the
  808.           proper number of answers for the number of questions in the
  809.           questionnaire.  QESSUMRY 6.1 will terminate abnormally if there
  810.           are too few answers in the <filename>.ANS file for the number of
  811.           questions.  Valid entries for the <filename>.ANS file are Y, N,
  812.           or A-H.  Entries are not case-sensitive.  If you use the automat-
  813.           ic .ANS file creation option, explained in the next paragraph,
  814.           the proper file format will be created.
  815.  
  816.                If no <filename>.ANS file exists, you will be asked if you
  817.           wish to provide "correct" answers to the questions.  If the
  818.           questionnaire is of the general survey type where there is no
  819.           "right" answer to the question, press "N".  If you do wish to
  820.           provide "correct" answers, such as to a knowledge questionnaire,
  821.           press "Y".  You will then be asked if you wish to have answers
  822.           written to an .ANS file.  If you respond "Y", QESSUMRY 6.1 will
  823.           create an .ANS file for the questionnaire from the answers you
  824.           input on the screen.  QESSUMRY 6.1 will then display each ques-
  825.           tion in the questionnaire and prompt you for the correct answer. 
  826.           In this form, only a one character response is accepted, but the
  827.           responses are not case-sensitive.  
  828.  
  829.                See appendix B for a sample answer file.
  830.  
  831.  
  832.  
  833.           Supplying an Explanation to Questions
  834.  
  835.                QESSUMRY 6.1 will check for the existence of an explanation
  836.           file - <filename>.EXP.  If <filename>.EXP does not exist, you
  837.           will be asked if you wish to supply an explanation for the
  838.           questions.
  839.  
  840.                If <filename>.EXP does not exist, you will be presented with
  841.           a format for entering the explanations after the display of each
  842.           question.  Explanations must not be longer than 10 lines of 72
  843.           characters each.  NOTE:  Lines longer than 72 characters will be
  844.           truncated to 72 characters in length.  The format indicates the
  845.           proper length.  To end the explanation entry, press {ENTER} on a
  846.           blank line.
  847.  
  848.                To skip an explanation for any individual question, press
  849.           {ENTER} on the first line of the explanation entry format.
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.           QESSUMRY 6.1                  - 12 -            February 22, 1991
  866.           Documentation
  867.           
  868.           
  869.           
  870.  
  871.           Format of <filename>.EXP
  872.  
  873.                Explanations may be provided through the use of an explana-
  874.           tion file, named <filename>.EXP.  It is critical that the <file-
  875.           name>.EXP file follow the proper format.  The first explanation
  876.           must start of the first line of the file, and explanations may be
  877.           no longer than 10 lines.  (Line length may be up to 79 charac-
  878.           ters, unlike the on-line entry which are limited to 72 charac-
  879.           ters.)
  880.  
  881.                Explanations are delimited by a percent character (%) in the
  882.           first position of a line.  The remainder of a limit line may be
  883.           used for comments.
  884.  
  885.                Questions for which no explanation is desired must still be
  886.           accounted for in the file, and the file must end with a percent
  887.           character (%).  NOTE:  There will be the same number of percent
  888.           characters in the first column as there are questions.  See
  889.           appendix C for a sample explanation file.
  890.  
  891.                If no <filename>.EXP file exists on the default drive\sub-
  892.           directory and you have indicated that you wish to provide expla-
  893.           nations, QESSUMRY 6.1 will ask if you wish to create <file-
  894.           name>.EXP.  If you do, QESSUMRY 6.1 will write the explanation
  895.           entered on the screen to <filename>.EXP for future use.
  896.  
  897.                See Appendix F for a sample question & answer summary file.
  898.  
  899.  
  900.  
  901.                               (U)ser Response Statistics
  902.  
  903.                When a questionnaire has "correct" answers, the sysop or
  904.           users may want to know how many questions each user answered
  905.           correctly, which questions the user missed, and what the success
  906.           rate for each question was.  This option creates such a summary,
  907.           output to a file called <filename>.URS.  The summary will also
  908.           identify the top scoring user or users.  For this option to
  909.           function properly, <filename>.ANS must be present on the default
  910.           drive\subdirectory.
  911.  
  912.                See Appendix G for a sample user response file.
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.           QESSUMRY 6.1                  - 13 -            February 22, 1991
  932.           Documentation
  933.           
  934.           
  935.           
  936.  
  937.                              (R)esponse Messages to Users
  938.  
  939.                Using the <filename>.URS file created by QESSUMRY 6.1, the
  940.           program can create a merge file with individual personalized
  941.           messages to users.  These messages include the same statistics
  942.           that are present in <filename>.URS, but each message includes the
  943.           statistics on an individual user.  Each message, when imported to
  944.           an RBBS message file, will be private to the user regarding his
  945.           or her individual score on the questionnaire.
  946.  
  947.                When the (R) option is selected from the menu, QESSUMRY 6.1
  948.           will first automatically execute the (U) option, ensuring that a
  949.           current <filename>.URS file is present.  QESSUMRY 6.1 will then
  950.           ask for a Leader Line to be placed in each individual message. 
  951.           This Leader Line is used to indicate which questionnaire the
  952.           response statistics are for.  If {Enter} is pressed at the
  953.           beginning of this prompt, QESSUMRY 6.1 will place the following
  954.           message into each individual response file:
  955.  
  956.                          On the <filename> Questionnaire:
  957.  
  958.  
  959.  
  960.           Kill Message
  961.  
  962.                QESSUMRY 6.1 will ask if you would like to add a Kill
  963.           Message to the output messages.  The default response in "yes". 
  964.           If the Kill Message is selected, QESSUMRY 6.1 will add the
  965.           message
  966.  
  967.           Please delete (kill) this message after you have reviewed it.
  968.  
  969.           to the end of each user message.
  970.  
  971.  
  972.  
  973.           Security Level of Messages
  974.  
  975.                When QESSUMRY 6.1 is started, it will look for a file called
  976.           QESSUMRY.PRM on the default drive\subdirectory.  This file
  977.           contains the message security level to apply to messages created
  978.           by the (R) option.  If this file is not located, QESSUMRY 6.1
  979.           will assign a security level of 5 to each message.
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.           QESSUMRY 6.1                  - 14 -            February 22, 1991
  998.           Documentation
  999.           
  1000.           
  1001.           
  1002.  
  1003.           Merging the Messages into RBBS-PC
  1004.  
  1005.                To create individual RBBS messages from the <filename>.MSG
  1006.           file, a merge utility such as Darwin Collins' SMLMESS program is
  1007.           required.  It is the Sysop's responsibility to determine that
  1008.           sufficient space exists in the message file to accomodate the
  1009.           imported messages.
  1010.  
  1011.  
  1012.  
  1013.                                OVERWRITING OUTPUT FILES
  1014.  
  1015.                <filename>.TXT, <filename>.DTA, <filename>.MSG, <file-
  1016.           name>.SUM, and <filename>.URS files will be over-written each
  1017.           time their option is selected.
  1018.  
  1019.  
  1020.  
  1021.                               EXPLANATION OF APPENDICES
  1022.  
  1023.                The following appendices present examples of the files
  1024.           discussed in this documentation.  For clarity, the actual file is
  1025.           separated from any discussion by 10 dots, centered on the page.
  1026.  
  1027.                                         . . . . . . . . . .
  1028.  
  1029.                These are NOT part of the file, just a way to show the
  1030.           limits of the file presented.
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.           QESSUMRY 6.1                  - 15 -            February 22, 1991
  1064.           Documentation
  1065.           
  1066.           
  1067.           
  1068.  
  1069.                                         Appendix A - Sample Definition File
  1070.                                                                  TRIVIA.DEF
  1071.  
  1072.  
  1073.                Following is a sample questionnaire definition file.  The
  1074.           outputs listed in Appendices D, E, and F are derived from this
  1075.           file, and it's accompanying data (.DAT) file and optional answer
  1076.           (.ANS) and explanation (.EXP) files.
  1077.  
  1078.                                         . . . . . . . . . .
  1079.           "TRIVIA.DAT",10
  1080.           *                           TRIVIA TEST #1
  1081.           *
  1082.           *
  1083.           :QUESTION1
  1084.           *
  1085.           *
  1086.           *
  1087.           *
  1088.           *The most famous stage play of 1865 was
  1089.           *( A ) - "Johnny Comes Marching Home", starring Edwin Booth
  1090.           *( B ) - "Our American Cousin", starring Laura Keene
  1091.           *( C ) - "The Great Train Robbery"
  1092.           *( D ) - "Freedom, Freedom", starring Frederick Douglass
  1093.           ?Choose A, B, C or D
  1094.           =AQUESTION2=BQUESTION2=CQUESTION2=DQUESTION2= QUES1E
  1095.           :QUES1E
  1096.           *Please respond A, B, C or D
  1097.           >QUESTION1
  1098.           :QUESTION2
  1099.           *
  1100.           *
  1101.           *
  1102.           *
  1103.           *Disneyland opened to the public in
  1104.           *( A ) - 1974
  1105.           *( B ) - 1950
  1106.           *( C ) - 1955
  1107.           *( D ) - 1962
  1108.           ?Choose A, B, C or D
  1109.           =AQUESTION3=BQUESTION3=CQUESTION3=DQUESTION3= QUES2E
  1110.           :QUES2E
  1111.           *Please respond A, B, C or D
  1112.           >QUESTION2
  1113.           :QUESTION3
  1114.           *
  1115.           *
  1116.           *
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.           QESSUMRY 6.1                  - 16 -            February 22, 1991
  1130.           Documentation
  1131.           
  1132.           
  1133.           
  1134.  
  1135.           *
  1136.           *In World War I, Japan was
  1137.           *( A ) - Allied with Germany and Prussia
  1138.           *( B ) - Neutral
  1139.           *( C ) - Fighting a separate war against Russia
  1140.           *( D ) - Allied with the United States and England
  1141.           ?Choose A, B, C or D
  1142.           =AQUESTION4=BQUESTION4=CQUESTION4=DQUESTION4= QUES3E
  1143.           :QUES3E
  1144.           *Please respond A, B, C or D
  1145.           >QUESTION3
  1146.           :QUESTION4
  1147.           *
  1148.           *
  1149.           *
  1150.           *
  1151.           *The only man to serve two non-consecutive terms as President was
  1152.           *( A ) - James Monroe
  1153.           *( B ) - Grover Cleveland
  1154.           *( C ) - Franklin D. Roosevelt
  1155.           *( D ) - William Jennings Bryan
  1156.           *( E ) - Thomas Jefferson
  1157.           ?Choose A, B, C, D or E
  1158.           =ACHECK=BCHECK=CCHECK=DCHECK=ECHECK= QUES4E
  1159.           :QUES4E
  1160.           *Please respond A, B, C, D or E
  1161.           >QUESTION4
  1162.           :CHECK
  1163.           *
  1164.           *
  1165.           *
  1166.           *
  1167.           ?Have you answered the Questionnaire before ? (Y/N)
  1168.           =YABORT=NEXIT= CHECKE
  1169.           :CHECKE
  1170.           *Please respond Y or N
  1171.           >CHECK
  1172.           :ABORT
  1173.           @
  1174.           :EXIT
  1175.                                         . . . . . . . . . .
  1176.  
  1177.                NOTE:  The question labeled CHECK is a 'housekeeping'
  1178.           question, and will not be included in the summaries, since the
  1179.           label does not begin with :QUESTION 
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.           QESSUMRY 6.1                  - 17 -            February 22, 1991
  1196.           Documentation
  1197.           
  1198.           
  1199.           
  1200.  
  1201.                                            Appendix B - Sample Answer Files
  1202.                                                                  TRIVIA.ANS
  1203.  
  1204.  
  1205.                This appendix lists the two variations of an answer file. 
  1206.           In the first, answers are entered on separate lines.  In the
  1207.           second, all answers are entered on one line, delimited by commas. 
  1208.           The file name for both files would be <filename>.ANS, or in this
  1209.           specific example, TRIVIA.ANS.
  1210.  
  1211.                                         . . . . . . . . . .
  1212.           b
  1213.           c
  1214.           d
  1215.           b
  1216.           b
  1217.                                         . . . . . . . . . . 
  1218.           B,C,D,B,B
  1219.                                         . . . . . . . . . .
  1220.  
  1221.                NOTE:  Answers may be either upper or lower case.
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.           QESSUMRY 6.1                  - 18 -            February 22, 1991
  1262.           Documentation
  1263.           
  1264.           
  1265.           
  1266.  
  1267.                                        Appendix C - Sample Explanation File
  1268.                                                                  TRIVIA.EXP
  1269.  
  1270.                This is an example of an explanation file, used when there
  1271.           are "correct" answers for questions, and you wish to explain why
  1272.           an answer is correct.
  1273.  
  1274.                NOTE that there is no percent mark starting the file, but
  1275.           that each explanation is separated by a percent mark.  The name
  1276.           and number of the
  1277.           question follow questions 2 & 3, showing that the limit line may
  1278.           be used as a reference line for comments.  This is eliminated in
  1279.           question 4 to show that comments are not required, although the
  1280.           limit character (%) is.  Explanations are no longer than 10 lines
  1281.           each, and do not contain blank lines.
  1282.  
  1283.                NOTE also that, although no explanation is provided for
  1284.           question 5, its position is still maintained by a limit mark, and
  1285.           that the file ends with a limit mark.  See Appendix F for the
  1286.           sample summary output file to see what this produces.
  1287.  
  1288.                                         . . . . . . . . . .
  1289.               "Our American Cousin" was an immensely popular play starring
  1290.           the English actress Laura Keene.  It gained even greater notori-
  1291.           ety because it was playing at Ford's Theatre in Washington, D.C.
  1292.           on April 14, 1865.  On that night, one of the audience, President
  1293.           Abraham Lincoln, was assassinated during the play. %Question 2
  1294.               Disneyland opened to the public on July 17, 1955, exactly one
  1295.           year after construction began.
  1296.           %QUESTION 3
  1297.               In World War I, Japan sided with the Allies against Germany. 
  1298.           (The Russo-Japanese occurred about ten years earlier, in 1904--
  1299.           1905)
  1300.           %
  1301.               Grover Cleveland served as the 22nd and 24th Presidents of
  1302.           the United States.
  1303.           %QUESTION 5
  1304.           %This is the end of file limit mark
  1305.  
  1306.                                         . . . . . . . . . .
  1307.  
  1308.                NOTE that the file ends with a limit mark (%).  This is
  1309.           necessary for proper operation of the program.
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.           QESSUMRY 6.1                  - 19 -            February 22, 1991
  1328.           Documentation
  1329.           
  1330.           
  1331.           
  1332.  
  1333.                                       Appendix D - Sample ASCII Output File
  1334.                                                                  TRIVIA.TXT
  1335.  
  1336.                This is a sample of the file produced when the [A]SCII File
  1337.           option is taken.  This same format is routed to the printer when
  1338.           that option is taken.
  1339.  
  1340.  
  1341.                                         . . . . . . . . . .
  1342.           QESSUMRY (c)               TRIVIA.DAT                 06-22-1990
  1343.           ::::::::::::::::::::::::::::::::::::::::::::::::::::::     19:57 
  1344.  
  1345.           Question 1                                   Total Answers:   13
  1346.  
  1347.                    Choice         # Responding                 Percentage
  1348.            
  1349.                    A:                    4                       30.77 %
  1350.                    B:                    3                       23.08 %
  1351.                    C:                    4                       30.77 %
  1352.                    D:                    2                       15.38 %
  1353.           ..............................................................  
  1354.           Question 2                                   Total Answers:   13
  1355.  
  1356.                    Choice         # Responding                 Percentage
  1357.            
  1358.                    A:                    0                        0.00 %
  1359.                    B:                    2                       15.38 %
  1360.                    C:                    5                       38.46 %
  1361.                    D:                    5                       38.46 %
  1362.           ..............................................................  
  1363.           Question 3                                   Total Answers:   13
  1364.  
  1365.                    Choice         # Responding                 Percentage
  1366.            
  1367.                    A:                    3                       23.08 %
  1368.                    B:                    4                       30.77 %
  1369.                    C:                    5                       38.46 %
  1370.                    D:                    1                        7.69 %
  1371.           ...............................................................  
  1372.           Question 4                                   Total Answers:   13
  1373.  
  1374.                    Choice         # Responding                 Percentage
  1375.            
  1376.                    A:                    4                       30.77 %
  1377.                    B:                    3                       23.08 %
  1378.                    C:                    3                       23.08 %
  1379.                    D:                    0                        0.00 %
  1380.                    E:                    3                       23.08 %
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.           QESSUMRY 6.1                  - 20 -            February 22, 1991
  1394.           Documentation
  1395.           
  1396.           
  1397.           
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.           QESSUMRY 6.1                  - 21 -            February 22, 1991
  1460.           Documentation
  1461.           
  1462.           
  1463.           
  1464.  
  1465.                          Appendix E - Sample Delimited Database Output File
  1466.                                                                  TRIVIA.DTA
  1467.  
  1468.                                                  
  1469.           Question 1 , 13 , 4 , 3 , 4 , 2 , 0 , 0 , 0 , 0  
  1470.           Question 2 , 13 , 0 , 2 , 5 , 5 , 0 , 0 , 0 , 0  
  1471.           Question 3 , 13 , 3 , 4 , 5 , 1 , 0 , 0 , 0 , 0  
  1472.           Question 4 , 13 , 4 , 3 , 3 , 0 , 3 , 0 , 0 , 0  
  1473.           Question 5 , 13 , 4 , 3 , 3 , 1 , 2 , 0 , 0 , 0  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.           QESSUMRY 6.1                  - 22 -            February 22, 1991
  1526.           Documentation
  1527.           
  1528.           
  1529.           
  1530.  
  1531.                               Appendix F - Sample Question & Answer Summary
  1532.                                                                  TRIVIA.SUM
  1533.  
  1534.                The ultimate output from the QESSUMRY program, this file
  1535.           integrates the questions, correct answers, explanation, and
  1536.           answer summary in one file output. 
  1537.  
  1538.                NOTE that no explanation is provided for Question 5 in this
  1539.           example:  See appendix C, above.
  1540.  
  1541.  
  1542.                                         . . . . . . . . . .
  1543.           Question 1 : 
  1544.             
  1545.           The most famous stage play of 1865 was 
  1546.           ( A ) - "Johnny Comes Marching Home", starring Edwin Booth 
  1547.           ( B ) - "Our American Cousin", starring Laura Keene 
  1548.           ( C ) - "The Great Train Robbery" 
  1549.           ( D ) - "Freedom, Freedom", starring Frederick Douglass 
  1550.             
  1551.                The CORRECT answer is [B] 
  1552.             
  1553.                              ======================================== 
  1554.             
  1555.                                    EXPLANATION for Question  1 
  1556.             
  1557.               "Our American Cousin" was an immensely popular play starring
  1558.           the English  actress Laura Keene.  It gained even greater notori-
  1559.           ety because it was 
  1560.           playing at Ford's Theatre in Washington, D.C. on April 14, 1865. 
  1561.           On that  night, one of the audience, President Abraham Lincoln,
  1562.           was assassinated  during the play. 
  1563.             
  1564.                              ++++++++++++++++++++++++++++++++++++++++ 
  1565.             
  1566.           Question 1                                   Total Answers:   13
  1567.  
  1568.            
  1569.                    Choice         # Responding                 Percentage 
  1570.             
  1571.                    A:                    4                       30.77 % 
  1572.                    B:                    3                       23.08 % 
  1573.                    C:                    4                       30.77 % 
  1574.                    D:                    2                       15.38 % 
  1575.           ................................................................
  1576.  
  1577.             
  1578.           Question 2 : 
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.           QESSUMRY 6.1                  - 23 -            February 22, 1991
  1592.           Documentation
  1593.           
  1594.           
  1595.           
  1596.  
  1597.             
  1598.           Disneyland opened to the public in 
  1599.           ( A ) - 1974 
  1600.           ( B ) - 1950 
  1601.           ( C ) - 1955 
  1602.           ( D ) - 1962 
  1603.             
  1604.                The CORRECT answer is [C] 
  1605.             
  1606.                              ======================================== 
  1607.             
  1608.                                    EXPLANATION for Question  2 
  1609.             
  1610.               Disneyland opened to the public on July 17, 1955, exactly one
  1611.           year after  construction began. 
  1612.             
  1613.                              ++++++++++++++++++++++++++++++++++++++++ 
  1614.             
  1615.           Question 2                                   Total Answers:   13
  1616.  
  1617.            
  1618.                    Choice         # Responding                 Percentage 
  1619.             
  1620.                    A:                    0                        0.00 % 
  1621.                    B:                    2                       15.38 % 
  1622.                    C:                    5                       38.46 % 
  1623.                    D:                    5                       38.46 % 
  1624.           ................................................................
  1625.  
  1626.             
  1627.           Question 3 : 
  1628.             
  1629.           In World War I, Japan was 
  1630.           ( A ) - Allied with Germany and Prussia 
  1631.           ( B ) - Neutral 
  1632.           ( C ) - Fighting a separate war against Russia 
  1633.           ( D ) - Allied with the United States and England 
  1634.             
  1635.                The CORRECT answer is [D] 
  1636.             
  1637.                              ======================================== 
  1638.             
  1639.                                    EXPLANATION for Question  3 
  1640.             
  1641.               In World War I, Japan sided with the Allies against Germany. 
  1642.           (The 
  1643.           Russo-Japanese occurred about ten years earlier, in 1904-1905) 
  1644.             
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.           QESSUMRY 6.1                  - 24 -            February 22, 1991
  1658.           Documentation
  1659.           
  1660.           
  1661.           
  1662.  
  1663.                              ++++++++++++++++++++++++++++++++++++++++ 
  1664.             
  1665.           Question 3                                   Total Answers:   13
  1666.  
  1667.            
  1668.                    Choice         # Responding                 Percentage 
  1669.             
  1670.                    A:                    3                       23.08 % 
  1671.                    B:                    4                       30.77 % 
  1672.                    C:                    5                       38.46 % 
  1673.                    D:                    1                        7.69 % 
  1674.           ................................................................
  1675.  
  1676.             
  1677.           Question 4 : 
  1678.             
  1679.           The only man to serve two non-consecutive terms as U.S. President
  1680.           was 
  1681.           ( A ) - James Monroe 
  1682.           ( B ) - Grover Cleveland 
  1683.           ( C ) - Franklin D. Roosevelt 
  1684.           ( D ) - William Jennings Bryan 
  1685.           ( E ) - Thomas Jefferson 
  1686.             
  1687.                The CORRECT answer is [B] 
  1688.             
  1689.                              ======================================== 
  1690.             
  1691.                                    EXPLANATION for Question  4 
  1692.             
  1693.               Grover Cleveland served as the 22nd and 24th Presidents of
  1694.           the United  States. 
  1695.             
  1696.                              ++++++++++++++++++++++++++++++++++++++++ 
  1697.             
  1698.           Question 4                                   Total Answers:   13
  1699.  
  1700.            
  1701.                    Choice         # Responding                 Percentage 
  1702.             
  1703.                    A:                    4                       30.77 % 
  1704.                    B:                    3                       23.08 % 
  1705.                    C:                    3                       23.08 % 
  1706.                    D:                    0                        0.00 % 
  1707.                    E:                    3                       23.08 % 
  1708.           ................................................................
  1709.  
  1710.             
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.           QESSUMRY 6.1                  - 25 -            February 22, 1991
  1724.           Documentation
  1725.           
  1726.           
  1727.           
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.           QESSUMRY 6.1                  - 26 -            February 22, 1991
  1790.           Documentation
  1791.           
  1792.           
  1793.           
  1794.  
  1795.                                Appendix G - Sample User Response Statistics
  1796.                                                                  TRIVIA.URS
  1797.  
  1798.                The following User Response Statistics file was taken from
  1799.           another trivia questionnaire, to which there were ten questions. 
  1800.           The respondent's name has been replaced with RESPONDENT'S NAME #x
  1801.           for this documentation to protect the actual users.  For space
  1802.           conservation, only five of the responses are listed here, al-
  1803.           though the summary of responses is shown.
  1804.  
  1805.  
  1806.  
  1807.           QESSUMRY (c)               TRIVIA.DAT                 06-16-1990
  1808.           ::::::::::::::::::::::::::::::::::::::::::::::::::::::     09:23  
  1809.                               User Response Statistics
  1810.            
  1811.            
  1812.           RESPONDENT'S NAME #1
  1813.                got [ 4 ] answers right out of [ 10 ] for a score of 40.0%
  1814.                     Questions missed: 1 2 3 6 8 9 
  1815.            
  1816.            
  1817.           RESPONDENT'S NAME #2 
  1818.                got [ 3 ] answers right out of [ 10 ] for a score of 30.0%
  1819.                     Questions missed: 2 3 4 5 6 8 9 
  1820.            
  1821.            
  1822.           RESPONDENT'S NAME #3 
  1823.                got [ 7 ] answers right out of [ 10 ] for a score of 70.0%
  1824.                     Questions missed: 1 2 10 
  1825.            
  1826.            
  1827.           RESPONDENT'S NAME #4 
  1828.                got [ 6 ] answers right out of [ 10 ] for a score of 60.0%
  1829.                     Questions missed: 3 5 6 8 
  1830.            
  1831.            
  1832.           RESPONDENT'S NAME #5
  1833.                got [ 1 ] answers right out of [ 10 ] for a score of 10.0%
  1834.                     Questions missed: 1 2 4 5 6 7 8 9 10 
  1835.  
  1836.                                  . . . . . . . . . .
  1837.            
  1838.           -----------------------------------------------------------------
  1839.  
  1840.            23 users got a total of 141 answers right for an average score
  1841.           of 40.87%  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.           QESSUMRY 6.1                  - 27 -            February 22, 1991
  1856.           Documentation
  1857.           
  1858.           
  1859.           
  1860.  
  1861.           -----------------------------------------------------------------
  1862.  
  1863.                           Correct Responses for Each Question
  1864.            
  1865.                                  # Correct             Percentage  
  1866.           Question  1:                7                  30.43%             
  1867.           Question  2:               14                  60.87%             
  1868.           Question  3:                3                  13.04%             
  1869.           Question  4:               11                  47.83%             
  1870.           Question  5:                5                  21.74%  
  1871.  
  1872.           Question  6:               12                  52.17%             
  1873.           Question  7:               11                  47.83%             
  1874.           Question  8:               19                  82.61%             
  1875.           Question  9:               10                  43.48%             
  1876.           Question 10:                4                  17.39%  
  1877.  
  1878.           --------------------------------------------------------------- 
  1879.                              Best Score:  7     ( 70.00%)
  1880.  
  1881.                                           by
  1882.  
  1883.                                  RESPONDENT'S NAME #3
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.           QESSUMRY 6.1                  - 28 -            February 22, 1991
  1922.           Documentation
  1923.           
  1924.           
  1925.           
  1926.  
  1927.  
  1928.                                         INDEX
  1929.           <filename>
  1930.                Explanation of Designation . . . . . . . . . . . . . . . . 3
  1931.           Answer file . . . . . . . . . . . . . . . . . . . . . . . . .  10
  1932.           ASCII text file . . . . . . . . . . . . . . . . . . . . . . . . 9
  1933.           Bulletin boards . . . . . . . . . . . . . . . . . . . . . . . . 1
  1934.           Correct answers . . . . . . . . . . . . . . . . . . . . . . .  10
  1935.                Explanation of . . . . . . . . . . . . . . . . . . . . .  11
  1936.           Delimit
  1937.                Character, file  . . . . . . . . . . . . . . . . . . . 4, 10
  1938.                Data File  . . . . . . . . . . . . . . . . . . . . . .  2, 8
  1939.                In <filename>.ANS  . . . . . . . . . . . . . . . . . . .  11
  1940.                In <filename>.EXP  . . . . . . . . . . . . . . . . . . .  12
  1941.           Error Files
  1942.                <filename>.ERR . . . . . . . . . . . . . . . . . . . . . . 9
  1943.                QESSUMRY.ERR . . . . . . . . . . . . . . . . . . . . . . . 9
  1944.           Examples  . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  1945.           Explanation file
  1946.                Format of  . . . . . . . . . . . . . . . . . . . . . . .  12
  1947.           File Extensions
  1948.                .ANS . . . . . . . . . . . . . . . . . . 3, 5, 10-12, 15, 17
  1949.                .DAT . . . . . . . . . . . . . . . . . . . . .  3-5, 7-9, 15
  1950.                .DEF . . . . . . . . . . . . . . . . . . . . . .  2, 4, 5, 7
  1951.                .DTA . . . . . . . . . . . . . . . . . . . . . . . 4, 10, 14
  1952.                .ERR . . . . . . . . . . . . . . . . . . . . . . . . .  4, 9
  1953.                .EXP . . . . . . . . . . . . . . . . . . . . . 4, 11, 12, 15
  1954.                .MSG . . . . . . . . . . . . . . . . . . . . . . . . . 4, 14
  1955.                .SUM . . . . . . . . . . . . . . . . . . . . . . . 4, 10, 14
  1956.                .TXT . . . . . . . . . . . . . . . . . . . . . . .  5, 9, 14
  1957.                .URS . . . . . . . . . . . . . . . . . . . . . .  3-5, 12-14
  1958.           File Extensions, Old
  1959.                .DIR . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  1960.                .FIL . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  1961.           Kill Message  . . . . . . . . . . . . . . . . . . . . . . . .  13
  1962.           Leader Line . . . . . . . . . . . . . . . . . . . . . . . . .  13
  1963.           Length
  1964.                <filename>.EXP file  . . . . . . . . . . . . . . . . . .  12
  1965.                <filename>.EXP lines . . . . . . . . . . . . . . . . . .  11
  1966.                Explanation screen lines . . . . . . . . . . . . . . . .  11
  1967.           Message Merge Utility
  1968.                SMLMESS  . . . . . . . . . . . . . . . . . . . . . . . 4, 14
  1969.           Message Security Level
  1970.                QESSUMRY.PRM . . . . . . . . . . . . . . . . . . . . . 5, 13
  1971.           NOTE  . . . . . . . . . . . . . . . . . .  3, 8, 10-12, 16-18, 22
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.           QESSUMRY 6.1                  - 29 -            February 22, 1991
  1988.           Documentation
  1989.           
  1990.           
  1991.           
  1992.  
  1993.           Options Requirements
  1994.                Answer file  . . . . . . . . . . . . . . . . . . . . . . . 5
  1995.                Questions & Answers  . . . . . . . . . . . . . . . . . . . 5
  1996.                Response line  . . . . . . . . . . . . . . . . . . . . . . 6
  1997.                User Response Statistics . . . . . . . . . . . . . . . . . 5
  1998.           Output  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  1999.                ASCII (Text) File  . . . . . . . . . . . . . . . . . .  2, 9
  2000.                Delimited Data File  . . . . . . . . . . . . . . . . . 2, 10
  2001.                Printer  . . . . . . . . . . . . . . . . . . . . . . . 2, 10
  2002.                Question and Answer Summary  . . . . . . . . . . . . . 2, 10
  2003.                Response Messages to Users . . . . . . . . . . . . . . 2, 13
  2004.                User Response Statistics . . . . . . . . . . . . . . . 2, 12
  2005.           Output selections
  2006.                Valid (for command line) . . . . . . . . . . . . . . . . . 8
  2007.           Parameter File
  2008.                QESSUMRY.PRM . . . . . . . . . . . . . . . . . . . . . 5, 13
  2009.           Printer . . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  2010.           Questionnaire Definition
  2011.                Guidelines . . . . . . . . . . . . . . . . . . . . . . . . 5
  2012.           RBBS-PC . . . . . . . . . . . . . . . . . . . . . . 2, 4-6, 14, 6
  2013.                RBBS . . . . . . . . . . . . . . . . . . . . . . 2-6, 13, 14
  2014.           Running the Program
  2015.                Errors during execution  . . . . . . . . . . . . . . . . . 9
  2016.                Open Files . . . . . . . . . . . . . . . . . . . . . . . . 7
  2017.                Variation 1  . . . . . . . . . . . . . . . . . . . . . . . 7
  2018.                Variation 2  . . . . . . . . . . . . . . . . . . . . . . . 8
  2019.           Sample files
  2020.                Answer . . . . . . . . . . . . . . . . . . . . . . . . .  17
  2021.                ASCII  . . . . . . . . . . . . . . . . . . . . . . . . .  19
  2022.                Definition . . . . . . . . . . . . . . . . . . . . . . .  15
  2023.                Delimited Database . . . . . . . . . . . . . . . . . . .  21
  2024.                Explanation  . . . . . . . . . . . . . . . . . . . . . .  18
  2025.                Question & Answer  . . . . . . . . . . . . . . . . . . .  22
  2026.                User Response Summary  . . . . . . . . . . . . . . . . .  26
  2027.           Shareware . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  2028.           True/False questions  . . . . . . . . . . . . . . . . . . . . . 6
  2029.           Truncation
  2030.                <filename>.EXP lines . . . . . . . . . . . . . . . . . .  11
  2031.           Warranty  . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.                                   REGISTRATION FORM
  2056.                                      QESSUMRY 6.1
  2057.  
  2058.  
  2059.  
  2060.           Name:___________________________________________________________
  2061.  
  2062.           Address:________________________________________________________
  2063.  
  2064.           City:____________________    State:______    Zip Code:__________
  2065.  
  2066.  
  2067.           Are you a SYSOP of an operating BBS?  ( ) Yes        ( ) No
  2068.  
  2069.           If Yes, what is the data phone number for the BBS? ______________
  2070.  
  2071.  
  2072.           Where did you obtain your copy of QESSUMRY? 
  2073.  
  2074.  
  2075.  
  2076.  
  2077.           If from a BBS, what is the name and number of the BBS?
  2078.  
  2079.  
  2080.  
  2081.  
  2082.           Enclose $18.00 Registration fee.
  2083.  
  2084.  
  2085.           Complete and send to:
  2086.  
  2087.                                     R. Mike Worley
  2088.                                   2420 Grandee / 901
  2089.                                 Boise, ID  83704-5936
  2090.  
  2091.  
  2092.           Thank you
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.