home *** CD-ROM | disk | FTP | other *** search
/ Collection of Education / collectionofeducationcarat1997.iso / COMPUSCI / QASA53.ZIP / DEMO2.DEF < prev    next >
Text File  |  1995-10-14  |  20KB  |  684 lines
  1.                           Sample QASA Database
  2.  
  3. This file must be compiled with QASA's database compiler, which will
  4. create the file DEMO2.QA.
  5.  
  6. This sample database contains questions and answers about QASA.
  7.  
  8. A QASA database may contain any of the following options. Any line
  9. not part of one of the following options is considered to be a comment,
  10. which is why this explanatory text may appear here. All of these options
  11. MUST appear alone on a line. The text below is ignored because other text
  12. appears on the line containing each option keyword.
  13.  
  14. Q=    question on following lines, terminated by a blank line or
  15.     another option.
  16. A=    answer on following lines, terminated by a blank line or
  17.     another option.
  18. H=      explanatory help text for preceding question/answer is on the
  19.     following lines, terminated by a blank line or another
  20.     option.
  21. P=    strip all punctuation from following answer list.
  22. N=    quiz name is on next line.
  23. M=    macro definition on following lines, terminated by a blank
  24.     line or another option.
  25. T=    time allowed is on next line in the format HH:MM:SS.
  26. C=    clear NOT allowed. No additional lines.
  27. S=    lock in sequential mode (user cannot change mode). No additional
  28.     lines.
  29. R=    lock in random mode (user cannot change mode). No additional
  30.     lines.
  31. F=    output score filename is on next line (no score recording
  32.     if omitted).
  33. E=    encrypt score file.
  34. W=    assign weighting. Weight appears as an integer on the next line.
  35.     This weight will be used for all questions following until and
  36.     unless another weight is assigned.
  37. D=    disable display of correct answers if answer is incorrect. No
  38.     additional lines.
  39. G=      define letter grade equivalency list or disable display of
  40.     letter grades during execution. To disable letter grade
  41.     display, the following line should contain "OFF" only. Otherwise,
  42.     any number of following lines contain the grade equivalencies
  43.     in the form <score>=<letter grade>.
  44. L=      limit the number of questions to a subset of the total number of
  45.         questions in the database. The number of questions in the subset
  46.         is specified on the following line.
  47. O=      omit the questions in the subset at compile time. Ignored without
  48.         the L= keyword. If L= is given without O=, then the subset will
  49.         be selected at run-time, giving a different subset each time the
  50.         database is run. If O= is given with L=, then the subset will be
  51.         determined by the compiler and the database will be the same each
  52.         time the program is run.
  53. V=    view literal answers. Causes first five (or more) characters of
  54.     the answer the user keyed in to be included in the score file
  55.     point matrix. This is BEFORE any preprocessing with the exception
  56.     that leading blanks are skipped.
  57. I=    Ignore character
  58. K=    Keep administrator's name (request it and record it in the score
  59.     file). No effect if score file not used.
  60. X=    Sets the length of eXported answers. The length is specified on
  61.     the following line. If two numbers are given, separated by a
  62.     comma, then the first is the length of answers that are kept
  63.     internally, and the optional second number is the length of the
  64.     answers that will be exported to the score file. The second
  65.     number can never be larger than the first.
  66.  
  67. In this sample database, questions are weighted by type as follows:
  68.     multiple-choice        1 point each
  69.     true/false (yes/no)    2 points each
  70.     fill-in            3 points each
  71.  
  72. Again, note that comments are just about free-form. Place them anywhere
  73. except between option keywords and their termination. QASA will discard
  74. all comment text as it compiles this file, so you are not penalized for
  75. commenting your databases.
  76.  
  77. The sample database configuration follows....
  78.  
  79. ==========================================================================
  80.  
  81. If this character appears in column 1, ignore it (skip over it)
  82. but do not count the line as blank. This allows spacing lines in
  83. explanatory help text. Do not use anywhere else.
  84. ---------------------------------------------------------------------
  85. I=
  86. *        (This is the default. To disable ignore, leave this line blank.)
  87.  
  88. Name the database. This name is displayed in QASA's main window.
  89. ----------------------------------------------------------------
  90. N=
  91. QA Study Aid Example Database #2
  92.  
  93. Specify a score file. If it already exists, score data will be
  94. appended. Otherwise, a new file will be created using this name.
  95. ----------------------------------------------------------------
  96. F=
  97. demo2.scr
  98.  
  99. Specify that we want the score file to contain literally what the user
  100. entered for each answer. This allows an analysis of consistently
  101. incorrect answers.
  102. ----------------------------------------------------------------------
  103. V=
  104.  
  105. Specify that we want the test to be 'blind'; in other words,
  106. disable the display of all scoring information until the test
  107. is completed.
  108. ------------------------------------------------------------------
  109. D=
  110.  
  111. Say that we want to retain at least 30 characters of each answer
  112. internally, but export only 15 characters to the score file.
  113. ----------------------------------------------------------------
  114. X=
  115. 30,15
  116.  
  117.  
  118. These are the 'true' and 'false' macro definitions...
  119. -----------------------------------------------------
  120.  
  121. M=
  122. $TRUE$
  123. True
  124. T
  125. Yes
  126. Y
  127.  
  128. M=
  129. $FALSE$
  130. False
  131. F
  132. No
  133. N
  134.  
  135. Define the letter grade equivalency list. The last line (59.99) causes
  136. the letter grade display to be omitted until the user achieves a score
  137. of at least 59.99. Set this to 0 to always display the letter grade.
  138. ----------------------------------------------------------------------
  139.  
  140. G=
  141. 95    = A+
  142. 90    = A
  143. 85    = A-
  144. 83    = B+
  145. 80    = B
  146. 75    = B-
  147. 73    = C+
  148. 70    = C
  149. 67    = C-
  150. 65    = D+
  151. 63    = D
  152. 60    = D-
  153. 59.99 = F
  154.  
  155. If we wanted to turn off the display of letter grades so the letter
  156. grade would be shown only when the quiz was completed and in the
  157. score file (if defined), then we would use the following:
  158. -------------------------------------------------------------------
  159.  
  160. G=                   [this turns G= into normal text]
  161. OFF
  162.  
  163. ==========================================================================
  164. The first question follows, with a weight of 2.
  165. -----------------------------------------------
  166.  
  167. W=
  168. 2
  169.  
  170. Q=
  171.  1. True/False
  172.  
  173.  QASA can be used to measure a teacher's effectiveness.
  174.  
  175. A=
  176. Yes, by storing the administrator's name in the score file also.
  177. $TRUE$
  178.  
  179. H=
  180. *
  181.  Using the K= option (in conjunction with F= to save the score in
  182.  a file), you can cause QASA to prompt for the quiz administrator's
  183.  name as well as the name of the student. Over a statistically
  184.  valid number of quizzes, the effectiveness of two or more teachers
  185.  can be compared. The ability to export the score files to a
  186.  spreadsheet program makes this an easy problem to solve with QASA.
  187.  
  188. ==========================================================================
  189.  
  190. W=
  191. 2
  192.  
  193. Q=
  194.  2. True/False
  195.  
  196.  QASA cannot support score files on a network server.
  197.  
  198. A=
  199. QASA can operate just fine on a network.
  200. $FALSE$
  201. H=
  202. *
  203.  If the F= keyword defines a score file on a network drive,
  204.  QASA will lock the file to prevent corruption by other users
  205.  taking tests with QASA. The SHARE.EXE program must be loaded,
  206.  but QASA will warn you if it's needed but absent.
  207.  
  208. ==========================================================================
  209.  
  210. W=
  211. 1
  212.  
  213. Q=
  214.  3. Multiple-choice
  215.  
  216.  I can sell the QA.EXE program with my accounting training
  217.  videotape (for example) if
  218.  
  219.  a. I pay a royalty for each copy sold
  220.  b. I cannot sell someone else's work
  221.  c. I purchase a distribution license
  222.  d. I register the program
  223. A=
  224. I can sell my own training courses with a distribution license.
  225. c
  226. H=
  227. *
  228.  See the documentation file QASA regarding distribution of the
  229.  QA interpreter. With a distribution license, Quid Pro Quo
  230.  Software gives you the right to package the interpreter and
  231.  sell it as you see fit, EXCEPT modify it, represent it as your
  232.  own work, or state or imply any type of ownership rights to
  233.  the program. You cannot, of course, distribute the compiler
  234.  QASA.EXE to anyone.
  235.