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