home *** CD-ROM | disk | FTP | other *** search
/ Explore the World of Soft…ids, Adults, Educational / RocelcoInc-ExploreTheWorldOfSoftware-KidsAdultsEducational-Vol2-Shareware.iso / educate / disk083 / q&asa.doc < prev    next >
Encoding:
Text File  |  1990-08-05  |  98.8 KB  |  2,810 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                              Q & A Study Aid (Q&ASA)
  15.  
  16.                                   User's Guide
  17.  
  18.                                   Version 3.80
  19.  
  20.                                  August 4, 1990
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                                     _______
  42.                                ____|__     |               (tm)
  43.                             --|       |    |-------------------
  44.                               |   ____|__  |  Association of
  45.                               |  |       |_|  Shareware
  46.                               |__|   o   |    Professionals
  47.                             -----|   |   |---------------------
  48.                                  |___|___|    MEMBER
  49.  
  50.  
  51.  
  52.  
  53.                                   Hal Endresen
  54.                               Quid Pro Quo Software
  55.                                   P.O. Box 1248
  56.                            Cedar Rapids, IA 52406-1248
  57.                            CompuServe ID [73760,2032]
  58.  
  59.  
  60.  
  61.  
  62.      Q&A Study Aid V3.80 User's Guide
  63.      
  64.  
  65.                                 Table Of Contents
  66.                                 -----------------
  67.  
  68.  
  69.      Revision Information  . . . . . . . . . . . . . . . . . . . . . .    1
  70.  
  71.      Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . .    4
  72.  
  73.      Credits . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    4
  74.  
  75.      The Association of Shareware Professionals  . . . . . . . . . . .    4
  76.  
  77.      Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . .    4
  78.  
  79.      Installation  . . . . . . . . . . . . . . . . . . . . . . . . . .    6
  80.  
  81.      A Special Note  . . . . . . . . . . . . . . . . . . . . . . . . .    8
  82.  
  83.      User Interface  . . . . . . . . . . . . . . . . . . . . . . . . .    9
  84.  
  85.      Q&ASA Command List  . . . . . . . . . . . . . . . . . . . . . . .   10
  86.  
  87.      The Command Line  . . . . . . . . . . . . . . . . . . . . . . . .   10
  88.  
  89.      /FL - Load A Database . . . . . . . . . . . . . . . . . . . . . .   10
  90.  
  91.      /FS - Save a Database and Exit To DOS . . . . . . . . . . . . . .   13
  92.  
  93.      /FC - Continue with a Saved Database  . . . . . . . . . . . . . .   13
  94.  
  95.      /FE - Set Screen Colors . . . . . . . . . . . . . . . . . . . . .   14
  96.  
  97.      /FM - Set Menu Selector Character . . . . . . . . . . . . . . . .   14
  98.  
  99.      /FX - Exit to DOS . . . . . . . . . . . . . . . . . . . . . . . .   14
  100.  
  101.      /MS - Sequential Mode . . . . . . . . . . . . . . . . . . . . . .   15
  102.  
  103.      /MR - Pseudorandom Mode . . . . . . . . . . . . . . . . . . . . .   15
  104.  
  105.      /MC - Clear . . . . . . . . . . . . . . . . . . . . . . . . . . .   15
  106.  
  107.      /N - Name . . . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  108.  
  109.      Scoring Window  . . . . . . . . . . . . . . . . . . . . . . . . .   16
  110.  
  111.      Answering Questions . . . . . . . . . . . . . . . . . . . . . . .   17
  112.  
  113.      Creating a Database . . . . . . . . . . . . . . . . . . . . . . .   17
  114.  
  115.      The Q&AC Database Compiler  . . . . . . . . . . . . . . . . . . .   22
  116.  
  117.      Using Q&AC  . . . . . . . . . . . . . . . . . . . . . . . . . . .   23
  118.  
  119.      
  120.      Copyright (C) 1988, 1989, 1990 Quid Pro Quo Software            Page 1
  121.      
  122.  
  123.  
  124.  
  125.  
  126.      Q&A Study Aid V3.80 User's Guide
  127.      
  128.  
  129.      Q&AC Language Syntax  . . . . . . . . . . . . . . . . . . . . . .   24
  130.  
  131.      The Q= and A= Keywords  . . . . . . . . . . . . . . . . . . . . .   25
  132.  
  133.      The N= Keyword  . . . . . . . . . . . . . . . . . . . . . . . . .   25
  134.  
  135.      The M= Keyword  . . . . . . . . . . . . . . . . . . . . . . . . .   26
  136.  
  137.      The T= Keyword  . . . . . . . . . . . . . . . . . . . . . . . . .   29
  138.  
  139.      The C= Keyword  . . . . . . . . . . . . . . . . . . . . . . . . .   29
  140.  
  141.      The S= and R= Keywords  . . . . . . . . . . . . . . . . . . . . .   30
  142.  
  143.      The F= Keyword  . . . . . . . . . . . . . . . . . . . . . . . . .   30
  144.  
  145.      The E= Keyword  . . . . . . . . . . . . . . . . . . . . . . . . .   32
  146.  
  147.      The D= Keyword  . . . . . . . . . . . . . . . . . . . . . . . . .   33
  148.  
  149.      The W= Keyword  . . . . . . . . . . . . . . . . . . . . . . . . .   33
  150.  
  151.      The Q&AD Score File Decoder . . . . . . . . . . . . . . . . . . .   34
  152.  
  153.      Conclusion  . . . . . . . . . . . . . . . . . . . . . . . . . . .   35
  154.  
  155.      Appendix : Q&AC Error Messages  . . . . . . . . . . . . . . . . .   36
  156.  
  157.      COPYRIGHT . . . . . . . . . . . . . . . . . . . . . . . . . . . .   39
  158.  
  159.      Q&A STUDY AID V3.80 REGISTRATION  . . . . . . . . . . . . . . . .   40
  160.  
  161.      USER SUPPORTED SOFTWARE . . . . . . . . . . . . . . . . . . . . .   41
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.      
  184.      Copyright (C) 1988, 1989, 1990 Quid Pro Quo Software            Page 2
  185.      
  186.  
  187.  
  188.  
  189.  
  190.      Q&A Study Aid V3.80 User's Guide
  191.      
  192.  
  193.  
  194.      Revision Information
  195.      --------------------
  196.  
  197.      Version 1.0    January 7, 1988
  198.  
  199.           Initial public release.
  200.  
  201.      Version 2.0    March 22, 1988
  202.  
  203.           Major  enhancements to allow Q&ASA to  be used in a formal class-
  204.           room environment. Among the changes are the following:
  205.  
  206.           o    Optional logging of scoring information to a disk file.
  207.           o    Compiled database eliminates run-time interpreter errors and
  208.                permits the database to be encrypted.
  209.           o    Display of the database name as the window title.
  210.           o    Faster response when loading questions.
  211.           o    Greatly improved help system allows selection and viewing of
  212.                any help category at any time.
  213.           o    Optional  locking of  selected mode  and lockout  of certain
  214.                commands.
  215.           o    Ability  to assign a weight  to each question  and have this
  216.                weight  determine the number of points awarded for a correct
  217.                answer to a question.
  218.           o    Ability to specify a time limit to answer all questions.
  219.           o    Elimination of all index files.
  220.  
  221.      Version 2.1    July 31, 1988
  222.  
  223.           Minor enhancements to help system.
  224.  
  225.      Version 3.0    May 1, 1989
  226.  
  227.           Corrected  a bug  in the  random mode  termination function,  and
  228.           enhanced the random mode search speed. Version 2.1 would continue
  229.           to ask questions after they had been answered, allowing a user to
  230.           gain a score exceeding 100%. Also enhanced the registration func-
  231.           tion.
  232.  
  233.           o    Added the 'D='  command to Q&AC and Q&ASA to allow the data-
  234.                base  author to disable display of the correct answer if the
  235.                user answers incorrectly.
  236.           o    Added the ability to specify and execute a database from the
  237.                DOS command line.
  238.  
  239.      Version 3.1    July 31, 1989
  240.  
  241.           Made some minor  corrections and  additions to  this manual,  and
  242.           corrected  a minor bug related to locating the executable file on
  243.           disk.
  244.  
  245.  
  246.  
  247.      
  248.      Copyright (C) 1988, 1989 Quid Pro Quo Software                  Page 1
  249.      
  250.  
  251.  
  252.  
  253.  
  254.      Q&A Study Aid V3.80 User's Guide
  255.      
  256.  
  257.      Version 3.50   August 10, 1989
  258.  
  259.           The  menu was  modified to  eliminate the  /FD and  /FS commands,
  260.           which  were  replaced  with  the single  command  /FL  (File/Load
  261.           Database). The directory defaults to the current working directo-
  262.           ry. The directory may be changed if desired.
  263.  
  264.           Major internal enhancements were made  to the video system. Q&ASA
  265.           will now  detect the  type of  display adapter  in use,  and will
  266.           operate properly  with 132-column and 43- and  50-line modes. The
  267.           screen  update rate  has  been increased.  The  /S? commands  are
  268.           necessary  only in extreme cases  where snow is  a severe problem
  269.           (these  commands have  been  retained, however).  Q&ASA will  now
  270.           autoselect the screen update method.
  271.  
  272.           The registration  functions have been entirely  replaced. The new
  273.           registration system now sets the  executable file to read-only to
  274.           prevent  inadvertent  overwriting of  the  executable image.  The
  275.           serial number now  provides certain  essential information  about
  276.           the system Q&ASA is running on. Q&ASA will detect certain changes
  277.           to itself and refuse  to execute if it is modified.  A demonstra-
  278.           tion mode has been added (although the program is not distributed
  279.           as a demo; it is a full-featured program with no crippling of any
  280.           function).
  281.  
  282.           Q&ASA  now intercepts  the Control-C  and Control-Break  keys and
  283.           will  perform a graceful exit  with proper updating  of the score
  284.           file. Hardware  error detection  and handling of  critical errors
  285.           has  been improved, and now offers the options of Retry or Cancel
  286.           (Cancel aborts only  the command that experienced  the error, not
  287.           the program as a whole).
  288.  
  289.           The Help  key (F1) is now  active in the opening  screen. You may
  290.           obtain  an  overview of  the operation  of  Q&ASA at  the opening
  291.           screen,  or exit  the  program by  pressing  ESCape. Several  new
  292.           categories have been added  to the help file for  registering and
  293.           for reporting problems.
  294.  
  295.      Version 3.60   December 10, 1989
  296.  
  297.           A potential problem was found and corrected with  the calculation
  298.           of weights. This problem  would be encountered only if  the total
  299.           weight exceeded 32767, which is the maximum weight permitted.
  300.  
  301.           The  /FS (File/Save  Database) and  /FC (File/Continue  Database)
  302.           commands were added. This combination allows the user of Q&ASA to
  303.           save the current  state of a test or quiz  database and return to
  304.           it  later. The database will  be restored to  its previous state.
  305.           These  commands will not  work if the  database has  a time limit
  306.           associated with it.
  307.  
  308.           The "E=" option has been added to the database compiler Q&AC.EXE.
  309.           This option specifies  that the score file is to  be encrypted so
  310.  
  311.      
  312.      Copyright (C) 1988, 1989 Quid Pro Quo Software                  Page 2
  313.      
  314.  
  315.  
  316.  
  317.  
  318.      Q&A Study Aid V3.80 User's Guide
  319.      
  320.  
  321.           that a user  cannot complete a  test or quiz,  and then edit  the
  322.           resulting  score in  the  score file.  A  new utility,  Q&AD.EXE,
  323.           restores the score file to plain ASCII text.
  324.  
  325.           A configuration file was added. This file must  be located in the
  326.           same directory as  the help  file Q&ASA.HLP, and  the same  rules
  327.           that  govern  its access  apply  to the  configuration  file. The
  328.           configuration  file is named Q&ASA.CFG. It is not included in the
  329.           distribution, since Q&ASA will  automatically create it the first
  330.           time it is executed.
  331.  
  332.           A new command,  /FE, allows the screen colors  to be changed. The
  333.           new values are saved in the configuration file.
  334.  
  335.           A  new command,  /FM, allows  the menu  selector character  to be
  336.           altered. This defaults  to the forward slash character ('/'), but
  337.           may now be changed to any other character in the  printable ASCII
  338.           range  of  '!'  through  '~', inclusive.  Once  changed,  the new
  339.           selector character  is saved  in  the configuration  file so  the
  340.           effect of the change will be permanent unless changed again.
  341.  
  342.           The  weighting system was altered  to permit questions  to have a
  343.           weight  of zero.  If desired,  all questions  may be  weighted as
  344.           zero, but this will cause all scores to be zero also.
  345.  
  346.      Version 3.70   December 30, 1989
  347.  
  348.           Fixed a major bug that caused all screen attributes to  be set to
  349.           zero if  the configuration file was missing. Since the configura-
  350.           tion file is not distributed with  Q&A Study Aid, the effect  was
  351.           to present a blank screen. Although commands could be entered and
  352.           the screen colors  set, all of this  had to be done with  a blank
  353.           screen.
  354.  
  355.           Also fixed  a bug in  the answer screen  that would not  allow an
  356.           altered  menu-select character to be used to escape into the menu
  357.           system. This bug was reported by  a concerned user; our thanks go
  358.           out to him.
  359.  
  360.      Version 3.80   August 4, 1990
  361.  
  362.           Changed Mode/Random from /MA to /MR.
  363.  
  364.           Eliminated the screen control menu.
  365.  
  366.           Left-justified the mode in the status window.
  367.  
  368.           Added a check  to insure that the screen is  free before updating
  369.           the time left.
  370.  
  371.           Recompiled with  aggressive optimizations using  the new  version
  372.           (V6.0) of the Microsoft C Optimizing Compiler. The .EXE file size
  373.           has been significantly reduced.
  374.  
  375.      
  376.      Copyright (C) 1988, 1989 Quid Pro Quo Software                  Page 3
  377.      
  378.  
  379.  
  380.  
  381.  
  382.      Q&A Study Aid V3.80 User's Guide
  383.      
  384.  
  385.      Compatibility
  386.      -------------
  387.  
  388.      The database files used  by Q&ASA 3.80 are source-compatible  with all
  389.      previous versions, but are not binary-compatible. All that is required
  390.      is that you recompile your database files with Version 3.80 of Q&AC.
  391.  
  392.              Q&ASA WILL NOT WORK WITH THE HERCULES GRAPHICS ADAPTER.
  393.  
  394.      Credits
  395.      -------
  396.  
  397.      Microsoft(R), Microsoft Windows(R), MS-DOS, and Microsoft C Optimizing
  398.      Compiler(R) are registered trademarks of Microsoft Corporation.
  399.  
  400.      IBM  and PC-DOS  are registered  trademarks of  International Business
  401.      Machines Corporation.
  402.  
  403.      dBASE is a registered trademark of Ashton-Tate.
  404.  
  405.  
  406.      The Association of Shareware Professionals
  407.      ------------------------------------------
  408.  
  409.      The Association  of Shareware  Professionals is an  organization whose
  410.      purpose  is to  promote  the shareware  distribution  concept, and  to
  411.      provide a forum for the resolution of disputes between ASP members and
  412.      their customers.
  413.  
  414.      Quid  Pro Quo  Software is  a member  of the Association  of Shareware
  415.      Professionals (ASP). ASP wants to make sure that the shareware princi-
  416.      ple works for  you. If you are  unable to resolve a  shareware-related
  417.      problem with an ASP member by contacting the member  directly, ASP may
  418.      be able to  help. The ASP Ombudsman can help you  resolve a dispute or
  419.      problem with an ASP member, but does not provide technical support for
  420.      members' products. Please write to the ASP Ombudsman at P.O. Box 5786,
  421.      Bellevue, WA  98006 or send a  Compuserve message via EasyPlex  to ASP
  422.      Ombudsman [70007,3536].
  423.  
  424.  
  425.      Introduction
  426.      ------------
  427.  
  428.      Q&ASA is a general-purpose program  designed to present questions from
  429.      a database. The user is then prompted for an answer and graded accord-
  430.      ingly.
  431.  
  432.      In the  context of  this document,  and within  all program  and other
  433.      files included with the Q&ASA package, the word  'database' is used in
  434.      its generic sense. For our purposes, a database is simply a collection
  435.      of  questions, answers,  and  options that  is  created by  the  user,
  436.      compiled,  and interpreted by the Q&ASA program. Like the more general
  437.      database  programs such  as dBASE(R),  Q&A Study  Aid uses  an indexed
  438.  
  439.      
  440.      Copyright (C) 1988, 1989 Quid Pro Quo Software                  Page 4
  441.      
  442.  
  443.  
  444.  
  445.  
  446.      Q&A Study Aid V3.80 User's Guide
  447.      
  448.  
  449.      database,  although  the index  is an  integral  part of  the database
  450.      itself and  not a separate  file. All of  the details of  the database
  451.      implementation, such  as the index,  records, fields, and  data types,
  452.      are handled automatically by the Q&A  Study Aid package. You need not,
  453.      therefore, be concerned with these, or even know what they mean.
  454.  
  455.      Q&ASA provides two methods of reading the questions from the database:
  456.      sequential and random. The program starts up in sequential mode.
  457.  
  458.      A  menu-driven command  interface  is provided  with pull-down  menus.
  459.      Filenames  are  selected from  a directory  by  pointing. It  is never
  460.      necessary to  type in a filename unless a database is specified on the
  461.      command line.
  462.  
  463.      Q&ASA supports a comprehensive  context-sensitive help system accessi-
  464.      ble via the F1 key. Help is provided by a single support file, Q&ASA.-
  465.      HLP.  This file  may be  located in  the current  directory or  in any
  466.      directory  specified  in  the  PATH environment  variable.  Q&ASA  may
  467.      therefore be placed in the \bin (or equivalent) directory and accessed
  468.      from  any other  directory,  provided that  PATH environment  variable
  469.      includes "\bin". If you place Q&ASA in a directory that is not in  the
  470.      PATH  string such  that it is  unable to  locate its  help file, Q&ASA
  471.      will, as a last resort, pop up a window and ask you to enter  the name
  472.      of directory containing the help file. If you do not enter a directory
  473.      name (by  pressing RETURN at the  prompt), the Help key  will be inac-
  474.      tive.
  475.  
  476.      Q&ASA uses a compiled database. The database compiler is included with
  477.      the package to allow you to create and compile your own databases. The
  478.      database compiler is called Q&AC.EXE.  Both Q&ASA.EXE and Q&AC.EXE are
  479.      written in the C  language (with some assembly-language)  and compiled
  480.      using the Microsoft C Optimizing Compiler Version 6.0.
  481.  
  482.      This package contains the following files:
  483.  
  484.           Q&ASA.EXE      Q&ASA main program
  485.           Q&AC.EXE       Q&ASA database compiler
  486.           Q&AD.EXE       Q&ASA encrypted score file decoder
  487.           Q&ASA.HLP      Q&ASA help file
  488.           Q&ASA.DOC      documentation file (this file)
  489.           REGISTER       program registration form
  490.  
  491.           SAMPLE.Q&A     sample database (compiled)
  492.           SAMPLE.DEF     database definition file for SAMPLE.Q&A
  493.  
  494.      The  Q&A Study  Aid package  is SHAREWARE  and  is copyrighted  by the
  495.      author. If Q&ASA meets  your needs, you are  expected to register  and
  496.      pay for  its use. The  SHAREWARE concept  allows users to  obtain high
  497.      quality  software  at bargain  prices, and  rewards authors  for their
  498.      efforts. Please support this  distribution concept by registering your
  499.      copy. You will find a registration form at the back of this manual and
  500.      in the REGISTER file. You have unlimited rights to copy and distribute
  501.      the program,  provided you  distribute it  as the  complete UNMODIFIED
  502.  
  503.      
  504.      Copyright (C) 1988, 1989 Quid Pro Quo Software                  Page 5
  505.      
  506.  
  507.  
  508.  
  509.  
  510.      Q&A Study Aid V3.80 User's Guide
  511.      
  512.  
  513.      package Q&ASA380.ZIP. Comments, bug reports, or other information that
  514.      may help  me improve this program are welcome and are encouraged. Only
  515.      you can tell me what you need!
  516.  
  517.      Q&ASA is offered  as is. There  is no guarantee  that it will work  on
  518.      your particular system;  however, it  has been tested  with CGA,  MDA,
  519.      EGA, and VGA monitors on PCs, ATs, and 386 systems. Text mode is used;
  520.      no graphics  card is  needed. Q&ASA  will  NOT use  an EMM  if one  is
  521.      present. A minimum of 80K  of available RAM is needed by  the program;
  522.      it will tell you if you do  not have sufficient memory to execute  it.
  523.      The maximum amount of memory that Q&ASA will use is 126K.
  524.  
  525.      All I/O is performed through  system calls, with the exception  of the
  526.      screen, which is  controlled by  direct writes to  the screen  buffer.
  527.      Under  Microsoft(R) Windows, you must give Q&ASA control of the screen
  528.      in  the Q&ASA.PIF  file. Commands  have been  provided to  control the
  529.      screen updating method to eliminate  any 'snow', although these should
  530.      not be  required. Q&ASA will  start in the  FAST screen mode,  meaning
  531.      that it will  not wait for any synchronizing signals before writing to
  532.      the screen. This  is the best  mode for use with  EGA, VGA, and  mono-
  533.      chrome (MDA) systems.
  534.  
  535.      Q&ASA assumes that your screen is set to any text mode (color or mono-
  536.      chrome). If not, it will NOT reset  the mode. If your screen is in any
  537.      of the graphics  modes when  Q&ASA is invoked,  you will see  garbage.
  538.      Exit Q&ASA using the /FX command (or press ESC if you are still in the
  539.      opening  screen) and reset  the mode manually using  the DOS MODE com-
  540.      mand.
  541.  
  542.  
  543.      Installation
  544.      ------------
  545.  
  546.      Q&A Study Aid  requires no  special installation other  than that  ex-
  547.      plained in the section entitled "A Special Note" below.
  548.  
  549.      The configuration file Q&ASA.CFG is not supplied with the distribution
  550.      package, since it is created automatically if it is missing. The first
  551.      time  you execute  Q&ASA, you  will get  a prompt  asking you  for the
  552.      directory containing the configuration  file, since Q&ASA will  not be
  553.      able to locate  it on the disk. This prompt  will appear anytime Q&ASA
  554.      is unable  to find its configuration file. If you move the file, enter
  555.      the name of the directory containing the file; otherwise, press RETURN
  556.      without entering a directory to cause Q&ASA to create the file.
  557.  
  558.      If you are using  a hard disk, you  may place the executable  files in
  559.      any directory (note that the files Q&ASA.HLP and Q&ASA.CFG are consid-
  560.      ered to  be part of the executable files).  If you wish to execute the
  561.      program from a different directory than the one in which the files are
  562.      placed, you must include the directory containing the executable files
  563.      in the PATH environment  variable. To view the PATH,  issue the MS-DOS
  564.      command  SET  with no  arguments;  all environment  variables  will be
  565.      listed to the screen.
  566.  
  567.      
  568.      Copyright (C) 1988, 1989 Quid Pro Quo Software                  Page 6
  569.      
  570.  
  571.  
  572.  
  573.  
  574.      Q&A Study Aid V3.80 User's Guide
  575.      
  576.  
  577.      If you do not have a PATH variable, as evidenced by a line of the form
  578.  
  579.      PATH=[list of directories]
  580.  
  581.      then you may enter one. If you have placed all executable files in the
  582.      directory C:\Q&ASA, for example, issue the command
  583.  
  584.           SET PATH=C:\Q&ASA <ENTER>
  585.  
  586.      Do not include any spaces after the  word PATH. Also, it is unwise  to
  587.      include any  removable drive in  the PATH, since  DOS will  attempt to
  588.      search the directory of that drive when you attempt to execute  Q&ASA.
  589.      If the floppy has been removed, you will constantly get  an error from
  590.      DOS.
  591.  
  592.      If you wish  to append a  new directory, C:\Q&ASA  for example, to  an
  593.      existing  PATH,  then simply  retype your  existing  PATH and  add the
  594.      directory to it as follows:
  595.  
  596.      You type:
  597.  
  598.           SET <ENTER>
  599.  
  600.      MS-DOS responds with (for example):
  601.  
  602.           PATH=C:\BIN
  603.           (other environment variables)
  604.  
  605.      You type:
  606.  
  607.           SET PATH=C:\BIN;C:\Q&ASA <ENTER>
  608.  
  609.      Note the position of the semicolon - it is REQUIRED.
  610.  
  611.      You  should place  the 'SET  PATH=xxxx' command  in your  AUTOEXEC.BAT
  612.      file, so that  it will  be set automatically  whenever your system  is
  613.      booted.
  614.  
  615.      The  Q&A Study Aid  package is small  enough to be  placed on a single
  616.      5.25" 360KB diskette if desired. If your database is too  large to fit
  617.      on one diskette, you may place it on a second diskette in the B: drive
  618.      if you have one.
  619.  
  620.      To  create a database file, you  need only a database definition file,
  621.      which you create, and the database compiler  Q&AC.EXE. Similarly, once
  622.      you have  created a  database, the  only files needed  to execute  the
  623.      database  are  the compiled  database  file  (".Q&A"), Q&ASA.EXE,  and
  624.      Q&ASA.HLP. If  space is really at a premium, you may omit the configu-
  625.      ration  file Q&ASA.CFG and  the help file Q&ASA.HLP,  but the HELP key
  626.      (F1) will no longer function. If you do this, Q&ASA will complain that
  627.      it cannot find  the help file, and  ask you to enter  the directory in
  628.      which it resides.  To omit it, simply  press ENTER without  entering a
  629.      directory.
  630.  
  631.      
  632.      Copyright (C) 1988, 1989 Quid Pro Quo Software                  Page 7
  633.      
  634.  
  635.  
  636.  
  637.  
  638.      Q&A Study Aid V3.80 User's Guide
  639.      
  640.  
  641.  
  642.      A Special Note
  643.      --------------
  644.  
  645.      Special  mention is made here of a particular characteristic of Q&ASA.
  646.      The  program, to enforce  its registration policies,  will, at certain
  647.      times, modify  its own executable  image on disk.  This is brought  to
  648.      your  attention as  this  behavior may  trigger some  virus-protection
  649.      programs. Please  do not be concerned  if this occurs; this  is normal
  650.      behavior. You  must allow Q&ASA to  modify itself or it  will not exe-
  651.      cute. Each time  it is executed, Q&ASA will set  itself to a read-only
  652.      file. The MS-DOS ATTRIB command  may be used to alter this  should you
  653.      desire to erase or move the program file.
  654.  
  655.      Q&ASA must be able to locate  its own .EXE file. Under MS-DOS  3.0 and
  656.      above, you should experience no problems, even if you rename the file.
  657.      However, under MSDOS 2.x, if you rename the program, you  must specify
  658.      the new program pathname using  an environment variable. For  example,
  659.      suppose Q&ASA.EXE  is in  the directory C:\BIN,  and you rename  it to
  660.      QUIZ.EXE. You must then issue the command
  661.  
  662.           SET Q&ASA=C:\BIN\QUIZ.EXE
  663.  
  664.      You may  place this command in your AUTOEXEC.BAT file if you wish. You
  665.      MUST specify the COMPLETE pathname, including the .EXE extension.
  666.  
  667.                                     IMPORTANT
  668.                                     ---------
  669.  
  670.      Q&ASA.EXE  selects  a random  serial  number  and combines  this  with
  671.      certain system information the FIRST time it is executed. This becomes
  672.      your serial number, and  this number MUST be supplied to  register the
  673.      program. ONCE  THE SERIAL NUMBER  HAS BEEN ASSIGNED  BY Q&ASA,  DO NOT
  674.      ERASE, MODIFY, OR  OVERWRITE THE Q&ASA.EXE  FILE OR YOUR  REGISTRATION
  675.      NUMBER WILL  NOT WORK (you  will have to  send for a  new registration
  676.      number, although once you  have paid the registration fee,  new regis-
  677.      tration numbers are supplied free of  charge if they are needed). Make
  678.      a backup  copy after you  have executed it  the first time,  and again
  679.      after registering your copy. Once you have registered and entered your
  680.      registration number, the serial  number will change; for  this reason,
  681.      it is important that you include  the most recent serial number in all
  682.      correspondence. This  applies ONLY  to the file  Q&ASA.EXE; all  other
  683.      files are standard executable or data files.
  684.  
  685.      Q&ASA also  requires that  the time and  date provided  by the  MS-DOS
  686.      operating system be  correct, since  it uses this  information in  the
  687.      score  file. When  Q&ASA is  started, the  current time  and  date are
  688.      checked; if either  is invalid,  Q&ASA will abort  after displaying  a
  689.      message  requesting you to set the system  date and time to the proper
  690.      values.
  691.  
  692.      Q&ASA NEVER modifies any file other  than its own executable image  on
  693.      disk, the score file (if defined  in the database), the saved database
  694.  
  695.      
  696.      Copyright (C) 1988, 1989 Quid Pro Quo Software                  Page 8
  697.      
  698.  
  699.  
  700.  
  701.  
  702.      Q&A Study Aid V3.80 User's Guide
  703.      
  704.  
  705.      file(s)  (".SAV") if this feature is used, and the configuration file.
  706.      You  need not be concerned about modifications to your database source
  707.      files or any other files on your system.
  708.  
  709.  
  710.      User Interface
  711.      --------------
  712.  
  713.      Commands are entered into Q&ASA via a pull-down two-level menu system.
  714.      The uppermost screen region is the menu system. Each word group on the
  715.      menu line  is the title block of a pull-down menu. Whenever one of the
  716.      titles  is selected, the menu expands to display any options available
  717.      under it.
  718.  
  719.      Under most  conditions, Q&ASA  will be  prompting for  an answer  to a
  720.      question. Some means must therefore be provided to  break out and into
  721.      the menu system so that an option  can be selected or a command given.
  722.      There are  two ways  of  doing this:  via an  ALT key  sequence or  by
  723.      pressing the menu  selector character, the  forward slash ('/').  Note
  724.      that this character  may be changed using the /FM  (File / Menu Selec-
  725.      tor)  command. This document will,  however, assume that  you have NOT
  726.      altered the default.
  727.  
  728.      If an ALT sequence  is used, it is only necessary to  press one or two
  729.      ALT keys to select  any command option. A top-level selector is speci-
  730.      fied  by ALT-shifting the highlighted letter. For example, the "Mode /
  731.      Sequential" command is executed with ALT-M/ALT-S.
  732.  
  733.      If you use  the '/' menu selector character, the  word MENU will first
  734.      appear at the right of the menu  line to indicate that you are in  the
  735.      menu  system. At this point, any combination of highlighted and under-
  736.      scored letters (as defined by the screen colors you choose) and cursor
  737.      keys can be used to select a command  option. Note that F1 will always
  738.      get help no matter where you may be, in or out of the menu system. The
  739.      only  exception to this is  for error messages  ("Problem"), for which
  740.      you may not obtain  help. Once the desired  option has been  selected,
  741.      RETURN executes  it. Note that  neither the  slash nor the  RETURN are
  742.      necessary when using ALT-key sequences.
  743.  
  744.      Versions 3.0 of Q&ASA and above provide the ability for you to specify
  745.      a database file on the  command line. If you do so, you will still see
  746.      the  opening screen, but as soon as you press a key, the database will
  747.      be loaded and  the first question will  be displayed. If the  database
  748.      specifies a time limit, the timer will be started immediately.
  749.  
  750.      If  the database  you specify cannot  be found, then  an error message
  751.      will be displayed, and you must select the database normally using the
  752.      /FL command. For example, the DOS command
  753.  
  754.           C>Q&ASA sample
  755.  
  756.      will load the  sample database  and display the  first question.  Note
  757.      that  you do  not have  to  specify the  ".Q&A" extension.  If you  do
  758.  
  759.      
  760.      Copyright (C) 1988, 1989 Quid Pro Quo Software                  Page 9
  761.      
  762.  
  763.  
  764.  
  765.  
  766.      Q&A Study Aid V3.80 User's Guide
  767.      
  768.  
  769.      specify an extension, it MUST be ".Q&A"; Q&ASA will force this  exten-
  770.      sion for all database files.
  771.  
  772.      Q&ASA's menu system commands are listed on the following page.
  773.  
  774.  
  775.      Q&ASA Command List
  776.      ------------------
  777.  
  778.           /FL       load a database
  779.           /FS       save a database for later resumption
  780.           /FC       continue with a previously-saved database
  781.           /FX       exit to DOS
  782.           /FE       set screen colors
  783.           /FM       set menu selector character
  784.           /MS       set mode to sequential
  785.           /MR       set mode to pseudorandom
  786.           /MC       clear score
  787.           /N        enter name
  788.  
  789.  
  790.      The Command Line
  791.      ----------------
  792.  
  793.      Q&ASA does not  require any command-line  parameters or arguments.  It
  794.      will, however, allow you to specify the name of a database file on the
  795.      command line so that the program may be invoked from a batch file.
  796.  
  797.      If you specify the name of a database file on the command line, you do
  798.      not have to  enter the extension. Q&ASA  will change the  extension as
  799.      required, and  add one if it  is omitted. For example,  to start Q&ASA
  800.      using the sample database provided, you simply type
  801.  
  802.      Q&ASA SAMPLE <ENTER>
  803.  
  804.      The  opening screen  will be  displayed normally,  but once  you press
  805.      ENTER, the database file SAMPLE will be automatically loaded.
  806.  
  807.  
  808.      /FL - Load A Database
  809.      ---------------------
  810.  
  811.      When  you  issue this  command,  Q&ASA will  display the  name  of the
  812.      directory you started Q&ASA from; e.g., the current working directory.
  813.      If  you database  files are  located in  this directory,  simply press
  814.      RETURN to  accept the default name. If your database files are located
  815.      in  another directory,  you may  edit the  directory name.  Q&ASA will
  816.      remember the new directory name and present it as the default the next
  817.      time you use this command.
  818.  
  819.      When specifying the directory,  you may select a different  disk drive
  820.      followed by the  path name to the  database files in  conventional DOS
  821.      form:
  822.  
  823.      
  824.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 10
  825.      
  826.  
  827.  
  828.  
  829.  
  830.      Q&A Study Aid V3.80 User's Guide
  831.      
  832.  
  833.                                  D:\DIR\DIR.....
  834.  
  835.      If you clear the  name of the directory by using the  backspace key or
  836.      by using the HOME  key followed by Ctrl-End, Q&ASA  will automatically
  837.      insert  the  name of  the current  working  directory after  you press
  838.      RETURN. Note that  you will not see  this occur as the window  will be
  839.      closed as soon as  you press RETURN. However, the  directory shown the
  840.      next time  you invoke  the /FL  command will  be  the current  working
  841.      directory again.
  842.  
  843.      If  you enter  a drive  or  directory that  does not  exist, you  will
  844.      receive  an error  message and  you  must enter  the command  again to
  845.      specify the proper directory. If  you enter the drive identifier  of a
  846.      floppy disk  drive, and the  drive door is  open, you will  receive an
  847.      error, and you will be  given the opportunity to close the  drive door
  848.      and retry the command.
  849.  
  850.      Note:     Certain DOS  configurations  can  cause  errors  that  Q&ASA
  851.                cannot detect. If,  for example, you  have installed a  'fo-
  852.                reign' disk drive using "DEVICE=DRIVER.SYS <parameters>" and
  853.                reassigned the name  of a diskette drive  using the DRIVPARM
  854.                command  in  your CONFIG.SYS  file  (MS-DOS  and PC-DOS  3.3
  855.                only),  and you enter the original  drive letter, Q&ASA will
  856.                appear  to hang.  Actually, what  is  happening is  that DOS
  857.                wants you insert the  diskette for the drive you  have reas-
  858.                signed  it to,  although you  will not  see the  message DOS
  859.                normally displays. All that is necessary is for you to press
  860.                the RETURN key.
  861.  
  862.      Once you have  entered the name of the directory containing your Q&ASA
  863.      database files, Q&ASA will pop up a window to allow you to select from
  864.      the  compiled database files available in that directory. If there are
  865.      no  database files in  the directory, Q&ASA  will display "[ empty ]".
  866.      Q&ASA will NOT display any files other than compiled database files.
  867.  
  868.      To select a compiled database file, move the selection bar to it using
  869.      the cursor keys, PgUp and PgDn, or Home and End. Each of these permits
  870.      traveling  up  and  down the  scrollable  list  in  larger increments.
  871.      Alternatively, you may also press a letter key that corresponds to the
  872.      first  character of the database  filename; Q&ASA will  find the first
  873.      file beginning  with that letter.  Successive depressions of  the same
  874.      key will  step to each database name that begins with that letter. The
  875.      search stops at the last file that begins with that letter. The search
  876.      always proceeds  down the list;  to restart the search,  press HOME to
  877.      move the selector back to the first file in the list.
  878.  
  879.      Once  you  have pointed  to the  file  you desire,  press  RETURN. The
  880.      compiled database file will  be loaded. If the optional  score logging
  881.      has  been enabled in  the database, Q&ASA will  request that you enter
  882.      your name  for the score file (you may not proceed until you have done
  883.      so). The first question will then appear on the screen, along with the
  884.      number of questions in the database in the scoring window. The name of
  885.      the database will also be shown in the center of the top border of the
  886.  
  887.      
  888.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 11
  889.      
  890.  
  891.  
  892.  
  893.  
  894.      Q&A Study Aid V3.80 User's Guide
  895.      
  896.  
  897.      question window if it has been specified in the database. If not, then
  898.      the window title will default to "Question".
  899.  
  900.      Note:     When  you load a database  file that specifies  a score file
  901.                name,  and that score file already  exists, Q&ASA will check
  902.                to  insure that the encryption modes are compatible. If not,
  903.                it will display an error message and override the encryption
  904.                setting in the database file you loaded.
  905.  
  906.                For example,  if you create two separate  databases, both of
  907.                which specify the same name for the score file, but only one
  908.                has score file encryption enabled, you will receive an error
  909.                when you load the second database. You will receive an error
  910.                no  matter which one you  load first. The  order will affect
  911.                only the encryption  of the score file, which  is determined
  912.                by  the first database loaded. If you always use a different
  913.                score file for  each database, or are  consistent with score
  914.                file encryption,  you should  experience  no problems.  Note
  915.                that Q&ASA will still function properly, however.
  916.  
  917.      Each time you  load a database file  with score file logging  enabled,
  918.      Q&ASA will  request your name,  even if you  have already  entered it.
  919.      This is to allow other users to reload the same database without using
  920.      the  same name for  all users. If  score file logging  is not enabled,
  921.      Q&ASA doesn't force you to enter your  name. You may do this anyway if
  922.      you wish, using the /N (Name) command, and Q&ASA will politely display
  923.      it when it displays your final score.
  924.  
  925.      If the database you load has a time limit associated with it, the time
  926.      remaining will be  displayed in  the status window  under the  heading
  927.      'Time Left', and  the clock will  start. The time  is counted down  to
  928.      zero, and always shows the time you  have remaining before Q&ASA stops
  929.      you and calculates your final score. If the database  does not specify
  930.      a time limit, the 'Time Left' will be displayed as 'No Limit'. If  you
  931.      allow the time to count down to zero, it will change to 'Time Out'.
  932.  
  933.      Note:     If you press the help key  while a timed database is loaded,
  934.                the time display will not be updated until you exit the help
  935.                system.  Q&ASA will, however, internally track the remaining
  936.                time.
  937.  
  938.      To permit Q&ASA to utilize relatively large databases (>3000 questions
  939.      and their answers), Q&ASA  loads an index into memory rather  than the
  940.      database file  itself. The database  index is created  by Q&AC  in the
  941.      form of a header in the  database file itself. Note that this is  true
  942.      of the help file also to minimize the memory used by Q&ASA.
  943.  
  944.      The database  file (.Q&A) should never  be changed directly, as  it is
  945.      encrypted to  prevent users from copying  the file to the  screen or a
  946.      printer and thereby  viewing the answers. If you wish  to create a new
  947.      database  or alter an existing one, you must edit the database defini-
  948.      tion file  (.DEF) and  recompile it  using Q&AC.  Q&AC  will create  a
  949.      (.Q&A) file from your (.DEF) file. Q&AC will not permit you to use the
  950.  
  951.      
  952.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 12
  953.      
  954.  
  955.  
  956.  
  957.  
  958.      Q&A Study Aid V3.80 User's Guide
  959.      
  960.  
  961.      .Q&A  extension on  a  definition  file,  so you  cannot  accidentally
  962.      overwrite a definition file.
  963.  
  964.      You must create  the database  definition file and  compile it  before
  965.      Q&ASA can be used. Instructions for  doing this are in a later section
  966.      of this guide.  Note that  this package contains  a compiled  database
  967.      that  you may  use to  test and  evaluate Q&ASA.  This file  is called
  968.      SAMPLE.Q&A. The database definition  file it was created from  is also
  969.      included, and is called SAMPLE.DEF.
  970.  
  971.  
  972.      /FS - Save a Database and Exit To DOS
  973.      -------------------------------------
  974.  
  975.      This command will save the present state of a database so that you may
  976.      return and  continue with it later.  IT WILL NOT WORK  IF THE DATABASE
  977.      HAS A TIME LIMIT ASSOCIATED WITH IT.
  978.  
  979.      If you issue  this command on a  database that has no time  limit, the
  980.      state of the database will be saved in a file in the current directory
  981.      with the  same base name  as the  database, but with  an extension  of
  982.      ".SAV". You may have different .SAV files in different directories for
  983.      the same database if you wish.
  984.  
  985.      Note:     If  you  issue the  /FL  (File/Load  Database) command,  any
  986.                existing .SAV file for that database will be erased from the
  987.                current working directory of  the disk, and you will  not be
  988.                able to resume it. The /FL command, by definition, specifies
  989.                that you wish to restart the database from the beginning.
  990.  
  991.      Once you issue  the /FS command,  the database will  be saved and  you
  992.      will be returned to the MS-DOS operating system.
  993.  
  994.  
  995.      /FC - Continue with a Saved Database
  996.      ------------------------------------
  997.  
  998.      This command will allow you to resume a  database which was previously
  999.      saved using  the /FS  (File/Save Database)  command. It  works exactly
  1000.      like  the /FL  (File/Load)  command, except  that  the list  of  files
  1001.      displayed will have  an extension of ".SAV"  instead of ".Q&A".  If no
  1002.      database file has been saved, "[none]" will be displayed.
  1003.  
  1004.      When  this command  is  used, the  previous state  of the  database is
  1005.      restored. The question that was on the screen will be redisplayed, and
  1006.      the scoring window will reflect the previous state of the database.
  1007.  
  1008.      Note that  once you have completed  a quiz or test  database, any .SAV
  1009.      file  in the directory from  which the database  was originally loaded
  1010.      will be erased. You cannot, therefore, resume a completed database.
  1011.  
  1012.  
  1013.  
  1014.  
  1015.      
  1016.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 13
  1017.      
  1018.  
  1019.  
  1020.  
  1021.  
  1022.      Q&A Study Aid V3.80 User's Guide
  1023.      
  1024.  
  1025.      /FE - Set Screen Colors
  1026.      -----------------------
  1027.  
  1028.      This command  is used to modify  the screen colors. The  function keys
  1029.      are used to change the colors, and a function-key map is displayed for
  1030.      reference  purposes. A simulated menu is also displayed, which changes
  1031.      to display the effect of the color selections you make.
  1032.  
  1033.      You may set the foreground and background colors for up to four screen
  1034.      areas.  Each function  key cycles  through each  of 16  possible color
  1035.      values (16 foreground and 16 background).
  1036.  
  1037.      Once you have set the  colors as you wish, press ENTER to save the new
  1038.      colors in the configuration file, or ESCape to cancel the changes. For
  1039.      the  full effect of  the changes to  be seen, you must  quit Q&ASA and
  1040.      then restart it so that it will redraw all screens using the new color
  1041.      set.
  1042.  
  1043.  
  1044.      /FM - Set Menu Selector Character
  1045.      ---------------------------------
  1046.  
  1047.      Q&ASA uses  one character to escape  (out of an answer  prompt if dis-
  1048.      played)  and  into the  menu system.  This  character defaults  to the
  1049.      forward  slash ('/'), but you may change  it to any character you wish
  1050.      in the printable  ASCII range of '!' through '~',  inclusive. Once you
  1051.      change it, it is saved in the configuration file and will therefore be
  1052.      set each time you start Q&ASA. If you change  your mind, you can reset
  1053.      the character  or press ESCape to  cancel the command if  you have not
  1054.      yet pressed the ENTER key.
  1055.  
  1056.  
  1057.      /FX - Exit to DOS
  1058.      -----------------
  1059.  
  1060.      Use this  command to quit  a Q&ASA session  and return to DOS.  If you
  1061.      have loaded a database but have  not answered all questions, the score
  1062.      file will be  updated with your current score and  a notation that you
  1063.      quit Q&ASA.  You cannot exit Q&ASA, clear  the database, or reload the
  1064.      current  or new database without  updating your score  file. This pre-
  1065.      vents extending time limits and/or starting a quiz over again.
  1066.  
  1067.      Also, when you  quit a  Q&ASA session  using this  command, any  saved
  1068.      database file of the same name is erased from disk, preventing resump-
  1069.      tion  if the database  had been previously  saved. As a  general rule,
  1070.      whenever your final score is displayed (and optionally, the score file
  1071.      is updated), or whenever  you load a database using the /FL (File/Load
  1072.      Database) command, any associated .SAV file will be erased.
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.      
  1080.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 14
  1081.      
  1082.  
  1083.  
  1084.  
  1085.  
  1086.      Q&A Study Aid V3.80 User's Guide
  1087.      
  1088.  
  1089.      Note:     Pressing Control-C or Control-Break  is interpreted the same
  1090.                as /FX without the RETURN. Simply press RETURN to update the
  1091.                score file and return to DOS.
  1092.  
  1093.  
  1094.      /MS - Sequential Mode
  1095.      ---------------------
  1096.  
  1097.      The sequential  mode option tells  Q&ASA that  you wish to  answer the
  1098.      questions in the same order as they appear in the  database file. When
  1099.      selected, the new mode will appear in the scoring  window. This option
  1100.      does NOT  cause Q&ASA to start reading from the beginning of the file;
  1101.      it  simply changes  the method  used to  determine the  next question.
  1102.      Sequential  mode reads the questions  from the database  in a circular
  1103.      fashion  until all questions have been answered. This allows switching
  1104.      between modes.
  1105.  
  1106.      When  all questions have been answered, Q&ASA will update the optional
  1107.      score file and display the final score.
  1108.  
  1109.      Note that  this command may  be locked out  by an option  given in the
  1110.      database definition file. If this is the case, the command will simply
  1111.      be ignored. No warning  will be given  indicating that the command  is
  1112.      locked out.
  1113.  
  1114.  
  1115.      /MR - Pseudorandom Mode
  1116.      -----------------------
  1117.  
  1118.      This  mode is  used when  you want  Q&ASA to  choose the  questions at
  1119.      random.  The random number generator  is seeded on  each invocation of
  1120.      Q&ASA by using the PC's clock to insure that the pseudorandom sequence
  1121.      is different each time the program is run.
  1122.  
  1123.      In this mode,  Q&ASA will select the next question  at random from the
  1124.      set  of unanswered questions. It  will not, therefore,  ask a question
  1125.      again once it has been answered.
  1126.  
  1127.      When  all questions have been answered, Q&ASA will update the optional
  1128.      score file and display the final score.
  1129.  
  1130.      Note that this  command may be  locked out by  an option given  in the
  1131.      database definition file. If this is the case, the command will simply
  1132.      be ignored.  No warning will  be given indicating that  the command is
  1133.      locked out.
  1134.  
  1135.  
  1136.      /MC - Clear
  1137.      -----------
  1138.  
  1139.      Use the Clear option to reset your score back to zero and to reset the
  1140.      question index back to the beginning  of the file. The question  index
  1141.      is cleared only here and when the database is initially loaded.
  1142.  
  1143.      
  1144.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 15
  1145.      
  1146.  
  1147.  
  1148.  
  1149.  
  1150.      Q&A Study Aid V3.80 User's Guide
  1151.      
  1152.  
  1153.      Note that  this command may be  locked out by  an option given  in the
  1154.      database definition file. If this is the case, the command will simply
  1155.      be ignored. No warning  will be given indicating  that the command  is
  1156.      locked out.
  1157.  
  1158.  
  1159.      /N - Name
  1160.      ---------
  1161.  
  1162.      This  command is  used to enter  your name,  which is  placed into the
  1163.      score file  and also displayed  when the quiz session  is completed or
  1164.      otherwise terminated.
  1165.  
  1166.      When this command is given, a data entry window will pop up and prompt
  1167.      for  your name and/or any other identifying information. You may enter
  1168.      up to 35 characters.
  1169.  
  1170.      If you  have not given your  name when the session  is terminated, and
  1171.      the  optional score logging feature has been enabled, Q&ASA will force
  1172.      you  to enter  it before  you  will be  permitted to  enter any  other
  1173.      command.
  1174.  
  1175.  
  1176.      Scoring Window
  1177.      --------------
  1178.  
  1179.      The  scoring window always  shows the  current state  of both  you and
  1180.      Q&ASA.  The  items that  appear in  the  scoring window  are described
  1181.      below.
  1182.  
  1183.           Time Left      This shows the time  remaining to answer all ques-
  1184.                          tions in the database. It will be blank  until you
  1185.                          load a database with the /FS command. If the data-
  1186.                          base has a time limit associated with it, you will
  1187.                          see this time  counting down to zero.  At zero, it
  1188.                          will change to 'Time Out'. If the  database has no
  1189.                          time limit, this will be displayed as 'No Limit'.
  1190.  
  1191.           Mode           This  is the  current question-indexing  mode, and
  1192.                          will  be  "Random" or  "Sequential".  Q&ASA always
  1193.                          starts up in sequential mode.
  1194.  
  1195.           Questions      When a  database has  been loaded,  this specifies
  1196.                          the total number of questions in the database.
  1197.  
  1198.           Answered       Tells the  number of  questions that you  have an-
  1199.                          swered. When it equals  the number of questions in
  1200.                          the database, your final score will be displayed.
  1201.  
  1202.           Correct        This  is the  number  of questions  that you  have
  1203.                          answered correctly.
  1204.  
  1205.  
  1206.  
  1207.      
  1208.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 16
  1209.      
  1210.  
  1211.  
  1212.  
  1213.  
  1214.      Q&A Study Aid V3.80 User's Guide
  1215.      
  1216.  
  1217.           Score          Your score  is a  simple  ratio of  the number  of
  1218.                          possible points to the number you have been award-
  1219.                          ed, and is displayed in percent.
  1220.  
  1221.  
  1222.      Answering Questions
  1223.      -------------------
  1224.  
  1225.      Q&ASA does  not require  you to  answer questions  in the  order Q&ASA
  1226.      presents them (as defined by the mode).  Q&ASA will determine the next
  1227.      question using  the mode you  select, but  once the  question is  dis-
  1228.      played, you may elect to skip it  (intending to come back to it later)
  1229.      and  let Q&ASA  present the  next one.  Q&ASA  will remember  that the
  1230.      question was skipped and  display it again at some later time, depend-
  1231.      ing upon the mode you have selected.
  1232.  
  1233.      Skipping a question  is done simply  by pressing the  ESCape key  when
  1234.      Q&ASA  prompts for  an answer.  The question will  not be  scored, but
  1235.      Q&ASA will present it again after you have answered all of the remain-
  1236.      ing questions (sequential mode) or at  any time (random mode). You may
  1237.      not omit a  question, but you may  essentially scan through the  ques-
  1238.      tions and answer them in the order you choose.
  1239.  
  1240.      If you choose to answer  a question, you must enter a  response. Q&ASA
  1241.      will not accept a blank answer.
  1242.  
  1243.      Q&ASA will  always display the number of points you will be awarded if
  1244.      you answer correctly at the right of the answer window.  The number of
  1245.      points displayed  is the ratio  of the total  number of points  to the
  1246.      weight of the question in points, as defined in the compiled database.
  1247.      If you answer incorrectly, you are awarded zero points.
  1248.  
  1249.      You may also enter  a command any time  you are being prompted  for an
  1250.      answer.
  1251.  
  1252.  
  1253.      Creating a Database
  1254.      -------------------
  1255.  
  1256.      The  database is the heart  of Q&ASA. Q&ASA  receives virtually all of
  1257.      the information it  needs to present and  score your answers  from the
  1258.      database.
  1259.  
  1260.      The database is  created from a plain ASCII, or  'flat' file, and then
  1261.      compiled using the database compiler Q&AC. The input given to Q&AC  is
  1262.      called the  database definition file; the  output of Q&AC  is the com-
  1263.      piled  database. Q&AC creates and destroys one intermediate file as it
  1264.      compiles the database definition file.
  1265.  
  1266.      Q&AC supports  a large number of  options that may be  used to control
  1267.      the quiz session. Each option is specified using a keyword followed by
  1268.      zero or more lines of text. It is important to  remember that keywords
  1269.      must be on a line by themselves with no other text.
  1270.  
  1271.      
  1272.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 17
  1273.      
  1274.  
  1275.  
  1276.  
  1277.  
  1278.      Q&A Study Aid V3.80 User's Guide
  1279.      
  1280.  
  1281.      If you use a word processor program to create the database  definition
  1282.      file, be  sure to use its  'nondocument' mode to insure  that it won't
  1283.      put in any formatting  codes. A plain ASCII text editor is recommended
  1284.      (EDLIN, which is included with PC-DOS, is one such editor).
  1285.  
  1286.      To enable Q&ASA  to handle all  of the common question  formats except
  1287.      'essay'  questions, a very general  database arrangement is used. Q&AC
  1288.      expects each question to be followed  by the correct answer, which  it
  1289.      uses to check the answer typed in by the user.
  1290.  
  1291.      Q&ASA  can handle  multiple-choice, true/false,  and fill-in-the-blank
  1292.      questions with equal ease.
  1293.  
  1294.      The database must  contain one  instance of each  of two keywords  for
  1295.      each question in the database. These keywords are, exactly, in quotes:
  1296.  
  1297.           "Q="
  1298.           "A="
  1299.  
  1300.      As  you might  expect, these  stand for  "question" and  "answer". The
  1301.      question MUST precede the answer. Q&AC will complain about any irregu-
  1302.      larities  it finds  in the  database when  it constructs  the compiled
  1303.      database file.
  1304.  
  1305.      The following is  a simple example  of a question  and answer as  they
  1306.      might  appear in the database definition file. It is a multiple-choice
  1307.      question. The following text is  entered into the database  definition
  1308.      file:
  1309.  
  1310.      Q=
  1311.      Multiple-choice:
  1312.  
  1313.      What is the capital of Pennsylvania?
  1314.      A. Philadelphia
  1315.      B. Washington, D.C.
  1316.      C. Harrisburg
  1317.      D. None of the above
  1318.  
  1319.      A=
  1320.      C
  1321.  
  1322.      Q&ASA  will display  the question  beginning  on the  line immediately
  1323.      following  the 'Q='  line. The end  of the  question is  marked by the
  1324.      'A='. All lines between  these markers form the question,  which Q&ASA
  1325.      will display exactly as  it appears in  the database. You may,  there-
  1326.      fore, format your questions any  way that you wish. Q&ASA  will impose
  1327.      NO restrictions other than the number of rows and columns; you may use
  1328.      up to 15 lines of 76 characters. If the question contains more than 15
  1329.      lines, the extra lines will be discarded. Blank  lines between the end
  1330.      of the actual question and the 'A=' line are effectively discarded and
  1331.      do not count against the 15 lines allowed.
  1332.  
  1333.  
  1334.  
  1335.      
  1336.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 18
  1337.      
  1338.  
  1339.  
  1340.  
  1341.  
  1342.      Q&A Study Aid V3.80 User's Guide
  1343.      
  1344.  
  1345.      Note  that  the 'Multiple-choice'  prompt is  actually  a part  of the
  1346.      database -NOT hard-coded into Q&ASA.  You may include this as  part of
  1347.      your database or omit it if you wish.
  1348.  
  1349.      The answer follows beginning  on the line immediately after  the 'A='.
  1350.      In this example, it is 'C'. All this means is that Q&ASA will score as
  1351.      correct any response to the question that is exactly 'C' OR 'c' - case
  1352.      is insignificant. Q&ASA does some preformatting of these strings prior
  1353.      to the  comparison, however. Both the  answer in the database  and the
  1354.      answer typed in by you are processed the same way:
  1355.  
  1356.           1.   All leading whitespace is removed. This means that
  1357.                     C
  1358.                and
  1359.                               C
  1360.                are  equivalent and are themselves  equivalent to the 'C' in
  1361.                the example above.
  1362.  
  1363.           2.   All  trailing whitespace,  including newline  characters, is
  1364.                removed.
  1365.  
  1366.           3.   All whitespace (blanks and  tabs) between words is collapsed
  1367.                to a single space;
  1368.                     "hello there"
  1369.                and
  1370.                     "hello         there"
  1371.                are equivalent.
  1372.  
  1373.           4.   All characters  are folded to uppercase; 'Yes' and 'yes' are
  1374.                therefore equivalent.
  1375.  
  1376.      These steps insure that a response will not be scored as incorrect due
  1377.      to the position of any  part of the response in either  your answer or
  1378.      that in the database.
  1379.  
  1380.      Note  that these  same rules  are also  applied to  the 'Q='  and 'A='
  1381.      markers. They may, therefore, appear anywhere on the line. You cannot,
  1382.      however, insert anything between 'Q' and '=', nor can you put anything
  1383.      else on the line with the marker.
  1384.  
  1385.      In  the  example above,  one correct  answer  was specified.  The only
  1386.      answer that  could be scored as  correct is 'C' (and  'c', of course).
  1387.      Note that we  could just as  well have used  numbers as selectors  and
  1388.      given '3'  as the answer.  Q&ASA makes  no attempt  to interpret  this
  1389.      information; it simply looks for an exact match based on the  criteria
  1390.      outlined above.
  1391.  
  1392.      This next example will demonstrate a true/false question.
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.      
  1400.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 19
  1401.      
  1402.  
  1403.  
  1404.  
  1405.  
  1406.      Q&A Study Aid V3.80 User's Guide
  1407.      
  1408.  
  1409.      Q=
  1410.  
  1411.  
  1412.  
  1413.                Answer true or false:
  1414.  
  1415.                Q&ASA understands the information in the database.
  1416.                     A=
  1417.      False
  1418.  
  1419.      Note the (valid) position of the  'A='. This time we have indented the
  1420.      question using tabs. When  Q&AC compiles the question, it  expands the
  1421.      tabs automatically (using 8-column  tab stops) to maintain  the align-
  1422.      ment as  it is  in the  database definition file.  We also  have three
  1423.      blank lines  after the 'Q=';  this serves  to shift the  question down
  1424.      toward the center of the question window to make it look nicer.
  1425.  
  1426.      This  example is  not  good practice  (although  it will  be  compiled
  1427.      correctly), since the 'A=' would be easy to miss if  the database were
  1428.      edited,  and the indentation is inconsistent. It does, however, have a
  1429.      more serious drawback:  to get the  question right,  you must type  in
  1430.      'false', all 5 characters - and 'false' is one word I just cannot type
  1431.      (it always comes out 'flase')!
  1432.  
  1433.      For a true/false question,  one would be likely  to respond with  'T',
  1434.      'F', 'yes',  'y', 'no', 'n', or  possibly '1' and '0'.  To accommodate
  1435.      these options, Q&ASA  allows more  than one correct  answer. In  fact,
  1436.      every nonblank line following 'A=' is treated as a correct answer. The
  1437.      second example above, then, would be more appropriately given by
  1438.  
  1439.      Q=
  1440.  
  1441.  
  1442.  
  1443.                Answer true or false:
  1444.  
  1445.                Q&ASA understands the information in the database.
  1446.  
  1447.      A=
  1448.      False
  1449.      F
  1450.      No
  1451.      N
  1452.      0
  1453.  
  1454.      This permits any of the five answers to be regarded as correct.
  1455.  
  1456.      If you give an incorrect response to a question (e.g., one that is not
  1457.      among the list  of correct  answers), Q&ASA will  display the  correct
  1458.      answer for  you, as well as  omit one or more points  from your score.
  1459.      When Q&ASA displays the correct answer, it uses the first one given in
  1460.      the answer list. What this means is that Q&ASA will display
  1461.  
  1462.  
  1463.      
  1464.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 20
  1465.      
  1466.  
  1467.  
  1468.  
  1469.  
  1470.      Q&A Study Aid V3.80 User's Guide
  1471.      
  1472.  
  1473.                         Incorrect. The correct answer is
  1474.                                       False
  1475.                            Press any key to continue.
  1476.  
  1477.  
  1478.      which is more professional than 'N', for example.
  1479.  
  1480.      This  feature adds  a lot  of  versatility to  Q&ASA.  Since Q&ASA  is
  1481.      intended  to be  a  study aid  as well  as  a general-purpose  testing
  1482.      program,  it  should provide  reinforcement  of  incorrect answers  by
  1483.      permitting a  more complete correct answer. To demonstrate this, we'll
  1484.      use a third example; this time, a fill-in-the-blank question:
  1485.  
  1486.      Q=
  1487.           The speed of light is ______ km/sec.
  1488.  
  1489.      A=
  1490.           Light travels at 300,000 km/sec.
  1491.           300000
  1492.           300,000
  1493.           300K
  1494.  
  1495.      In this example, an incorrect response will elicit
  1496.  
  1497.                         Incorrect. The correct answer is
  1498.                         Light travels at 300,000 km/sec.
  1499.                            Press any key to continue.
  1500.  
  1501.      Of course, this is  also a correct answer in itself, but  not a likely
  1502.      one. If  you do  enter it, it  will be scored  as correct.  You would,
  1503.      however, be required to include the  comma, the slash between 'km' and
  1504.      'sec', and the period.
  1505.  
  1506.      There are  three  more  plausible correct  answers  that  Q&ASA  would
  1507.      consider to  be correct. Any one  of them is sufficient  to credit the
  1508.      answer to you.
  1509.  
  1510.      Note that the display of the correct answer  may be disabled beginning
  1511.      with Version 3.0 of Q&ASA.  This is done by issuing the  'D=' (Display
  1512.      Off) command in the database. This a global command and  will turn off
  1513.      the display of  all answers, no matter where you  place the command in
  1514.      the database definition file.
  1515.  
  1516.      When creating a large database definition file, it is annoying to have
  1517.      to type the four or  more common answers to a true/false  question. To
  1518.      make  this easier, Q&AC supports simple macros.  A macro is a block of
  1519.      text that is inserted in place of a macro identifier. We may therefore
  1520.      create a  macro for 'true' and a macro  for 'false', and use the macro
  1521.      identifier instead of typing all four answer lines. These macros would
  1522.      look something like the example on the following page.
  1523.  
  1524.  
  1525.  
  1526.  
  1527.      
  1528.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 21
  1529.      
  1530.  
  1531.  
  1532.  
  1533.  
  1534.      Q&A Study Aid V3.80 User's Guide
  1535.      
  1536.  
  1537.      M=
  1538.      $TRUE$
  1539.      true
  1540.      t
  1541.      yes
  1542.      y
  1543.  
  1544.      M=
  1545.      $FALSE$
  1546.      false
  1547.      f
  1548.      no
  1549.      n
  1550.  
  1551.  
  1552.  
  1553.      Q=
  1554.  
  1555.                Answer true or false:
  1556.  
  1557.                Q&ASA understands the information in the database.
  1558.  
  1559.      A=
  1560.      $FALSE$
  1561.  
  1562.      The "M=" is the macro keyword, and tells Q&AC that the following lines
  1563.      form a macro definition. The first line following the macro keyword is
  1564.      the  macro identifier.  You may use  any character  string as  a macro
  1565.      identifier,  provided it does not  contain blanks or  tabs. The dollar
  1566.      signs are  not necessary,  but serve nicely  to identify $FALSE$  as a
  1567.      macro invocation. When Q&AC  reads the identifier, it  will substitute
  1568.      all lines following the macro identifier up to the first blank line or
  1569.      keyword,  whichever  is found  first.  Note  that  Q&ASA will  display
  1570.      "false" as the correct answer if the question is answered incorrectly,
  1571.      as it  is the first answer in the  answer list formed by expanding the
  1572.      macro.
  1573.  
  1574.      The  above is a short  introduction to creating  a database definition
  1575.      file. The following section describes the Q&AC compiler in detail.
  1576.  
  1577.  
  1578.      The Q&AC Database Compiler
  1579.      --------------------------
  1580.  
  1581.      Q&AC is a  separate program that is used only when a database is first
  1582.      created. Once the  database definition  file has been  created, it  is
  1583.      compiled  with  Q&AC, and  the compiled  database  file (which  has an
  1584.      extension of .Q&A)  is distributed to the users of  the Q&ASA program.
  1585.      This offers several advantages, among them:
  1586.  
  1587.           1.   The  database is encrypted. A  user of Q&ASA  cannot look in
  1588.                the file  using any  viewing, listing, or  debugging program
  1589.  
  1590.  
  1591.      
  1592.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 22
  1593.      
  1594.  
  1595.  
  1596.  
  1597.  
  1598.      Q&A Study Aid V3.80 User's Guide
  1599.      
  1600.  
  1601.                and  see  the questions  and  answers. Q&ASA  knows  the en-
  1602.                cryption method and decrypts the database as it reads it.
  1603.  
  1604.           2.   The author of  the database  definition file  may specify  a
  1605.                number of options to control the quiz session. These options
  1606.                cannot be seen or modified by the user of Q&ASA.
  1607.  
  1608.           3.   Since the  database has  been preprocessed by  Q&AC, loading
  1609.                and display of questions is faster and error-free. It is not
  1610.                necessary to perform any formatting at run time.
  1611.  
  1612.  
  1613.      Using Q&AC
  1614.      ----------
  1615.  
  1616.      Q&AC has a simple invocation syntax, as follows:
  1617.  
  1618.           Q&AC <database definition filename> <ENTER>
  1619.  
  1620.      There are no other command-line parameters or options.
  1621.  
  1622.      Q&AC expects you to use an extension of .DEF for  the database defini-
  1623.      tion file. If you use this extension,  you do not have to type it.  If
  1624.      you use any other extension, you must specify the entire filename. For
  1625.      example, the sample  database definition file is called SAMPLE.DEF. To
  1626.      compile it, type
  1627.  
  1628.           Q&AC SAMPLE <ENTER>
  1629.  
  1630.      If the  database definition file  were named SAMPLE.TXT,  however, you
  1631.      would be required to type
  1632.  
  1633.           Q&AC SAMPLE.TXT <ENTER>
  1634.  
  1635.      If you  give the database definition  file an extension  of .Q&A, Q&AC
  1636.      will  reject it, as this  extension is reserved  for compiled database
  1637.      files. The  reason this  extension is  reserved is  so that  Q&ASA may
  1638.      filter  the  files in  the directory  when  it displays  the available
  1639.      databases.
  1640.  
  1641.      Q&AC will not make any changes  to the database definition file  (your
  1642.      'source' file).  It will create a  compiled database file of  the same
  1643.      base  name, but with an extension of  .Q&A. In the examples above, the
  1644.      compiled database files would all be named SAMPLE.Q&A. If the compiled
  1645.      database  file  already exists,  it is  overwritten  by Q&AC,  and the
  1646.      original contents will be lost. Q&AC will NOT warn you of this.
  1647.  
  1648.      When Q&AC is finished, it will display the options you selected in the
  1649.      definition file. The output below was produced by compiling the sample
  1650.      database SAMPLE.DEF.
  1651.  
  1652.  
  1653.  
  1654.  
  1655.      
  1656.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 23
  1657.      
  1658.  
  1659.  
  1660.  
  1661.  
  1662.      Q&A Study Aid V3.80 User's Guide
  1663.      
  1664.  
  1665.      Q&A Study Aid Database Compiler Version 3.80 (SHAREWARE)
  1666.      Copyright (C) 1988, 1989 Quid Pro Quo Software. All rights reserved.
  1667.  
  1668.      File SAMPLE.DEF compiled to file SAMPLE.Q&A
  1669.  
  1670.      Configuration
  1671.  
  1672.           Name ............... "Q&ASA Sample Database"
  1673.           Total weight ....... 29
  1674.           Score filename ..... "q&a.scr"
  1675.           Time limit ......... 00:10:00
  1676.           Mode lock .......... (none)
  1677.           Clear command ...... Enabled
  1678.           Answer Display ..... Enabled
  1679.  
  1680.      Macros
  1681.  
  1682.           $FALSE$
  1683.           $TRUE$
  1684.  
  1685.      367 Source lines
  1686.      20 Questions
  1687.  
  1688.  
  1689.      Q&AC Language Syntax
  1690.      --------------------
  1691.  
  1692.      Q&AC,  being a true compiler, requires that you follow certain syntac-
  1693.      tical rules when creating  a database definition file. The  syntax was
  1694.      made  as simple  and forgiving  as possible  to minimize  the learning
  1695.      time.
  1696.  
  1697.      The  Q&AC language is line-oriented, meaning that Q&AC views its input
  1698.      in  terms of  whole lines.  You  may not,  therefore, put  two keyword
  1699.      markers on the same line, for example.
  1700.  
  1701.      The following is a short summary of the keywords that Q&AC uses.
  1702.  
  1703.           Q=   Question text
  1704.           A=   Answer list
  1705.           N=   quiz Name
  1706.           M=   Macro definition
  1707.           T=   Time limit
  1708.           C=   Clear not allowed
  1709.           S=   lock in Sequential mode
  1710.           R=   lock in Random mode
  1711.           F=   output score Filename
  1712.           E=   Encrypt score file
  1713.           W=   assign Weighting
  1714.           D=   disable Display of incorrect answers
  1715.  
  1716.      Each of these keywords is described in the following paragraphs.
  1717.  
  1718.  
  1719.      
  1720.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 24
  1721.      
  1722.  
  1723.  
  1724.  
  1725.  
  1726.      Q&A Study Aid V3.80 User's Guide
  1727.      
  1728.  
  1729.      Q&AC scans and discards all text in the database definition file  that
  1730.      is  not part  of a  keyword interpretation.  This  means that  you may
  1731.      insert comments almost anywhere,  without using special comment delim-
  1732.      iters. Since  Q&AC is line-oriented, you  may not, of course,  place a
  1733.      comment  on the same  line with  any keyword  or its  associated text.
  1734.      Comments are  otherwise unrestricted.  The sample database  definition
  1735.      file SAMPLE.DEF provides many examples of the use of comments.
  1736.  
  1737.  
  1738.      The Q= and A= Keywords
  1739.      ----------------------
  1740.  
  1741.      As mentioned previously, Q= and A= are the keywords for 'question' and
  1742.      'answer', respectively. Each has the same basic syntax:
  1743.  
  1744.      Q= (or A=)
  1745.      <text>
  1746.      <text>
  1747.       ....
  1748.      <text>
  1749.      <termination>
  1750.  
  1751.      For all Q&AC  keywords that take multiple lines  of text as arguments,
  1752.      with the  single exception of the Q= keyword, the <termination> is the
  1753.      same:  a blank line, another keyword, or end-of-file. In this context,
  1754.      a blank  line is  any line that  contains zero  or more  space or  tab
  1755.      characters only.  For the Q= keyword,  a blank line is  NOT a termina-
  1756.      tion; only the  'A=' keyword terminates  a question. This is  to allow
  1757.      blank lines  in the question  text. You must  be careful not  to place
  1758.      comment  lines between  the Q=  and A=  keywords, since these  will be
  1759.      regarded as part of the question and displayed on the Q&ASA screen.
  1760.  
  1761.      A question may not have more than 15 lines of text associated with it,
  1762.      and you are limited to 76 characters per line. Within this rectangular
  1763.      boundary,  you are unrestricted. If  you exceed the  allowed number of
  1764.      lines  or if a  line contains more  than 76 characters  (after tab and
  1765.      macro expansion), Q&AC will display an error message and stop.
  1766.  
  1767.      You  are permitted  any number of  answer lines,  limited only  by the
  1768.      amount of memory available in the PC running Q&ASA. If the PC has 128K
  1769.      bytes or  more of  available memory  (free memory  above  DOS and  all
  1770.      TSRs), you are essentially unrestricted.
  1771.  
  1772.  
  1773.      The N= Keyword
  1774.      --------------
  1775.  
  1776.      The N= keyword is used  to specify the quiz name. The name must appear
  1777.      on the line following the keyword, and  may be up to 70 characters  in
  1778.      length. When  the database is loaded into  Q&ASA, this name appears in
  1779.      the top border of the center (question) window.
  1780.  
  1781.      For example, to name a quiz on American history as such, you would use
  1782.  
  1783.      
  1784.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 25
  1785.      
  1786.  
  1787.  
  1788.  
  1789.  
  1790.      Q&A Study Aid V3.80 User's Guide
  1791.      
  1792.  
  1793.      N=
  1794.      American History Quiz
  1795.  
  1796.  
  1797.      The M= Keyword
  1798.      --------------
  1799.  
  1800.      The M= keyword  is the macro definition keyword, and indicates to Q&AC
  1801.      that  the following lines are a macro definition. The macro definition
  1802.      takes the following form:
  1803.  
  1804.      M=
  1805.      <macro identifier>
  1806.      <first macro line>
  1807.      <second macro line>
  1808.       ..............
  1809.      <Nth macro line>
  1810.      <termination>
  1811.  
  1812.      Macros  are expanded recursively, so if you place the macro identifier
  1813.      in any of the macro definition lines,  you will create a self-referen-
  1814.      tial macro that will  be expanded endlessly. The recursion  is allowed
  1815.      so that you may build complex macros from simple ones if you wish.
  1816.  
  1817.      For example,  to build a macro  for 'TRUE' from two  other macros, you
  1818.      could use:
  1819.  
  1820.      M=
  1821.      $T$
  1822.      True
  1823.      T
  1824.      M=
  1825.      $Y$
  1826.      Yes
  1827.      Y
  1828.      M=
  1829.      $TRUE$
  1830.      $T$
  1831.      $Y$
  1832.  
  1833.      We  have defined  three macros,  "$T$", "$Y$",  and "$TRUE$".  If Q&AC
  1834.      encounters  $TRUE$ in the database definition file, it will replace it
  1835.      with
  1836.  
  1837.      True
  1838.      T
  1839.      Yes
  1840.      Y
  1841.  
  1842.      because "True"  and "T" are  expansions of $T$  and "Yes" and  "Y" are
  1843.      expansions of $Y$. Note  that blank lines are unnecessary  between the
  1844.      macro definitions, since each is terminated  by the M= keyword of  the
  1845.      following macro.
  1846.  
  1847.      
  1848.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 26
  1849.      
  1850.  
  1851.  
  1852.  
  1853.  
  1854.      Q&A Study Aid V3.80 User's Guide
  1855.      
  1856.  
  1857.      You may use  a macro  identifier anywhere in  the database  definition
  1858.      file  except within  its  own definition,  as  has been  pointed  out.
  1859.      However,  macro  invocations MUST  be  surrounded  by whitespace.  For
  1860.      example,  many  multiple-choice questions  use  the blanket  selectors
  1861.      "none of the above" and "all of the above". You may  therefore use the
  1862.      following macros:
  1863.  
  1864.      M=
  1865.      $NONE$
  1866.      None of the above.
  1867.      M=
  1868.      $ALL$
  1869.      All of the above.
  1870.  
  1871.      and write a multiple-choice question as:
  1872.  
  1873.      Q=
  1874.      Multiple-choice:
  1875.  
  1876.      In what year did Christopher Columbus land in the New World?
  1877.  
  1878.           1. 1592
  1879.           2. 1492
  1880.           3. 1066
  1881.           4. $NONE$
  1882.           5. $ALL$
  1883.  
  1884.      A=
  1885.      2. 1492
  1886.      2
  1887.      1492
  1888.  
  1889.      Q&AC will expand this to:
  1890.  
  1891.      Q=
  1892.      Multiple-choice:
  1893.  
  1894.      In what year did Christopher Columbus land in the New World?
  1895.  
  1896.           1. 1592
  1897.           2. 1492
  1898.           3. 1066
  1899.           4. None of the above.
  1900.           5. All of the above.
  1901.  
  1902.      A=
  1903.      2. 1492
  1904.      2
  1905.      1492
  1906.  
  1907.      Remember that Q&AC is line-oriented, however. If you put the following
  1908.      in the database definition file:
  1909.  
  1910.  
  1911.      
  1912.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 27
  1913.      
  1914.  
  1915.  
  1916.  
  1917.  
  1918.      Q&A Study Aid V3.80 User's Guide
  1919.      
  1920.  
  1921.      M=
  1922.      $NW$
  1923.      New World
  1924.  
  1925.      Q=
  1926.      Multiple-choice:
  1927.  
  1928.      In what year did Christopher Columbus land in the $NW$?
  1929.  
  1930.           1. 1592
  1931.           2. 1492
  1932.           3. 1066
  1933.           4. None of the above.
  1934.           5. All of the above.
  1935.  
  1936.      Q&AC  will NOT expand  it because there is  no whitespace between $NW$
  1937.      and the '?'. If, however, you use
  1938.  
  1939.      M=
  1940.      $NW$
  1941.      New World
  1942.  
  1943.      Q=
  1944.      Multiple-choice:
  1945.  
  1946.      In what year did Christopher Columbus land in the $NW$ ?
  1947.  
  1948.           1. 1592
  1949.           2. 1492
  1950.           3. 1066
  1951.           4. None of the above.
  1952.           5. All of the above.
  1953.  
  1954.      Q&AC will expand it to
  1955.  
  1956.      Q=
  1957.      Multiple-choice:
  1958.  
  1959.      In what year did Christopher Columbus land in the New World
  1960.       ?
  1961.           1. 1592
  1962.           2. 1492
  1963.           3. 1066
  1964.           4. None of the above.
  1965.           5. All of the above.
  1966.  
  1967.      because the  macro expansion  includes the  newline.  You should  not,
  1968.      therefore, attempt to use a macro in the middle of a block of text.
  1969.  
  1970.      Macros must be defined before  they can be used. If you place  a macro
  1971.      definition in the middle  of the database definition file  and use the
  1972.      macro identifier before and after it, then the identifiers that appear
  1973.  
  1974.  
  1975.      
  1976.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 28
  1977.      
  1978.  
  1979.  
  1980.  
  1981.  
  1982.      Q&A Study Aid V3.80 User's Guide
  1983.      
  1984.  
  1985.      before the macro  definition will NOT be expanded.  Define all of your
  1986.      macros before entering the first question.
  1987.  
  1988.  
  1989.      The T= Keyword
  1990.      --------------
  1991.  
  1992.      This is the  time limit keyword. Include it in the database definition
  1993.      file  to specify  a time  limit. If  you omit  it, the  time  limit is
  1994.      infinite.
  1995.  
  1996.      The syntax is as follows:
  1997.  
  1998.      T=
  1999.      HH:MM:SS
  2000.  
  2001.      where HH is hours, MM is minutes, and SS is seconds. If the time limit
  2002.      is less than an hour, you may omit the hours field;  similarly, if the
  2003.      time limit is less than a  minute, you may omit the hours and  minutes
  2004.      fields.  The  sample database  definition  file  contains a  10-minute
  2005.      timeout, given by
  2006.  
  2007.      T=
  2008.      10:00
  2009.  
  2010.      Note:     If you specify a time limit  for a database, the /FS (File/-
  2011.                Save Database)  command will be disabled.  A user attempting
  2012.                to use this command  will receive an error message,  and the
  2013.                command will be ignored.
  2014.  
  2015.  
  2016.      The C= Keyword
  2017.      --------------
  2018.  
  2019.      This  keyword  is used  to disable  the  Clear command.  An individual
  2020.      taking a quiz with Q&ASA can use the Clear command  to reset the score
  2021.      and essentially do the quiz twice.  The author of the database defini-
  2022.      tion file may prevent this by entering
  2023.  
  2024.      C=
  2025.  
  2026.      in the database definition file. When  this is done, Q&ASA will ignore
  2027.      the Clear command completely.
  2028.  
  2029.      Note  that if  the Clear  command is  allowed, by  omission of  the C=
  2030.      keyword, and  the score file is enabled with the F= keyword (described
  2031.      later), then a score record will be written to the score file indicat-
  2032.      ing that the user cleared the score and restarted the quiz.
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.      
  2040.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 29
  2041.      
  2042.  
  2043.  
  2044.  
  2045.  
  2046.      Q&A Study Aid V3.80 User's Guide
  2047.      
  2048.  
  2049.      The S= and R= Keywords
  2050.      ----------------------
  2051.  
  2052.      These are the mode lock keywords, where S= stands for "sequential" and
  2053.      R=  stands for  "random".  These keywords  are  mutually exclusive;  a
  2054.      database  definition may  not contain  both keywords.  If it  does, an
  2055.      error will be generated by Q&AC and compilation will stop.
  2056.  
  2057.      These  keywords are used  to lock Q&ASA  in the mode  specified by the
  2058.      keyword. If you do not give either keyword, then the  user of Q&ASA is
  2059.      free to use the Mode command to change modes.
  2060.  
  2061.      For example, to lock Q&ASA in sequential mode, use the following:
  2062.  
  2063.      S=
  2064.  
  2065.      and to lock Q&ASA in random mode:
  2066.  
  2067.      R=
  2068.  
  2069.      There are no other arguments. The lock remains in effect until another
  2070.      database is loaded (which may also be locked).
  2071.  
  2072.  
  2073.      The F= Keyword
  2074.      --------------
  2075.  
  2076.      The F=  keyword controls logging of score  information to a disk file.
  2077.      Logging is enabled by  specifying a filename with the  F= keyword, and
  2078.      disabled if you omit the keyword.
  2079.  
  2080.      The  filename you  specify may  be any  valid DOS  pathname, up  to 64
  2081.      characters in length. All scoring records are appended to  the file if
  2082.      it  already exists, or  the file will  be created automatically  if it
  2083.      does not exist.
  2084.  
  2085.      The  score logging  file may  exist on  a file  server of  a networked
  2086.      system  if desired.  However,  Q&ASA DOES  NOT  SUPPORT FILE  SHARING.
  2087.      Typically, and networked  system will  require that a  file be  locked
  2088.      while it is being updated so that no other network user may access the
  2089.      file until  the updating  has been  completed. If Q&ASA  is used  in a
  2090.      networked system, the  networking extensions to DOS must  provide this
  2091.      function.
  2092.  
  2093.      If networking  is to be used, but the network does not perform locking
  2094.      on a file level, then  you should specify a score logging  file on the
  2095.      local  drive of  each PC,  and collect  these files  at a  later time.
  2096.      Otherwise, you may end up with a corrupted score file.
  2097.  
  2098.      All  score  log records  are plain  ASCII  (except when  encryption is
  2099.      selected). An example is reproduced on the following page.
  2100.  
  2101.  
  2102.  
  2103.      
  2104.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 30
  2105.      
  2106.  
  2107.  
  2108.  
  2109.  
  2110.      Q&A Study Aid V3.80 User's Guide
  2111.      
  2112.  
  2113.      Student Name:       John Q. Public
  2114.      Database Name:      Q&ASA Sample Database
  2115.      Final Score:        72.41%
  2116.      Termination:        TIME LIMIT
  2117.  
  2118.      Started:            Monday, July 31, 1989, 15:44:44
  2119.      Completed:          Monday, July 31, 1989, 15:46:45
  2120.      Elapsed Time:       00:02:00
  2121.  
  2122.      Database File:      SAMPLE.Q&A
  2123.      Total Questions:    20
  2124.      Possible Points:    29
  2125.      Points Awarded:     21
  2126.  
  2127.      Point Matrix:
  2128.                     1     2     3     4     5     6     7     8     9    10
  2129.      0001-0010  10.34  3.45  3.45   ???  3.45   ---   ???   ---  3.45  3.45
  2130.      0011-0020   6.90  3.45  6.90  3.45   ---  3.45  3.45  6.90  3.45  6.90
  2131.  
  2132.      **********************************************************************
  2133.  
  2134.  
  2135.      The '*****....*****' forms a separator between individual records.
  2136.  
  2137.      The  first  block  contains  summary information  regarding  the  quiz
  2138.      session. The  quiz taker's name is  listed along with the  name of the
  2139.      database  (given by the  N= keyword), the final  score, and the reason
  2140.      the score record was written to the score file. In this example, it is
  2141.      given as 'TIME LIMIT'. This means that the quiz taker used up the time
  2142.      allotted by the T= keyword. The possible reasons for termination are:
  2143.  
  2144.           Completed      The user  answered all questions  (and optionally,
  2145.                          within the time allotted by the T= keyword).
  2146.  
  2147.           TIME LIMIT     The  user exceeded  the  time allotted  by the  T=
  2148.                          keyword.  This reason  can only  be produced  if a
  2149.                          time limit was given.
  2150.  
  2151.           ABORTED        This indicates  that the user quit  the Q&ASA ses-
  2152.                          sion before answering all questions  using the /FX
  2153.                          command or by pressing Control-C or Control-Break.
  2154.  
  2155.           CLEARED        The  Clear command  (/MC)  was used  to clear  the
  2156.                          score and restart the  quiz. This reason cannot be
  2157.                          produced if the C= keyword is used  to disable the
  2158.                          Clear command.
  2159.  
  2160.           RELOADED       The user  reloaded the database, or  loaded a dif-
  2161.                          ferent database, or  continued a  previously-saved
  2162.                          database before all questions were answered.
  2163.  
  2164.  
  2165.  
  2166.  
  2167.      
  2168.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 31
  2169.      
  2170.  
  2171.  
  2172.  
  2173.  
  2174.      Q&A Study Aid V3.80 User's Guide
  2175.      
  2176.  
  2177.      The  final score is always the ratio  of the number of possible points
  2178.      to  the total number of  points awarded by  answering correctly. Ques-
  2179.      tions that were not answered are scored as incorrect.
  2180.  
  2181.      The log record also specifies the time the database was loaded (there-
  2182.      by starting the timer, if a  time limit was given), the time the  quiz
  2183.      was completed or stopped (for any of the reasons given above), and the
  2184.      elapsed time.
  2185.  
  2186.      The third block of the record gives the name of  the compiled database
  2187.      file, the number of questions in  the file, and the number of possible
  2188.      points  with  the number  of points  awarded.  Because Q&AC  and Q&ASA
  2189.      support weighting, the number of possible points may be different from
  2190.      the number of questions.
  2191.  
  2192.      The last block  is the point  matrix. This shows  the results of  each
  2193.      question  in the database, ten  questions per line.  Each question may
  2194.      have three possible outcomes:
  2195.  
  2196.           1.   The question was answered, and answered correctly. The point
  2197.                matrix will show the number of points  awarded as a ratio of
  2198.                the number of possible points, relative to 100.
  2199.  
  2200.           2.   The  question was  answered, but  answered incorrectly.  The
  2201.                point matrix will show that no points were awarded with '---
  2202.                '.
  2203.  
  2204.           3.   The question was not answered, either by skipping over it or
  2205.                by exceeding the allotted  time. The point matrix will  show
  2206.                this with '???'. No points were awarded.
  2207.  
  2208.      In the  example score record shown,  you can see that  questions 6, 8,
  2209.      and 15 were answered incorrectly, questions 4 and 7  were not answered
  2210.      (probably due to the time limit given as the reason),  and the remain-
  2211.      ing  15 questions were answered correctly. The point breakdown will be
  2212.      described in the section on weighting.
  2213.  
  2214.  
  2215.      The E= Keyword
  2216.      --------------
  2217.  
  2218.      This  keyword is used to  instruct Q&ASA that the score  file is to be
  2219.      encrypted. This prevents  a user  from completing a  quiz session  and
  2220.      then editing the score file manually to increase the score.
  2221.  
  2222.      When this  keyword is used, the score file will not be human-readable,
  2223.      and  must be  converted back  to plain  text. This  is done  using the
  2224.      utility program  Q&AD.EXE (Q&A Decoder).  Q&AD will restore  the score
  2225.      file to plain text using the same file name.  If the score file is, or
  2226.      has already been converted to plain text, Q&AD will not reprocess it.
  2227.  
  2228.      If you enter  the E= keyword anywhere in the database definition file,
  2229.      Q&AC will set a global flag that encrypts the entire score file.
  2230.  
  2231.      
  2232.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 32
  2233.      
  2234.  
  2235.  
  2236.  
  2237.  
  2238.      Q&A Study Aid V3.80 User's Guide
  2239.      
  2240.  
  2241.  
  2242.      The D= Keyword
  2243.      --------------
  2244.  
  2245.      This keyword is used to disable the display of the correct answer if a
  2246.      question is answered incorrectly. If omitted, Q&ASA will display
  2247.  
  2248.                         Incorrect. The correct answer is
  2249.                                 (Correct Answer)
  2250.                             Press any key to continue
  2251.  
  2252.      The syntax of the D= keyword is as follows:
  2253.  
  2254.      D=
  2255.  
  2256.      If you enter the D= keyword anywhere in  the database definition file,
  2257.      Q&AC will set a global flag  that disables this display. Q&ASA will go
  2258.      on to the next question as though the answer was correct.
  2259.  
  2260.  
  2261.      The W= Keyword
  2262.      --------------
  2263.  
  2264.      This keyword is used to assign weights to each question. The weighting
  2265.      system you use  is entirely arbitrary  and up to  you. Q&AC and  Q&ASA
  2266.      impose only the restriction that you use integer weights, and that you
  2267.      use numbers between 0 and 32767 inclusive.
  2268.  
  2269.      The syntax of the W= keyword is as follows:
  2270.  
  2271.      W=
  2272.      <weight>
  2273.  
  2274.      When Q&AC encounters this keyword, it reads the weight and assigns  it
  2275.      to all the questions that follow it. If Q&AC encounters the W= keyword
  2276.      again, it will change the weight to the new weight, and assign the new
  2277.      weight  to all following questions.  As each question  is processed by
  2278.      Q&AC, Q&AC  keeps  track of  the  total weight.  When Q&ASA  scores  a
  2279.      question, it determines the point  score to be the ratio of  the total
  2280.      weight  to that of the question in  percent. This point score is added
  2281.      to the running score shown in  the scoring window, and also appears in
  2282.      the point matrix in the score file.
  2283.  
  2284.      If you  do not specify  a weight anywhere  in the  database definition
  2285.      file, all questions will be weighted as one point by default.
  2286.  
  2287.      Note  that this arrangement allows you total flexibility in setting up
  2288.      a  weighting system.  You do  not have  to weight  each question  as a
  2289.      fraction of 100, for example. Q&AC and Q&ASA do this for you.
  2290.  
  2291.      The sample database  weights each 'fill-in' question as  three points,
  2292.      each  true/false as 2 points, and each multiple-choice question as one
  2293.  
  2294.  
  2295.      
  2296.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 33
  2297.      
  2298.  
  2299.  
  2300.  
  2301.  
  2302.      Q&A Study Aid V3.80 User's Guide
  2303.      
  2304.  
  2305.      point. There is one 'fill-in' question, 7 'true/false' questions,  and
  2306.      12 'multiple-choice' questions. The points are calculated as follows:
  2307.  
  2308.           fill-in             1    times     3 points  =    3 points
  2309.           true/false          7    times     2 points  =    14 points
  2310.           multiple-choice     12   times     1 point   =    12 points
  2311.                               ---------------------------------------
  2312.           Totals:             20 questions                  29 points
  2313.  
  2314.      There are therefore 29 possible points (as shown in the score file). A
  2315.      'fill-in'  question is worth 3/29  points or 10.34  points relative to
  2316.      100.  A  'true/false' question  is worth  2/29  points or  6.90 points
  2317.      relative  to 100, and a 'multiple-choice' question 1/29 or 3.45 points
  2318.      relative to 100.  In the example score record, the  user was awarded a
  2319.      total of 21 out of 29 possible points, for a score of 21/29 or 72.41%.
  2320.      Adding all  of the points shown  in the point matrix  will produce the
  2321.      same result.
  2322.  
  2323.      Version  3.80 of Q&ASA allows you to assign a weight of zero to one or
  2324.      any number of questions. These questions will not affect the score, as
  2325.      the score  for any question  is the ratio  of the total  weight of all
  2326.      questions to the weight of the question being scored. If  you assign a
  2327.      weight of zero to all questions, the score will always be zero.
  2328.  
  2329.  
  2330.      The Q&AD Score File Decoder
  2331.      ---------------------------
  2332.  
  2333.      The Q&AD.EXE program is  a utility that will decrypt  score files that
  2334.      have  been encrypted  by virtue  of the  'E=' keyword in  the database
  2335.      definition file. Q&AD will  convert the encrypted file to  plain ASCII
  2336.      text as though it had never been  encrypted. Encrypting the score file
  2337.      prevents a  user from completing  a quiz and the  manually editing the
  2338.      score file to change the score.
  2339.  
  2340.      Q&AD will  not alter any file  that is not encrypted.  You may, there-
  2341.      fore, run  it on a score  file even if you  are not sure if  it is en-
  2342.      crypted.
  2343.  
  2344.      Q&AD  replaces the encrypted file  with the decrypted  file; e.g., the
  2345.      filename is  not changed.  Since you may  specify any filename  as the
  2346.      score  filename, Q&AD has  no default extension.  You must, therefore,
  2347.      supply the complete score file name.
  2348.  
  2349.      Q&AD has a simple invocation syntax, as follows:
  2350.  
  2351.           Q&AD <score filename> ENTER
  2352.  
  2353.      There  are  no other  command line  options  or parameters.  Q&AD will
  2354.      report if  the decryption was  successful or if  the file was  not en-
  2355.      crypted.
  2356.  
  2357.  
  2358.  
  2359.      
  2360.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 34
  2361.      
  2362.  
  2363.  
  2364.  
  2365.  
  2366.      Q&A Study Aid V3.80 User's Guide
  2367.      
  2368.  
  2369.      Conclusion
  2370.      ----------
  2371.  
  2372.      Most of these examples can be  found in the sample database definition
  2373.      file, SAMPLE.DEF.  Experiment with it  (remember to recompile  it with
  2374.      Q&AC if you  change it), but please  don't pass on a modified  copy to
  2375.      someone else.
  2376.  
  2377.                                   Hal Endresen
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.      
  2424.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 35
  2425.      
  2426.  
  2427.  
  2428.  
  2429.  
  2430.      Q&A Study Aid V3.80 User's Guide
  2431.      
  2432.  
  2433.  
  2434.                          Appendix : Q&AC Error Messages
  2435.                          ------------------------------
  2436.  
  2437.      Usage: Q&AC <definition filename>
  2438.  
  2439.           This  error will be generated  if you invoke  Q&AC without speci-
  2440.           fying the name of a database definition file.
  2441.  
  2442.      Illegal definition filename: <filename>
  2443.  
  2444.           This  error is generated if you supply a database definition file
  2445.           with an extension of .Q&A.
  2446.  
  2447.      Cannot find database definition file <filename>
  2448.  
  2449.           This error indicates that Q&AC was not able to open  the database
  2450.           definition file you specified.
  2451.  
  2452.      Unable to create temporary file <filename>
  2453.  
  2454.           This error indicates that Q&AC was not able to  create its inter-
  2455.           mediate temporary file.
  2456.  
  2457.      File <def file> : Line <line> : Answer omitted
  2458.  
  2459.           You specified a question without an accompanying  answer, or your
  2460.           syntax is such that Q&AC could not determine where the answer is.
  2461.  
  2462.      File <def file> : Line <line> : Question omitted
  2463.  
  2464.           You specified  an answer without  a preceding  question, or  your
  2465.           syntax  was such that Q&AC could not determine where the question
  2466.           is.
  2467.  
  2468.      File <def file> : Line <line> : Macro name missing
  2469.  
  2470.           You  specified the macro definition keyword M=, but the next line
  2471.           is blank.
  2472.  
  2473.      File <def file> : Line <line> : Weight definition missing
  2474.  
  2475.           You  specified the  weighting keyword  W=, but  the next  line is
  2476.           blank.
  2477.  
  2478.      File <def file> : Line <line> : Invalid weight
  2479.  
  2480.           You specified a  weight that  was outside the  range 1..32767  or
  2481.           entered non-numeric characters.
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.      
  2488.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 36
  2489.      
  2490.  
  2491.  
  2492.  
  2493.  
  2494.      Q&A Study Aid V3.80 User's Guide
  2495.      
  2496.  
  2497.      File <def file> : Line <line> : Title missing
  2498.  
  2499.           You specified the name keyword N=, but the next line is blank.
  2500.  
  2501.      File <def file> : Line <line> : Title too long - truncated
  2502.  
  2503.           The name  you entered  after the  N=  keyword is  longer than  70
  2504.           characters.
  2505.  
  2506.      File <def file> : Line <line> : Time limit definition missing
  2507.  
  2508.           You  specified the time  limit keyword T=,  but the next  line is
  2509.           blank.
  2510.  
  2511.      File <def file> : Line <line> : Invalid time limit
  2512.  
  2513.           The time  limit you specified following the  T= keyword is not in
  2514.           the form HH:MM:SS.
  2515.  
  2516.      File <def file> : Line <line> : Mode lock already set
  2517.  
  2518.           You specified S= and R= in the same definition file. Q&AC is com-
  2519.           plaining about the second occurrence.
  2520.  
  2521.      File <def file> : Line <line> : Filename missing
  2522.  
  2523.           You specified an output score  file with the F= keyword, but  the
  2524.           next line is blank.
  2525.  
  2526.      File <def file> : Line <line> : Illegal filename
  2527.  
  2528.           You  specified a filename after  the F= keyword  that has invalid
  2529.           characters or longer than 64 characters.
  2530.  
  2531.      File <def file> : Line <line> : Question line exceeds 76 characters
  2532.  
  2533.           You entered a  line in a  question block that  will not fit  into
  2534.           Q&ASA's window.
  2535.  
  2536.      File <def file> : Line <line> : Question exceeds 15 lines
  2537.  
  2538.           You entered a question that has too many lines.
  2539.  
  2540.      File <def file> : Line <line> : Answer line exceeds 76 characters
  2541.  
  2542.           You entered  an answer line that will not fit into Q&ASA's answer
  2543.           window.
  2544.  
  2545.      Cannot create database output file <filename>
  2546.  
  2547.           Q&AC was unable to create the compiled database output file.
  2548.  
  2549.  
  2550.  
  2551.      
  2552.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 37
  2553.      
  2554.  
  2555.  
  2556.  
  2557.  
  2558.      Q&A Study Aid V3.80 User's Guide
  2559.      
  2560.  
  2561.      Cannot open temporary file <filename>
  2562.  
  2563.           Q&AC was unable to create its temporary file.
  2564.  
  2565.      File <def file> : Line <line> : Insufficient memory
  2566.  
  2567.           Q&AC  ran out of memory  while processing your  database. If this
  2568.           happens, you have several options. You may:
  2569.  
  2570.           1.   Reduce the number  of questions or  split the database  into
  2571.                two files.
  2572.           2.   Reduce the number of macros.
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.      
  2616.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 38
  2617.      
  2618.  
  2619.  
  2620.  
  2621.  
  2622.      Q&A Study Aid V3.80 User's Guide
  2623.      
  2624.  
  2625.                                     COPYRIGHT
  2626.  
  2627.  
  2628.      This program is  copyright (C) 1988, 1989, 1990 by  Hal Endresen, Quid
  2629.      Pro Quo Software. All rights reserved.
  2630.  
  2631.      Q&A Study Aid is distributed as SHAREWARE, or User-Supported Software.
  2632.      You  are encouraged  to try  the  program and  share  it with  others,
  2633.      provided that:
  2634.  
  2635.           The  program is  distributed in  unmodified form as  the complete
  2636.           archive Q&ASA380.ZIP, complete with documentation  and the regis-
  2637.           tration form on the following page.
  2638.  
  2639.           No fee, charge or other consideration is requested or accepted.
  2640.  
  2641.           The  program is  not distributed  in conjunction  with any  other
  2642.           product.
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.  
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.  
  2657.  
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.      
  2680.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 39
  2681.      
  2682.  
  2683.  
  2684.  
  2685.  
  2686.      Q&A Study Aid V3.80 User's Guide
  2687.      
  2688.  
  2689.  
  2690.                         Q&A STUDY AID V3.80 REGISTRATION
  2691.                         --------------------------------
  2692.  
  2693.      If you intend to use Q&A Study Aid on a regular basis, please register
  2694.      it  and  show your  support for  the  author. Commercial,  business or
  2695.      governmental use by non-registered users is prohibited.
  2696.  
  2697.  
  2698.                       Q&A STUDY AID V3.80 REGISTRATION FORM
  2699.                       -------------------------------------
  2700.  
  2701.      Name _______________________________________________________________
  2702.  
  2703.      Company ____________________________________________________________
  2704.  
  2705.      Address ____________________________________________________________
  2706.  
  2707.      City __________________________________ State ______ Zip ___________
  2708.  
  2709.      Phone ______________________________________________________________
  2710.  
  2711.  
  2712.      SERIAL NUMBER FROM OPENING SCREEN __________________________________
  2713.  
  2714.  
  2715.  
  2716.      Optional Information (in case you experience a problem):
  2717.  
  2718.      Display System _____________________________________________________
  2719.  
  2720.      DOS Version ________________________________________________________
  2721.  
  2722.      PC Make/Model/CPU __________________________________________________
  2723.  
  2724.      Disk Drives Type/Capacity __________________________________________
  2725.  
  2726.      System RAM _________________________________________________________
  2727.  
  2728.  
  2729.      To register, send this form and a check for $20.00 to:
  2730.  
  2731.                               Quid Pro Quo Software
  2732.                                   P.O. Box 1248
  2733.                            Cedar Rapids, IA 52406-1248
  2734.  
  2735.      Registered users  will receive notification  of upgrades of  Q&A Study
  2736.      Aid,  and a registration number to remove the registration notice from
  2737.      the opening screen. Registered users will  also receive support either
  2738.      by telephone (as available), via CompuServe [73760,2032], or  by mail.
  2739.      Non-registered  users may make inquiries as to the suitability of this
  2740.      program for their particular purpose.
  2741.  
  2742.  
  2743.      
  2744.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 40
  2745.      
  2746.  
  2747.  
  2748.  
  2749.  
  2750.      Q&A Study Aid V3.80 User's Guide
  2751.      
  2752.  
  2753.  
  2754.                              USER SUPPORTED SOFTWARE
  2755.                              -----------------------
  2756.  
  2757.      The user-supported software concept (usually referred to as SHAREWARE)
  2758.      is  an attempt to  provide quality software  at low cost.  The cost of
  2759.      offering  a new product by conventional means is staggering, and hence
  2760.      dissuades many independent authors and small companies from developing
  2761.      and promoting  their  ideas and  satisfying  new market  niches.  User
  2762.      supported software is an  attempt to develop a new  marketing channel,
  2763.      where products can be introduced at low cost.
  2764.  
  2765.      If user-supported software works, then everyone will benefit. The user
  2766.      will  benefit by receiving quality products at  low cost, and by being
  2767.      able to  "test drive"  software thoroughly before  purchasing it.  The
  2768.      author benefits by being  able to enter the commercial  software arena
  2769.      without first needing large sources of venture capital.
  2770.  
  2771.      But it can only work with your support. If you find that you are still
  2772.      using Q&A  Study Aid  after a  couple of weeks,  then obviously  it is
  2773.      worth something to you, and you should register.
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.  
  2780.  
  2781.  
  2782.  
  2783.  
  2784.  
  2785.  
  2786.  
  2787.  
  2788.  
  2789.  
  2790.  
  2791.  
  2792.  
  2793.  
  2794.  
  2795.  
  2796.  
  2797.  
  2798.  
  2799.  
  2800.  
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.      
  2808.      Copyright (C) 1988, 1989 Quid Pro Quo Software                 Page 41
  2809.      
  2810.