home *** CD-ROM | disk | FTP | other *** search
/ Collection of Education / collectionofeducationcarat1997.iso / COMPUSCI / QASA53.ZIP / QASA.DOC < prev    next >
Text File  |  1995-10-14  |  211KB  |  5,016 lines
  1.  
  2.  
  3.  
  4.  
  5.                                                     
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                  QA Study Aid (QASA)
  18.  
  19.                                      User's Guide
  20.  
  21.                                      Version 5.3
  22.  
  23.                                    October 14, 1995
  24.  
  25.           
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.                                          _______
  45.                                     ____|__     |                (R)
  46.                                  --|       |    |-------------------
  47.                                    |   ____|__  |  Association of
  48.                                    |  |       |_|  Shareware
  49.                                    |__|   o   |    Professionals
  50.                                  -----|   |   |---------------------
  51.                                       |___|___|    MEMBER
  52.  
  53.  
  54.  
  55.                                      Hal Endresen
  56.                                 Quid Pro Quo Software
  57.                                      PO Box 1248
  58.                              Cedar Rapids, IA 52406-1248
  59.                                Internet pendehal@ia.net
  60.                                 CompuServe 73760,2032
  61.  
  62.  
  63.  
  64.           QA Study Aid V5.3 User's Guide
  65.  
  66.  
  67.  
  68.                  *****      QASA CAN BE REGISTERED ONLINE       *****
  69.                  ***** Registering QASA Online Using CompuServe *****
  70.  
  71.           QASA can now be registered online using CompuServe's shareware
  72.           registration service. To register single copies of QASA on
  73.           CompuServe, enter GO SWREG at the CompuServe prompt, and select
  74.           the option "Register Shareware." You will be presented with the
  75.           following menu:
  76.  
  77.                     Register Shareware
  78.  
  79.                     SEARCH BY:
  80.  
  81.                     1 Registration ID
  82.                     2 Title
  83.                     3 File Name
  84.                     4 Author's User ID
  85.                     5 Author's Name
  86.                     6 Keywords (Categories)
  87.  
  88.           Choose option "1" (Registration ID). When prompted for the ID,
  89.           enter "502" to register QASA. We will receive a registration
  90.           notification from CompuServe, and a registered copy of the latest
  91.           version of QA Study Aid will to you by return mail. The registra-
  92.           tion fee will be charged to your CompuServe account.
  93.  
  94.           If are registering more than one copy or wish a site license,
  95.           please use the "Register" function in the "Utilities" menu.
  96.  
  97.  
  98.                         ***** CREDIT CARD REGISTRATIONS *****
  99.  
  100.           Quid Pro Quo Software accepts VISA and Mastercard. You may
  101.           register via E-mail by completing the online registration form
  102.           (/UR command) and either mailing the form or sending it via E-
  103.           Mail. E-Mail messages are encoded to keep your credit card
  104.           account number private. This method allows full on-line registra-
  105.           tion; you will receive your registration number by return E-mail.
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  120.  
  121.  
  122.  
  123.           QA Study Aid V5.3 User's Guide                                  i
  124.  
  125.  
  126.                                   Table Of Contents
  127.                                   -----------------
  128.  
  129.                          DEFINITION OF SHAREWARE . . . . . . . . . . . . . . . . . . . .                                                                           1
  130.  
  131.                          The Association of Shareware Professionals  . . . . . . . . . .                                                                           1
  132.  
  133.                          Credits . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                           2
  134.  
  135.                          Introduction  . . . . . . . . . . . . . . . . . . . . . . . . .                                                                           3
  136.  
  137.                          Installation  . . . . . . . . . . . . . . . . . . . . . . . . .                                                                           5
  138.  
  139.                          Removing QA Study Aid . . . . . . . . . . . . . . . . . . . . .                                                                           7
  140.  
  141.                          View Modes  . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                           7
  142.  
  143.                          Compatibility . . . . . . . . . . . . . . . . . . . . . . . . .                                                                           9
  144.  
  145.                          A Special Note  . . . . . . . . . . . . . . . . . . . . . . . .                                                                           9
  146.  
  147.                          User Interface  . . . . . . . . . . . . . . . . . . . . . . .                                                                          11
  148.  
  149.                          QASA Command List . . . . . . . . . . . . . . . . . . . . . .                                                                          12
  150.  
  151.                          QA Command List . . . . . . . . . . . . . . . . . . . . . . .                                                                          13
  152.  
  153.                          The Command Line  . . . . . . . . . . . . . . . . . . . . . .                                                                          13
  154.  
  155.                          /FO - Open A Database . . . . . . . . . . . . . . . . . . . .                                                                          14
  156.  
  157.                          /FS - Save a Database . . . . . . . . . . . . . . . . . . . .                                                                          17
  158.  
  159.                          /FR - Restore a Saved Database  . . . . . . . . . . . . . . .                                                                          17
  160.  
  161.                          /FC - Close Database  . . . . . . . . . . . . . . . . . . . .                                                                          18
  162.  
  163.                          /FD - Shell To DOS  . . . . . . . . . . . . . . . . . . . . .                                                                          18
  164.  
  165.                          /FX - Exit to DOS . . . . . . . . . . . . . . . . . . . . . .                                                                          18
  166.  
  167.                          /VS - View Sequential . . . . . . . . . . . . . . . . . . . .                                                                          19
  168.  
  169.                          /VR - View Random . . . . . . . . . . . . . . . . . . . . . .                                                                          19
  170.  
  171.                          /VA - View All Questions  . . . . . . . . . . . . . . . . . .                                                                          19
  172.  
  173.                          /VU - View Unanswered Questions Only  . . . . . . . . . . . .                                                                          20
  174.  
  175.                          /VC - Clear . . . . . . . . . . . . . . . . . . . . . . . . .                                                                          20
  176.  
  177.  
  178.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  179.  
  180.  
  181.  
  182.           QA Study Aid V5.3 User's Guide                                 ii
  183.  
  184.  
  185.  
  186.                          /N - Name . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                          20
  187.  
  188.                          /UE - Edit Database . . . . . . . . . . . . . . . . . . . . .                                                                          21
  189.  
  190.                          /UC - Invoke QASA Compiler  . . . . . . . . . . . . . . . . .                                                                          22
  191.  
  192.                          /UL - List Compiled Quiz  . . . . . . . . . . . . . . . . . .                                                                          22
  193.  
  194.                          /UD - Decrypt Score File  . . . . . . . . . . . . . . . . . .                                                                          25
  195.  
  196.                          /US - Export Score File Summary . . . . . . . . . . . . . . .                                                                          25
  197.  
  198.                          /UX - Export Score File . . . . . . . . . . . . . . . . . . .                                                                          26
  199.  
  200.                          /UR - Registration Form . . . . . . . . . . . . . . . . . . .                                                                          27
  201.  
  202.                          /CS - Set Screen Colors . . . . . . . . . . . . . . . . . . .                                                                          29
  203.  
  204.                          /CM - Set Menu Selector Character . . . . . . . . . . . . . .                                                                          29
  205.  
  206.                          /CP - Set Password  . . . . . . . . . . . . . . . . . . . . .                                                                          29
  207.  
  208.                          /CE - Assign Editor . . . . . . . . . . . . . . . . . . . . .                                                                          30
  209.  
  210.                          Scoring Window  . . . . . . . . . . . . . . . . . . . . . . .                                                                          31
  211.  
  212.                          Answering Questions . . . . . . . . . . . . . . . . . . . . .                                                                          32
  213.  
  214.                          Creating a Database . . . . . . . . . . . . . . . . . . . . .                                                                          33
  215.                                    Macros . . . . . . . . . . . . . . . . . . . . . . . . .                                                                          38
  216.                                    The QASA Database Compiler . . . . . . . . . . . . . . .                                                                          39
  217.                                    Using The QASA Compiler  . . . . . . . . . . . . . . . .                                                                          40
  218.                                    QASA Language Syntax . . . . . . . . . . . . . . . . . .                                                                          41
  219.                                    Terminators  . . . . . . . . . . . . . . . . . . . . . .                                                                          42
  220.                                    The Q= and A= Keywords . . . . . . . . . . . . . . . . .                                                                          43
  221.                                    The H= Keyword . . . . . . . . . . . . . . . . . . . . .                                                                          43
  222.                                    The I= Keyword . . . . . . . . . . . . . . . . . . . . .                                                                          44
  223.                                    The P= Keyword . . . . . . . . . . . . . . . . . . . . .                                                                          45
  224.                                    The N= Keyword . . . . . . . . . . . . . . . . . . . . .                                                                          46
  225.                                    The M= Keyword . . . . . . . . . . . . . . . . . . . . .                                                                          47
  226.                                    The T= Keyword . . . . . . . . . . . . . . . . . . . . .                                                                          51
  227.                                    The C= Keyword . . . . . . . . . . . . . . . . . . . . .                                                                          51
  228.                                    The S= and R= Keywords . . . . . . . . . . . . . . . . .                                                                          52
  229.                                    The F= Keyword . . . . . . . . . . . . . . . . . . . . .                                                                          52
  230.                                    The E= Keyword . . . . . . . . . . . . . . . . . . . . .                                                                          55
  231.                                    The D= Keyword . . . . . . . . . . . . . . . . . . . . .                                                                          56
  232.                                    The W= Keyword . . . . . . . . . . . . . . . . . . . . .                                                                          56
  233.                                    The L= Keyword . . . . . . . . . . . . . . . . . . . . .                                                                          57
  234.                                    The O= Keyword . . . . . . . . . . . . . . . . . . . . .                                                                          58
  235.  
  236.  
  237.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  238.  
  239.  
  240.  
  241.           QA Study Aid V5.3 User's Guide                                iii
  242.  
  243.  
  244.                                    The V= Keyword . . . . . . . . . . . . . . . . . . . . .                                                                          59
  245.                                    The X= Keyword . . . . . . . . . . . . . . . . . . . . .                                                                          59
  246.                                    The K= Keyword . . . . . . . . . . . . . . . . . . . . .                                                                          60
  247.  
  248.                          Appendix A: QASA Compiler Error Messages  . . . . . . . . . .                                                                          61
  249.  
  250.                          Appendix B: Revision Information  . . . . . . . . . . . . . .                                                                          64
  251.  
  252.                          LIMITED WARRANTY  . . . . . . . . . . . . . . . . . . . . . .                                                                          73
  253.  
  254.                          LICENSE TERMS . . . . . . . . . . . . . . . . . . . . . . . .                                                                          74
  255.                                    APPLICABLE TO ALL USE OR DISTRIBUTION  . . . . . . . . .                                                                          74
  256.                                    APPLICABLE TO TRIAL USE OF EVALUATION VERSION  . . . . .                                                                          74
  257.                                    APPLICABLE TO USE OF REGISTERED VERSION  . . . . . . . .                                                                          75
  258.                                    APPLICABLE TO DISTRIBUTED COPIES OF THE INTERPRETER  . .                                                                          75
  259.  
  260.                          LIMITED DISTRIBUTION LICENSE  . . . . . . . . . . . . . . . .                                                                          75
  261.  
  262.                          COPYRIGHT . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                          76
  263.  
  264.                          REGISTRATION  . . . . . . . . . . . . . . . . . . . . . . . .                                                                          77
  265.  
  266.                          PRICING, SITE LICENSING, AND DISTRIBUTION LICENSE . . . . . .                                                                          78
  267.                                    UNLIMITED UPGRADE PLAN . . . . . . . . . . . . . . . . .                                                                          78
  268.                                    UPGRADE PURCHASES  . . . . . . . . . . . . . . . . . . .                                                                          79
  269.                                    DEFINITION OF DISTRIBUTION LICENSE . . . . . . . . . . .                                                                          79
  270.                                    DEFINITION OF SITE LICENSE . . . . . . . . . . . . . . .                                                                          79
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  297.  
  298.  
  299.  
  300.           QA Study Aid V5.3 User's Guide                                  1
  301.  
  302.  
  303.  
  304.           DEFINITION OF SHAREWARE
  305.           -----------------------
  306.  
  307.           Shareware distribution gives users a chance to try software
  308.           before buying it. If you try a Shareware program and continue
  309.           using it, you are required to register and pay for its use. With
  310.           registration, you get anything from the simple right to continue
  311.           using the software, technical support services, or an updated
  312.           program with printed manual.
  313.  
  314.           Copyright laws apply to both Shareware and commercial software,
  315.           and the copyright holder retains all rights, with a few specific
  316.           exceptions as stated below. Shareware authors are accomplished
  317.           programmers, just like the authors of commercial software, and
  318.           the programs are of comparable quality (in both cases, there are
  319.           good programs and bad ones!). The main difference is the method
  320.           of distribution. The author specifically grants you the right to
  321.           copy and distribute the software, either to all and sundry or to
  322.           a specific group. For example, some authors require written
  323.           permission before a commercial disk vendor may copy and/or
  324.           distribute their Shareware.
  325.  
  326.           Shareware is a distribution method, not a type of software. You
  327.           should find and purchase software that suits your needs and
  328.           pocketbook, whether it's commercial or Shareware. The Shareware
  329.           system is easier because you can try before you buy. Because the
  330.           overhead is low, prices are low also. Shareware has the ultimate
  331.           money-back guarantee - if you don't use the product, you don't
  332.           pay for it.
  333.  
  334.  
  335.           The Association of Shareware Professionals
  336.           ------------------------------------------
  337.  
  338.           The Association of Shareware Professionals is an organization
  339.           whose purpose is to promote the shareware distribution concept,
  340.           and to provide a forum for the resolution of disputes between ASP
  341.           members and their customers.
  342.  
  343.           Quid Pro Quo Software is a member of the Association of Shareware
  344.           Professionals (ASP).  ASP wants to make sure that the shareware
  345.           principle works for you. If you are unable to resolve a share-
  346.           ware-related problem with an ASP member by contacting the member
  347.           directly, ASP may be able to help. The ASP Ombudsman can help you
  348.           resolve a dispute or problem with an ASP member, but does not
  349.           provide technical support for members' products. Please write to
  350.           the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427 or
  351.           send a CompuServe message via CompuServe Mail to ASP Ombudsman
  352.           70007,3536.
  353.  
  354.  
  355.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  356.  
  357.  
  358.  
  359.           QA Study Aid V5.3 User's Guide                                  2
  360.  
  361.  
  362.  
  363.           Credits
  364.           -------
  365.  
  366.           Microsoft(R), Microsoft Windows(R), MS-DOS, Microsoft C Optimiz-
  367.           ing Compiler(R), and Microsoft Macro Assembler are registered
  368.           trademarks of Microsoft Corporation.
  369.  
  370.           IBM, OS/2, and PC-DOS are registered trademarks of International
  371.           Business Machines Corporation.
  372.  
  373.           dBASE is a registered trademark of Ashton-Tate.
  374.  
  375.           RTLink/Plus is a registered trademark of Pocket Soft, Inc.
  376.  
  377.           DESQview is a registered trademark of Quarterdeck Office Systems,
  378.           Inc.
  379.  
  380.           Lotus, Lotus 1-2-3, and 1-2-3 are trademarks of Lotus Development
  381.           Corporation.
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  415.  
  416.  
  417.  
  418.           QA Study Aid V5.3 User's Guide                                  3
  419.  
  420.  
  421.           Introduction
  422.           ------------
  423.  
  424.           QA Study Aid is a general-purpose testing program designed to
  425.           present questions from a database. The user is then prompted for
  426.           an answer and graded accordingly.
  427.  
  428.           In the context of this document, and within all program and other
  429.           files included with the QASA package, the word 'database' is used
  430.           in its generic sense. For our purposes, a database is simply a
  431.           collection of questions, answers, and options that is created by
  432.           the user, compiled, and interpreted by the QASA program. Like the
  433.           more general database programs such as dBASE(R), QA Study Aid
  434.           uses an indexed database, although the index is an integral part
  435.           of the database itself and not a separate file. All of the
  436.           details of the database implementation, such as the index,
  437.           records, fields, and data types, are handled automatically by the
  438.           QA Study Aid package.
  439.  
  440.           QASA provides two methods of reading the questions from the
  441.           database: sequential and random. The program defaults to sequen-
  442.           tial mode. There are also two view modes: 'view all' and 'view
  443.           unanswered'. The view mode will have a large effect on how QASA
  444.           presents questions and handles your answers.
  445.  
  446.           A menu-driven command interface is provided with pull-down menus.
  447.           Filenames are selected from a directory by pointing. It is never
  448.           necessary to type in a filename unless a database is specified on
  449.           the command line.
  450.  
  451.           QASA supports a comprehensive context-sensitive help system
  452.           accessible via the F1 key. Help is provided by a single file,
  453.           QASA.HLP. This file may be located in the current directory or in
  454.           any directory specified in the PATH environment variable. QASA
  455.           may therefore be placed in the \DOS (or equivalent) directory and
  456.           accessed from any other directory, provided that PATH environment
  457.           variable includes "\DOS". If you place QASA in a directory that
  458.           is not in the PATH string such that it is unable to locate its
  459.           help file, QASA will, as a last resort, pop up a window and ask
  460.           you to enter the name of directory containing the help file. If
  461.           you do not enter a directory name (by pressing RETURN at the
  462.           prompt), the Help key will be inactive.
  463.  
  464.           QASA uses a compiled database. The database compiler is included
  465.           within QASA to allow you to create and compile your own databas-
  466.           es. The database compiler is invoked via the "Utilities" menu.
  467.           The interpreter-only program, QA.EXE, does not include the
  468.           compiler or any of the other test-creation and management utili-
  469.           ties provided by QASA.EXE.
  470.  
  471.  
  472.  
  473.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  474.  
  475.  
  476.  
  477.           QA Study Aid V5.3 User's Guide                                  4
  478.  
  479.  
  480.           Both QASA.EXE and QA.EXE are written in the C language (with some
  481.           assembly language) and compiled using the Microsoft C Optimizing
  482.           Compiler Version 8.00 ("Visual C/C++") and the Microsoft Macro
  483.           Assembler V6.0B. Pocket Soft's .RTLink/Plus overlay linker V7.11
  484.           is used to generate the executable files.
  485.  
  486.           This package contains the following files:
  487.  
  488.                INSTALL.EXE    installation program
  489.  
  490.                QASA.EXE       QASA main program
  491.                QA.EXE         QASA Interpreter
  492.                QASA.HLP       QASA and QA help file
  493.                QASA.CFG       configuration file suitable for VGA monitors
  494.                QASA.DOC       documentation file (this file)
  495.  
  496.                DEMO1.BAT      batch file for 'view unanswered' demo
  497.                DEMO1.QA       DEMO1 database (compiled)
  498.                DEMO1.DEF      database definition file for DEMO1.QA
  499.  
  500.                DEMO2.BAT      batch file for 'view all' demo
  501.                DEMO2.QA       DEMO2 database (compiled)
  502.                DEMO2.DEF      database definition file for DEMO2.QA
  503.  
  504.                VENDOR.DOC     information for disk vendors and BBS sysops
  505.                FILE_ID.DIZ    description for BBS sysops
  506.                VENDINFO.DIZ   description for BBS sysops and distributors
  507.  
  508.           The QA Study Aid package is SHAREWARE and is copyrighted by the
  509.           author. If QASA meets your needs and you continue to use the
  510.           program, you must register and pay for its use. The SHAREWARE
  511.           concept allows users to obtain high quality software at bargain
  512.           prices, and rewards authors for their efforts. Please support
  513.           this distribution concept by registering your copy. You will find
  514.           a registration form at the back of this manual (although the /UR
  515.           command will doubtless be much more convenient).Comments, bug
  516.           reports, or other information that may help me improve this
  517.           program are welcome and are encouraged. Only you can tell me what
  518.           you need!
  519.  
  520.           QASA is offered as is. There is no guarantee that it will work on
  521.           your particular system; however, it has been tested with CGA,
  522.           MDA, EGA, and VGA monitors on PCs, ATs, 386 and 486 systems, and
  523.           under DOS, Windows, DESQview, and OS/2 2.0+. Text mode is used;
  524.           no graphics card is needed. QASA will NOT use either EMS or XMS
  525.           memory, even if it is present. A minimum of 220K of memory (RAM)
  526.           is needed by the program; it will tell you if you do not have
  527.           sufficient memory to execute it. QASA will use all available
  528.           memory below the 640K conventional-memory boundary if it is re-
  529.           quired.
  530.  
  531.  
  532.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  533.  
  534.  
  535.  
  536.           QA Study Aid V5.3 User's Guide                                  5
  537.  
  538.  
  539.           All I/O is performed through system calls, with the exception of
  540.           the screen, which is controlled by direct writes to the screen
  541.           buffer. Under Microsoft(R) Windows, you must give QASA control of
  542.           the screen in a QASA.PIF file. Under DESQview, QASA will multi-
  543.           task in a DESQview window, and does not require any special
  544.           system resources.
  545.  
  546.           QA.EXE will execute properly in a DOS session under OS/2 2.0 and
  547.           above. Previous versions of QASA.EXE would cause a sharing
  548.           violation when it enforced its registration policies. This has
  549.           been corrected.
  550.  
  551.           QASA assumes that your screen is set to any text mode (color or
  552.           monochrome). If not, it will NOT reset the mode. If your screen
  553.           is in any of the graphics modes when QASA is invoked, you will
  554.           see garbage. Exit QASA using the /FX command (or press ESC if you
  555.           are still in the opening screen) and reset the mode manually
  556.           using the DOS MODE command. When QASA terminates, it will restore
  557.           the previous contents of your screen.
  558.  
  559.  
  560.           Installation
  561.           ------------
  562.  
  563.           QA Study Aid is provided with a comprehensive installation
  564.           program. The installation program requires a fixed disk as the
  565.           target (where QA Study Aid is to be installed). Once the package
  566.           has been installed, however, it may be transferred to a floppy
  567.           diskette.
  568.  
  569.           THE SHAREWARE VERSION HAS A 25-QUESTION LIMIT IMPOSED BY THE
  570.           COMPILER. Your entire database definition file will be parsed,
  571.           but if it contains more than 25 questions, a limit will be
  572.           imposed. THE LIMIT IS ELIMINATED BY REGISTERING!
  573.  
  574.           INSTALL will search your system for any existing copies of the QA
  575.           Study Aid package and also to locate a suitable directory in
  576.           which to place the package. You may install QA Study Aid to any
  577.           directory on your system, EXCEPT on a network drive. INSTALL will
  578.           not recognize a network drive. If you already own a registered
  579.           copy of QA Study Aid, INSTALL will re-register the new version.
  580.  
  581.           The installation program also creates a batch file to update any
  582.           existing databases. These databases must be in the same directory
  583.           as either QASA.EXE or QA.EXE for INSTALL to locate them. A batch
  584.           file is used so that large tests may be compiled without the loss
  585.           of the resources consumed by the installation program. PLEASE
  586.           EXAMINE THE BATCH FILE TO BE SURE INSTALL HAS PROPERLY IDENTIFIED
  587.           EACH SOURCE FILE. Until the compiler is actually run, QA Study
  588.  
  589.  
  590.  
  591.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  592.  
  593.  
  594.  
  595.           QA Study Aid V5.3 User's Guide                                  6
  596.  
  597.  
  598.           Aid cannot distinguish a test source database from any other type
  599.           of text file.
  600.  
  601.           If you are a registered user, INSTALL will also create the file
  602.           README.REG. This file contains important information for reg-
  603.           istered users. If you are not a registered user, INSTALL will not
  604.           create this file.
  605.  
  606.           The configuration file QASA.CFG is supplied with the distribution
  607.           package. This file is suitable for EGA and VGA color systems. If
  608.           you cannot read the screen, simply erase the configuration file
  609.           QASA.CFG, since it is created automatically if it is missing. If
  610.           you do this, you will get a prompt asking you for the directory
  611.           containing the configuration file, since QASA will not be able to
  612.           locate it on the disk. This prompt will appear anytime QASA is
  613.           unable to find its configuration file. If you move the file,
  614.           enter the name of the directory containing the file; otherwise,
  615.           press RETURN without entering a directory to cause QASA to create
  616.           the file. The default will be suitable for any system, including
  617.           LCD displays. You will not be required to enter a directory if
  618.           the configuration file is stored in any directory in the PATH
  619.           environment variable, or if it is in the current directory.
  620.  
  621.           If you wish to execute QA Study Aid from any directory on your
  622.           system, you must add the directory in which QASA is installed to
  623.           the PATH statement in your AUTOEXEC.BAT file, Remember, this line
  624.           cannot exceed 127 characters. You will have to reboot your
  625.           computer after modifying the file.
  626.  
  627.           The QA Study Aid package is small enough to be placed on a single
  628.           5.25" 360KB diskette (WITHOUT DOCUMENTATION) if desired. If your
  629.           database is too large to fit on one diskette, you may place it on
  630.           a second diskette in the B: drive if you have one.
  631.  
  632.           To create a database file, you need only a database definition
  633.           file, which you create with an editor such as EDIT or EDLIN. Once
  634.           you have created a database, you compile it with QASA. Once
  635.           compiled, the only files needed to execute the database are the
  636.           compiled database file (".QA"), QASA.EXE or QA.EXE, QASA.HLP, and
  637.           QASA.CFG. If space is really at a premium, you may omit the help
  638.           file QASA.HLP, but the HELP key (F1) will no longer function. If
  639.           you do this, QASA will complain that it cannot find the help
  640.           file, and ask you to enter the directory in which it resides. To
  641.           omit it, simply press ENTER without entering a directory.
  642.  
  643.           The QA.EXE program uses the same resource files as QASA.EXE:
  644.           QASA.HLP and QASA.CFG. If you wish to use a different configura-
  645.           tion for QA.EXE, you must install it in a different directory or
  646.           on a different drive. Then, using QASA, create the desired
  647.           configuration and exit QASA. The resulting QASA.CFG file may then
  648.  
  649.  
  650.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  651.  
  652.  
  653.  
  654.           QA Study Aid V5.3 User's Guide                                  7
  655.  
  656.  
  657.           be copied to the directory or drive containing the QA.EXE pro-
  658.           gram.
  659.  
  660.           Removing QA Study Aid
  661.           ---------------------
  662.  
  663.           Should you desire to remove the QA Study Aid package from your
  664.           computer, you may simply delete the files. QASA maintains no data
  665.           in any operating system files or in any other directories. To
  666.           remove QASA from your computer, use the following DOS commands.
  667.           These commands assume that QA Study Aid is installed in the
  668.           directory C:\QASA. If you have installed it elsewhere, substitute
  669.           the appropriate directory name. THIS PROCEDURE WILL REMOVE THE
  670.           PRODUCT FILES AND THE DIRECTORY IN WHICH THEY RESIDE.
  671.  
  672.                C:
  673.                CD \QASA
  674.                DEL *.* [ENTER]          (Respond 'Y' to 'Are you sure?')
  675.                CD ..
  676.                RD QASA
  677.  
  678.           If you have a registered version, you should copy the files to a
  679.           floppy diskette. If you accidentally delete a registered version,
  680.           we will provide a new registration number at no charge if you
  681.           decide to reinstall the product on your computer.
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  710.  
  711.  
  712.  
  713.           QA Study Aid V5.3 User's Guide                                  8
  714.  
  715.  
  716.           View Modes
  717.           ----------
  718.  
  719.           QASA (and QA) can both be operated in one of two view modes:
  720.           'view all' (/VA command) and 'view unanswered' (/VU command).
  721.           'View unanswered' is the default.
  722.  
  723.           In 'view unanswered' mode, QASA will only present questions that
  724.           have not yet been answered. This is true regardless of the
  725.           presentation sequence (sequential or random). In this mode, it
  726.           would be appropriate to activate the display of incorrect answers
  727.           so that a student could be told the correct answer for reinforce-
  728.           ment, since the student will not have the ability to change the
  729.           answer.
  730.  
  731.           Also, in 'view unanswered' mode, when all questions have been
  732.           answered, there are no more questions to present, so QASA will
  733.           end the test automatically and write the score record to the
  734.           score file.
  735.  
  736.           'View all' mode provides the student with the ability to review
  737.           all of his or her answers before ending the quiz. The only time
  738.           the quiz will end automatically is if the test is timed and the
  739.           time runs out. Otherwise, the questions will be presented in the
  740.           order given by the presentation sequence (random or sequential).
  741.           In 'view all' mode, however, questions are presented whether or
  742.           not they have been answered. If the question has already been
  743.           answered, then the previous answer is shown (NOTE: The maximum
  744.           length of the stored answer is seven characters by default, and
  745.           can be increased up to 40 characters with the X= database op-
  746.           tion).
  747.  
  748.           If, in 'view all' mode, you backspace over a previous answer to
  749.           erase it, then the question will be scored as unanswered (the
  750.           number of questions answered in the scoring window will decrease
  751.           by one). If you change the answer, the new answer will be scored
  752.           immediately, although you will not be shown the results of the
  753.           scoring.
  754.  
  755.           In general, in 'view all' mode, no information is displayed that
  756.           could lead the student to deduce the correct answer, as the
  757.           student is able to review and/or change the answers. The excep-
  758.           tion to this is If the display of correct answers is enabled (D=
  759.           option omitted in the database). In this case, the correct answer
  760.           will be displayed, BUT THAT QUESTION WILL BE LOCKED OUT. Once the
  761.           student has been shown the correct answer, or the scoring window
  762.           provides information that could tell the student if the answer
  763.           was correct or not, then the student will not be able to access
  764.           that question again during the test session.
  765.  
  766.  
  767.  
  768.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  769.  
  770.  
  771.  
  772.           QA Study Aid V5.3 User's Guide                                  9
  773.  
  774.  
  775.           The student is free to switch between presentation modes. How-
  776.           ever, the previous will still hold true. If any information is
  777.           displayed that provides an indication of whether or not the
  778.           answer is correct, then the question will be locked out of the
  779.           presentation sequence.
  780.  
  781.           As the test writer, if it is your intention to permit students to
  782.           review and change their answers, then you should include the D=
  783.           option in the database (disable display of correct answers). This
  784.           will allow the student to switch between modes without having
  785.           questions locked out.
  786.  
  787.           In 'view all' mode, the student must manually end the test when
  788.           he or she is finished reviewing the answers. This is done with
  789.           either the /FC (File/Close) or /FX (File/eXit) commands. The
  790.           score file record will be written at that time.
  791.  
  792.  
  793.           Compatibility
  794.           -------------
  795.  
  796.           The database files used by QASA 5.3 are fully source-compatible
  797.           with all previous versions, but are not binary-compatible. All
  798.           that is required is that you recompile your database files with
  799.           Version 5.3 of QASA. To do so, examine the batch file UPDATE.BAT
  800.           created by the installation program (created only is existing
  801.           database files are found), insure the named database definition
  802.           files are correct, and execute it. If you have databases that
  803.           INSTALL did not find, you must recompile them manually with the
  804.           QASA program.
  805.  
  806.  
  807.                 QASA WILL NOT WORK WITH THE HERCULES GRAPHICS ADAPTER.
  808.  
  809.  
  810.           A Special Note
  811.           --------------
  812.  
  813.           Special mention is made here of a particular characteristic of
  814.           QASA. The program, to enforce its registration policies, will, at
  815.           certain times, modify its own executable image on disk. This is
  816.           brought to your attention as this behavior may trigger some
  817.           virus-protection programs. Please do not be concerned if this
  818.           occurs; this is normal behavior. You must allow QASA to modify
  819.           itself or it will not execute.
  820.  
  821.           QASA must be able to locate its own .EXE file. Under MS-DOS 3.0
  822.           and above and OS/2 2.0 and above, you should experience no
  823.           problems, even if you rename the file. However, under MS-DOS 2.x,
  824.           if you rename the program, you must specify the new program
  825.  
  826.  
  827.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  828.  
  829.  
  830.  
  831.           QA Study Aid V5.3 User's Guide                                 10
  832.  
  833.  
  834.           pathname using an environment variable. For example, suppose that
  835.           QASA.EXE is in the directory C:\BIN, and you rename it to
  836.           QUIZ.EXE. You must then issue the command
  837.  
  838.                SET QASA=C:\BIN\QUIZ.EXE
  839.  
  840.           You may place this command in your AUTOEXEC.BAT file if you wish.
  841.           You MUST specify the COMPLETE pathname, including the .EXE
  842.           extension. You cannot, however, change the name of the help file
  843.           QASA.HLP. The easiest way to change the program name is to use a
  844.           batch file. For example, to change the name to QUIZ, create
  845.           QUIZ.BAT as follows:
  846.  
  847.                COPY CON: QUIZ.BAT <ENTER>
  848.                QASA %1 <ENTER>
  849.                ^Z <ENTER>                         (^Z means hold down Ctrl
  850.                                                   and press 'Z')
  851.  
  852.           The '%1' will still enable you to specify the name of a database
  853.           to load automatically upon startup by typing:
  854.  
  855.                QUIZ sample
  856.  
  857.                                       IMPORTANT
  858.                                       ---------
  859.  
  860.           QASA.EXE selects a serial number and combines this with certain
  861.           system information the FIRST time it is executed (INSTALL will do
  862.           this for you). This becomes your serial number, and this number
  863.           MUST be supplied to register the program (the /UR command prints
  864.           the registration form with the serial number on it). ONCE THE
  865.           SERIAL NUMBER HAS BEEN ASSIGNED BY QASA, DO NOT MODIFY OR OVER-
  866.           WRITE THE QASA.EXE FILE OR YOUR REGISTRATION NUMBER WILL NOT
  867.           WORK. If you accidentally overwrite a registered program file,
  868.           you will have to send for a new registration number (although
  869.           once you have paid the registration fee, new registration numbers
  870.           are supplied free of charge if they are needed). It is a good
  871.           idea to make a backup copy after you have executed it the first
  872.           time, and again after registering your copy. Once you have
  873.           registered and entered your registration number, the serial
  874.           number will change; for this reason, it is important that you
  875.           include the most recent serial number in all correspondence. This
  876.           applies ONLY to the file QASA.EXE.
  877.  
  878.           QASA also requires that the time and date provided by the MS-DOS
  879.           operating system be correct, since it uses this information in
  880.           the score file. Each time QASA is started, the current time and
  881.           date are checked; if either is invalid, QASA will abort after
  882.           displaying a message requesting you to set the system date and
  883.           time to the proper values.
  884.  
  885.  
  886.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  887.  
  888.  
  889.  
  890.           QA Study Aid V5.3 User's Guide                                 11
  891.  
  892.  
  893.           QASA NEVER modifies any file other than its own executable image
  894.           on disk, the score file (if defined in the database), the saved
  895.           database file(s) (".SAV") if this feature is used, the database
  896.           listing file(s) (".LST"), the exported score file(s) (".PRN"),
  897.           and the configuration file. It will also create a ".QA" file each
  898.           time you compile a new quiz. You need not be concerned about
  899.           modifications to your database source files or any other files on
  900.           your system.
  901.  
  902.  
  903.           User Interface
  904.           --------------
  905.  
  906.           The following applies to both QASA.EXE and QA.EXE.
  907.  
  908.           Commands are entered into QASA via a pull-down two-level menu
  909.           system. The uppermost screen region is the menu system. Each word
  910.           group on the menu line is the title block of a pull-down menu.
  911.           Whenever one of the titles is selected, the menu expands to
  912.           display any options available under it.
  913.  
  914.           Under most conditions, QASA will be prompting for an answer to a
  915.           question. Some means must therefore be provided to break out and
  916.           into the menu system so that an option can be selected or a
  917.           command given. There are two ways of doing this: via an ALT key
  918.           sequence or by pressing the menu selector character, the forward
  919.           slash ('/'). Note that this character may be changed using the
  920.           /CM (Configuration/Menu Selector) command. This document will,
  921.           however, assume that you have NOT altered the default.
  922.  
  923.           If an ALT sequence is used, it is only necessary to press one or
  924.           two ALT keys to select any command option. A top-level selector
  925.           is specified by ALT-shifting the highlighted letter. For example,
  926.           the "Mode / Sequential" command is executed with ALT-M/ALT-S. To
  927.           do this, hold down the ALT key and press 'M' and then 'S'.
  928.  
  929.           If you use the '/' menu selector character, the word MENU will
  930.           first appear at the right of the menu line to indicate that you
  931.           are in the menu system. At this point, any combination of high-
  932.           lighted and underscored letters (as defined by the screen colors
  933.           you choose) and cursor keys can be used to select a menu title
  934.           block. Note that F1 will always get help no matter where you may
  935.           be, in or out of the menu system. The only exception to this is
  936.           for error messages ("Problem"), for which you may not obtain
  937.           help. Once the desired option has been selected, RETURN executes
  938.           it. Note that neither the slash nor the RETURN are necessary when
  939.           using ALT-key sequences.
  940.  
  941.           Versions 3.0 of QASA and above provide the ability for you to
  942.           specify a database file on the command line. If you do so, you
  943.  
  944.  
  945.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  946.  
  947.  
  948.  
  949.           QA Study Aid V5.3 User's Guide                                 12
  950.  
  951.  
  952.           will still see the opening screen, but as soon as you press a
  953.           key, the database will be loaded and the first question will be
  954.           displayed. If the database specifies a time limit, the timer will
  955.           be started immediately.
  956.  
  957.           If the database you specify cannot be found, then an error
  958.           message will be displayed, and you must select the database
  959.           normally using the /FO command. For example, the DOS command
  960.  
  961.                C>QASA sample
  962.  
  963.           will load the sample database and display the first question.
  964.           Note that you do not have to specify the ".QA" extension. If you
  965.           do specify an extension, it MUST be ".QA"; QASA will force this
  966.           extension for all database files.
  967.  
  968.           QASA's menu system commands are listed on the following page.
  969.  
  970.  
  971.           QASA Command List
  972.           -----------------
  973.  
  974.                /FO       Open a database
  975.                /FS       Save a database for later resumption
  976.                /FR       Restore a previously-saved database
  977.                /FC       Close database
  978.                /FD       shell to DOS
  979.                /FX       eXit to DOS
  980.  
  981.                /VS       set presentation order to Sequential view
  982.                /VR       set presentation order to Random view
  983.                /VA       view All questions (review/change answers)
  984.                /VU       view Unanswered questions only (default)
  985.                /VC       Clear score and start quiz over
  986.  
  987.                /N        enter name
  988.  
  989.                /UE       Edit quiz
  990.                /UC       Compile quiz
  991.                /UL       List compiled quiz
  992.                /UD       Decode score file (to plain text)
  993.                /US       export score file Summary
  994.                /UX       eXport score file
  995.                /UR       Registration form
  996.  
  997.                /CC       set screen Colors
  998.                /CS       set menu Selector character
  999.                /CP       set Password
  1000.                /CE       assign Editor
  1001.  
  1002.  
  1003.  
  1004.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  1005.  
  1006.  
  1007.  
  1008.           QA Study Aid V5.3 User's Guide                                 13
  1009.  
  1010.  
  1011.           QA Command List
  1012.           ---------------
  1013.  
  1014.                /FL       Load a database
  1015.                /FC       Continue with a previously-saved database
  1016.                /FS       Save a database for later resumption
  1017.                /FQ       Quit database
  1018.                /FX       eXit to DOS
  1019.  
  1020.           The Command Line
  1021.           ----------------
  1022.  
  1023.           QASA and QA do not require any command-line parameters or argu-
  1024.           ments. They will, however, allow you to specify the name of a
  1025.           database file on the command line so that the program may be
  1026.           invoked from a batch file. You can also specify the default view
  1027.           modes (sequential/random and all/unanswered).
  1028.  
  1029.           If you specify the name of a database file on the command line,
  1030.           you do not have to enter the extension. QASA will change the
  1031.           extension as required, and add one if it is omitted. For example,
  1032.           to start QASA using a sample database provided, you simply type
  1033.  
  1034.                QASA DEMO1 <ENTER>
  1035.  
  1036.           or
  1037.  
  1038.                QA DEMO1 <ENTER>
  1039.  
  1040.           The opening screen will be displayed normally, but once you press
  1041.           ENTER, the database file DEMO1 will be automatically loaded.
  1042.  
  1043.           To tell QASA (or QA) which view mode to start with, use the /V
  1044.           command option. The 'V' must be followed by one or two letters,
  1045.           as follows:
  1046.  
  1047.                /V ('s' OR 'r') ('a' OR 'u')
  1048.  
  1049.           There may not be any spaces between any of the letters. The
  1050.           letters are as follows:
  1051.  
  1052.                a    view All
  1053.                u    view Unanswered
  1054.                s    view Sequentially
  1055.                r    view Randomly
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  1064.  
  1065.  
  1066.  
  1067.           QA Study Aid V5.3 User's Guide                                 14
  1068.  
  1069.  
  1070.           These options can be given in any order. The following are all
  1071.           valid.
  1072.  
  1073.                /Va       Select 'view all', accept default for ordering
  1074.                /Vsu      Select 'view unanswered' and 'sequential order'
  1075.                /vUr      Select 'view unanswered' and 'random order'
  1076.  
  1077.  
  1078.           /FO - Open A Database
  1079.           ---------------------
  1080.  
  1081.           When you issue this command, QASA or QA will display the name of
  1082.           the directory you started the program from; e.g., the current
  1083.           working directory. If your database files are located in this
  1084.           directory, simply press RETURN to accept the default name. If
  1085.           your database files are located in another directory, you may
  1086.           edit the directory name. QASA/QA will remember the new directory
  1087.           name and present it as the default the next time you use this
  1088.           command.
  1089.  
  1090.           When specifying the directory, you may select a different disk
  1091.           drive followed by the path name to the database files in conven-
  1092.           tional DOS form:
  1093.  
  1094.                D:\DIR\DIR...
  1095.  
  1096.           If you clear the name of the directory by using the backspace key
  1097.           or by using the HOME key followed by Ctrl-End, QASA/QA will
  1098.           automatically insert the name of the current working directory
  1099.           after you press RETURN. Note that you will not see this occur as
  1100.           the window will be closed as soon as you press RETURN. However,
  1101.           the directory shown the next time you invoke the /FL command will
  1102.           be the current working directory again.
  1103.  
  1104.           If you enter a drive or directory that does not exist, you will
  1105.           receive an error message and you must enter the command again to
  1106.           specify the proper directory. If you enter the drive identifier
  1107.           of a floppy disk drive, and the drive door is open, you will
  1108.           receive an error, and you will be given the opportunity to close
  1109.           the drive door and retry the command.
  1110.  
  1111.           Note:     Certain DOS configurations can cause apparent errors
  1112.                     that QASA or QA cannot detect. If, for example, you
  1113.                     have installed a 'foreign' disk drive using the command
  1114.                     "DEVICE=DRIVER.SYS <parameters>" and reassigned the
  1115.                     name of a diskette drive using the DRIVPARM command in
  1116.                     your CONFIG.SYS file (MS-DOS and PC-DOS 3.30 and later
  1117.                     only), and you enter the original drive letter, QASA
  1118.                     and QA will appear to hang. Actually, what is happening
  1119.                     is that DOS wants you insert the diskette for the drive
  1120.  
  1121.  
  1122.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  1123.  
  1124.  
  1125.  
  1126.           QA Study Aid V5.3 User's Guide                                 15
  1127.  
  1128.  
  1129.                     you have reassigned it to, although you will not see
  1130.                     the message DOS normally displays. All that is neces-
  1131.                     sary is for you to press the RETURN key.
  1132.  
  1133.           Once you have entered the name of the directory containing your
  1134.           database files, QASA/QA will pop up a window to allow you to
  1135.           select from the compiled database files available in that direc-
  1136.           tory. If there are no database files in the directory, QASA/QA
  1137.           will display "[ empty ]". QASA/QA will NOT display any files
  1138.           other than compiled database files.
  1139.  
  1140.           To select a compiled database file, move the selection bar to it
  1141.           using the cursor keys, PgUp and PgDn, or Home and End. Each of
  1142.           these permits traveling up and down the scrollable list in larger
  1143.           increments. Alternatively, you may also press a letter key that
  1144.           corresponds to the first character of the database filename;
  1145.           QASA/QA will find the first file beginning with that letter.
  1146.           Successive depressions of the same key will step to each database
  1147.           name that begins with that letter. The search stops at the last
  1148.           file that begins with that letter. The search always proceeds
  1149.           down the list; to restart the search, press HOME to move the
  1150.           selector back to the first file in the list.
  1151.  
  1152.           Once you have pointed to the file you desire, press RETURN. The
  1153.           compiled database file will be opened. If the optional score
  1154.           logging has been enabled in the database, QASA/QA will request
  1155.           that you enter your name for the score file (you may not proceed
  1156.           until you have done so, although you may abort the command at
  1157.           this point by pressing ESC). The first question will then appear
  1158.           on the screen, along with the number of questions in the database
  1159.           in the scoring window. The name of the database will also be
  1160.           shown in the center of the top border of the question window if
  1161.           it has been specified in the database. If no title was specified,
  1162.           then the window title will default to "Question".
  1163.  
  1164.           Note:     When you open a database file that specifies a score
  1165.                     file name, and that score file already exists, QASA and
  1166.                     QA will check to insure that the encryption modes are
  1167.                     compatible. If not, they will display an error message
  1168.                     and override the encryption setting in the database
  1169.                     file you opened.
  1170.  
  1171.                     For example, if you create two separate databases, both
  1172.                     of which specify the same name for the score file, but
  1173.                     only one has score file encryption enabled, you will
  1174.                     receive an error when you load the second database, no
  1175.                     matter which one you load first. The order will affect
  1176.                     only the encryption of the score file, which is deter-
  1177.                     mined by the first database loaded. If you always use a
  1178.                     different score file for each database, or are consis-
  1179.  
  1180.  
  1181.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  1182.  
  1183.  
  1184.  
  1185.           QA Study Aid V5.3 User's Guide                                 16
  1186.  
  1187.  
  1188.                     tent with score file encryption, you should experience
  1189.                     no problems. Note that QASA and QA will still function
  1190.                     properly, however.
  1191.  
  1192.           Each time you open a database file with score file logging
  1193.           enabled, QASA/QA will request your name, even if you have already
  1194.           entered it. This is to allow other users to open the same data-
  1195.           base without using the same name for all users. If score file
  1196.           logging is not enabled, QASA/QA doesn't force you to enter your
  1197.           name. You may do this anyway with QASA if you wish, using the /N
  1198.           (Name) command, and QASA will politely display it when it dis-
  1199.           plays your final score.
  1200.  
  1201.           If the database you open has a time limit associated with it, the
  1202.           time remaining will be displayed in the status window under the
  1203.           heading 'Time Left', and the clock will start. The time is
  1204.           counted down to zero, and always shows the time you have remain-
  1205.           ing before QASA/QA stops you and calculates your final score. If
  1206.           the database does not specify a time limit, the 'Time Left' field
  1207.           will not be displayed. If you allow the time to count down to
  1208.           zero, it will change to 'Time Out'.
  1209.  
  1210.           Note:     If you press the help key while a timed database is
  1211.                     loaded, the time display will not be updated until you
  1212.                     exit the help system. QASA/QA will, however, internally
  1213.                     track the remaining time. You may NOT extend the time
  1214.                     by using help.
  1215.  
  1216.           To permit QASA/QA to utilize relatively large databases (~40,000
  1217.           questions and their answers in a 640K system), QASA and QA load
  1218.           an index into memory rather than the database file itself. The
  1219.           database index is created by QASA in the form of a header in the
  1220.           database file itself. Note that this is also true of the help
  1221.           file to minimize the memory used by QASA and QA.
  1222.  
  1223.           The database file (.QA) should never be changed directly, as it
  1224.           is encrypted to prevent users from copying the file to the screen
  1225.           or a printer and thereby viewing the answers. If you wish to
  1226.           create a new database or alter an existing one, you must edit the
  1227.           database definition file (.DEF) and recompile it using QASA. QASA
  1228.           will create a (.QA) file from your (.DEF) file. QASA will not
  1229.           permit you to use the .QA extension on a definition file, so you
  1230.           cannot accidentally overwrite a compiled database.
  1231.  
  1232.           You must create the database definition file and compile it
  1233.           before QASA or QA can be used. Instructions for doing this are in
  1234.           a later section of this guide. Note that this package contains
  1235.           compiled databases that you may use to test and evaluate QASA and
  1236.           QA. These files are called DEMOx.QA. The database definition
  1237.  
  1238.  
  1239.  
  1240.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  1241.  
  1242.  
  1243.  
  1244.           QA Study Aid V5.3 User's Guide                                 17
  1245.  
  1246.  
  1247.           files they were created from are also included, and are called
  1248.           DEMOx.DEF, where 'x' is the demo number.
  1249.  
  1250.  
  1251.           /FS - Save a Database
  1252.           ---------------------
  1253.  
  1254.           This command will save the present state of a database so that
  1255.           you may return and continue with it later. IT WILL NOT WORK IF
  1256.           THE DATABASE HAS A TIME LIMIT ASSOCIATED WITH IT.
  1257.  
  1258.           If you issue this command on a database that has no time limit,
  1259.           the state of the database will be saved in a file in the current
  1260.           directory with the same base name as the database, but with an
  1261.           extension of ".SAV". You may have different .SAV files in differ-
  1262.           ent directories for the same database if you wish.
  1263.  
  1264.           Note:     If you issue this command or the /FO (File/Load Data-
  1265.                     base) command, any existing .SAV file for that database
  1266.                     will be erased from the current working directory of
  1267.                     the disk, and you will not be able to resume it. The
  1268.                     /FO command, by definition, specifies that you wish to
  1269.                     restart the database from the beginning.
  1270.  
  1271.           Once you issue the /FS command, the database will be saved and
  1272.           you will be returned to the main screen so that you may execute
  1273.           another command.
  1274.  
  1275.  
  1276.           /FR - Restore a Saved Database
  1277.           ------------------------------
  1278.  
  1279.           This command will allow you to restore a database that was
  1280.           previously saved using the /FS (File/Save Database) command. It
  1281.           works exactly like the /FO (File/Open) command, except that the
  1282.           list of files displayed will have an extension of ".SAV" instead
  1283.           of ".QA". If no database file has been saved, "[ empty ]" will be
  1284.           displayed.
  1285.  
  1286.           When this command is used, the previous state of the database is
  1287.           restored. The question that was on the screen will be redis-
  1288.           played, and the scoring window will reflect the previous state of
  1289.           the database.
  1290.  
  1291.           Note that once you have completed a quiz or test database, any
  1292.           .SAV file in the directory from which the database was originally
  1293.           loaded will be erased. You cannot, therefore, resume a completed
  1294.           database.
  1295.  
  1296.  
  1297.  
  1298.  
  1299.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  1300.  
  1301.  
  1302.  
  1303.           QA Study Aid V5.3 User's Guide                                 18
  1304.  
  1305.  
  1306.           /FC - Close Database
  1307.           --------------------
  1308.  
  1309.           This command will close the current database and update the score
  1310.           file if one is specified.
  1311.  
  1312.  
  1313.           /FD - Shell To DOS
  1314.           ------------------
  1315.  
  1316.           This command may be used to invoke a secondary copy of the DOS
  1317.           command processor COMMAND.COM (or whatever file is specified by
  1318.           the "SHELL=" environment variable). QASA will remain loaded. Note
  1319.           that this command will NOT work if a database is currently open
  1320.           (the open database could consume all available memory, so you
  1321.           will always receive an error message). This command is not avail-
  1322.           able in QA.EXE.
  1323.  
  1324.           Once DOS has been invoked, you may execute any commands you wish,
  1325.           although you will have less memory available. When you wish to
  1326.           return to QASA, type 'EXIT' at the DOS prompt. The previous state
  1327.           of QASA will be restored to the screen.
  1328.  
  1329.  
  1330.           /FX - Exit to DOS
  1331.           -----------------
  1332.  
  1333.           Use this command to quit a QASA/QA session and return to DOS. If
  1334.           you have loaded a database but have not answered all questions,
  1335.           the score file will be updated with your current score and a
  1336.           notation that you quit QASA/QA. You cannot exit QASA/QA, clear
  1337.           the database, or reload the current or new database without
  1338.           updating your score file. This prevents extending time limits
  1339.           and/or starting a quiz over again without any knowledge by the
  1340.           administrator that such an event occurred.
  1341.  
  1342.           Also, when you quit a QASA/QA session using this command, any
  1343.           saved database file of the same name is erased from disk, pre-
  1344.           venting resumption if the database had been previously saved. As
  1345.           a general rule, whenever your final score is displayed (and
  1346.           optionally, the score file is updated), or whenever you load a
  1347.           database using the /FL (File/Load Database) command, any associ-
  1348.           ated .SAV file will be erased.
  1349.  
  1350.           Note:     Pressing Control-C or Control-Break is interpreted the
  1351.                     same as /FX without the RETURN. Simply press RETURN to
  1352.                     update the score file and return to DOS. This is so
  1353.                     that these break sequences cannot be used to break out
  1354.                     of the program without writing a score file record.
  1355.  
  1356.  
  1357.  
  1358.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  1359.  
  1360.  
  1361.  
  1362.           QA Study Aid V5.3 User's Guide                                 19
  1363.  
  1364.  
  1365.           /VS - View Sequential
  1366.           ---------------------
  1367.  
  1368.           The sequential view option tells QASA/QA that you wish to answer
  1369.           the questions in the same order as they appear in the database
  1370.           file (this is the default). When selected, the new mode will
  1371.           appear in the scoring window. This option does NOT cause QASA to
  1372.           start reading from the beginning of the file; it simply changes
  1373.           the method used to determine the next question. Sequential mode
  1374.           reads the questions from the database in a circular fashion. This
  1375.           allows switching between view modes.
  1376.  
  1377.           Note that this command may be locked out by an option given in
  1378.           the database definition file. If this is the case, the command
  1379.           will simply be ignored. No warning will be given indicating that
  1380.           the command is locked out.
  1381.  
  1382.  
  1383.           /VR - View Random
  1384.           -----------------
  1385.  
  1386.           The random view option is used when you want QASA to choose the
  1387.           questions at random. The random number sequence is different each
  1388.           time the program is run. In this mode, QASA will select the next
  1389.           question at random.
  1390.  
  1391.           Note that this command may be locked out by an option given in
  1392.           the database definition file. If this is the case, the command
  1393.           will simply be ignored. No warning will be given indicating that
  1394.           the command is locked out.
  1395.  
  1396.  
  1397.           /VA - View All Questions
  1398.           ------------------------
  1399.  
  1400.           In this presentation mode, QASA will display ALL questions,
  1401.           whether you have answered them or not (see the discussion of view
  1402.           modes on page 7). If a question has already been answered, your
  1403.           answer will reappear. This mode allows you to review your answers
  1404.           and make any changes you wish.
  1405.  
  1406.           In this mode, QASA will NOT end the quiz session when all ques-
  1407.           tions have been answered. You must close the database to receive
  1408.           your final score and have your score record written to disk.
  1409.  
  1410.           One of the features of QASA is its ability to display the correct
  1411.           answer to a question you have answered incorrectly. This feature
  1412.           is enabled or disabled by the test writer. If it is enabled, such
  1413.           that correct answers are displayed, QASA will NOT allow you to
  1414.           review or change your answer, since you now know the correct one.
  1415.  
  1416.  
  1417.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  1418.  
  1419.  
  1420.  
  1421.           QA Study Aid V5.3 User's Guide                                 20
  1422.  
  1423.  
  1424.           None of the presentation modes will allow you to access a ques-
  1425.           tion once you have seen the answer.
  1426.  
  1427.  
  1428.           /VU - View Unanswered Questions Only
  1429.           ------------------------------------
  1430.  
  1431.           This is the default presentation mode. In this view mode, QASA
  1432.           will show you only questions that have not been answered (see the
  1433.           discussion on view modes on page 7). If you answer a question and
  1434.           you wish to change your answer, you may switch to 'View All' mode
  1435.           described above. If you have been shown the answer, however, you
  1436.           cannot change your answer.
  1437.  
  1438.           When all of the questions have been answered, QASA will end the
  1439.           session automatically and write a score record to disk.
  1440.  
  1441.  
  1442.           /VC - Clear
  1443.           -----------
  1444.  
  1445.           Use the Clear option to reset your score back to zero and to
  1446.           reset the question index back to the beginning of the file. The
  1447.           question index is cleared only by using this command or by
  1448.           loading a new database. If you use this command, a record will be
  1449.           written to the score file indicating that the database was
  1450.           started over.
  1451.  
  1452.           Note that this command may be locked out by an option given in
  1453.           the database definition file. If this is the case, the command
  1454.           will simply be ignored. No warning will be given indicating that
  1455.           the command is locked out.
  1456.  
  1457.  
  1458.           /N - Name
  1459.           ---------
  1460.  
  1461.           This command is used to enter your name, which is placed into the
  1462.           score file and also displayed when the quiz session is completed
  1463.           or otherwise terminated.
  1464.  
  1465.           When this command is given, a data entry window will pop up and
  1466.           prompt for your name and/or any other identifying information.
  1467.           You may enter up to 35 characters.
  1468.  
  1469.           If a database is loaded that specifies a score file, this command
  1470.           will not work. In this case, you will be prompted to enter your
  1471.           name when the database is loaded; you may not change it until the 
  1472.           database has been completed or aborted.
  1473.  
  1474.  
  1475.  
  1476.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  1477.  
  1478.  
  1479.  
  1480.           QA Study Aid V5.3 User's Guide                                 21
  1481.  
  1482.  
  1483.           /UE - Edit Database
  1484.           -------------------
  1485.  
  1486.           This command will operate only if you have assigned an editor
  1487.           using the /CE (Configure/Editor) command.
  1488.  
  1489.           When you issue this command, QASA or QA will display the name of
  1490.           the directory you started the program from; e.g., the current
  1491.           working directory. If your database definition files are located
  1492.           in this directory, simply press RETURN to accept the default
  1493.           name. If your database definition files are located in another
  1494.           directory, you may edit the directory name. QASA/QA will remember
  1495.           the new directory name and present it as the default the next
  1496.           time you use this command.
  1497.  
  1498.           When specifying the directory, you may select a different disk
  1499.           drive followed by the path name to the database files in conven-
  1500.           tional DOS form:
  1501.  
  1502.                D:\DIR\DIR.....
  1503.  
  1504.           If you clear the name of the directory by using the backspace key
  1505.           or by using the HOME key followed by Ctrl-End, QASA/QA will
  1506.           automatically insert the name of the current working directory
  1507.           after you press RETURN. Note that you will not see this occur as
  1508.           the window will be closed as soon as you press RETURN. However,
  1509.           the directory shown the next time you invoke the /FL command will
  1510.           be the current working directory again.
  1511.  
  1512.           If you enter a drive or directory that does not exist, you will
  1513.           receive an error message and you must enter the command again to
  1514.           specify the proper directory. If you enter the drive identifier
  1515.           of a floppy disk drive, and the drive door is open, you will
  1516.           receive an error, and you will be given the opportunity to close
  1517.           the drive door and retry the command.
  1518.  
  1519.           Once you have entered the name of the directory containing your
  1520.           database definition files, QASA will pop up a window to allow you
  1521.           to select from the database definition files available in that
  1522.           directory. If there are no database definition files in the
  1523.           directory, QASA will display "[ empty ]". QASA will NOT display
  1524.           any files other than database definition files.
  1525.  
  1526.           To select a database definition file, move the selection bar to
  1527.           it using the cursor keys, PgUp and PgDn, or Home and End. Each of
  1528.           these permits traveling up and down the scrollable list in larger
  1529.           increments. Alternatively, you may also press a letter key that
  1530.           corresponds to the first character of the filename; QASA will
  1531.           find the first file beginning with that letter. Successive
  1532.           depressions of the same key will step to each database name that
  1533.  
  1534.  
  1535.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  1536.  
  1537.  
  1538.  
  1539.           QA Study Aid V5.3 User's Guide                                 22
  1540.  
  1541.  
  1542.           begins with that letter. The search stops at the last file that
  1543.           begins with that letter. The search always proceeds down the
  1544.           list; to restart the search, press HOME to move the selector back
  1545.           to the first file in the list.
  1546.  
  1547.           Once you have pointed to the file you desire, press RETURN. The
  1548.           full pathname of the database definition file you have selected
  1549.           will be passed to your editor, and the editor will be started.
  1550.           QASA will remain in memory. When you exit your editor, QASA will
  1551.           resume. You may then compile your database and test it. If you
  1552.           need to make corrections, simply call up your editor again with
  1553.           this command to make the necessary changes.
  1554.  
  1555.  
  1556.           /UC - Invoke QASA Compiler
  1557.           ---------------------------
  1558.  
  1559.           This command (QASA only) is used to compile a database definition
  1560.           file into a compiled database file that may be executed by QASA.
  1561.           This command is password-protected, and cannot be executed while
  1562.           a database is loaded even if you know the password.
  1563.  
  1564.           See the section entitled "Using the QASA Compiler" on page 40 for
  1565.           a full explanation on invoking and using the compiler.
  1566.  
  1567.  
  1568.           /UL - List Compiled Quiz
  1569.           ------------------------
  1570.  
  1571.           This command (QASA only) enables you to make a hard copy of a
  1572.           compiled database for archival and/or reference purposes. All of
  1573.           the information in the database definition file is included in
  1574.           the listing. The command is password-protected.
  1575.  
  1576.           The listing will begin a header that specifies the selected
  1577.           options and parameters, and then follow with each question and
  1578.           answer in the database. Information associated with each question
  1579.           is included with the question. The listing file will always have
  1580.           exactly the same name as the compiled database, except it will
  1581.           have an extension of .LST. Since the name is identical, the path
  1582.           is also, so the listing file will always be placed in the same
  1583.           directory as the compiled database definition file. You should be
  1584.           aware that listing files can become quite large - they will
  1585.           usually be about the same size as your database definition file.
  1586.           The listing file does not contain paging information - it is a
  1587.           continuous file.
  1588.  
  1589.           If you have selected a random subset, the listing will show which
  1590.           questions were selected (IF you specify that the selection be
  1591.           made at compile time). The following is a partial example from
  1592.  
  1593.  
  1594.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  1595.  
  1596.  
  1597.  
  1598.           QA Study Aid V5.3 User's Guide                                 23
  1599.  
  1600.  
  1601.           the supplied sample database. It has been edited slightly to fit
  1602.           in this User's Guide.
  1603.  
  1604.           -----------------------------------------------------------------
  1605.           QA Study Aid V5.30 Database Listing
  1606.           Copyright   1988 Quid Pro Quo Software. All Rights Reserved.
  1607.  
  1608.           ************** Database Parameters ******************
  1609.  
  1610.           Database Name:      QA Study Aid Sample Database
  1611.           Database File:      D:\QASA\V530\SAMPLE.QA
  1612.           Score Filename:     SAMPLE.SCR
  1613.           Score File Options: Include Answers
  1614.           Total Questions:    20 out of 26 (randomly selected at run time)
  1615.           Total Weight:       37
  1616.           Time Limit:         00:10:00 (HH:MM:SS)
  1617.           Mode Lock:          None
  1618.           Clear Command:      Enabled
  1619.           Answer Display:     Enabled
  1620.           Source Lines:       636
  1621.           Letter Grades:      13
  1622.                95.00 = "A+"   80.00 = "B"    70.00 = "C"    63.00 = "D"
  1623.                90.00 = "A"    75.00 = "B-"   67.00 = "C-"   60.00 = "D-"
  1624.                85.00 = "A-"   73.00 = "C+"   65.00 = "D+"   59.99 = "F"
  1625.                83.00 = "B+"  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  1654.  
  1655.  
  1656.  
  1657.           QA Study Aid V5.3 User's Guide                                 24
  1658.  
  1659.  
  1660.           *********************** Question 1 **********************
  1661.           Source Line:        172
  1662.           Presentation:       Enabled
  1663.           Punctuation:        Remove
  1664.           Point Weight:       3 (percentage determined dynamically)
  1665.           --------------------- Question Text ---------------------
  1666.            1. Fill-in:
  1667.  
  1668.            QASA requires a minimum of _____ bytes of memory.
  1669.           ---------------------- Answer List ----------------------
  1670.           QASA requires at least 256K of memory.
  1671.           256000
  1672.           256K
  1673.           256KB
  1674.           256 K
  1675.           256 KB
  1676.           *********************** Question 2 **********************
  1677.           Source Line:        195
  1678.           Presentation:       Enabled
  1679.           Punctuation:        Remove
  1680.           Point Weight:       1 (percentage determined dynamically)
  1681.           --------------------- Question Text ---------------------
  1682.            2. Multiple-choice:
  1683.  
  1684.            How many questions and answers can typically be put in a QASA
  1685.            database, assuming your computer has 512K bytes of free memory
  1686.            when QASA is started?
  1687.  
  1688.                   A. 1000
  1689.                   B. Limited by disk space
  1690.                   C. 40,000
  1691.                   D. All of the above
  1692.                   E. None of the above
  1693.           ---------------------- Answer List -----------------------
  1694.           C. 40,000. Each question requires 10 bytes of memory.
  1695.           C
  1696.           40K
  1697.           40000
  1698.  
  1699.           ... and so on.
  1700.  
  1701.           The end of the listing is marked by the line
  1702.  
  1703.           ************************** End ****************************
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  1713.  
  1714.  
  1715.  
  1716.           QA Study Aid V5.3 User's Guide                                 25
  1717.  
  1718.  
  1719.           /UD - Decrypt Score File
  1720.           ------------------------
  1721.  
  1722.           This command (QASA only) is used to decrypt a score file. The
  1723.           command is password-protected.
  1724.  
  1725.           It will pop up a directory window so that you may enter the
  1726.           directory containing the score file to decrypt, or you may accept
  1727.           the directory shown by pressing ENTER. Once you have selected the
  1728.           directory, a file-selection window will be displayed so that you
  1729.           may select the score file to decrypt.
  1730.  
  1731.           Once you select a score file, the file will be converted to plain
  1732.           ASCII text. If the file is not encrypted, you will receive an
  1733.           error message.
  1734.  
  1735.           THE DECRYPTED SCORE FILE REPLACES THE ORIGINAL FILE. All score
  1736.           files are named using the base score file name defined in the
  1737.           database definition file, with an extension of ".SCR".
  1738.  
  1739.  
  1740.           /US - Export Score File Summary
  1741.           -------------------------------
  1742.  
  1743.           This command (QASA only) is used to export the contents of
  1744.           summary fields in the score file to a file whose format is
  1745.           acceptable to the vast majority of database and spreadsheet
  1746.           programs. This command is password-protected.
  1747.  
  1748.           By using this command, you may import all scores for an entire
  1749.           class into a spreadsheet, for example, and use the spreadsheet to
  1750.           calculate bell curves, normalize the scores or convert them to
  1751.           another form. You could average the scores for several QASA quiz
  1752.           sessions. You may also use a database program to maintain a
  1753.           history by student of all quizzes and their scores.
  1754.  
  1755.           This command will pop up a directory window so that you may enter
  1756.           the directory containing the score file to export, or you may
  1757.           accept the directory shown by pressing ENTER. Once you have
  1758.           selected the directory, a file-selection window will be displayed
  1759.           so that you may select the score file to export.
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  1772.  
  1773.  
  1774.  
  1775.           QA Study Aid V5.3 User's Guide                                 26
  1776.  
  1777.  
  1778.           QASA will then locate and export certain fields in the score
  1779.           file, creating one line for each record in the score file, as
  1780.           follows:
  1781.  
  1782.                Student,Database,Score,Grade,Termination,Time,Administrator
  1783.  
  1784.                where:
  1785.  
  1786.                     Student        is the student's name in quotes
  1787.                     Database       is the name of the database in quotes
  1788.                     Score          is the final score
  1789.                     Grade          is the letter grade in quotes
  1790.                     Termination    is the termination explanation in quotes
  1791.                     Time           is the elapsed time in seconds
  1792.                     Administrator  is the name of the test administrator
  1793.                                    for this student
  1794.  
  1795.           Note that QASA will also export a header line, which you may
  1796.           delete from the spreadsheet or database if you wish. The follow-
  1797.           ing is an example of an exported score file containing two
  1798.           records. Note that the two header lines are actually exported as
  1799.           one line.
  1800.  
  1801.  
  1802.           "Student","Database","Score","Grade","Termination","Time",
  1803.           "Administrator"
  1804.  
  1805.           "John Public","Pop Quiz",79.23,"C+","Time Out",720,"A. Teacher"
  1806.           "Jane Doe","Math Quiz",94.00,"A","Completed",298,"A. Teacher"
  1807.  
  1808.           If you are exporting the score file for use with Lotus(r) 1-2-3,
  1809.           you would use the /FI (File/Import) command. Be sure to select
  1810.           the "Numbers" option.
  1811.  
  1812.  
  1813.           /UX - Export Score File
  1814.           -----------------------
  1815.  
  1816.           This command (QASA only) is used to export the entire contents of
  1817.           the score file in a form that can be imported into spreadsheet
  1818.           and/or database programs. The data obtained from this export can
  1819.           be used for statistical analysis of problem subject areas,
  1820.           analysis of teacher effectiveness by subject area or as a whole,
  1821.           and a myriad of other uses.
  1822.  
  1823.           Since spreadsheet and database programs have a finite limit on
  1824.           the number of columns (spreadsheets) or fields per record (data-
  1825.           bases), this command analyzes the contents of the score file and
  1826.           arranges the record for each student into a single column. All
  1827.           data that pertains to a particular student will be contained in
  1828.  
  1829.  
  1830.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  1831.  
  1832.  
  1833.  
  1834.           QA Study Aid V5.3 User's Guide                                 27
  1835.  
  1836.  
  1837.           its own column. The underlying assumption is that there will be
  1838.           fewer student records than there will be questions, which are
  1839.           placed in rows.
  1840.  
  1841.           Since the score file may contain records for different tests,
  1842.           each of which may have a different number of questions, the
  1843.           number of rows in the exported data will be equal to the number
  1844.           of questions in the student record with the most questions. This
  1845.           means that there may be cells in some student records for which
  1846.           no question exists if the row number exceeds the number of
  1847.           questions in that test. These cells are always filled with zero.
  1848.  
  1849.           For any particular question, an entry may contain one of four
  1850.           numeric values that describe how the question was answered. These
  1851.           'answer codes' are as follows.
  1852.  
  1853.  
  1854.                0    the question does not exist
  1855.                1    the student did not answer the question
  1856.                2    the question was answered INCORRECTLY
  1857.                3    the question was answered CORRECTLY
  1858.  
  1859.  
  1860.           Similarly, since QASA can capture the literal text typed in by
  1861.           the test taker, these fields will be exported if ANY score file
  1862.           record contains literal answers. The literal answer strings will
  1863.           follow the questions, row-by-row, doubling the number of rows in
  1864.           the resulting export file. If the score file field does not have
  1865.           a literal answer associated with it, or if answer was left blank,
  1866.           then the literal field for that question will be an empty string;
  1867.           e.g., "".
  1868.  
  1869.           The first ten rows in the export file will contain the summary
  1870.           data in the same order as that exported by the Export Score File
  1871.           Summary command described above. Rows 11 and higher contain the
  1872.           answer data for each question in the test.
  1873.  
  1874.           Note that the default length of a literal answer string is five
  1875.           characters. You can increase this using the X= option in the
  1876.           database.
  1877.  
  1878.  
  1879.           /UR - Registration Form
  1880.           ------------------------
  1881.  
  1882.           WE HIGHLY RECOMMEND THAT YOU USE THIS COMMAND TO REGISTER QASA!
  1883.  
  1884.           This command (QASA only) will print a registration form to make
  1885.           it as easy as possible for you to register your copy of QA Study
  1886.  
  1887.  
  1888.  
  1889.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  1890.  
  1891.  
  1892.  
  1893.           QA Study Aid V5.3 User's Guide                                 28
  1894.  
  1895.  
  1896.           Aid. It is only a form and cannot force you to register. You can
  1897.           also use CompuServe to register single copies.
  1898.  
  1899.           You may print the form to any device or any file. The device must
  1900.           be able to interpret carriage return, line feed, backspace, form
  1901.           feed, and normal text.
  1902.  
  1903.           The registration form will prompt your for the necessary informa-
  1904.           tion. In addition, it will determine a number of items concerning
  1905.           your system configuration for support purposes. If any of the
  1906.           configuration items is incorrect, please make the necessary
  1907.           corrections. For example, QASA will not detect an LCD screen -
  1908.           only color or monochrome.
  1909.  
  1910.           The will calculate and display the registration fee based upon
  1911.           the number of copies you wish to register and the options you
  1912.           select.
  1913.  
  1914.           The form will require that you complete certain fields before it
  1915.           will write the form to the output device you select. For example,
  1916.           you must enter your name and address, since we must have this
  1917.           information to mail your registration number.
  1918.  
  1919.           CREATING CODED E-MAIL
  1920.  
  1921.           This is a method of registration that allows you to send us an
  1922.           order that includes your credit card information, yet still keep
  1923.           your order and your credit card information confidential. The
  1924.           message can be read only by Quid Pro Quo Software. All of the
  1925.           data in your order is encrypted in such a way that it can be sent
  1926.           as a mail message through any electronic mail service. The only
  1927.           requirement is that the mail service be able to accept a message
  1928.           as an uploaded file. PLEASE DO NOT ATTEMPT TO SEND AN E-MAIL
  1929.           ORDER BY TYPING THE MESSAGE FROM A PRINTED PAGE! To create the
  1930.           message file, select "Create Coded E-Mail", and then enter a
  1931.           filename as the output device. QASA will generate an encrypted
  1932.           message and write to the file you specify. Send this message to
  1933.           Quid Pro Quo Software via electronic mail.
  1934.  
  1935.                                 ***** IMPORTANT *****
  1936.  
  1937.           YOU CANNOT EXPECT THE ENCRYPTION ALGORITHM TO WITHSTAND A DELIB-
  1938.           ERATE ATTEMPT TO DECODE IT. THE ALGORITHM IS NOT SECURE. IF YOU
  1939.           WISH TO HAVE MORE SECURITY, YOU SHOULD NOT USE EMAIL FOR CREDIT
  1940.           CARD REGISTRATION. QUID PRO QUO SOFTWARE ACCEPTS NO RESPONSIBIL-
  1941.           ITY FOR THE SECURITY OF ANY INFORMATION SENT OVER ANY TYPE OF
  1942.           EMAIL SYSTEM.
  1943.  
  1944.           If you order QA Study Aid using an email service, we will reply
  1945.           to you using the reply address through the same email service if
  1946.  
  1947.  
  1948.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  1949.  
  1950.  
  1951.  
  1952.           QA Study Aid V5.3 User's Guide                                 29
  1953.  
  1954.  
  1955.           possible. If we cannot respond through the same mail service, we
  1956.           will send your registration number by mail.
  1957.  
  1958.  
  1959.           /CS - Set Screen Colors
  1960.           -----------------------
  1961.  
  1962.           This command (QASA only) is used to modify the screen colors. A
  1963.           color map of all possible color is displayed, along with a
  1964.           simulated menu window. A title bar at the top of the screen
  1965.           specifies which portion of the screen you are modifying. All
  1966.           color selections are performed by using the cursor keys to point
  1967.           to the desired color. The PgUp and PgDn keys are used to alter
  1968.           the title bar, thereby changing the item whose color is to be
  1969.           modified. The simulated menu will change with each color change
  1970.           so that you may see the effect of the changes.
  1971.  
  1972.           Once you have set the colors as you wish, press ENTER to save the
  1973.           new colors in the configuration file, or ESCape to cancel the
  1974.           changes. For the full effect of the changes to be seen, you must
  1975.           quit QASA and then restart it so that it will redraw all screens
  1976.           using the new color set.
  1977.  
  1978.  
  1979.           /CM - Set Menu Selector Character
  1980.           ---------------------------------
  1981.  
  1982.           QASA and QA use a specific character to call up (out of an answer
  1983.           prompt if displayed) the menu system. This character defaults to
  1984.           the forward slash ('/'), but you may change it to any character
  1985.           you wish in the printable ASCII range of '!' through '~', inclu-
  1986.           sive. Once you change it, it is saved in the configuration file
  1987.           and will therefore be set each time you start QASA or QA. If you
  1988.           change your mind, you can reset the character or press ESCape to
  1989.           cancel the command. The current menu selector character is always
  1990.           displayed at the bottom of the question/answer window ('/' for
  1991.           Menus). This command is not available with QA.EXE.
  1992.  
  1993.  
  1994.           /CP - Set Password
  1995.           ------------------
  1996.  
  1997.           This command (QASA only) is used to set or change the password
  1998.           that allows access to the compiler, score file decoder, and the
  1999.           score file export commands. It cannot be used if QASA is execut-
  2000.           ing under OS/2. You must do this while running under MS-DOS or
  2001.           PC-DOS or by using the 'load specific DOS version' feature of
  2002.           OS/2 2.0.
  2003.  
  2004.  
  2005.  
  2006.  
  2007.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  2008.  
  2009.  
  2010.  
  2011.           QA Study Aid V5.3 User's Guide                                 30
  2012.  
  2013.  
  2014.           QASA is distributed with no password. Anyone may therefore use
  2015.           the password-protected commands until and unless a password is
  2016.           entered using this command.
  2017.  
  2018.           When this command is selected, if there is a password, you will
  2019.           be asked to enter it. You cannot change a password unless you
  2020.           know the current password. The password may be any series of
  2021.           characters in the range of space through a tilde ('~'), inclu-
  2022.           sive, and may contain up to 19 characters.
  2023.  
  2024.           If there is no current password, you will not be asked to enter
  2025.           it.
  2026.  
  2027.           Once you have entered the current password, if any, you will be
  2028.           asked to enter the new password. Once you have done this, you
  2029.           will be prompted to confirm it. If the two passwords match, the
  2030.           new password will be encrypted and stored. Any attempt to identi-
  2031.           fy or modify the password will render QASA useless; it will no
  2032.           longer execute.
  2033.  
  2034.           Note that once a valid password has been entered, QASA is 'un-
  2035.           locked', and you will not be required to enter the password again
  2036.           for any function (until you quit and restart the program).
  2037.  
  2038.  
  2039.           /CE - Assign Editor
  2040.           -------------------
  2041.  
  2042.           This command (QASA only) allows you to assign your favorite
  2043.           editor to QASA for use by the /UE (Utilities/Edit) command.
  2044.  
  2045.           Since QA Study Aid uses a plain text file, it does not include
  2046.           its own editor. An editor is likely to be a matter of strong
  2047.           personal preference. For this reason, QASA allows you to assign
  2048.           your own editor. Once assigned, you may use the /UE command to
  2049.           edit your database definition file, then return to QASA to
  2050.           compile and test your database. QASA effectively integrates your
  2051.           editor choice into its user interface.
  2052.  
  2053.           To be most useful when used with QASA, your editor should be able
  2054.           to accept the name of the file to edit as a parameter on the
  2055.           command line. If it cannot do so, then you will have to manually
  2056.           select the database file to edit once your editor has been
  2057.           started.
  2058.  
  2059.           Like batch (.BAT) files, QASA allows you to specify the name of
  2060.           the database definition file using a special marker: "%name%"
  2061.           (without the quotes). When you start the editor with the /UE
  2062.           command, QASA will display a list of your database definition
  2063.           files (.DEF). The file you select will be passed to your editor
  2064.  
  2065.  
  2066.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  2067.  
  2068.  
  2069.  
  2070.           QA Study Aid V5.3 User's Guide                                 31
  2071.  
  2072.  
  2073.           in place of the special marker. For example, let's say your
  2074.           editor is named EDITOR.COM, can accept filenames on its command
  2075.           line, and requires two other arguments, "/This" and "/That", to
  2076.           be configured the way you like it. You could use any one of the
  2077.           following lines to assign your editor for use with QASA.
  2078.  
  2079.                EDITOR.COM /This /That %name%
  2080.                C:\UTILS\EDITOR.COM %name% /This /That
  2081.                EDITOR %name% /This /That
  2082.  
  2083.           The third form will likely be the most familiar to you, since it
  2084.           is almost identical to the way the command would be issued on the
  2085.           command line. This form will work fine with QASA, but it will
  2086.           cause DOS to search the PATH to find EDITOR.COM. The second form
  2087.           is the most efficient, since it tells DOS exactly where the
  2088.           editor is, thereby avoiding the PATH search and allowing faster
  2089.           loading. In all cases, "%name%" will be replaced by the name of
  2090.           the database definition file you select with the /UE command.
  2091.  
  2092.  
  2093.  
  2094.           Scoring Window
  2095.           --------------
  2096.  
  2097.           The scoring window always shows the current state of both you and
  2098.           QASA/QA. The scoring window is blank until a database is loaded,
  2099.           so you may easily ascertain if a database is loaded or not. The
  2100.           items that may appear in the scoring window are described below.
  2101.  
  2102.                Time Left      This shows the time remaining to answer all
  2103.                               questions in a database that has a time lim-
  2104.                               it. If the database does not have a time
  2105.                               limit, this field will not be displayed. If
  2106.                               the database has a time limit associated with
  2107.                               it, you will see this time counting down to
  2108.                               zero. At zero, it will change to 'Time Out'.
  2109.  
  2110.                Mode           This is the current question-indexing mode,
  2111.                               and will be "Random" or "Sequential". QASA
  2112.                               always starts up in sequential mode. The mode
  2113.                               may be specified in the database.
  2114.  
  2115.                               This field also shows if the 'view all' mode
  2116.                               is active by appending '/All' to the sequence
  2117.                               string, as 'Sequential/All' or 'Random/All'.
  2118.                               If the '/All' suffix is not displayed, then
  2119.                               the presentation mode is 'view unanswered'.
  2120.  
  2121.                Questions      This specifies the total number of questions
  2122.                               in the database.
  2123.  
  2124.  
  2125.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  2126.  
  2127.  
  2128.  
  2129.           QA Study Aid V5.3 User's Guide                                 32
  2130.  
  2131.  
  2132.                Answered       This indicates the number of questions that
  2133.                               you have answered. When it equals the number
  2134.                               of questions in the database, your final
  2135.                               score will be displayed.
  2136.  
  2137.                Correct        This is the number of questions that you have
  2138.                               answered correctly.
  2139.  
  2140.                Score          Your score is a simple ratio of the number of
  2141.                               possible points to the number you have been
  2142.                               awarded, and is displayed in percent.
  2143.  
  2144.                Grade          If optional letter-grade equivalencies have
  2145.                               been assigned in the database, and the grade
  2146.                               display has not been turned OFF, then this
  2147.                               will show the current grade that has been
  2148.                               achieved relative to the score. The database
  2149.                               may be configured so that the grade is not
  2150.                               displayed at all until a certain score has
  2151.                               been achieved; once this base score is
  2152.                               achieved, the grade will be updated along
  2153.                               with the score. If the grade display has been
  2154.                               turned off, or if there are no grade equiva-
  2155.                               lencies in the database, then this field will
  2156.                               not be shown.
  2157.  
  2158.  
  2159.           Answering Questions
  2160.           -------------------
  2161.  
  2162.           QASA/QA do not require you to answer questions in the order they
  2163.           are presented (as defined by the mode). QASA/QA will determine
  2164.           the next question using the mode you select (or the mode that
  2165.           been forced in the database), but once the question is displayed,
  2166.           you may elect to skip it (intending to come back to it later) and
  2167.           let QASA/QA present the next one. QASA/QA will remember that the
  2168.           question was skipped and display it again at some later time,
  2169.           depending upon the mode you have selected.
  2170.  
  2171.           Skipping a question is done simply by pressing ENTER when QASA/QA
  2172.           prompts for an answer. The question will not be scored, but
  2173.           QASA/QA will present it again after you have answered all of the
  2174.           remaining questions (sequential mode) or at any time (random
  2175.           mode). You may not omit a question, but you may essentially scan
  2176.           through the questions and answer them in the order you choose.
  2177.  
  2178.           QASA/QA will always display the number of percentage points you
  2179.           will be awarded, if you answer correctly, at the right of the
  2180.           answer window. The number of points displayed is the ratio of the
  2181.           total weight of all questions in the database (or of all ques-
  2182.  
  2183.  
  2184.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  2185.  
  2186.  
  2187.  
  2188.           QA Study Aid V5.3 User's Guide                                 33
  2189.  
  2190.  
  2191.           tions in a subset of the database) to the weight of the question
  2192.           in points relative to 100%, as defined in the compiled database.
  2193.           If you answer incorrectly, you are awarded zero points.
  2194.  
  2195.           You may also enter a command any time you are being prompted for
  2196.           an answer.
  2197.  
  2198.  
  2199.           Creating a Database
  2200.           -------------------
  2201.  
  2202.           The database is the heart of QASA. QASA receives virtually all of
  2203.           the information it needs to present and score your answers from
  2204.           the database.
  2205.  
  2206.           The database is created from a plain ASCII, or 'flat' file, and
  2207.           then compiled using the database compiler within QASA. The input
  2208.           given to QASA is called the database definition file; the output
  2209.           of QASA is the compiled database. QASA creates and destroys one
  2210.           intermediate file (with an extension of ".$$$") as it compiles
  2211.           the database definition file. QASA will require free disk space
  2212.           approximately equal to twice the size of the database definition
  2213.           file.
  2214.  
  2215.           QASA supports a large number of options that may be used to
  2216.           control the quiz session. Each option is specified using a
  2217.           command keyword followed by zero or more lines of text. It is
  2218.           important to remember that keywords must be on a line by them-
  2219.           selves with NO OTHER TEXT.
  2220.  
  2221.           If you use a word processor program to create the database
  2222.           definition file, be sure to use its 'non-document' mode to insure
  2223.           that it won't put in any formatting codes. A plain ASCII text
  2224.           editor is recommended (EDLIN, or preferably EDIT, which are
  2225.           included with DOS, are two such editors).
  2226.  
  2227.           To enable QASA to handle all of the common question formats
  2228.           except 'essay' questions, a very general database arrangement is
  2229.           used. QASA expects each question to be followed by the correct
  2230.           answer, which it uses to check the answer typed in by the user.
  2231.  
  2232.           QASA can handle multiple-choice, true/false, and fill-in-the-
  2233.           blank questions with equal ease.
  2234.  
  2235.           The database must contain one instance of each of two keywords
  2236.           for each question in the database. These keywords are, exactly,
  2237.           in quotes:
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  2244.  
  2245.  
  2246.  
  2247.           QA Study Aid V5.3 User's Guide                                 34
  2248.  
  2249.  
  2250.                "Q="
  2251.                "A="
  2252.  
  2253.           As you might expect, these stand for "question" and "answer". The
  2254.           question MUST precede the answer. QASA will complain about any
  2255.           irregularities it finds in the database when it constructs the
  2256.           compiled database file.
  2257.  
  2258.           The following is a simple example of a question and answer as
  2259.           they might appear in the database definition file. It is a
  2260.           multiple-choice question. The following text is entered into the
  2261.           database definition file:
  2262.  
  2263.           Q=
  2264.           Multiple-choice:
  2265.  
  2266.           What is the capital of Pennsylvania?
  2267.           A. Philadelphia
  2268.           B. Washington, D.C.
  2269.           C. Harrisburg
  2270.           D. None of the above
  2271.  
  2272.           A=
  2273.           C
  2274.  
  2275.           QASA/QA will display the question beginning on the line immedi-
  2276.           ately following the 'Q=' line. The end of the question is marked
  2277.           by the 'A='. All lines between these markers form the question,
  2278.           which QASA will display exactly as it appears in the database.
  2279.           You may, therefore, format your questions any way that you wish.
  2280.           QASA does absolutely no interpretation of the text you enter for
  2281.           a question. QASA will impose NO restrictions other than the
  2282.           number of rows and columns; you may use up to 15 lines of 76
  2283.           characters. If the question contains more than 15 lines, the
  2284.           extra lines will be discarded and you will receive an error
  2285.           message. Blank lines between the end of the actual question and
  2286.           the 'A=' line are effectively discarded and do not count against
  2287.           the 15 lines allowed. The question above, therefore, consists of
  2288.           seven lines, not eight.
  2289.  
  2290.           Note that the 'Multiple-choice' prompt is actually a part of the
  2291.           database - NOT hard-coded into QASA. You may include this as part
  2292.           of your database or omit it if you wish. Similarly, you may
  2293.           number your questions any way you wish, or not at all. QASA/QA,
  2294.           however, will consider them to be numbered sequentially beginning
  2295.           with one as the first question in the database when it creates a
  2296.           score file entry.
  2297.  
  2298.           The answer follows beginning on the line immediately after the
  2299.           'A='. In this example, it is 'C'. All this means is that QASA
  2300.  
  2301.  
  2302.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  2303.  
  2304.  
  2305.  
  2306.           QA Study Aid V5.3 User's Guide                                 35
  2307.  
  2308.  
  2309.           will score as correct any response to the question that is
  2310.           exactly 'C' OR 'c' - case is not significant. QASA/QA does some
  2311.           preformatting of these strings prior to the comparison, however.
  2312.           Both the answer in the database and the answer typed in when the
  2313.           database is executed are processed the same way:
  2314.  
  2315.                1.   All surrounding whitespace, including newlines, is
  2316.                     removed. This means that
  2317.                          C
  2318.                     and
  2319.                                    C
  2320.                     are equivalent and are themselves equivalent to the 'C'
  2321.                     in the example above.
  2322.  
  2323.                2.   All whitespace (blanks and tabs) between words is col-
  2324.                     lapsed to a single space:
  2325.                          "Washington, D.C."
  2326.                     and
  2327.                          "Washington,        D.C."
  2328.                     are equivalent.
  2329.  
  2330.                3.   All characters are folded to uppercase; 'Yes' and 'yes'
  2331.                     are therefore equivalent.
  2332.  
  2333.                4.   Punctuation is optionally removed. Punctuation is
  2334.                     removed as if it did not exist. When P= precedes a
  2335.                     question, then
  2336.                          "Washington, D.C."
  2337.                     and
  2338.                          "Washington DC"
  2339.                     are equivalent. Note that punctuation is REMOVED, not
  2340.                     replaced with space characters. This also means that
  2341.                          "Washington,D.C."
  2342.                     becomes
  2343.                          "WashingtonDC"
  2344.                     when punctuation is removed. If you plan on removing
  2345.                     punctuation, be sure you include answers in the answer
  2346.                     list as they would appear when they are typed in, using
  2347.                     only punctuation as delimiters (no spaces).
  2348.  
  2349.           These steps insure that a response will not be scored as incor-
  2350.           rect due to the position or character case of any part of the
  2351.           response in either your answer or that in the database.
  2352.  
  2353.           Note that these same rules are also applied to the 'Q=' and 'A='
  2354.           markers. They may, therefore, appear anywhere on the line. You
  2355.           cannot, however, insert anything between 'Q' and '=', nor can you
  2356.           put anything else on the line with the command keyword.
  2357.  
  2358.  
  2359.  
  2360.  
  2361.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  2362.  
  2363.  
  2364.  
  2365.           QA Study Aid V5.3 User's Guide                                 36
  2366.  
  2367.  
  2368.           In the example above, one correct answer was specified. The only
  2369.           answer that could be scored as correct is 'C' (and 'c', of
  2370.           course). Note that we could just as well have used numbers as
  2371.           selectors and given '3' as the answer. QASA makes no attempt to
  2372.           interpret this information; it simply looks for an exact match
  2373.           based on the criteria outlined above.
  2374.  
  2375.           This next example will demonstrate a true/false question.
  2376.  
  2377.           Q=
  2378.  
  2379.  
  2380.  
  2381.                     Answer true or false:
  2382.  
  2383.                     QASA understands the information in the database.
  2384.                          A=
  2385.           False
  2386.  
  2387.           Note the (valid) position of the 'A='. This time we have indented
  2388.           the question using tabs. When QASA compiles the question, it
  2389.           expands the tabs automatically (using 8-column tab stops) to
  2390.           maintain the alignment as it is in the database definition file.
  2391.           We also have three blank lines after the 'Q='; this serves to
  2392.           shift the question down toward the center of the question window
  2393.           to make it look nicer.
  2394.  
  2395.           This example is not good practice (although it will be compiled
  2396.           correctly), since the 'A=' would be easy to miss if the database
  2397.           were edited, and the indentation is inconsistent. It does,
  2398.           however, have a more serious drawback: to get the question right,
  2399.           you must type in 'false' - all 5 characters - and 'false' is one
  2400.           word I just cannot type (it always comes out 'flase')!
  2401.  
  2402.           For a true/false question, one would be likely to respond with
  2403.           'T', 'F', 'yes', 'y', 'no', 'n', or possibly '1' and '0'. To
  2404.           accommodate these options, QASA allows more than one correct
  2405.           answer. In fact, every nonblank line following 'A=' is treated as
  2406.           a correct answer. The second example above, then, would be more
  2407.           appropriately given by
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  2421.  
  2422.  
  2423.  
  2424.           QA Study Aid V5.3 User's Guide                                 37
  2425.  
  2426.  
  2427.           Q=
  2428.  
  2429.  
  2430.  
  2431.                     Answer true or false:
  2432.  
  2433.                     QASA understands the information in the database.
  2434.  
  2435.           A=
  2436.           False
  2437.           F
  2438.           No
  2439.           N
  2440.           0
  2441.  
  2442.           This permits any of the five answers to be regarded as correct.
  2443.  
  2444.           If you give an incorrect response to a question (e.g., one that
  2445.           is not among the list of correct answers), QASA will display the
  2446.           correct answer for you, as well as omit one or more points from
  2447.           your score. When QASA/QA displays the correct answer, it uses the
  2448.           first one given in the answer list. What this means is that
  2449.           QASA/QA will display
  2450.  
  2451.                            Incorrect. The correct answer is
  2452.                                         False
  2453.                               Press any key to continue.
  2454.  
  2455.           which is more professional than 'N', for example.
  2456.  
  2457.           This feature adds a lot of versatility to QASA and QA. Since
  2458.           QASA/QA is intended to be a study aid as well as a general-
  2459.           purpose testing program, it provides reinforcement of incorrect
  2460.           answers by permitting a more complete correct answer. To demon-
  2461.           strate this, we'll use a third example; this time, a fill-in-the-
  2462.           blank question:
  2463.  
  2464.           Q=
  2465.                The speed of light is ______ km/sec.
  2466.  
  2467.           A=
  2468.                Light travels at 300,000 km/sec.
  2469.                300000
  2470.                300,000
  2471.                300K
  2472.  
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  2480.  
  2481.  
  2482.  
  2483.           QA Study Aid V5.3 User's Guide                                 38
  2484.  
  2485.  
  2486.           In this example, an incorrect response will elicit
  2487.  
  2488.                            Incorrect. The correct answer is
  2489.                            Light travels at 300,000 km/sec.
  2490.                               Press any key to continue.
  2491.  
  2492.           Of course, this is also a correct answer in itself, but not a
  2493.           likely one. If you do enter it, it will be scored as correct. You
  2494.           would, however, be required to include the comma, the slash
  2495.           between 'km' and 'sec', and the period.
  2496.  
  2497.           There are three more plausible correct answers that QASA would
  2498.           consider to be correct. Any one of them is sufficient to credit
  2499.           the answer as correct.
  2500.  
  2501.           Note that the display of the correct answer may be disabled
  2502.           beginning with Version 3.0 of QASA. This is done by issuing the
  2503.           'D=' (Display Off) command in the database. This a global command
  2504.           and will turn off the display of all answers, no matter where you
  2505.           place the command in the database definition file.
  2506.  
  2507.  
  2508.           Macros
  2509.           ------
  2510.  
  2511.           When creating a large database definition file, it is annoying to
  2512.           have to type the four or more common answers to a true/false
  2513.           question. To make this easier, QASA supports simple macros. A
  2514.           macro is a block of text that is inserted in place of a macro
  2515.           identifier. We may therefore create a macro for 'true' and a
  2516.           macro for 'false', and use the macro identifier instead of typing
  2517.           all four answer lines. These macros would look something like the
  2518.           following example.
  2519.  
  2520.  
  2521.           M=
  2522.                $TRUE$
  2523.                true
  2524.                t
  2525.                yes
  2526.                y
  2527.  
  2528.           M=
  2529.                $FALSE$
  2530.                false
  2531.                f
  2532.                no
  2533.                n
  2534.  
  2535.  
  2536.  
  2537.  
  2538.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  2539.  
  2540.  
  2541.  
  2542.           QA Study Aid V5.3 User's Guide                                 39
  2543.  
  2544.  
  2545.           Q=
  2546.  
  2547.                     Answer true or false:
  2548.  
  2549.                     QASA understands the information in the database.
  2550.  
  2551.           A=
  2552.           $FALSE$
  2553.  
  2554.           The "M=" is the macro keyword, and tells QASA that the following
  2555.           lines form a macro definition. The first line following the macro
  2556.           keyword is the macro identifier. You may use ANY character string
  2557.           as a macro identifier, provided it does not contain blanks or
  2558.           tabs. The dollar signs are not necessary, but serve nicely to
  2559.           identify $FALSE$ as a macro invocation. When QASA reads the
  2560.           identifier, it will substitute all lines following the macro
  2561.           identifier up to the first blank line or keyword, whichever is
  2562.           found first. Note that QASA will display "false" as the correct
  2563.           answer if the question is answered incorrectly, as it is the
  2564.           first answer in the answer list formed by expanding the macro.
  2565.  
  2566.           The above is a short introduction to creating a database defini-
  2567.           tion file. The following section describes the QASA compiler in
  2568.           detail.
  2569.  
  2570.  
  2571.           The QASA Database Compiler
  2572.           ---------------------------
  2573.  
  2574.           The QASA compiler is used whenever a database is first created or
  2575.           it is changed. AFTER YOU REGISTER QASA, YOU MUST ALSO RECOMPILE
  2576.           YOUR DATABASES. A password (if entered using the /UP command) is
  2577.           required to gain access to it. Once the database definition file
  2578.           has been created, it is compiled with QASA, and the compiled
  2579.           database file (which has an extension of .QA) is used with the
  2580.           QASA program. This offers several advantages, among them:
  2581.  
  2582.                1.   The database is encrypted. A user of QASA or QA cannot
  2583.                     look in the file using any viewing, listing, or debug-
  2584.                     ging program and see the questions and answers. The
  2585.                     QASA/QA interpreter knows the encryption method and
  2586.                     decrypts the database as it reads it.
  2587.  
  2588.                2.   The author of the database definition file may specify
  2589.                     a number of options to control the quiz session. These
  2590.                     options cannot be seen or modified by anyone using QASA
  2591.                     or QA.
  2592.  
  2593.                3.   Since the database has been preprocessed by QASA,
  2594.                     loading and display of questions is fast and error-
  2595.  
  2596.  
  2597.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  2598.  
  2599.  
  2600.  
  2601.           QA Study Aid V5.3 User's Guide                                 40
  2602.  
  2603.  
  2604.                     free. It is not necessary for QASA or QA to perform any
  2605.                     formatting at run time.
  2606.  
  2607.  
  2608.           Using The QASA Compiler
  2609.           ------------------------
  2610.  
  2611.           When you issue the /UC command, QASA will prompt for a password
  2612.           (if one has been defined), and will then display a window showing
  2613.           the current directory. If your database definition files are in
  2614.           another directory, you may edit the directory here using the
  2615.           standard DOS directory naming conventions. Once you accept the
  2616.           directory by pressing ENTER, a file-selection window will be
  2617.           displayed, listing all of the database definition files in that
  2618.           directory (e.g., all files with an extension of ".DEF"). QASA
  2619.           requires you to use an extension of ".DEF" for the database
  2620.           definition file. Select the file you wish to compile and press
  2621.           ENTER. QASA will compile the database and then present a screen
  2622.           showing the results of the compilation.
  2623.  
  2624.           QASA will not make any changes to the database definition file
  2625.           (your 'source' file). It will create a compiled database file of
  2626.           the same base name, but with an extension of .QA. If the database
  2627.           definition file is named QUIZ.DEF, then the compiled database
  2628.           will have a name of QUIZ.QA. If the compiled database file
  2629.           already exists, it is overwritten by QASA, and the original
  2630.           contents will be lost. QASA will NOT warn you of this.
  2631.  
  2632.           When QASA is finished, it will display the results of the compi-
  2633.           lation, including the options you selected in the definition
  2634.           file. The output below was produced by compiling the sample
  2635.           database SAMPLE.DEF (the screen window has been reduced horizon-
  2636.           tally to fit on the page).
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.  
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  2657.  
  2658.  
  2659.  
  2660.           QA Study Aid V5.3 User's Guide                                 41
  2661.  
  2662.  
  2663.  
  2664.           +--------------------- Compilation Results ---------------------
  2665.           | Database Name:  QA Study Aid Sample Database
  2666.           | Input File:     D:\QASA\V530\SAMPLE.DEF
  2667.           | Output File:    D:\QPQ\V530\SAMPLE.QA
  2668.           | Score Filename: SAMPLE.SCR
  2669.           | Score Options:  Plain Text,Literal Answers,Record Administrator 
  2670.           | Time Limit:     00:10:00            Total Weight:    37
  2671.           | Clear Command:  Enabled             Mode Lock:       (none)
  2672.           | Letter Grades:  13                  Answer Display:  Enabled
  2673.           | Source Lines:   636                 Total Questions: 20   of 26
  2674.           | Macro List:                         With Help Text:  2
  2675.           | $TRUE$
  2676.           | $FALSE$
  2677.           |                    Press Any Key To Continue                  
  2678.           +---------------------------------------------------------------
  2679.  
  2680.  
  2681.           QASA Language Syntax
  2682.           ---------------------
  2683.  
  2684.           QASA, being a true compiler, requires that you follow certain
  2685.           syntactical rules when creating a database definition file. The
  2686.           syntax was made as simple and forgiving as possible to minimize
  2687.           the learning time.
  2688.  
  2689.           The QASA language is line-oriented, meaning that QASA views its
  2690.           input in terms of whole lines. You may not, therefore, put two
  2691.           keyword markers on the same line, for example.
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  2716.  
  2717.  
  2718.  
  2719.           QA Study Aid V5.3 User's Guide                                 42
  2720.  
  2721.  
  2722.           The following is a short summary of the keywords that QASA uses.
  2723.  
  2724.                Q=   Question text
  2725.                A=   Answer list
  2726.                H=   explanatory Help follows
  2727.                P=   remove Punctuation from the next answer
  2728.                N=   quiz Name
  2729.                M=   Macro definition
  2730.                T=   Time limit
  2731.                C=   Clear not allowed
  2732.                S=   lock in Sequential mode
  2733.                R=   lock in Random mode
  2734.                F=   output score Filename
  2735.                E=   Encrypt score file
  2736.                W=   assign Weighting
  2737.                G=   assign letter-Grade equivalencies
  2738.                D=   disable Display of incorrect answers
  2739.                L=   Limit the number of questions to a subset
  2740.                O=   omit the subset at compile time as opposed to run time
  2741.                V=   View literal answers
  2742.                I=   Ignore character
  2743.                X=   set eXport length
  2744.  
  2745.           Each of these keywords is described in the following paragraphs.
  2746.  
  2747.           QASA scans and discards all text in the database definition file
  2748.           that is not part of a keyword interpretation. This means that you
  2749.           may insert comments almost anywhere, without using special
  2750.           comment delimiters or markers. Since QASA is line-oriented, you
  2751.           may not, of course, place a comment on the same line with any
  2752.           keyword or its associated text. Comments are otherwise unre-
  2753.           stricted. The sample database definition file SAMPLE.DEF provides
  2754.           many examples of the use of comments.
  2755.  
  2756.           Terminators
  2757.           -----------
  2758.  
  2759.           Every QASA command keyword (e.g., "Q=", "A=", etc.) has a termi-
  2760.           nation, which tells the compiler when the end of the keyword
  2761.           interpretation has been reached. For all QASA keywords, with the
  2762.           single exception of the Q= keyword, the termination is the same:
  2763.           a blank line, another keyword, or end-of-file. In this context, a
  2764.           blank line is any line that contains zero or more space or tab
  2765.           characters only. For the Q= keyword, a blank line is NOT a termi-
  2766.           nation; only the 'A=' keyword terminates a question. This is to
  2767.           allow blank lines in the question text. You must be careful not
  2768.           to place comment lines between the Q= and A= keywords, since
  2769.           these will be regarded as part of the question and displayed on
  2770.           the QASA or QA screen.
  2771.  
  2772.  
  2773.  
  2774.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  2775.  
  2776.  
  2777.  
  2778.           QA Study Aid V5.3 User's Guide                                 43
  2779.  
  2780.  
  2781.           The Q= and A= Keywords
  2782.           ----------------------
  2783.  
  2784.           As mentioned previously, Q= and A= are the keywords for 'ques-
  2785.           tion' and 'answer', respectively. The syntax is as follows:
  2786.  
  2787.                Q=
  2788.                <question text>
  2789.                <question text>
  2790.                <blank line(s)>
  2791.                ....
  2792.                <question text>
  2793.                <blank line(s)>
  2794.                A=
  2795.                <displayed answer>
  2796.                ....
  2797.                <termination>
  2798.  
  2799.           A question may not have more than 15 lines of text associated
  2800.           with it, and you are limited to 76 characters per line. Within
  2801.           this rectangular boundary, you are unrestricted. If you exceed
  2802.           the allowed number of lines or if a line contains more than 76
  2803.           characters (after tab and macro expansion), QASA will display an
  2804.           error message.
  2805.  
  2806.           You are permitted any number of answer lines, limited only by the
  2807.           amount of memory available in the PC running QASA or QA. If the
  2808.           PC has 128K bytes or more of available memory (free memory above
  2809.           QASA, DOS, and all TSRs), you are essentially unrestricted.
  2810.  
  2811.  
  2812.           The H= Keyword
  2813.           --------------
  2814.  
  2815.           This keyword is used to assist the student in mastering the
  2816.           subject material by providing more detailed help when an answer
  2817.           is incorrect. For example, if a question is created in a way that
  2818.           some mathematical identity or formula must be known to the
  2819.           student in order to arrive at the correct answer, that identity
  2820.           or formula could be placed in the help section. If the student
  2821.           answers incorrectly, then the incorrect answer prompt will appear
  2822.           as follows.
  2823.  
  2824.           +-------- Incorrect. The correct answer is -------+
  2825.           |                                                 |
  2826.           |        The first line of the answer list        |
  2827.           |                                                 |
  2828.           |  Press F1 for information | Any key to Continue |
  2829.           +-------------------------------------------------+
  2830.  
  2831.  
  2832.  
  2833.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  2834.  
  2835.  
  2836.  
  2837.           QA Study Aid V5.3 User's Guide                                 44
  2838.  
  2839.  
  2840.           Note the prompt "Press F1 for information". This prompt will
  2841.           appear only on questions that have help text associated with
  2842.           them, and ONLY if the correct answer display has NOT been dis-
  2843.           abled with the D= keyword.
  2844.  
  2845.           THE H= KEYWORD MUST FOLLOW THE A= KEYWORD. Explanatory help
  2846.           becomes part of the question and answer. For example, consider
  2847.           the following question and answer.
  2848.  
  2849.           Q=
  2850.           Fill-in:
  2851.  
  2852.           In a right triangle, if the two sides intersecting at the right
  2853.           angle have lengths 3 and 4, the length of the hypotenuse is __.
  2854.           A=
  2855.           5
  2856.  
  2857.           The same question appears below with explanatory help.
  2858.  
  2859.           Q=
  2860.           Fill-in:
  2861.  
  2862.           In a right triangle, if the two sides intersecting at the right
  2863.           angle have lengths 3 and 4, the length of the hypotenuse is __.
  2864.           A=
  2865.           5
  2866.           H=
  2867.           The Pythagorean Theorem states that the length of the hypotenuse
  2868.           is equal to the square root of the sum of the squares of the
  2869.           other two sides. Therefore, (3*3)+(4*4)=25, the square root of
  2870.           which is 5.
  2871.  
  2872.           Like answer text, explanatory help text is terminated either by
  2873.           another keyword or by a blank line. One can easily avoid blank
  2874.           lines in an answer list, but blank lines may be needed in explan-
  2875.           atory help text. This is the purpose of the I= keyword described
  2876.           in the next section.
  2877.  
  2878.  
  2879.           The I= Keyword
  2880.           --------------
  2881.  
  2882.           This keyword means "Ignore" and appears as follows.
  2883.  
  2884.                I=
  2885.                c
  2886.  
  2887.           where 'c' is a printable, non-space character called the 'ignore
  2888.           character'. If this keyword is not issued, the ignore character
  2889.  
  2890.  
  2891.  
  2892.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  2893.  
  2894.  
  2895.  
  2896.           QA Study Aid V5.3 User's Guide                                 45
  2897.  
  2898.  
  2899.           does not exist. You may intentionally turn the ignore character
  2900.           off by placing a blank line after I=. as follows.
  2901.  
  2902.                I=
  2903.                *
  2904.  
  2905.           The ignore character is now an asterisk.
  2906.  
  2907.                I=
  2908.  
  2909.           The ignore character is now disabled.
  2910.  
  2911.           The ignore character is valid only when it is the FIRST CHARACTER
  2912.           on any given line. It serves to make a line non-blank, but does
  2913.           not otherwise exist. For example, to place the text
  2914.  
  2915.           I=
  2916.           *
  2917.           H=
  2918.           The ignore character is disabled by placing a blank line after
  2919.           the I= keyword, as follows:
  2920.  
  2921.           I=   (text required here or I= will be interpreted as a keyword!)
  2922.           *
  2923.           The ignore character is now disabled.
  2924.           I=
  2925.  
  2926.           In the above example, the line beginning with the asterisk is
  2927.           shortened by one by removing the asterisk. However, before its
  2928.           removal, it caused the line to be interpreted as part of the
  2929.           explanatory help and not as a blank line, which is how it will
  2930.           appear when displayed.
  2931.  
  2932.           Note that the asterisk was assigned as the ignore character and
  2933.           then disable after the explanatory help. It is not necessary to
  2934.           disable the ignore character, but you must remember that it will
  2935.           be ignored (removed) if it appears as the first character of a
  2936.           line.
  2937.  
  2938.  
  2939.           The P= Keyword
  2940.           --------------
  2941.  
  2942.           This keyword is used to simplify the answer list for answers that
  2943.           contain unimportant punctuation. For example, if the correct
  2944.           answer to a question is "Washington, D.C.", you may not want a
  2945.           student scored as incorrect if he or she were to answer with
  2946.           "Washington DC". The P= keyword prevents this situation.
  2947.  
  2948.  
  2949.  
  2950.  
  2951.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  2952.  
  2953.  
  2954.  
  2955.           QA Study Aid V5.3 User's Guide                                 46
  2956.  
  2957.  
  2958.           The P= keyword applies ONLY to the next answer list following the
  2959.           keyword. Once the next answer is compiled, punctuation is once
  2960.           again significant.
  2961.  
  2962.           Also, the P= keyword causes punctuation to be stripped from all
  2963.           answer lines beginning with the SECOND answer line. This is so
  2964.           that the correct answer can be displayed with all punctuation
  2965.           intact if the question is answered incorrectly. To elaborate on
  2966.           the "Washington, D.C." example, you could use:
  2967.  
  2968.           P=
  2969.           Q=
  2970.           What is the capitol of the United States?
  2971.           A=
  2972.           Washington, D.C.
  2973.           Washington, D.C.
  2974.  
  2975.           Note that the FIRST answer line will be left intact, but all
  2976.           punctuation will be removed from the second line when it is
  2977.           compiled. Also, when the user enters an answer in response to the
  2978.           question, all punctuation will be removed from the answer before
  2979.           it is compared to the answer list. Therefore, any answer that
  2980.           contains "Washington DC" will be scored as correct: "Washington,
  2981.           DC", "Washington D.C.", and so on. It is NOT necessary to include
  2982.           the punctuation in the second answer line above.
  2983.  
  2984.           This keyword is also useful for numbers; e.g., it removes any
  2985.           distinction between "1,000" and "1000", and between "$50" and
  2986.           "50". In some cases you will have to exercise caution, as in
  2987.           "$50.00", where "5000" would be scored as correct, even though it
  2988.           is not at all what was intended.
  2989.  
  2990.  
  2991.           The N= Keyword
  2992.           --------------
  2993.  
  2994.           The N= keyword is used to specify the quiz name. The name must
  2995.           appear on the line following the keyword, and may be up to 60
  2996.           characters in length. When the database is loaded into QASA or
  2997.           QA, this name appears in the top border of the center (question)
  2998.           window.
  2999.  
  3000.           For example, to name a quiz on American history as such, you
  3001.           would use
  3002.  
  3003.           N=
  3004.           American History Quiz
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  3011.  
  3012.  
  3013.  
  3014.           QA Study Aid V5.3 User's Guide                                 47
  3015.  
  3016.  
  3017.           The M= Keyword
  3018.           --------------
  3019.  
  3020.           The M= keyword is the macro definition keyword, and indicates to
  3021.           QASA that the following lines are a macro definition. The macro
  3022.           definition takes the following form:
  3023.  
  3024.                M=
  3025.                <macro identifier>
  3026.                <first macro line>
  3027.                <second macro line>
  3028.                ..............
  3029.                <Nth macro line>
  3030.                <termination>
  3031.  
  3032.           Macros are expanded only within question and answer text, so you
  3033.           may not use a macro to specify a score file name, for example.
  3034.  
  3035.           To build a macro for 'TRUE' from two other macros, you could use:
  3036.  
  3037.           M=
  3038.           $T$
  3039.           True
  3040.           T
  3041.           M=
  3042.           $Y$
  3043.           Yes
  3044.           Y
  3045.           M=
  3046.           $TRUE$
  3047.           $T$
  3048.           $Y$
  3049.  
  3050.           We have defined three macros, "$T$", "$Y$", and "$TRUE$". If QASA
  3051.           encounters $TRUE$ in a question or answer, it will replace it
  3052.           with:
  3053.  
  3054.           True
  3055.           T
  3056.           Yes
  3057.           Y
  3058.  
  3059.           because "True" and "T" are expansions of $T$ and "Yes" and "Y"
  3060.           are expansions of $Y$. Note that blank lines are unnecessary
  3061.           between the macro definitions, since each is terminated by the M=
  3062.           keyword of the following macro.
  3063.  
  3064.           Macro invocations MUST be surrounded by whitespace. For example,
  3065.           many multiple-choice questions use the blanket selectors "none of
  3066.  
  3067.  
  3068.  
  3069.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  3070.  
  3071.  
  3072.  
  3073.           QA Study Aid V5.3 User's Guide                                 48
  3074.  
  3075.  
  3076.           the above" and "all of the above". You could therefore use the
  3077.           following macros:
  3078.  
  3079.           M=
  3080.           $NONE$
  3081.           None of the above.
  3082.           M=
  3083.           $ALL$
  3084.           All of the above.
  3085.  
  3086.           and write a multiple-choice question as:
  3087.  
  3088.           Q=
  3089.           Multiple-choice:
  3090.  
  3091.           In what year did Christopher Columbus land in the New World?
  3092.  
  3093.                1. 1592
  3094.                2. 1492
  3095.                3. 1066
  3096.                4. $NONE$
  3097.                5. $ALL$
  3098.  
  3099.           A=
  3100.           2. 1492
  3101.           2
  3102.           1492
  3103.  
  3104.           QASA will expand this to:
  3105.  
  3106.           Q=
  3107.           Multiple-choice:
  3108.  
  3109.           In what year did Christopher Columbus land in the New World?
  3110.  
  3111.                1. 1592
  3112.                2. 1492
  3113.                3. 1066
  3114.                4. None of the above.
  3115.                5. All of the above.
  3116.  
  3117.           A=
  3118.           2. 1492
  3119.           2
  3120.           1492
  3121.  
  3122.           Remember that the QASA compiler is line-oriented, however. If you
  3123.           put the following in the database definition file:
  3124.  
  3125.  
  3126.  
  3127.  
  3128.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  3129.  
  3130.  
  3131.  
  3132.           QA Study Aid V5.3 User's Guide                                 49
  3133.  
  3134.  
  3135.           M=
  3136.           $NW$
  3137.           New World
  3138.  
  3139.           Q=
  3140.           Multiple-choice:
  3141.  
  3142.           In what year did Christopher Columbus land in the $NW$?
  3143.  
  3144.                1. 1592
  3145.                2. 1492
  3146.                3. 1066
  3147.                4. None of the above.
  3148.                5. All of the above.
  3149.  
  3150.           QASA will NOT expand it because there is no whitespace between
  3151.           $NW$ and the '?'. If, however, you use
  3152.  
  3153.           M=
  3154.           $NW$
  3155.           New World
  3156.  
  3157.           Q=
  3158.           Multiple-choice:
  3159.  
  3160.           In what year did Christopher Columbus land in the $NW$ ?
  3161.  
  3162.                1. 1592
  3163.                2. 1492
  3164.                3. 1066
  3165.                4. None of the above.
  3166.                5. All of the above.
  3167.  
  3168.           QASA will expand it to
  3169.  
  3170.           Q=
  3171.           Multiple-choice:
  3172.  
  3173.           In what year did Christopher Columbus land in the New World
  3174.            ?
  3175.                1. 1592
  3176.                2. 1492
  3177.                3. 1066
  3178.                4. None of the above.
  3179.                5. All of the above.
  3180.  
  3181.           because the macro expansion includes the newline. You should not,
  3182.           therefore, attempt to use a macro in the middle of a block of
  3183.           text.
  3184.  
  3185.  
  3186.  
  3187.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  3188.  
  3189.  
  3190.  
  3191.           QA Study Aid V5.3 User's Guide                                 50
  3192.  
  3193.  
  3194.           Although QASA contains a two-pass compiler, macros must be
  3195.           defined before they can be used. If you place a macro definition
  3196.           in the middle of the database definition file and use the macro
  3197.           identifier before and after it, then the identifiers that appear
  3198.           before the macro definition will NOT be expanded. Define all of
  3199.           your macros before entering the first question.
  3200.  
  3201.           As shown in the examples above, macros are expanded recursively,
  3202.           so if you place the macro identifier in any of the macro defini-
  3203.           tion lines, you will create a self-referential macro. QASA will
  3204.           detect this condition no matter how deeply nested the reference
  3205.           may be. A self-referential macro will cause a fatal compiler
  3206.           error. Recursive macros are allowed so that you may build complex
  3207.           macros from simple ones if you wish. An obvious self-referential
  3208.           macro is shown below:
  3209.  
  3210.           M=
  3211.           $MACRONAME$
  3212.           macro text line 1
  3213.           macro text line 2
  3214.           $MACRONAME$
  3215.  
  3216.           When QASA encounters the second "$MACRONAME$", it would attempt
  3217.           to expand it using the current definition of $MACRONAME$, which
  3218.           would in turn cause it to encounter $MACRONAME$ again, and so on,
  3219.           until the program runs out of memory. QASA will detect this
  3220.           condition and generate an error message.
  3221.  
  3222.           Not all self-referential macros are obvious, however. Note that
  3223.           you can create a self-referential macro using two macros, as
  3224.           shown below:
  3225.  
  3226.           M=
  3227.           $MACRO 1$
  3228.           text
  3229.           text
  3230.           $MACRO 2$
  3231.  
  3232.           M=
  3233.           $MACRO 2$
  3234.           text
  3235.           text
  3236.           $MACRO 1$
  3237.  
  3238.           In this case, both macros refer to the other when expanded,
  3239.           creating a circular reference. This will also cause a fatal
  3240.           compiler error.
  3241.  
  3242.  
  3243.  
  3244.  
  3245.  
  3246.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  3247.  
  3248.  
  3249.  
  3250.           QA Study Aid V5.3 User's Guide                                 51
  3251.  
  3252.  
  3253.           The T= Keyword
  3254.           --------------
  3255.  
  3256.           This is the time limit keyword. Include it in the database
  3257.           definition file to specify a time limit. If you omit it, there is
  3258.           no time limit.
  3259.  
  3260.           The syntax is as follows:
  3261.  
  3262.                T=
  3263.                HH:MM:SS
  3264.  
  3265.           where HH is hours, MM is minutes, and SS is seconds. If the time
  3266.           limit is less than an hour, you may omit the hours field; simi-
  3267.           larly, if the time limit is less than a minute, you may omit the
  3268.           hours and minutes fields. The sample database definition file
  3269.           contains a 10-minute timeout, given by
  3270.  
  3271.           T=
  3272.           10:00
  3273.  
  3274.           Note:     If you specify a time limit for a database, the /FS
  3275.                     (File/Save Database) command will be disabled. A user
  3276.                     attempting to use this command will receive an error
  3277.                     message, and the command will be ignored.
  3278.  
  3279.  
  3280.           The C= Keyword
  3281.           --------------
  3282.  
  3283.           This keyword is used to disable the Clear command. An individual
  3284.           taking a quiz with QASA can use the Clear command to reset the
  3285.           score and essentially do the quiz twice. The author of the
  3286.           database definition file may prevent this by entering
  3287.  
  3288.           C=
  3289.  
  3290.           in the database definition file. When this is done, QASA will
  3291.           ignore the Clear command completely.
  3292.  
  3293.           Note that if the Clear command is allowed, by omission of the C=
  3294.           keyword, and the score file is enabled with the F= keyword
  3295.           (described later), then a score record will be written to the
  3296.           score file indicating that the user cleared the score and re-
  3297.           started the quiz.
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  3306.  
  3307.  
  3308.  
  3309.           QA Study Aid V5.3 User's Guide                                 52
  3310.  
  3311.  
  3312.           The S= and R= Keywords
  3313.           ----------------------
  3314.  
  3315.           These are the mode lock keywords, where S= stands for "sequen-
  3316.           tial" and R= stands for "random". These keywords are mutually
  3317.           exclusive; a database definition may not contain both keywords.
  3318.           If it does, an error will be generated by QASA.
  3319.  
  3320.           These keywords are used to lock QASA and QA in the mode specified
  3321.           by the keyword. If you do not give either keyword, then the user
  3322.           of QASA (only) is free to use the Mode command to change modes.
  3323.  
  3324.           For example, to lock QASA in sequential mode, use the following:
  3325.  
  3326.           S=
  3327.  
  3328.           and to lock QASA in random mode:
  3329.  
  3330.           R=
  3331.  
  3332.           There are no other arguments. The lock remains in effect until
  3333.           another database is loaded (which may also be locked).
  3334.  
  3335.  
  3336.           The F= Keyword
  3337.           --------------
  3338.  
  3339.           The F= keyword controls logging of score information to a disk
  3340.           file. Logging is enabled by specifying a filename with the F=
  3341.           keyword, and disabled if you omit the keyword.
  3342.  
  3343.           The filename you specify may be any valid DOS pathname, up to 64
  3344.           characters in length. All scoring records are appended to the
  3345.           file if it already exists, or the file will be created automati-
  3346.           cally if it does not exist. QASA and QA will, however, force the
  3347.           filename to have an extension of ".SCR".
  3348.  
  3349.           The score logging file may exist on a file server of a networked
  3350.           system if desired. However, QASA AND QA SUPPORT FILE SHARING. You
  3351.           must have SHARE.EXE installed for file sharing to be effective.
  3352.           Both QASA and QA will detect the presence or absence of SHARE.EXE
  3353.           and warn you if it is needed. If QASA or QA is unable to obtain a
  3354.           lock on the file, a warning will be displayed and the file will
  3355.           be saved on a local disk. IN NO CASE WILL A SCORE BE DISCARDED.
  3356.  
  3357.           All score log records are plain ASCII (except when encryption is
  3358.           selected). An example is reproduced below. It is compressed
  3359.           slightly to fit on the page.
  3360.  
  3361.  
  3362.  
  3363.  
  3364.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  3365.  
  3366.  
  3367.  
  3368.           QA Study Aid V5.3 User's Guide                                 53
  3369.  
  3370.  
  3371.           Student Name:         John Q. Public
  3372.           Database Name:        QA Study Aid Sample Database
  3373.           Final Score:          88.89%
  3374.           Grade:                A-
  3375.           Termination:          TIME LIMIT
  3376.  
  3377.           Started:              Saturday, May 7, 1995, 6:53:45 pm
  3378.           Completed:            Saturday, May 7, 1995, 6:55:00 pm
  3379.           Elapsed Time:         00:01:15
  3380.  
  3381.           Database File:        D:\QASA\V530\SAMPLE.QA
  3382.           Total Questions:      20 of 25 (randomly selected at run time)
  3383.           Possible Points:      27
  3384.           Points Awarded:       24
  3385.  
  3386.           Answers:      1    2    3    4    5    6    7    8    9   10
  3387.           ---------  ---- ---- ---- ---- ---- ---- ---- ---- ---- ----
  3388.           0001-0010 11.11 3.70 3.70 3.70 3.70 7.41       --- 7.41  ---
  3389.            Entered:  128k    c    2    2    c    y         n    y    c
  3390.           0011-0020  3.70 3.70      7.41 3.70      7.41  --- 3.70 7.41
  3391.            Entered:     3    7         n    d         n    c    3    n
  3392.           0021-0030  3.70 3.70      3.70
  3393.            Entered:     2    2         2
  3394.  
  3395.           *****************************************************************
  3396.  
  3397.           The '***..***' forms a separator between individual records.
  3398.  
  3399.           The first block contains summary information regarding the quiz
  3400.           session. The quiz taker's name is listed along with the name of
  3401.           the database (given by the N= keyword), the final score, the
  3402.           letter-grade equivalent (or "n/a" if none were assigned), and the
  3403.           reason the score record was written to the score file. In this
  3404.           example, it is given as 'TIME LIMIT'. This means that the quiz
  3405.           taker used up the time allotted by the T= keyword. The possible
  3406.           reasons for termination are:
  3407.  
  3408.                Completed      The user answered all questions (and option-
  3409.                               ally, within the time allotted by the T=
  3410.                               keyword).
  3411.  
  3412.                TIME LIMIT     The user exceeded the time allotted by the T=
  3413.                               keyword. This reason can only be produced if
  3414.                               a time limit was given.
  3415.  
  3416.                ABORTED        This indicates that the user quit the QASA or
  3417.                               QA session before answering all questions
  3418.                               using the /FX command or by pressing Control-
  3419.                               C or Control-Break.
  3420.  
  3421.  
  3422.  
  3423.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  3424.  
  3425.  
  3426.  
  3427.           QA Study Aid V5.3 User's Guide                                 54
  3428.  
  3429.  
  3430.                CLEARED        The Clear command (/MC) was used to clear the
  3431.                               score and restart the quiz. This reason can-
  3432.                               not be produced if the C= keyword is used to
  3433.                               disable the Clear command.
  3434.  
  3435.                RELOADED       The user reloaded the database, or loaded a
  3436.                               different database, or continued a previous-
  3437.                               ly-saved database before all questions were
  3438.                               answered.
  3439.  
  3440.           The final score is always the ratio of the number of possible
  3441.           points to the total number of points awarded by answering cor-
  3442.           rectly. Questions that were not answered are scored as incorrect
  3443.           (zero points awarded).
  3444.  
  3445.           The score file record also specifies the time the database was
  3446.           loaded (thereby starting the timer, if a time limit was given),
  3447.           the time the quiz was completed or stopped (for any of the
  3448.           reasons given above), and the elapsed time.
  3449.  
  3450.           The third block of the record gives the name of the compiled
  3451.           database file, the number of questions in the file, and the
  3452.           number of possible points with the number of points awarded.
  3453.           Because QASA supports weighting, the number of possible points
  3454.           may be entirely different from the number of questions.
  3455.  
  3456.           The last block is the answer matrix. This shows the results of
  3457.           each question in the database, ten questions per line. Each
  3458.           question may have one of four possible outcomes:
  3459.  
  3460.                1.   The question was answered, and answered correctly. The
  3461.                     point matrix will show the number of points awarded as
  3462.                     a ratio of the number of possible points, relative to
  3463.                     100.
  3464.  
  3465.                2.   The question was answered, but answered incorrectly.
  3466.                     The point matrix will show that no points were awarded
  3467.                     with '---'.
  3468.  
  3469.                3.   The question was not answered, either by skipping over
  3470.                     it or by exceeding the allotted time. The point matrix
  3471.                     will show this with '???'. No points were awarded.
  3472.  
  3473.                4.   The point matrix entry for the question is completely
  3474.                     blank, which means that it was omitted from a subset
  3475.                     generated from the full database. In this case, the
  3476.                     question was not considered at all, in any calcula-
  3477.                     tions.
  3478.  
  3479.  
  3480.  
  3481.  
  3482.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  3483.  
  3484.  
  3485.  
  3486.           QA Study Aid V5.3 User's Guide                                 55
  3487.  
  3488.  
  3489.           In the example score record shown, you can see that questions 8,
  3490.           10, and 18 were answered incorrectly, questions 7, 13, 16, and 23
  3491.           were not answered (most likely due to the time limit given as the
  3492.           reason), and the remaining 15 questions were answered correctly.
  3493.           The point breakdown will be described in the section on weight-
  3494.           ing.
  3495.  
  3496.           Because this database included the V= keyword (View literal
  3497.           answers), the answers that the student entered are included in
  3498.           the answer matrix as "Entered:". By default, the first five
  3499.           characters of each answer are written to the score file (leading
  3500.           whitespace is removed). This information may be used to perform
  3501.           statistical analysis on problem subject areas. For example, if
  3502.           question 6 is answered incorrectly in 90% of the tests, then the
  3503.           phrasing of the question is suspect or the subject area needs
  3504.           review.
  3505.  
  3506.           You can increase the length of the answers written to the score
  3507.           file using the X= keyword. If the default length of five is
  3508.           increased, then the length of each line in the answer matrix will
  3509.           increase accordingly. For example, with the answer length of
  3510.           five, the matrix will require 70 characters (5 answer plus one
  3511.           space) times 10 questions per line, plus question numbers. Since
  3512.           you can increase the answer length to 40 characters, you can
  3513.           potentially make each line up to 420 characters long. Why would
  3514.           you want to do this? Because the entire answer in the score file
  3515.           is exported using the /UX command. 
  3516.  
  3517.  
  3518.           The E= Keyword
  3519.           --------------
  3520.  
  3521.           This keyword is used to instruct QASA that the score file is to
  3522.           be encrypted. This prevents a user from completing a quiz session
  3523.           and then editing the score file manually to increase the score.
  3524.  
  3525.           When this keyword is used, the score file will not be human-
  3526.           readable, and must be converted back to plain text. This is done
  3527.           using the /UD (Utilities/Decrypt score file) command. This
  3528.           command, which is password-protected, will restore the score file
  3529.           to plain text using the same file name. If the score file is, or
  3530.           has already been converted to plain text, /UD will not reprocess
  3531.           it.
  3532.  
  3533.           If you enter the E= keyword anywhere in the database definition
  3534.           file, QASA will set a global flag that encrypts the entire score
  3535.           file.
  3536.  
  3537.  
  3538.  
  3539.  
  3540.  
  3541.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  3542.  
  3543.  
  3544.  
  3545.           QA Study Aid V5.3 User's Guide                                 56
  3546.  
  3547.  
  3548.           The D= Keyword
  3549.           --------------
  3550.  
  3551.           This keyword is used to disable the display of the correct answer
  3552.           if a question is answered incorrectly. If omitted, QASA or QA
  3553.           will display
  3554.  
  3555.                            Incorrect. The correct answer is
  3556.                                    (Correct Answer)
  3557.                               Press any key to continue
  3558.  
  3559.           The syntax of the D= keyword is as follows:
  3560.  
  3561.           D=
  3562.  
  3563.           If you enter the D= keyword anywhere in the database definition
  3564.           file, QASA will set a global flag that disables this display.
  3565.           QASA/QA will go on to the next question as though the answer was
  3566.           correct.
  3567.  
  3568.           Note that if this option is given, the scoring window will not
  3569.           display the number of questions answered correctly or any other
  3570.           scoring information.
  3571.  
  3572.  
  3573.           The W= Keyword
  3574.           --------------
  3575.  
  3576.           This keyword is used to assign weights to each question. The
  3577.           weighting system you use is entirely arbitrary and up to you.
  3578.           QASA imposes only the restriction that you use integer weights,
  3579.           and that you use numbers between 0 and 16383, inclusive.
  3580.  
  3581.           The syntax of the W= keyword is as follows:
  3582.  
  3583.           W=
  3584.           <weight>
  3585.  
  3586.           When QASA encounters this keyword, it reads the weight and
  3587.           assigns it to all the questions that follow it. If QASA encoun-
  3588.           ters the W= keyword again, it will change the weight to the new
  3589.           weight, and assign the new weight to all following questions. As
  3590.           each question is processed by the QASA compiler, QASA keeps track
  3591.           of the total weight. When QASA scores a question, it determines
  3592.           the point score to be the ratio of the total weight to that of
  3593.           the question in percent. This point score is added to the running
  3594.           score shown in the scoring window, and also appears in the point
  3595.           matrix in the score file (actually, the point score is recalcu-
  3596.           lated after each question from the weights to avoid rounding
  3597.           errors).
  3598.  
  3599.  
  3600.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  3601.  
  3602.  
  3603.  
  3604.           QA Study Aid V5.3 User's Guide                                 57
  3605.  
  3606.  
  3607.           If you do not specify a weight anywhere in the database defini-
  3608.           tion file, all questions will be weighted as one point by de-
  3609.           fault.
  3610.  
  3611.           Note that this arrangement allows you total flexibility in
  3612.           setting up a weighting system. You do not have to weight each
  3613.           question as a fraction of 100, for example. QASA does this for
  3614.           you.
  3615.  
  3616.           The sample database weights each 'fill-in' question as three
  3617.           points, each true/false as 2 points, and each multiple-choice
  3618.           question as one point. There is one 'fill-in' question, 7 'true-
  3619.           false' questions, and 12 'multiple-choice' questions. The points
  3620.           are calculated as follows:
  3621.  
  3622.                fill-in             1    times     3 points  =    3 points
  3623.                true/false          7    times     2 points  =    14 points
  3624.                multiple-choice     12   times     1 point   =    12 points
  3625.                                    -------------------------------------
  3626.                Totals:             20 questions                  29 points
  3627.  
  3628.           There are therefore 29 possible points (as shown in the score
  3629.           file). A 'fill-in' question is worth 3/29 points or 10.34 points
  3630.           relative to 100. A 'true/false' question is worth 2/29 points or
  3631.           6.90 points relative to 100, and a 'multiple-choice' question
  3632.           1/29 or 3.45 points relative to 100. In the example score record,
  3633.           the user was awarded a total of 21 out of 29 possible points, for
  3634.           a score of 21/29 or 72.41%. Adding all of the points shown in the
  3635.           point matrix will produce the same result (there may be a slight
  3636.           difference due to rounding, which is done only when the scores
  3637.           are displayed).
  3638.  
  3639.           QASA also allows you to assign a weight of zero to one or any
  3640.           number of questions. These questions will not affect the score,
  3641.           as the score for any question is the ratio of the total weight of
  3642.           all questions to the weight of the question being scored. If you
  3643.           assign a weight of zero to all questions, the score will always
  3644.           be zero.
  3645.  
  3646.  
  3647.           The L= Keyword
  3648.           --------------
  3649.  
  3650.           The Limit keyword command allows you to specify to the QASA
  3651.           compiler that it is to create a subset of the database. The
  3652.           syntax is as follows:
  3653.  
  3654.           L=
  3655.           <number of questions>
  3656.  
  3657.  
  3658.  
  3659.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  3660.  
  3661.  
  3662.  
  3663.           QA Study Aid V5.3 User's Guide                                 58
  3664.  
  3665.  
  3666.           The sample database contains 25 questions, and also contains the
  3667.           L= keyword to limit the database to 20 of the possible 25 ques-
  3668.           tions. The QASA compiler chooses the 20 questions at random.
  3669.  
  3670.           When a subset database is created and executed, there are two
  3671.           possible times when the subset selection may be made: (1) when
  3672.           the database is compiled, in which case the compiler makes the
  3673.           choices, and (2) at run-time, when the database is loaded, in
  3674.           which case it is the QASA or QA interpreter that selects the
  3675.           subset.
  3676.  
  3677.           If QASA is being used by a single individual, it makes little
  3678.           difference when the selections are made. In a classroom environ-
  3679.           ment, however, the difference is substantial.
  3680.  
  3681.           In a classroom environment, or any environment where more than
  3682.           one person is taking a quiz using QASA (or QA), a database where
  3683.           the subset is chosen at compile time will result in each person
  3684.           being asked exactly the same set of questions. This is useful for
  3685.           generating a random class quiz, for example.
  3686.  
  3687.           However, if the choice is deferred until run time, then each
  3688.           person will be asked the same number of questions, but each
  3689.           person will be taking a quiz that may be entirely different from
  3690.           all the others. If the database contains questions of varying
  3691.           difficulty, some will be given 'easy' questions, while others may
  3692.           receive 'hard' ones.
  3693.  
  3694.           The choice of when to generate the random subset is performed by
  3695.           the O= keyword described below.
  3696.  
  3697.  
  3698.           The O= Keyword
  3699.           --------------
  3700.  
  3701.           This keyword is used to define when the random subset of the
  3702.           database defined by the L= keyword is generated. If the L=
  3703.           keyword is not specified, this keyword will have no effect. It
  3704.           may be given before or after the L= keyword.
  3705.  
  3706.           If specified, O= means Omit immediately; in other words, omit the
  3707.           questions that are not a part of the random subset at compile
  3708.           time.
  3709.  
  3710.  
  3711.  
  3712.  
  3713.  
  3714.  
  3715.  
  3716.  
  3717.  
  3718.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  3719.  
  3720.  
  3721.  
  3722.           QA Study Aid V5.3 User's Guide                                 59
  3723.  
  3724.  
  3725.           The V= Keyword
  3726.           --------------
  3727.  
  3728.           This keyword is used to specify that the text the user entered
  3729.           when taking the quiz is to be stored in the score file in the
  3730.           answer matrix. The text will be stripped of leading whitespace,
  3731.           but will not otherwise be pre-processed before storage in the
  3732.           score file. The information can, therefore, be used to resolve
  3733.           disputes or to collect statistical information concerning the
  3734.           answers most students give for a particular question. On page 55
  3735.           is an example of an answer matrix which includes literal answers.
  3736.  
  3737.           Note that literal answers are always carried internally so that
  3738.           answers may be reviewed in 'view all' mode, This option deter-
  3739.           mines only if the are written to the score file (and therefore,
  3740.           if they are exported using the /UX command).
  3741.  
  3742.  
  3743.           The X= Keyword
  3744.           --------------
  3745.  
  3746.           This keyword is used to increase the length of the literal
  3747.           answers retained internally and exported. It takes at least one
  3748.           number (n1) as an argument; a second number (n2) is optional. The
  3749.           syntax is as follows:
  3750.  
  3751.                X=
  3752.                n1[,n2]
  3753.  
  3754.           where [] indicates optional arguments. The first number is the
  3755.           maximum length of the literal answers that will be carried
  3756.           internally - in other words, the maximum number of characters
  3757.           that can be presented for review in 'view all' mode. If set to 7,
  3758.           for example, an answer of 'Washington, D.C.' would be recalled
  3759.           for review as 'Washing'. When scored again following the review,
  3760.           it would be scored as incorrect. To avoid this problem, the
  3761.           default internal answer length is set to 40 characters. You can
  3762.           save memory by decreasing this if you do not need this many
  3763.           characters.
  3764.  
  3765.           The optional second argument is the length of the literal answer
  3766.           that will be written to the score file (the default is five). If
  3767.           omitted, then its value will be same as the first.
  3768.  
  3769.  
  3770.  
  3771.  
  3772.  
  3773.  
  3774.  
  3775.  
  3776.  
  3777.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  3778.  
  3779.  
  3780.  
  3781.           QA Study Aid V5.3 User's Guide                                 60
  3782.  
  3783.  
  3784.           The K= Keyword
  3785.           --------------
  3786.  
  3787.           This keyword is used to instruct QASA and QA to prompt for the
  3788.           name of the administrator. This may be the person administering
  3789.           the test, the teacher's name, or the name of any person you wish
  3790.           to associate with each test session for each student.
  3791.  
  3792.           The name of the administrator will be recorded in the score file
  3793.           and in the exported data file. If no score file is specified,
  3794.           this keyword has no effect.
  3795.  
  3796.  
  3797.  
  3798.  
  3799.  
  3800.  
  3801.  
  3802.  
  3803.  
  3804.  
  3805.  
  3806.  
  3807.  
  3808.  
  3809.  
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815.  
  3816.  
  3817.  
  3818.  
  3819.  
  3820.  
  3821.  
  3822.  
  3823.  
  3824.  
  3825.  
  3826.  
  3827.  
  3828.  
  3829.  
  3830.  
  3831.  
  3832.  
  3833.  
  3834.  
  3835.  
  3836.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  3837.  
  3838.  
  3839.  
  3840.           QA Study Aid V5.3 User's Guide                                 61
  3841.  
  3842.  
  3843.                        Appendix A: QASA Compiler Error Messages
  3844.                        ----------------------------------------
  3845.  
  3846.           Illegal definition filename: <filename>
  3847.  
  3848.                This error is generated if you supply a database definition
  3849.                file with an extension of .QA.
  3850.  
  3851.           Cannot find database definition file <filename>
  3852.  
  3853.                This error indicates that QASA was not able to open the
  3854.                database definition file you specified.
  3855.  
  3856.           Unable to create temporary file <filename>
  3857.  
  3858.                This error indicates that QASA was not able to create its
  3859.                intermediate temporary file.
  3860.  
  3861.           File <def file> : Line <line> : Answer omitted
  3862.  
  3863.                You specified a question without an accompanying answer, or
  3864.                your syntax is such that QASA could not determine where the
  3865.                answer is.
  3866.  
  3867.           File <def file> : Line <line> : Question omitted
  3868.  
  3869.                You specified an answer without a preceding question, or
  3870.                your syntax was such that QASA could not locate the ques-
  3871.                tion.
  3872.  
  3873.           File <def file> : Line <line> : Macro name missing
  3874.  
  3875.                You specified a macro definition (M=), but the next line is
  3876.                blank.
  3877.  
  3878.           File <def file> : Line <line> : Weight definition missing
  3879.  
  3880.                You specified weighting (W=), but the next line is blank.
  3881.  
  3882.           File <def file> : Line <line> : Invalid weight
  3883.  
  3884.                You specified a weight that was outside the range 1..32767
  3885.                or entered non-numeric characters.
  3886.  
  3887.           File <def file> : Line <line> : Title missing
  3888.  
  3889.                You specified the name keyword N=, but the next line is
  3890.                blank.
  3891.  
  3892.  
  3893.  
  3894.  
  3895.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  3896.  
  3897.  
  3898.  
  3899.           QA Study Aid V5.3 User's Guide                                 62
  3900.  
  3901.  
  3902.           File <def file> : Line <line> : Title too long - truncated
  3903.  
  3904.                The name you entered after the N= keyword is longer than 60
  3905.                characters.
  3906.  
  3907.           File <def file> : Line <line> : Time limit definition missing
  3908.  
  3909.                You specified the time limit keyword T=, but the next line
  3910.                is blank.
  3911.  
  3912.           File <def file> : Line <line> : Invalid time limit
  3913.  
  3914.                The time limit you specified following the T= keyword is not
  3915.                in the form HH:MM:SS.
  3916.  
  3917.           File <def file> : Line <line> : Mode lock already set
  3918.  
  3919.                You specified S= and R= in the same definition file. QASA is
  3920.                complaining about the second occurrence.
  3921.  
  3922.           File <def file> : Line <line> : Filename missing
  3923.  
  3924.                You specified an output score file with the F= keyword, but
  3925.                the next line is blank.
  3926.  
  3927.           File <def file> : Line <line> : Illegal filename
  3928.  
  3929.                You specified a filename after the F= keyword that has
  3930.                invalid characters or longer than 64 characters.
  3931.  
  3932.           File <def file> : Line <line> : Question line exceeds <nn>
  3933.           characters
  3934.  
  3935.                You entered a line in a question block that will not fit
  3936.                into QASA's window.
  3937.  
  3938.           File <def file> : Line <line> : Question exceeds <nn> lines
  3939.  
  3940.                You entered a question that has too many lines.
  3941.  
  3942.           File <def file> : Line <line> : Answer line exceeds <nn> charac-
  3943.           ters
  3944.  
  3945.                You entered an answer line that will not fit into QASA's
  3946.                answer window.
  3947.  
  3948.           Cannot create database output file <filename>
  3949.  
  3950.                QASA was unable to create the compiled database output file.
  3951.  
  3952.  
  3953.  
  3954.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  3955.  
  3956.  
  3957.  
  3958.           QA Study Aid V5.3 User's Guide                                 63
  3959.  
  3960.  
  3961.           Cannot open temporary file <filename>
  3962.  
  3963.                QASA was unable to create its temporary file.
  3964.  
  3965.           File <def file> : Line <line> : Macro <name> is self-referential
  3966.  
  3967.                The macro specified is self-referential. This may be a
  3968.                direct self-referencing macro or it may occur as a result of
  3969.                a complex series of recursive, circular macro expansions.
  3970.  
  3971.           Sample limit excessive - corrected
  3972.  
  3973.                The number entered as the argument to the L= keyword exceeds
  3974.                the number of questions in the database. This is a warning
  3975.                to tell you that the sample size has been reduced to the
  3976.                number of questions in the database.
  3977.  
  3978.  
  3979.  
  3980.  
  3981.  
  3982.  
  3983.  
  3984.  
  3985.  
  3986.  
  3987.  
  3988.  
  3989.  
  3990.  
  3991.  
  3992.  
  3993.  
  3994.  
  3995.  
  3996.  
  3997.  
  3998.  
  3999.  
  4000.  
  4001.  
  4002.  
  4003.  
  4004.  
  4005.  
  4006.  
  4007.  
  4008.  
  4009.  
  4010.  
  4011.  
  4012.  
  4013.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  4014.  
  4015.  
  4016.  
  4017.           QA Study Aid V5.3 User's Guide                                 64
  4018.  
  4019.  
  4020.  
  4021.                            Appendix B: Revision Information
  4022.                            --------------------------------
  4023.  
  4024.           Version 5.3    October 14, 1995
  4025.  
  4026.                Added the 'view all' review mode and added the commands /VU
  4027.                and /VA.
  4028.  
  4029.                Changed the 'Mode' menu to the 'View' menu.
  4030.  
  4031.                Changed the 'File' menu options to follow CUA guidelines.
  4032.                The database operations are now 'open' and 'close' instead
  4033.                of 'load' and 'quit'.
  4034.  
  4035.                Replaced the test indexing mechanism. The index will now be
  4036.                loaded into memory until memory is full. Any additional
  4037.                index information will overflow to a swap file on disk. In
  4038.                addition, the size of each index entry is now variable to
  4039.                accommodate the X= keyword.
  4040.  
  4041.                Replaced the SAMPLE database with DEMO1 and DEMO2, which
  4042.                show operation in 'view unanswered' and 'view all' modes,
  4043.                respectively. The demos can be invoked with the batch files
  4044.                DEMO1.BAT and DEMO2.BAT.
  4045.  
  4046.                Added the 'File', 'View', and 'Name' menus to the QA.EXE
  4047.                program.
  4048.  
  4049.                Fixed a bug that suppressed the menus in QA.EXE if a quiz
  4050.                name is specified on the command line.
  4051.  
  4052.                Added the /Vxx command-line options to select the operating
  4053.                mode on startup.
  4054.  
  4055.                Modified the user interface so that questions can always be
  4056.                answered or skipped with the ENTER key. The ESCape key is no
  4057.                longer required, although it will still function. Also
  4058.                changed the selector for additional help on answers to the
  4059.                F1 (help) key.
  4060.  
  4061.                Fixed a bug in the registration form that allowed credit
  4062.                card information to be added without specifying the correct
  4063.                credit card.
  4064.  
  4065.                Imposed the 25-question limit n the compiler for unregis-
  4066.                tered versions (ref: ASP bylaws modified PoNC (Policy on No
  4067.                Crippling)).
  4068.  
  4069.  
  4070.  
  4071.  
  4072.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  4073.  
  4074.  
  4075.  
  4076.           QA Study Aid V5.3 User's Guide                                 65
  4077.  
  4078.  
  4079.           Version 5.2    July 31, 1995
  4080.  
  4081.                Added the ability to export the entire score file after an
  4082.                X-Y transformation of the score file data.
  4083.  
  4084.                Removed the requirement of decoding the score file before
  4085.                exporting it. An encoded score file can be exported and it
  4086.                will remain encoded.
  4087.  
  4088.                Added progress indicators to the export and compile func-
  4089.                tions.
  4090.  
  4091.           Version 5.1    June 30, 1995
  4092.  
  4093.                Corrected a bug in the memory allocation strategy that
  4094.                prevented more than 1532 questions from being loaded. A swap
  4095.                file is now used if the test is larger than 1500 questions.
  4096.  
  4097.                Significant price reductions.
  4098.  
  4099.           Version 5.0    September 6,1994
  4100.  
  4101.                Corrected a serious bug that occurred when a random subset
  4102.                was selected at run-time and the presentation mode was set
  4103.                to random. At the end of the subset, QASA would hang, look-
  4104.                ing for another question to present. Thank you for reporting
  4105.                the error.
  4106.  
  4107.                Added an installation program that locates any existing copy
  4108.                of QA Study Aid and transfers the registration data to the
  4109.                new version.
  4110.  
  4111.                Added the /CE (Configure/Editor) and /UE (Utilities/Edit)
  4112.                commands to support an integrated editor.
  4113.  
  4114.                Created separate configuration menu group.
  4115.  
  4116.                Added the ability to record the name of the administrator
  4117.                (the person administering the test, or the teacher, as
  4118.                appropriate) in the score file and in the exported data
  4119.                file. This feature is controlled by the K= keyword.
  4120.  
  4121.                Added the explanatory help text feature which allows de-
  4122.                tailed help to be optionally displayed if a student answers
  4123.                a question incorrectly. This feature is controlled by the H=
  4124.                keyword.
  4125.  
  4126.                The text that a student enters for each question may now be
  4127.                saved in the answer matrix in the score file. This data can
  4128.  
  4129.  
  4130.  
  4131.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  4132.  
  4133.  
  4134.  
  4135.           QA Study Aid V5.3 User's Guide                                 66
  4136.  
  4137.  
  4138.                be used for statistical analysis or for resolving disputes.
  4139.                The V= keyword controls this feature.
  4140.  
  4141.                Blank lines may now be entered where blank lines are nor-
  4142.                mally interpreted as terminators using the ignore character.
  4143.                The ignore character is assigned by the I= keyword.
  4144.  
  4145.                Added credit card information to the registration form.
  4146.                Added the encrypted E-mail registration capability.
  4147.  
  4148.                Added registration information to the QA interpreter. The
  4149.                interpreter can now detect if QASA has been registered. Both
  4150.                QASA and QA will display registration information on startup
  4151.                ("Registration Reminder Screen").
  4152.  
  4153.                Formalized a distribution policy for the QA interpreter.
  4154.  
  4155.                Added the Unlimited Upgrade option plan for no-charge up-
  4156.                grades.
  4157.  
  4158.           Version 4.1    January 17, 1993
  4159.  
  4160.                Beginning with Version 4.1, QASA can be registered online
  4161.                via CompuServe. GO SWREG and register ID # 502.
  4162.  
  4163.                Modified the registration screen so that if 200 or more
  4164.                copies are specified, a site license is automatically grant-
  4165.                ed.
  4166.  
  4167.           Version 4.0    December 1, 1992
  4168.  
  4169.                Version 4.0 incorporates many of the changes and improve-
  4170.                ments that have been suggested by various users of QA Study
  4171.                Aid. Two significant features have been added in this ver-
  4172.                sion:
  4173.  
  4174.                (1)  A separate program, QA.EXE, is included with the QA
  4175.                     Study Aid package. This program is essentially the
  4176.                     QASA.EXE program without the quiz creation capabili-
  4177.                     ties. It has only a single menu for simple operation.
  4178.                     Its purpose is to enable you to give tests and quizzes
  4179.                     without confusing the test takers with the many options
  4180.                     available with QASA.EXE.
  4181.  
  4182.                     QA.EXE is not serialized and does not attempt to modify
  4183.                     itself at any time; this permits it to be executed in a
  4184.                     DOS screen under OS/2 2.0.
  4185.  
  4186.                     Also, if the name of a quiz is specified on the command
  4187.                     line (or in a batch file), then QA.EXE will automati-
  4188.  
  4189.  
  4190.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  4191.  
  4192.  
  4193.  
  4194.           QA Study Aid V5.3 User's Guide                                 67
  4195.  
  4196.  
  4197.                     cally terminate, returning control to DOS when the quiz
  4198.                     is completed (or terminated for any reason). This
  4199.                     feature permits one to complete a quiz session without
  4200.                     using any commands or menu functions at all.
  4201.  
  4202.                (2)  QASA.EXE is now able to generate a subset of a data-
  4203.                     base. For example, if you create a database containing
  4204.                     50 questions, you can specify that QASA generate a
  4205.                     database containing only 25 questions, chosen at ran-
  4206.                     dom. You may select the size of the subset to be any-
  4207.                     thing from 1 up to the full size of the database.
  4208.  
  4209.                     Further, the random selection of questions may be
  4210.                     specified to occur at one of two times: during the
  4211.                     compilation process, or when the database is loaded.
  4212.                     Making the selection at compile time allows each stu-
  4213.                     dent to receive the same database. If the selection is
  4214.                     deferred until run time, then each student will receive
  4215.                     a unique and different subset of the database. Each
  4216.                     student will, however, be given the same number of
  4217.                     questions to answer.
  4218.  
  4219.                     Two new command keywords, "L=" and "O=", are used to
  4220.                     control the creation of database subsets.
  4221.  
  4222.                The naming conventions have been changed in version 4.0.
  4223.                Specifically, the ampersand ('&') has been removed from all
  4224.                filenames, as some operating systems (DEC's VMS and IBM's
  4225.                OS/2 are two) cannot tolerate this character within a file-
  4226.                name. CompuServe cannot tolerate an ampersand either. Also,
  4227.                the filenames have been shortened to six characters instead
  4228.                of the eight allowed by DOS, again to accommodate other
  4229.                operating systems. These changes insure that QA Study Aid
  4230.                will have the same filename from all sources.
  4231.  
  4232.           Version 3.91   April 26, 1992
  4233.  
  4234.                Added the /UR (Utilities/print Registration form) command.
  4235.                This command prompts for all of the information needed to
  4236.                register QA Study Aid, and prints a form ready to mail,
  4237.                complete with computations showing pricing. This feature
  4238.                also determines many of the more important features of your
  4239.                computer system so that this information is available should
  4240.                you require assistance.
  4241.  
  4242.                Added the file VENDOR.DOC for vendors and BBS Sysops.
  4243.  
  4244.           Version 3.90   September 1, 1991
  4245.  
  4246.  
  4247.  
  4248.  
  4249.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  4250.  
  4251.  
  4252.  
  4253.           QA Study Aid V5.3 User's Guide                                 68
  4254.  
  4255.  
  4256.                Fixed a major bug that caused questions to be skipped in
  4257.                both sequential and random modes. All questions are now
  4258.                properly presented in either mode. Thanks to a concerned
  4259.                user in Pennsylvania for reporting this error.
  4260.  
  4261.                Integrated all auxiliary programs into the main program
  4262.                file. There is now only one program. Access to the compiler
  4263.                and other functions related to the score file is now by
  4264.                password access.
  4265.  
  4266.                Added a secure password function. QASA is distributed with-
  4267.                out a password. To enable password protection, you must
  4268.                enter a password.
  4269.  
  4270.                Added the ability to export certain fields of the score file
  4271.                in a form suitable for importing into other spreadsheet and
  4272.                database programs.
  4273.  
  4274.                Added the ability to associate "letter grades" to scores.
  4275.                Letter grades consist of any string up to five characters in
  4276.                length. This permits the use of an A..F grading system, or
  4277.                the GPA grading system used in colleges and universities;
  4278.                e.g., 4.0 and down, or even "PASS/FAIL". There is no defined
  4279.                limit on the number of associations between scores and
  4280.                letter grades.
  4281.  
  4282.                Added the ability to exclude all punctuation from an answer
  4283.                list and from the user's response. This allows the answer
  4284.                list to be shorter, and permits numbers with commas to be
  4285.                scored correctly if the commas are omitted.
  4286.  
  4287.                Added code to detect self-referential macros, now matter how
  4288.                deeply recursive the nesting may be. QASA can no longer
  4289.                crash if self-referential macros are inadvertently speci-
  4290.                fied.
  4291.  
  4292.                Added a test to lock out the /N (Name) command once a data-
  4293.                base with score file logging has been loaded and a name has
  4294.                been entered. This prevents a user from changing his or her
  4295.                name if the score is low.
  4296.  
  4297.                Added the "Utilities" menu that provides access to the pass-
  4298.                word-setting function, the compiler, score file utilities,
  4299.                menu selector character, and color selection, as follows:
  4300.  
  4301.                     o    The /UM command sets the menu selector character.
  4302.                     o    The /US command sets the screen colors.
  4303.                     o    The /UP command sets the password.
  4304.                     o    The /UC command executes the compiler.
  4305.  
  4306.  
  4307.  
  4308.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  4309.  
  4310.  
  4311.  
  4312.           QA Study Aid V5.3 User's Guide                                 69
  4313.  
  4314.  
  4315.                     o    The /UD command is used to convert an encrypted
  4316.                          score file to plain text.
  4317.                     o    The /UE command is used to export a score file in
  4318.                          a format suitable for use with other database and
  4319.                          spreadsheet programs.
  4320.  
  4321.                Recompiled QASA using the large data model. In a system with
  4322.                512K bytes of memory available after booting, QASA can now
  4323.                accommodate some 40,000 questions and their answers. Inter-
  4324.                nal overlays are used to keep the size of executable memory
  4325.                image to a minimum.
  4326.  
  4327.                QASA is now "DESQview aware" and will properly execute
  4328.                within a DESQview window.
  4329.  
  4330.                Added a command to "shell" to DOS for access to an editor or
  4331.                other program from within QASA.
  4332.  
  4333.                The /FS (File/Save Database) command no longer causes an
  4334.                immediate exit to DOS. You may therefore save a database in
  4335.                progress and then load another one.
  4336.  
  4337.           Version 3.80   August 4, 1990
  4338.  
  4339.                Changed Mode/Random from /MA to /MR.
  4340.  
  4341.                Eliminated the screen control menu.
  4342.  
  4343.                Left-justified the mode in the status window.
  4344.  
  4345.                Added a check to insure that the screen is free before
  4346.                updating the time left.
  4347.  
  4348.                Recompiled with aggressive optimizations using the new
  4349.                version (V6.0) of the Microsoft C Optimizing Compiler. The
  4350.                .EXE file size has been significantly reduced.
  4351.  
  4352.           Version 3.70   December 30, 1989
  4353.  
  4354.                Fixed a major bug that caused all screen attributes to be
  4355.                set to zero if the configuration file was missing. Since the
  4356.                configuration file is not distributed with QA Study Aid, the
  4357.                effect was to present a blank screen. Although commands
  4358.                could be entered and the screen colors set, all of this had
  4359.                to be done with a blank screen.
  4360.  
  4361.                Also fixed a bug in the answer screen that would not allow
  4362.                an altered menu-select character to be used to escape into
  4363.                the menu system. This bug was reported by a concerned user;
  4364.                our thanks go out to him.
  4365.  
  4366.  
  4367.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  4368.  
  4369.  
  4370.  
  4371.           QA Study Aid V5.3 User's Guide                                 70
  4372.  
  4373.  
  4374.           Version 3.60   December 10, 1989
  4375.  
  4376.                A potential problem was found and corrected with the calcu-
  4377.                lation of weights. This problem would be encountered only if
  4378.                the total weight exceeded 32767, which is the maximum weight
  4379.                permitted.
  4380.  
  4381.                The /FS (File/Save Database) and /FC (File/Continue Data-
  4382.                base) commands were added. This combination allows the user
  4383.                of QASA to save the current state of a test or quiz database
  4384.                and return to it later. The database will be restored to its
  4385.                previous state. These commands will not work if the database
  4386.                has a time limit associated with it.
  4387.  
  4388.                The "E=" option has been added to the database compiler
  4389.                Q&AC.EXE. This option specifies that the score file is to be
  4390.                encrypted so that a user cannot complete a test or quiz, and
  4391.                then edit the resulting score in the score file. A new
  4392.                utility, Q&AD.EXE, restores the score file to plain ASCII
  4393.                text.
  4394.  
  4395.                A configuration file was added. This file must be located in
  4396.                the same directory as the help file Q&ASA.HLP, and the same
  4397.                rules that govern its access apply to the configuration
  4398.                file. The configuration file is named Q&ASA.CFG. It is not
  4399.                included in the distribution, since QASA will automatically
  4400.                create it the first time it is executed.
  4401.  
  4402.                A new command, /FE, allows the screen colors to be changed.
  4403.                The new values are saved in the configuration file.
  4404.  
  4405.                A new command, /FM, allows the menu selector character to be
  4406.                altered. This defaults to the forward slash character ('/'),
  4407.                but may now be changed to any other character in the print-
  4408.                able ASCII range of '!' through '~', inclusive. Once chang-
  4409.                ed, the new selector character is saved in the configuration
  4410.                file so the effect of the change will be permanent unless
  4411.                changed again.
  4412.  
  4413.                The weighting system was altered to permit questions to have
  4414.                a weight of zero. If desired, all questions may be weighted
  4415.                as zero, but this will cause all scores to be zero also.
  4416.  
  4417.           Version 3.50   August 10, 1989
  4418.  
  4419.                The menu was modified to eliminate the /FD and /FS commands,
  4420.                which were replaced with the single command /FL (File/Load
  4421.                Database). The directory defaults to the current working
  4422.                directory. The directory may be changed if desired.
  4423.  
  4424.  
  4425.  
  4426.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  4427.  
  4428.  
  4429.  
  4430.           QA Study Aid V5.3 User's Guide                                 71
  4431.  
  4432.  
  4433.                Major internal enhancements were made to the video system.
  4434.                QASA will now detect the type of display adapter in use, and
  4435.                will operate properly with 132-column and 43- and 50-line
  4436.                modes. The screen update rate has been increased. The /S?
  4437.                commands are necessary only in extreme cases where snow is a
  4438.                severe problem (these commands have been retained, however).
  4439.                QASA will now autoselect the screen update method.
  4440.  
  4441.                The registration functions have been entirely replaced. The
  4442.                new registration system now sets the executable file to
  4443.                read-only to prevent inadvertent overwriting of the execut-
  4444.                able image. The serial number now provides certain essential
  4445.                information about the system QASA is running on. QASA will
  4446.                detect certain changes to itself and refuse to execute if it
  4447.                is modified. A demonstration mode has been added (although
  4448.                the program is not distributed as a demo; it is a full-
  4449.                featured program with no crippling of any function).
  4450.  
  4451.                QASA now intercepts the Control-C and Control-Break keys and
  4452.                will perform a graceful exit with proper updating of the
  4453.                score file. Hardware error detection and handling of criti-
  4454.                cal errors has been improved, and now offers the options of
  4455.                Retry or Cancel (Cancel aborts only the command that experi-
  4456.                enced the error, not the program as a whole).
  4457.  
  4458.                The Help key (F1) is now active in the opening screen. You
  4459.                may obtain an overview of the operation of QASA at the
  4460.                opening screen, or exit the program by pressing ESCape.
  4461.                Several new categories have been added to the help file for
  4462.                registering and for reporting problems.
  4463.  
  4464.           Version 3.1    July 31, 1989
  4465.  
  4466.                Made some minor corrections and additions to this manual,
  4467.                and corrected a minor bug related to locating the executable
  4468.                file on disk.
  4469.  
  4470.           Version 3.0    May 1, 1989
  4471.  
  4472.                Corrected a bug in the random mode termination function, and
  4473.                enhanced the random mode search speed. Version 2.1 would
  4474.                continue to ask questions after they had been answered,
  4475.                allowing a user to gain a score exceeding 100%. Also en-
  4476.                hanced the registration function.
  4477.  
  4478.                o    Added the 'D=' command to Q&AC and Q&ASA to allow the
  4479.                     database author to disable display of the correct
  4480.                     answer if the user answers incorrectly.
  4481.                o    Added the ability to specify and execute a database
  4482.                     from the DOS command line.
  4483.  
  4484.  
  4485.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  4486.  
  4487.  
  4488.  
  4489.           QA Study Aid V5.3 User's Guide                                 72
  4490.  
  4491.  
  4492.           Version 2.1    July 31, 1988
  4493.  
  4494.                Minor enhancements to help system.
  4495.  
  4496.           Version 2.0    March 22, 1988
  4497.  
  4498.                Major enhancements to allow QASA to be used in a formal
  4499.                classroom environment. Among the changes are the following:
  4500.  
  4501.                o    Optional logging of scoring information to a disk file.
  4502.                o    Compiled database eliminates run-time interpreter
  4503.                     errors and permits the database to be encrypted.
  4504.                o    Display of the database name as the window title.
  4505.                o    Faster response when loading questions.
  4506.                o    Greatly improved help system allows selection and
  4507.                     viewing of any help category at any time.
  4508.                o    Optional locking of selected mode and lockout of cer-
  4509.                     tain commands.
  4510.                o    Ability to assign a weight to each question and have
  4511.                     this weight determine the number of points awarded for
  4512.                     a correct answer to a question.
  4513.                o    Ability to specify a time limit to answer all ques-
  4514.                     tions.
  4515.                o    Elimination of all index files.
  4516.  
  4517.           Version 1.0    January 7, 1988
  4518.  
  4519.                Initial public release.
  4520.  
  4521.  
  4522.  
  4523.  
  4524.  
  4525.  
  4526.  
  4527.  
  4528.  
  4529.  
  4530.  
  4531.  
  4532.  
  4533.  
  4534.  
  4535.  
  4536.  
  4537.  
  4538.  
  4539.  
  4540.  
  4541.  
  4542.  
  4543.  
  4544.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  4545.  
  4546.  
  4547.  
  4548.           QA Study Aid V5.3 User's Guide                                 73
  4549.  
  4550.  
  4551.                                    LIMITED WARRANTY
  4552.                                    ----------------
  4553.  
  4554.           The evaluation ("shareware") version of QA Study Aid is provided
  4555.           for evaluation only, on an "as is" basis. The registered version
  4556.           is provided with a 30-day money-back guarantee, provided all
  4557.           materials are returned, and if you purchased a site/distribution
  4558.           license, no copies of QA.EXE have been distributed.
  4559.  
  4560.           TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, QUID PRO QUO
  4561.           SOFTWARE DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE,
  4562.           WHETHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY
  4563.           IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
  4564.           PURPOSE. NEITHER QUID PRO QUO SOFTWARE NOR ANYONE ELSE WHO HAS
  4565.           BEEN INVOLVED IN THE CREATION, PRODUCTION, OR DELIVERY OF THIS
  4566.           SOFTWARE SHALL BE LIABLE FOR ANY INDIRECT, CONSEQUENTIAL, OR
  4567.           INCIDENTAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
  4568.           SUCH SOFTWARE, EVEN IF QUID PRO QUO SOFTWARE HAS BEEN ADVISED OF
  4569.           THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. IN NO EVENT SHALL QUID
  4570.           PRO QUO SOFTWARE'S LIABILITY FOR ANY DAMAGES EVER EXCEED THE
  4571.           PRICE PAID FOR THE LICENSE TO USE THE SOFTWARE, REGARDLESS OF THE
  4572.           FORM OF THE CLAIM. THE PERSON USING THE SOFTWARE BEARS ALL RISK
  4573.           AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE.
  4574.  
  4575.           This agreement shall be governed by the laws of the State of Iowa
  4576.           and shall inure to the benefit of Quid Pro Quo Software and any
  4577.           successors, administrators, heirs and assigns. Any action or
  4578.           proceeding brought by either party against the other arising out
  4579.           of or related to this agreement shall be brought only in a STATE
  4580.           or FEDERAL COURT of competent jurisdiction located in Linn
  4581.           County, Iowa. The parties hereby consent to in personam jurisdic-
  4582.           tion of said courts.
  4583.  
  4584.  
  4585.  
  4586.  
  4587.  
  4588.  
  4589.  
  4590.  
  4591.  
  4592.  
  4593.  
  4594.  
  4595.  
  4596.  
  4597.  
  4598.  
  4599.  
  4600.  
  4601.  
  4602.  
  4603.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  4604.  
  4605.  
  4606.  
  4607.           QA Study Aid V5.3 User's Guide                                 74
  4608.  
  4609.  
  4610.                                     LICENSE TERMS
  4611.                                     -------------
  4612.  
  4613.                  LICENSE TERMS APPLICABLE TO ALL USE OR DISTRIBUTION
  4614.                  ---------------------------------------------------
  4615.  
  4616.           The QA Study Aid package and all associated software and documen-
  4617.           tation are copyrighted products of Quid Pro Quo Software and are
  4618.           protected by United States copyright law and also by interna-
  4619.           tional treaty provisions.
  4620.  
  4621.           All rights not expressly granted here are reserved to Quid Pro
  4622.           Software. The use or distribution of these products is expressly
  4623.           prohibited, except as authorized by the terms of this agreement.
  4624.  
  4625.           You may not use, copy, rent, lease, sell, modify, decompile,
  4626.           disassemble, otherwise reverse engineer, or transfer the licensed
  4627.           program except as provided in this agreement.
  4628.  
  4629.           U.S. Government Restricted Rights: Use, duplication, or disclo-
  4630.           sure by the U.S. Government of the computer software and documen-
  4631.           tation in this package shall be subject to restrictions as set
  4632.           forth in subdivision (b)(3)(ii) of the Rights in Technical Data
  4633.           and Computer Software clause at 252.227-7013 (DFARS 52.227-7013).
  4634.           Manufacturer is Quid Pro Quo Software, P.O. Box 1248, Cedar
  4635.           Rapids, IA 52406-1248 USA.
  4636.  
  4637.  
  4638.              LICENSE TERMS APPLICABLE TO TRIAL USE OF EVALUATION VERSION
  4639.              -----------------------------------------------------------
  4640.  
  4641.           Quid Pro Quo Software grants you a limited license to use this
  4642.           software for evaluation purposes for a period not to exceed
  4643.           thirty days.
  4644.  
  4645.           During this evaluation period, you may make full use of the QA
  4646.           Study Aid package. You may NOT distribute any part of the pack-
  4647.           age. You may distribute the complete package provided it has not
  4648.           been altered in any way. You have the ability to evaluate all of
  4649.           the features of QA Study Aid, but the compiler imposes a 25-
  4650.           question limit on the number of questions in a compiled database.
  4651.           Your source definition file is never altered in any way.
  4652.  
  4653.           If you continue using this software after the thirty-day evalua-
  4654.           tion period, or wish to distribute tests and/or quizzes created
  4655.           with the QASA compiler, you MUST make the prescribed registration
  4656.           payment to Quid Pro Quo Software. The registration form is
  4657.           computer-generated by the QASA.EXE program. If you do not have
  4658.           the program file, you may complete and mail the registration form
  4659.           from the manual (QASA.DOC).
  4660.  
  4661.  
  4662.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  4663.  
  4664.  
  4665.  
  4666.           QA Study Aid V5.3 User's Guide                                 75
  4667.  
  4668.  
  4669.                 LICENSE TERMS APPLICABLE TO USE OF REGISTERED VERSION
  4670.                 -----------------------------------------------------
  4671.  
  4672.           The software and the disks on which it is contained are licensed
  4673.           on a non-exclusive basis to you, the purchaser, for your own use.
  4674.           You are not obtaining title to the software or any copyright
  4675.           rights.
  4676.  
  4677.           If you have purchased a license to distribute the QA.EXE inter-
  4678.           preter by purchasing a site/distribution license, you may also
  4679.           create tests and/or quizzes and distribute them and the QA.EXE
  4680.           interpreter with your product(s). The distribution license also
  4681.           allows you to distribute the QASA.CFG and QASA.HLP files with the
  4682.           QA.EXE interpreter. UNDER NO CIRCUMSTANCES ARE YOU PERMITTED TO
  4683.           DISTRIBUTE TO ANYONE THE REGISTERED VERSION OF THE COMPILER
  4684.           QASA.EXE.
  4685.  
  4686.           You may use the licensed software on a single personal computer
  4687.           system, and make as many copies as needed for backup and archival
  4688.           purposes. If you need to use these products on more than one
  4689.           computer, or if you wish to distribute tests and/or quizzes,
  4690.           please fill in the appropriate quantity on the electronic regis-
  4691.           tration form in QASA.EXE.
  4692.  
  4693.           LICENSE TERMS APPLICABLE TO DISTRIBUTED COPIES OF THE INTERPRETER
  4694.           -----------------------------------------------------------------
  4695.  
  4696.           The QA Study Aid Interpreter consists of the files QA.EXE,
  4697.           QASA.HLP, and QASA.CFG. If you have purchased a site/distribution
  4698.           license (granted through the purchase of 500 or more licensed
  4699.           copies of QA Study Aid), you are entitled to distribute these
  4700.           files along with any tests or quizzes you have created using the
  4701.           QA Study Aid package.
  4702.  
  4703.           Any such distribution is solely between you and the receiver of
  4704.           the distributed files, and do not involve QA Study Aid or Quid
  4705.           Pro Quo Software in any way. Support for the QA Study Aid Inter-
  4706.           preter is your responsibility, NOT the responsibility of Quid Pro
  4707.           Quo Software.
  4708.  
  4709.                              LIMITED DISTRIBUTION LICENSE
  4710.                              ----------------------------
  4711.  
  4712.           Permission is granted to individuals charging no fees, and to
  4713.           BBSs, User Groups, Mail-Order Disk Vendors, CD-ROM publishers,
  4714.           and BBS File-Distribution Networks regardless of fees, to dis-
  4715.           tribute the QA Study Aid package, provided they convey a complete
  4716.           and unaltered copy of the shareware version of this product, and
  4717.           provided they claim no ownership of these products.
  4718.  
  4719.  
  4720.  
  4721.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  4722.  
  4723.  
  4724.  
  4725.           QA Study Aid V5.3 User's Guide                                 76
  4726.  
  4727.  
  4728.           Permission to distribute these products is not transferable,
  4729.           assignable, saleable, or franchisable. Each vendor wishing to
  4730.           distribute these products must independently satisfy the terms of
  4731.           this limited distribution license.
  4732.  
  4733.           Quid Pro Quo Software may revoke any permissions granted here, by
  4734.           notifying you in writing.
  4735.  
  4736.                                       COPYRIGHT
  4737.                                       ---------
  4738.  
  4739.           This program is copyright   1988, 1989, 1990, 1991, 1992, 1993,
  4740.           1994, 1995 by Harold J. Endresen, Quid Pro Quo Software. All
  4741.           rights reserved worldwide.
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.  
  4748.  
  4749.  
  4750.  
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756.  
  4757.  
  4758.  
  4759.  
  4760.  
  4761.  
  4762.  
  4763.  
  4764.  
  4765.  
  4766.  
  4767.  
  4768.  
  4769.  
  4770.  
  4771.  
  4772.  
  4773.  
  4774.  
  4775.  
  4776.  
  4777.  
  4778.  
  4779.  
  4780.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  4781.  
  4782.  
  4783.  
  4784.           QA Study Aid V5.3 User's Guide                                 77
  4785.  
  4786.  
  4787.                                      REGISTRATION
  4788.                                      ------------
  4789.  
  4790.           QA Study Aid is a "shareware program" and is provided at no
  4791.           charge to the user for evaluation. Feel free to share it with
  4792.           others, but please do not give it away altered or as part of
  4793.           another system. The essence of "user-supported" software is to
  4794.           provide personal computer users with quality software without
  4795.           high prices, and provides an incentive for programmers to contin-
  4796.           ue to develop new products. If you find this program useful and
  4797.           find that you are using QA Study Aid and continue to it after a
  4798.           reasonable trial period (30 days), you must make a registration
  4799.           payment to Quid Pro Quo Software. The registration fee will
  4800.           license each purchased copy for use on any one computer at any
  4801.           one time. You must treat this software just like a book. An
  4802.           example is that this software may be used by any number of people
  4803.           and may be freely moved from one computer location to another,
  4804.           PROVIDED there is no possibility of it being used at one location
  4805.           while it is also being used at another - just as a book cannot be
  4806.           read by two different persons at the same time.
  4807.  
  4808.           You are encouraged to pass a copy of QA Study Aid along to anyone
  4809.           else for evaluation. Please encourage them to register their copy
  4810.           if they find the program useful and continue using it. All
  4811.           registered users will receive a copy of the latest version of the
  4812.           QA Study Aid system if the registration form specifies any
  4813.           version prior to the latest version, and all registered users
  4814.           will be notified of upgrades and improvements. As a registered
  4815.           user, you are also entitled to free replacement of the program
  4816.           should a maintenance release be made within a period of one year
  4817.           following your original registration.
  4818.  
  4819.           Commercial or governmental users of QA Study Aid must register
  4820.           and pay for their copies of QA Study Aid within 30 days of first
  4821.           use or their license is withdrawn.
  4822.  
  4823.           REGISTRATION ELIMINATES THE 25-QUESTION LIMITATION.
  4824.  
  4825.  
  4826.  
  4827.  
  4828.  
  4829.  
  4830.  
  4831.  
  4832.  
  4833.  
  4834.  
  4835.  
  4836.  
  4837.  
  4838.  
  4839.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  4840.  
  4841.  
  4842.  
  4843.           QA Study Aid V5.3 User's Guide                                 78
  4844.  
  4845.  
  4846.                   PRICING, SITE LICENSING, AND DISTRIBUTION LICENSE
  4847.                   -------------------------------------------------
  4848.  
  4849.           QA Study Aid has a standard price of $20.00 in US dollars.
  4850.           Quantity discounts apply per the following schedule.
  4851.  
  4852.                One copy            No discount
  4853.                2-4 copies          12.5% discount
  4854.                5-19 copies         25% discount
  4855.                20-49 copies        60% discount
  4856.                50-199 copies       70% discount
  4857.                200+ copies         87.5% discount ($500 maximum; site li-
  4858.                                    cense and interpreter distribution
  4859.                                    rights)
  4860.  
  4861.           Any purchase of two hundred copies entitles the purchaser to a
  4862.           site license and interpreter distribution rights.
  4863.  
  4864.                                 UNLIMITED UPGRADE PLAN
  4865.                                 ----------------------
  4866.  
  4867.           The Unlimited Upgrade Plan allows you to purchase, for a single
  4868.           one-time fee, the QA Study Aid program and all future releases,
  4869.           enhancements, and bug fixes. It also entitles you to conversions
  4870.           (ports) from the MS-DOS operating system to any other operating
  4871.           system (such as Windows(R) or OS/2(R)) as they may become avail-
  4872.           able. The Unlimited Upgrade Plan shall be administered by the
  4873.           installation program, and will require that you have available a
  4874.           copy of your registered version with the Unlimited Upgrade Plan
  4875.           option. Each upgrade will confer the Unlimited Upgrade Plan
  4876.           rights and privileges to the upgraded program.
  4877.  
  4878.           THE UNLIMITED UPGRADE PLAN DOES NOT INCLUDE DISKETTES OR POSTAGE
  4879.           EXCEPT AS REQUIRED FOR PORTS TO OPERATING SYSTEMS THAT CANNOT USE
  4880.           PROGRAMS AVAILABLE THROUGH SHAREWARE DISTRIBUTION CHANNELS. The
  4881.           Unlimited Upgrade Plan expects that you will obtain upgraded
  4882.           versions through Shareware distribution channels such as BBS
  4883.           systems, CompuServe, diskette vendors, and so forth. The INSTALL
  4884.           program will perform the necessary registration of the upgrade.
  4885.  
  4886.           The price of the Unlimited Upgrade Plan is equal to one half the
  4887.           purchase price of the QA Study Aid package, in the same quanti-
  4888.           ties as initially purchased. If your purchase of QA Study Aid is
  4889.           $100, then the Unlimited Upgrade Plan for the number of copies
  4890.           purchased is $50. The Unlimited Upgrade Plan can be purchased
  4891.           separately. Contact Quid Pro Quo Software directly for separate
  4892.           purchases.
  4893.  
  4894.  
  4895.  
  4896.  
  4897.  
  4898.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  4899.  
  4900.  
  4901.  
  4902.           QA Study Aid V5.3 User's Guide                                 79
  4903.  
  4904.  
  4905.                                   UPGRADE PURCHASES
  4906.                                   -----------------
  4907.  
  4908.           If you have not purchased the Unlimited Upgrade Plan, you may
  4909.           purchase each upgrade at a 50% discount. The discount is applied
  4910.           after all other discounts have been applied. Diskettes and
  4911.           postage are included.
  4912.  
  4913.                           DEFINITION OF DISTRIBUTION LICENSE
  4914.                           ----------------------------------
  4915.  
  4916.           A distribution license grants the purchaser the right to dis-
  4917.           tribute the files QA.EXE, QASA.HLP, and QASA.CFG, collectively
  4918.           referred to as the INTERPRETER. The files may not be modified
  4919.           (QASA.CFG may be customized as desired prior to distribution).
  4920.           These files may be packaged and sold by you, PROVIDED you agree
  4921.           to the following terms:
  4922.  
  4923.           1.  ALL PRODUCT SUPPORT FOR DISTRIBUTED COPIES OF THE INTERPRETER
  4924.               IS PROVIDED BY YOU.
  4925.           2.  YOU MAY NOT CLAIM OR IMPLY AUTHORSHIP OR OWNERSHIP OF ANY
  4926.               KIND OF THE INTERPRETER.
  4927.           3.  THE INTERPRETER MAY NOT BE MODIFIED EXCEPT AS STATED ABOVE.
  4928.  
  4929.                               DEFINITION OF SITE LICENSE
  4930.                               --------------------------
  4931.  
  4932.           A site license entitles the purchaser to install QA Study Aid on
  4933.           an unlimited number of computers located at, AND PHYSICALLY
  4934.           ACCESSIBLE FROM, a single postal address. A site may consist of
  4935.           several buildings separated by roadways or other construction. A
  4936.           SITE LICENSE DOES NOT GRANT THE PURCHASER RIGHTS TO INSTALL QA
  4937.           STUDY AID ON COMPUTERS THAT MAY ACCESSED VIA WIDE-AREA OR ANY
  4938.           OTHER TYPE OF NETWORKING THAT PERMITS USE OF THE PROGRAM FROM
  4939.           OUTSIDE THE GEOGRAPHICAL AREA DEFINED BY THE POSTAL ADDRESS.
  4940.  
  4941.           Multiple-site and nationwide licenses are available on a case-by-
  4942.           case basis. Please contact Quid Pro Quo Software for details.
  4943.  
  4944.  
  4945.  
  4946.  
  4947.  
  4948.  
  4949.  
  4950.  
  4951.  
  4952.  
  4953.  
  4954.  
  4955.  
  4956.  
  4957.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software
  4958.  
  4959.  
  4960.  
  4961.           QA Study Aid V5.3 User's Guide                                 80
  4962.  
  4963.  
  4964.                          QA STUDY AID V5.3 REGISTRATION FORM
  4965.  
  4966.           Name_____________________________________________________________
  4967.  
  4968.           Title ___________________________________________________________
  4969.  
  4970.           Company _________________________________________________________
  4971.  
  4972.           Address _________________________________________________________
  4973.  
  4974.           City __________________________________ State ______ Zip ________
  4975.  
  4976.           Country _______________________________ Phone ___________________
  4977.  
  4978.           VISA       __      Card Number __________________________________
  4979.  
  4980.           Mastercard __      Expiration Date ___________
  4981.  
  4982.           SERIAL NUMBER FROM OPENING SCREEN _______________________________
  4983.  
  4984.           Display System __________________________________________________
  4985.           DOS Version _____________________________________________________
  4986.           PC Make/Model/CPU _______________________________________________
  4987.           Fixed Disk Type/Capacity ________________________________________
  4988.           Floppy Disks ____________________________________________________
  4989.           System RAM ______________________________________________________
  4990.  
  4991.           To register, send this form with payment in US dollars to Quid
  4992.           Pro Quo Software at the address shown below.
  4993.  
  4994.                One copy            No discount
  4995.                2-4 copies          12.5% discount
  4996.                5-19 copies         25% discount
  4997.                20-49 copies        60% discount
  4998.                50-199 copies       70% discount
  4999.                200+ copies         87.5% discount ($500 maximum)
  5000.  
  5001.           NUMBER OF COPIES DESIRED                     ___________________
  5002.           Times per-copy price of $20.00               ___________________
  5003.           Less discount                                ___________________
  5004.           SUBTOTAL                                     ___________________
  5005.  
  5006.           Unlimited Upgrade Plan (add 50% of SUBTOTAL) ___________________
  5007.           Upgrade Only (subtract 50% of SUBTOTAL)      ___________________
  5008.           TOTAL                                        ___________________
  5009.  
  5010.                                 Quid Pro Quo Software
  5011.                                      PO Box 1248
  5012.                            Cedar Rapids, IA 52406-1248 USA
  5013.  
  5014.  
  5015.  
  5016.            Copyright   1988-1995 Harold J. Endresen, Quid Pro Quo Software