home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / MISC / EDUCATIO / VARG465B.ZIP / GRADE.MAN < prev    next >
Encoding:
Text File  |  1991-05-22  |  318.7 KB  |  7,337 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                       VAR Grade
  12.  
  13.                              Grading Tools for Teachers
  14.  
  15.                                      Version 4.6
  16.  
  17.  
  18.                                        MANUAL
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                      This program has been written to assist you
  31.                            in the grading of your classes.
  32.  
  33.                                Written by DENNIS REVIE
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.                          (c) Copyright 1991 by Dennis Revie
  41.                             Distributed by VARed Software
  42.                                 1490 Calle Fidelidad
  43.                             Thousand Oaks, CA 91360-6819
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                VAR Grade is COPYRIGHTED (C) 1987-1991 by Dennis Revie.
  71.                All rights are reserved.
  72.  
  73.                VAR Grade can be distributed as SHAREWARE.  It is not free.
  74.  
  75.  
  76.                Baby Driver is licensed from Ithaca Street Software, Inc.
  77.                COPYRIGHT (C) 1989.  The programs INSTALLP.EXE and BDE.EXE
  78.                are copyright Ithaca Street Software, Inc., and are included
  79.                in accordance with the license.  Comments and instructions
  80.                from the Baby Driver manual have been used in this manual.
  81.  
  82.                VAR Grade is written in Borland International's Turbo
  83.                Pascal.  The files that can be listed by the "DIR *.BGI"
  84.                (screen drivers) and "DIR *.CHR" (fonts) are copyrighted by
  85.                Borland International and are used in accordance with the
  86.                license.
  87.  
  88.                LHARC.EXE is Copyright (C) 1988-89 by Haruyasu Yoshizaki.
  89.                PKUNZIP.EXE is Copyright (C) 1989-90 by PKWare, Inc.
  90.  
  91.  
  92.  
  93.  
  94.                VAR Grade is dedicated to VAR, without whom neither the
  95.                program nor the program author would exist.
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.                Last Revision:  May 1991.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.                                DEFINITION OF SHAREWARE
  123.  
  124.  
  125.  
  126.  
  127.                Shareware distribution gives users a chance to try software
  128.           before buying it. If you try a Shareware program and continue
  129.           using it, you are expected to register. Individual programs
  130.           differ on details -- some request registration while others
  131.           require it, some specify a maximum trial period. With
  132.           registration, you get anything from the simple right to continue
  133.           using the software to an updated program with printed manual.
  134.  
  135.                Copyright laws apply to both Shareware and commercial
  136.           software, and the copyright holder retains all rights, with a few
  137.           specific exceptions as stated below. Shareware authors are
  138.           accomplished programmers, just like commercial authors, and the
  139.           programs are of comparable quality. (In both cases, there are
  140.           good programs and bad ones!) The main difference is in the method
  141.           of distribution. The author specifically grants the right to copy
  142.           and distribute the software, either to all and sundry or to a
  143.           specific group. For example, some authors require written
  144.           permission before a commercial disk vendor may copy their
  145.           Shareware.
  146.  
  147.                Shareware is a distribution method, not a type of software.
  148.           You should find software that suits your needs and pocketbook,
  149.           whether it's commercial or Shareware. The Shareware system makes
  150.           fitting your needs easier, because you can try before you buy.
  151.           And because the overhead is low, prices are low also. Shareware
  152.           has the ultimate money-back guarantee -- if you don't use the
  153.           product, you don't pay for it.
  154.  
  155.  
  156.                                DISCLAIMER - AGREEMENT
  157.  
  158.  
  159.  
  160.                Users of VAR Grade must accept this disclaimer of warranty:
  161.           "VAR Grade is supplied as is.  The author disclaims all
  162.           warranties, expressed or implied, including, without limitation,
  163.           the warranties of merchantability and of fitness for any purpose.
  164.           The author assumes no liability for damages, direct or
  165.           consequential, which may result from the use of VAR Grade." VAR
  166.           Grade is a "shareware program" and is provided at no charge to
  167.  
  168.                                           i
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.           the user for evaluation.  Feel free to share it with your
  176.           friends, but please do not give it away altered or as part of
  177.           another system.  The essence of "user-supported" software is to
  178.           provide personal computer users with quality software without
  179.           high prices, and yet to provide incentive for programmers to
  180.           continue to develop new products.  If you find this program
  181.           useful and find that you are using VAR Grade and continue to use
  182.           VAR Grade after a reasonable trial period, you must make a
  183.           registration payment of $50 (US).  You will recieve the current
  184.           version plus printed manual, and the next major update and
  185.           manual.  Canadian checks are accepted.  Outside the US and
  186.           Canada, registration is $60, payable in US dollars on an
  187.           international postal money order.  This registration fee will
  188.           license one copy for use on any one computer at any one time.
  189.           You must treat this software just like a book.  An example is
  190.           that this software may be used by any number of people and may be
  191.           freely moved from one computer location to another, so long as
  192.           there is no possibility of it being used at one location while
  193.           it's being used at another.  Just as a book cannot be read by two
  194.           different persons at the same time.
  195.  
  196.                Schools, colleges, and Universities must register and pay
  197.           for their copies of VAR Grade within 60 days of first use or
  198.           their license is withdrawn.  Site-License arrangements may be
  199.           made by contacting us at the address listed below, and can be
  200.           arranged on a per-school or per-user basis.
  201.                Anyone distributing VAR Grade for any kind of remuneration
  202.           must first contact us at the address below for authorization.
  203.           This authorization will be automatically granted to distributors
  204.           recognized by the (ASP) as adhering to its guidelines for
  205.           shareware distributors, and such distributors may begin offering
  206.           VAR Grade immediately (However we must still be advised so that
  207.           the distributor can be kept up-to-date with the latest version of
  208.           VAR Grade.).
  209.  
  210.                You are encouraged to pass a copy of VAR Grade along to your
  211.           friends for evaluation.  Please encourage them to register their
  212.           copy if they find that they can use it.  All registered users
  213.           will receive a copy of the latest version of VAR Grade, as well
  214.           as the next significant upgrade.
  215.                To register, send the registration fee to the address listed
  216.           below.  The manual is the same as the on disk version, except
  217.           that it includes figures and an index, as well as looking
  218.           "spiffier".
  219.                Note that if you find any significant bugs, they will be
  220.           corrected and a corrected version of VAR Grade sent to you as
  221.           soon as possible.
  222.  
  223.  
  224.                                          ii
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.                Registered users will have the opportunity to purchase
  232.           further updates at a nominal cost.
  233.                When you register please include your name, address, and the
  234.           version of the program that you have.  A suggested form is
  235.           included with the program in the file REGISTER.TXT.
  236.  
  237.                If reporting bugs, please include the version of VAR Grade
  238.           that you have, as well as:
  239.  
  240.                (1) The type of computer AND microprocessor 8088, 80286,
  241.                  ...).
  242.                (2) The type of printer you will use with it.
  243.                (3) The version of DOS that you are using (important for
  244.                  finding bugs).
  245.                (4) List the bugs that you have found--and EXACTLY, if
  246.                  possible, how they occurred.  This information is needed
  247.                  to find and correct the bug.
  248.                (5) Also include any other suggestions for improving the
  249.                  program--wish lists, etc.
  250.  
  251.                This program is produced by a member of the Association of
  252.           Shareware Professionals (ASP).  ASP wants to make sure that the
  253.           shareware principle works for you. If you are unable to resolve a
  254.           shareware-related problem with an ASP member by contacting the
  255.           member directly, ASP may be able to help. The ASP Ombudsman can
  256.           help you resolve a dispute or problem with an ASP member, but
  257.           does not provide technical support for members' products. Please
  258.           write to the ASP Ombudsman at 545 Grover Rd., Muskegon, MI 49442
  259.           or send a Compuserve message via easyplex to ASP Ombudsman
  260.           70007,3536.
  261.  
  262.             Registration
  263.  
  264.                Fees and conditions are listed above in the Disclaimer-
  265.                  Agreement ($50 inside North America, $60 outside it).
  266.                To order direct from us, send a check or P.O. to:
  267.                       VARed Software
  268.                       1490 Calle Fidelidad
  269.                       Thousand Oaks, CA 91360-6918
  270.                Credit card orders:  You can order VAR Grade from the Public
  271.                  (Software) Library with your MC, Visa, AmEx, or Discover
  272.                  Card by calling (800) 2424-PsL or (713) 524-6394, or by
  273.                  FAX to (713) 524-6398, or by Compuserve to 71355,470, or
  274.                  by mail to PsL, P.O. Box 35705, Houston, TX 77235-5705.
  275.                  These credit card numbers are for ordering only.
  276.  
  277.             
  278.  
  279.  
  280.                                          iii
  281.  
  282.  
  283.  
  284.  
  285.  
  286.             Information
  287.  
  288.                For dealer pricing, volume discounts, site licensing,
  289.                  shipping of product, returns, latest version number, or
  290.                  other technical information, contact us by calling (805)
  291.                  523-7546, or by 
  292.                Compuserve to 73427,112, or write to the address listed
  293.                  above.
  294.  
  295.                                             +---------+
  296.                                       +---------+     |               (R)
  297.                                     --|         |o    |------------------
  298.                                       |   +------+--+ |  Association of
  299.                                       |   |         |-+  Shareware
  300.                                       +---|    o    |    Professionals
  301.                                     ------|    |    |--------------------
  302.                                           +----+----+    MEMBER
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.                                          iv
  337.  
  338.  
  339.  
  340.  
  341.  
  342.                                                        Table of Contents
  343.  
  344.                                   TABLE OF CONTENTS
  345.  
  346.  
  347.  
  348.           DEFINITION OF SHAREWARE....................................i
  349.  
  350.           DISCLAIMER - AGREEMENT.....................................i
  351.  
  352.           TABLE OF CONTENTS.........................................iv
  353.  
  354.           I. INTRODUCTION TO VAR GRADE...............................1
  355.  
  356.               A. Program Features....................................2
  357.               B. Conventions Used in this Manual.....................7
  358.               C. Sample Classes......................................8
  359.  
  360.           II. REQUIREMENTS...........................................9
  361.  
  362.               A. Versions............................................9
  363.               B. Files on the Disks..................................9
  364.               C. Required Files.....................................11
  365.               D. Where Should the Files Be?.........................11
  366.               E. Networks...........................................12
  367.  
  368.           III. INSTALLATION OF VAR GRADE............................13
  369.  
  370.               A. Using INSTALL......................................13
  371.               B. Installation Without INSTALL.......................15
  372.  
  373.           IV. FIRST USE OF VAR GRADE................................17
  374.  
  375.               A. Printing the Manual................................17
  376.               B. Starting the Program...............................17
  377.               C. Using an Existing Class: Tutorial..................17
  378.               D. Starting a New Class...............................21
  379.               E. Entering Data......................................23
  380.               F. If You are Lost....................................24
  381.               G. Exiting the Program................................24
  382.               H. How Special Keys are Used..........................24
  383.               I. How the Cursor Keys Work...........................25
  384.               J. Using a Mouse......................................26
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.                                           v
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.           V. STARTING THE PROGRAM...................................27
  400.  
  401.               A. Where Should the Program Files Be?.................27
  402.               B. Picking a Class....................................30
  403.               C. Converting Old Classes Into New Classes............32
  404.               D. Classes Too Big for the Memory.....................32
  405.               E. Setting Up the Class...............................33
  406.               F. Entering Students, Tasks, Attendance, and Grades...35
  407.               G. Reading the Manual and Help screens................36
  408.  
  409.           VI. ENTERING STUDENTS.....................................38
  410.  
  411.               A. General Methods....................................38
  412.               B. Names and IDs......................................38
  413.               C. Typing in Names and IDs............................39
  414.               D. Importing Students from Files......................41
  415.               E. Sorting Students...................................47
  416.  
  417.           VII. DEFINING TASKS.......................................49
  418.  
  419.               A. Regular Tasks......................................49
  420.               B. Special Tasks......................................51
  421.               C. Scaling Tasks......................................55
  422.               D. Memory Limitations.................................55
  423.               E. Manipulating Tasks.................................55
  424.               F. Examples of Task Definitions.......................57
  425.  
  426.           VIII. ENTERING GRADES.....................................61
  427.  
  428.               A. Entering Data for the Whole Class..................61
  429.               B. Entering Individual Student Data...................64
  430.               C. Saving Entered Data to Disk........................65
  431.  
  432.           IX. ATTENDANCE............................................66
  433.  
  434.               A. Defining Attendance Days...........................66
  435.               B. Changing Defaults..................................66
  436.               C. Entering Class Attendance..........................67
  437.               D. Entering Individual Student Attendance.............68
  438.               E. Default Attendance Task values.....................68
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.                                          vi
  449.  
  450.  
  451.  
  452.  
  453.  
  454.                                                        Table of Contents
  455.           X. ANALYZING THE GRADES...................................69
  456.  
  457.               A. Default Values for Analysis........................69
  458.               B. Plotting the Scores of a Class.....................70
  459.               C. Plotting the Scores of an Individual...............72
  460.               D. Calculating Statistics.............................73
  461.               E. Correlating Different Tasks........................73
  462.               F. Statistical Plots of the Classes...................75
  463.               G. Scaling the Tasks..................................76
  464.               H. Setting the Fewest Allowed Points..................76
  465.               I. Assigning Standard Deviations and T-Scores.........76
  466.               J. Adjusting the Statistics of a Task.................77
  467.               K. Changing the Grading Names.........................77
  468.               L. Picking Automatic Grade Cutoffs....................78
  469.  
  470.           XI. ASSIGNING AND PRINTING THE GRADES AND ATTENDANCE......79
  471.  
  472.               A. Default Values for Analysis........................79
  473.               B. Printing the Student Scores and Attendance.........85
  474.               C. Calculating and Printing Grades....................88
  475.               D. Exporting Data.....................................89
  476.               E. Reports............................................90
  477.  
  478.           XII. OTHER PROGRAM FEATURES..............................103
  479.  
  480.               A. File Maintainance.................................103
  481.               B. Running Other Programs from VAR Grade.............106
  482.               C. Dates.............................................106
  483.               D. Video Displays....................................106
  484.               E. GrUtil.Exe........................................109
  485.               F. Examples of VAR Grade Batch Files.................112
  486.  
  487.           XIII. APPENDIX...........................................115
  488.  
  489.               A. Program Parameters--Defaults and Limits...........115
  490.               B. Backup Files......................................115
  491.               C. Beeps or Noises...................................117
  492.               D. Menus.............................................117
  493.  
  494.           XIV. GLOSSARY............................................119
  495.  
  496.           
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.                                          vii
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                     The whole art of teaching is only the art of awakening
  527.                     the natural curiosity of young minds for the purpose of
  528.                     satisfying it afterwards.
  529.  
  530.                          The Crime of Sylvestre Bonnard.  Part II, Chapter
  531.                          4.
  532.                          Anatole France (1844-1920)
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.                     Each is given a bag of tools,
  544.                     A shapeless mass,
  545.                     A book of rules;
  546.                     And each must make,
  547.                     Ere life is flown,
  548.                     A stumbling-block
  549.                     Or a stepping-stone.
  550.  
  551.                          Stumbling-Block or Stepping-Stone.  Stanza 2.
  552.                          R.L. Sharpe [1890]
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.                                         viii
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.                             I. INTRODUCTION TO VAR GRADE
  570.  
  571.  
  572.  
  573.                WELCOME TO VAR GRADE!  This program has been written to be
  574.           flexible enough to allow you to grade your class with the same
  575.           methods you now use--except that the program does the tedious
  576.           chores of adding, plotting, and writing the scores.  The program
  577.           has been written by and for teachers and requires no special
  578.           knowledge of computers or MS-DOS.
  579.  
  580.                This manual will help both computer novices and computer
  581.           experts get the most out of the VAR Grade program.  If you are
  582.           not an experienced computer user, the manual will show you how to
  583.           get started with the program.  Before putting data from your own
  584.           classes on the computer, we suggest that you go through the
  585.           tutorial in Chapter IV, First Use of VAR Grade, which uses a
  586.           sample class to illustrate the steps in starting the program.  If
  587.           you are acquainted with MS-DOS and want to modify the program to
  588.           meet your specific needs, the manual contains helpful information
  589.           on doing so in Chapter V, Starting the Program.  Menus are used
  590.           to access all areas of the program.  This "menu-driven" program
  591.           should be easy to use, but you can also get help at any time by
  592.           simultaneously pressing the <Alt> key and the key "H".
  593.  
  594.                One of the most powerful features of the program is its
  595.           ability to analyze student grades in a variety of ways.  The
  596.           tutorials and additional material in Chapter IV will enable you
  597.           to examine both individual and group performance using several
  598.           different methods of data analysis.  The calculations generated
  599.           by VAR Grade will give you a great deal of information helpful in
  600.           assigning final grades.  Both you and your students will benefit
  601.           from this data, since you can identify clearly how the student is
  602.           performing relative to the rest of the class, and also evaluate
  603.           the student's work on different assignments.  The program also
  604.           allows you to generate clear and attractive graphics, which will
  605.           answer the question "why did I get this grade?" in detail
  606.           probably beyond what any student would expect.
  607.  
  608.                The program can be used for both grades and attendance.  You
  609.           may grade with either letter or number grades, and you can mix
  610.           and match letter and number grades.  You can change the points of
  611.           any assignment or score at any time.  You can also use many
  612.           different types of pre-defined assignments (tasks), including
  613.           ones that are the sums, averages, and weights of other tasks.
  614.           Any task or combination of tasks can be plotted, correlated, and
  615.  
  616.                                           1
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.           analyzed statistically.  Attendance for your classes can be
  624.           recorded.  Several categories of attendance are defined by VAR
  625.           Grade.  Individual student scores can be printed or scores for
  626.           each section of the class can be printed.  You can control page
  627.           length, margins, and type size when printing the data.
  628.  
  629.                The program has also been designed to be as immune as
  630.           possible from errors on your part. The program checks for
  631.           reasonable task scores, will not easily let you exit the program
  632.           without saving your data, and will check to ensure that the data
  633.           sent to a disk was actually written before letting you exit from
  634.           the program.  It will also prevent accidental deletions of your
  635.           files by making them read-only files (which you cannot delete
  636.           with the DOS "del" or "erase" commands). You can also protect
  637.           your grades from prying eyes by requiring a password before
  638.           allowing access to your data.
  639.  
  640.                The program has been in use for several years, and has
  641.           undergone constant improvements and corrections.  However,
  642.           suggestions are always welcome for additions, deletions, or
  643.           improvements to the program.  Please send comments!  Most of the
  644.           recent changes in the program were suggested by people using this
  645.           program.
  646.  
  647.           A. Program Features
  648.  
  649.             An unlimited number of students, tasks, and classes of students
  650.             are allowed by VAR Grade.  Only the amount of memory in your
  651.             computer limits these.
  652.  
  653.             1. Entering the students
  654.  
  655.                You can enter the students either by entering their names
  656.                directly into the program, or by telling the program to use
  657.                a file of names for the students.  The "N" option on the
  658.                Main Menu will allow a choice between these alternatives.
  659.                See Chapter VI, Entering Students, for further information.
  660.  
  661.                You can sort and list students several ways, including by
  662.                names, IDs, sections, and task scores.  You can display and
  663.                print students by their names or their IDs.  These can be
  664.                Changed in the "Z" option of the Main Menu.
  665.  
  666.             2. The number of sections
  667.  
  668.                The number of sections is initially set at 1 when you first
  669.                start a new class.  For elementary schools, that is probably
  670.                all that you will need.  For high schools and colleges,
  671.  
  672.                                           2
  673.  
  674.  
  675.  
  676.  
  677.  
  678.                                                             Introduction
  679.                several sections of the same class are frequently given by
  680.                the same instructor.  There is a limit of 99 sections of
  681.                students in the class.
  682.  
  683.             3. Tasks
  684.  
  685.                Below is a quick overview of tasks.  For more information,
  686.                see Chapter VII, Defining Tasks.  Tasks can be defined or
  687.                changed in the "T" option of the Main Menu.  Besides
  688.                defining tasks, there is a full retinue of tools to
  689.                manipulate the tasks after they have been defined.
  690.  
  691.                (a) Regular tasks
  692.  
  693.                  There are ten types of tasks allowed.  Two of them
  694.                  correspond to ordinary number and letter grades.  These
  695.                  can be defined in the "T" section of the Main Menu.  You
  696.                  give a task a name, then, if it is a number task, the
  697.                  total allowed points for the task.
  698.  
  699.                  (i) Number tasks are ones in which you enter numbers as
  700.                  the grades.
  701.  
  702.                  (ii) Letter tasks are ones where the scores are entered as
  703.                  letters.
  704.  
  705.                  (iii) Extra credit tasks are ones where the points are
  706.                  added to a number task, but the total points of the number
  707.                  task are not altered.  Extra credit tasks are treated in
  708.                  special ways by the program.  As far as the special exams
  709.                  below are concerned, they have 0 total points.
  710.  
  711.  
  712.  
  713.  
  714.                (b) Special tasks
  715.  
  716.                  The second type of tasks are called Special tasks. These
  717.                  pre-defined tasks are also be specified in the "T" section
  718.                  of the Main Menu.  Special tasks are Sums, Averages,
  719.                  Highest, Percentages, etc., of other tasks.  You do not
  720.                  enter scores into special tasks.  Instead, you pick the
  721.                  tasks to be counted in the sum (or average, percentage,
  722.                  highest, etc.) of other tasks.  The program then
  723.                  calculates the scores for you.  These scores will be
  724.                  recalculated each time you change student scores.
  725.  
  726.  
  727.  
  728.                                           3
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.                  (i) Sum tasks
  736.  
  737.                     These are tasks that are the sums of other tasks.
  738.                     Tasks that are not yet entered can be included in the
  739.                     list of tasks that will be summed.  When the tasks are
  740.                     then defined, they will be included in the sums.
  741.  
  742.                  (ii) Averaged tasks
  743.  
  744.                     These are tasks that are the average of other tasks.
  745.                     If you use letter grades, the averages are reported as
  746.                     scores between the highest (e.g., A) and the lowest
  747.                     tasks (e.g., F), otherwise they are the numerical
  748.                     average of the tasks.  Any tasks that have not yet been
  749.                     entered are not averaged, so the averages reflect only
  750.                     those tasks for which the student has had scores
  751.                     entered.
  752.  
  753.                  (iii) Percentage tasks
  754.  
  755.                     These are tasks that average other tasks, then convert
  756.                     those averages to percentages.  Like averaged tasks,
  757.                     any tasks that have not yet been entered are not used
  758.                     in the conversions, so the percentages reported for the
  759.                     students are for the tasks that have had scores
  760.                     entered.
  761.  
  762.                  (iv) Highest tasks
  763.  
  764.                     These are tasks that sum the scores of other tasks,
  765.                     then the lowest one or more scores are discarded
  766.                     ("throw out the lowest of several scores").  The
  767.                     program will find the lowest of a set of tasks and add
  768.                     up only the highest tasks.  Scores that are unentered
  769.                     are discarded first, then the lowest scores that have
  770.                     been entered are discarded.
  771.  
  772.                  (v) Weighted tasks
  773.  
  774.                     You can define a task as the sum of other tasks, each
  775.                     worth a certain weight.
  776.  
  777.                  (vi) Attendance tasks
  778.  
  779.                     Not only can attendance be taken (see below), but the
  780.                     attendance can be given values to be used as part of
  781.                     the final grade.
  782.  
  783.  
  784.                                           4
  785.  
  786.  
  787.  
  788.  
  789.  
  790.                                                             Introduction
  791.                  (vii) Final tasks
  792.  
  793.                     You can define a task as a final task.  Letter grades
  794.                     are assigned based upon grade cutoffs specified by you.
  795.  
  796.             4. Attendance
  797.  
  798.                On the "A" option of the Main Menu, you can have VAR Grade
  799.                also keep attendance for your class.  There can be up to 240
  800.                days of attendance, with several different types of
  801.                attendance (present, absent, late, etc.).  The characters
  802.                that represent each attendance type can be changed from the
  803.                Attendance Menu.
  804.  
  805.             5. Notes
  806.  
  807.                Besides names and IDs, you can enter notes of up to 20
  808.                characters for the students.  The notes can be anything,
  809.                including why a student missed an exam, seat numbers,
  810.                nicknames, etc.  These notes can be printed along with your
  811.                grades.
  812.  
  813.             6. Entering data
  814.  
  815.                Scores and attendance can be entered spreadsheet style.
  816.                Students and their data are listed either by individual
  817.                students or by the whole class.  Data entry is checked for
  818.                valid input, so no scores can entered that have more than
  819.                the allowed points.
  820.  
  821.             7. Writing the scores
  822.  
  823.  
  824.  
  825.                Using the "W" option of the Main Menu, there are two ways
  826.                you can print scores.  First, you can print the scores of
  827.                one student OR the scores you want for an entire class or
  828.                combination of sections of the class.  After choosing which
  829.                way to write out the scores, a menu will be displayed that
  830.                will list a number of options for printing on the Print
  831.                Menu: which sections, what printer, and whether to write to
  832.                the screen only, or also to a disk file or a printer.  Thus,
  833.                the Print Menu allows great flexibility in how the program
  834.                prints the data.  Second, the program allows you to write
  835.                your own "report forms" so that you can print the scores
  836.                just about any way you want.
  837.  
  838.  
  839.  
  840.                                           5
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.             8. Plotting the scores
  848.  
  849.  
  850.  
  851.                In the "P" option of the Main Menu, you can plot and graph
  852.                the scores of any task you choose.  If you grade with
  853.                numbers, you also choose the low and high scores to plot.
  854.                You can also plot all the scores for one student in the "I"
  855.                option of the Plotting Menu.
  856.  
  857.                You can correlate scores on two tasks.  The scores will be
  858.                plotted against each other and the correlation coefficients
  859.                calculated.  You will be asked for the high and low scores
  860.                for each exam, just as when plotting exam scores.
  861.  
  862.                You can also plot the class scores for any task or set of
  863.                tasks.  Ranges, means, medians, and standard deviations are
  864.                calculated and plotted.
  865.  
  866.                All the plots can be displayed using several fonts, and the
  867.                results printed on your printer.
  868.  
  869.             9. Define a grading system
  870.  
  871.                You can pick just about any grading system you want, simply
  872.                by renaming the grades and changing their points.  You can
  873.                also have the program automatically assign grades according
  874.                to your grading scale.  These and other options are
  875.                available in the "G" option of the Main Menu.
  876.  
  877.             10. Assign final grades
  878.  
  879.                At the end of an task or semester, you can assign grades and
  880.                have the grades and grade cutoffs neatly printed using the
  881.                "G" option of the Main Menu.  If you use number grades, you
  882.                also can weight exams by adding or multiplying the current
  883.                scores by a number, and/or calculate statistics on tasks
  884.                (without plotting scores).
  885.  
  886.             11. Printers
  887.  
  888.                You can tell the program which printer that you are using.
  889.                In fact, to be able to print graphs and plots, you need to
  890.                pick a printer during installation or on the "Z" option of
  891.                the Main Menu, with section "P".  Virtually every printer is
  892.                now supported by VAR Grade for printing graphs and plots.
  893.                Most are also supported for printing files in pica, elite,
  894.                and compressed characters (if your printer supports them).
  895.  
  896.                                           6
  897.  
  898.  
  899.  
  900.  
  901.  
  902.                                                             Introduction
  903.                For unsupported printers, you can find the codes in your
  904.                printer manual, and enter the necessary codes to support
  905.                your printer.
  906.  
  907.             12. Passwords
  908.  
  909.                If you keep your grades on a computer that is accessible to
  910.                others, you can prevent most people from "browsing" in the
  911.                student data by telling the program that you want to use a
  912.                password.  The password can be up to 15 characters long, and
  913.                can include spaces and punctuation marks.  Passwords can be
  914.                changed in the "Z" option of the Main Menu.
  915.  
  916.             13. Other program features
  917.  
  918.                Anytime that you want to change some of the current settings
  919.                of the program, you can use the "Z" option on the Main Menu.
  920.                Some of these are listed above.  Among other changes, you
  921.                can change (a) the colors of the characters and background,
  922.                error messages, help screens, and graph points, (b) the
  923.                lines on a screen, (c) the number of decimal places to use
  924.                when writing scores, and (d) the ways dates are displayed.
  925.  
  926.           B. Conventions Used in this Manual
  927.  
  928.             Names of files and programs are printed in UPPERCASE letters.
  929.  
  930.             Warnings and notes are printed in italics.
  931.  
  932.             Examples of what to type are in double quotes: "TYPE THIS".
  933.  
  934.             MS-DOS prompts are usually listed as: A>.  Anything after the
  935.                prompt should be typed.
  936.  
  937.                Example: A> GRADE
  938.  
  939.                The prompt is A>, and you should type "GRADE".
  940.  
  941.             Special keys are those that do not print normal (ASCII) keys.
  942.                They are designated in the manual and program by bracketing
  943.                the key name with "<" and ">".
  944.  
  945.                Example: <Esc> means the Escape key, <Rtn> means the Return
  946.                  or Enter key.
  947.  
  948.  
  949.  
  950.  
  951.  
  952.                                           7
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.           C. Sample Classes
  960.  
  961.             To look at the capabilities of VAR Grade, four sample classes
  962.             called GSample, A, B, and C have been included.  Many of the
  963.             features of the program have been used for these classes.  To
  964.             view them, type "GRADE GSAMPLE", "GRADE A", "GRADE B", or
  965.             "GRADE C".  These classes are also used for tutorials and
  966.             figures in the manual.
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.                                           8
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.                                                             Requirements
  1015.  
  1016.                                   II. REQUIREMENTS
  1017.  
  1018.  
  1019.  
  1020.             1. This program will run on an IBM PC or compatible computer.
  1021.  
  1022.             2. It requires MS-DOS 2.0 or later.
  1023.  
  1024.             3. It requires at least 300,000 bytes of free memory (memory
  1025.                LEFT after DOS and memory resident programs like Borland's
  1026.                SidekickTM are running). If you have 384K memory or greater
  1027.                in your computer you should have no problem running VAR
  1028.                Grade.
  1029.  
  1030.             4. Two 360K disk drives or one drive of 720K or more.  A hard
  1031.                disk is recommended.
  1032.  
  1033.             5. The program can run using either a monochrome or a color
  1034.                monitor.  To see graphs and plots, you need a display
  1035.                adapter that can display graphics (e.g., Hercules, CGA, EGA,
  1036.                VGA, and others).  If you want to print graphs and plots, a
  1037.                dot matrix, ink jet, or laser printer is required.  Grades
  1038.                can be printed on any printer.
  1039.  
  1040.           A. Versions
  1041.  
  1042.             The standard version of this program allows you to have up to
  1043.             16,000 students in up to 99 sections or groups per class, up to
  1044.             8,000 tasks per class, 240 attendance days per class, and an
  1045.             unlimited number of classes.  In reality, the limitations are
  1046.             due to available memory.  Should you desire "custom" versions
  1047.             of this program, they are also available.  When you register
  1048.             your current version, should you desire a custom version,
  1049.             indicate so and we will try to meet your requirements.  The
  1050.             program automatically uses a math coprocessor chip (8087 or
  1051.             80287, etc) if one is installed.
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.                                           9
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.           B. Files on the Disks
  1072.  
  1073.             Disk #1:
  1074.  
  1075.                README.BAT     Lists Readme.46 to the screen.
  1076.                README.46      Introduction to VAR Grade.
  1077.                PKUNZIP.EXE    Archive program used to extract files.
  1078.                               Alternatively, LHArc.EXE may be included.  If
  1079.                               LHArc is used, all files ending in "ZIP",
  1080.                               below, will end in "LZH".
  1081.                INSTALL.EXE    Installation program for VAR Grade.
  1082.                GRADE1.ZIP     Archive of the following files:
  1083.  
  1084.                  GRADE.EXE    This is the main program.
  1085.                  GRADE.OVR    This is the overlay for the program.
  1086.                  GSAMPLE.PAR  Sample class data.
  1087.                  GSAMPLE.DAT  Student data for the GSample class.
  1088.                  REGISTER.TXT Registration form.
  1089.                  A.PAR, B.PAR, C.PAR    Sample classes.
  1090.                  A.DAT, B.DAT, C.DAT    Sample classes.
  1091.  
  1092.             Disk #2:
  1093.  
  1094.                PKUNZIP.EXE    Archive program used to extract files.
  1095.                GRADE2.ZIP     Archive of the following files:
  1096.  
  1097.                  GRADE.HLP    The file containing help screens.
  1098.                  INSTALLP.EXE The program that installs printers.
  1099.                  GPRTDRV.PDT  Printer drivers (for INSTALLP).
  1100.                  *.BGI        Screen drivers for VAR Grade.
  1101.                  *.CHR        Fonts for the screen drivers.
  1102.                  *.FRM        Sample report forms.
  1103.                  GRADE.MAN    The VAR Grade Manual.
  1104.                  GRUTIL.EXE   Utility program used to load students into
  1105.                                 classes or print grids of the classes.
  1106.  
  1107.             Disk #3:
  1108.  
  1109.                  BDE.EXE      Program to change printer codes.  NOTE:  This
  1110.                                 program is included with the registered
  1111.                                 version.  However, unregistered users may
  1112.                                 obtain a copy of it by sending $10 for
  1113.                                 postage and handling to the address listed
  1114.                                 above for registering the program.
  1115.  
  1116.             The installation program will generate another file, GRADE.PDT.
  1117.             This file contains information needed to print graphs and
  1118.  
  1119.  
  1120.                                          10
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.                                                             Requirements
  1127.             screens.  After the program is run, an additional file is
  1128.             created, called GRADE.PRT.  This file contains information used
  1129.             for printing text from VAR Grade.
  1130.  
  1131.           C. Required Files
  1132.  
  1133.             For the program to run, it requires:
  1134.  
  1135.                GRADE.EXE (program)
  1136.                GRADE.OVR (overlay)
  1137.  
  1138.             The following files are needed for graphs:
  1139.  
  1140.                ?.BGI (which one depends upon your display adapter)
  1141.                GRADE.PDT (to print graphs)
  1142.                *.CHR (to change fonts for graphs)
  1143.  
  1144.             The following files are used for installing printers:
  1145.  
  1146.                INSTALLP.EXE (installs new printers)
  1147.                GPRTDRV.PDT (printer codes, needed by Installp)
  1148.  
  1149.             The following are utilities, only:
  1150.  
  1151.                BDE.EXE (to change printer codes for a printer)
  1152.                GRUTIL.EXE (to print grids and make classes from batch
  1153.                files)
  1154.  
  1155.           D. Where Should the Files Be?
  1156.  
  1157.  
  1158.             1. If you have DOS 2.X
  1159.  
  1160.                The required files can be in the default directory or drive,
  1161.                they can be anywhere in the directories specified by the DOS
  1162.                PATH command, or they can be in the default directory of any
  1163.                drive.
  1164.  
  1165.             2. If you have DOS 3.X or later
  1166.  
  1167.                The program can be invoked from any drive or directory if
  1168.                the required files are in the same directory as the program.
  1169.                Otherwise, the files can be in the default directory or
  1170.                drive, they can be anywhere in the directories specified by
  1171.                the DOS PATH command, or they can be in the default
  1172.                directory of any drive.
  1173.  
  1174.  
  1175.  
  1176.                                          11
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.           E. Networks
  1184.  
  1185.             This version will run on networks (LAN).  It will not, however,
  1186.             take advantage of special features of the networks, such as
  1187.             interactive mail or print queues.
  1188.  
  1189.             To be able to use any video driver, you need to copy all the
  1190.             video drivers onto your network hard disk.  This can be done by
  1191.             dearchiving all the files ending in "BGI" from the archive file
  1192.             GRADE2.ZIP (or GRADE2.LZH).  See Chapter III, part B for
  1193.             details on how to unarc the files.
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.                                          12
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.                                                             Installation
  1239.  
  1240.  
  1241.                            III. INSTALLATION OF VAR GRADE
  1242.  
  1243.  
  1244.  
  1245.                When you obtain VAR Grade, it will be on disks.  The program
  1246.           can be run directly from those disks; however, some of the files
  1247.           are not required, and some of the files are better placed onto
  1248.           other disks.  Therefore, a program has been included on Disk #1
  1249.           that will set up new disks for you that has the correct files on
  1250.           the correct disks.  VAR Grade can be installed onto either a hard
  1251.           (fixed) disk or onto floppy (removable) disks.  The program
  1252.           INSTALL will automatically install VAR Grade.  You will need to
  1253.           answer some questions and follow the instructions, but will not
  1254.           have to worry about what files are needed where.  If you prefer
  1255.           to install the program yourself, directions are given below in
  1256.           Section B.
  1257.  
  1258.           A. Using INSTALL
  1259.  
  1260.             To install the program, you can run the program INSTALL.
  1261.             Follow the instructions below.  INSTALL will not modify any
  1262.             existing files on your computer.
  1263.  
  1264.             1. Put Disk #1 (the "Program" disk) into a drive.  It can be in
  1265.                any drive.
  1266.  
  1267.             2. You will need 4 blank, formatted 360K double-sided floppy
  1268.                disks, 2 720K 3 1/2" disks, or 1.2 megabytes of free disk
  1269.                space on any other disks.  If the disks are not formatted or
  1270.                not empty, they can be formatted during the installation.
  1271.                NOTE: The program uses the MS-DOS format command for
  1272.                formatting, and will only format disks of 1.44 Megabytes
  1273.                capacity or less.  Put one of these disks into the drive you
  1274.                will install the program onto.  If you are installing onto a
  1275.                hard disk, you will not need any floppy disks.
  1276.  
  1277.             3. Type "INSTALL".  An opening screen will appear, explaining
  1278.                the requirements for VAR Grade and how to use the
  1279.                installation program.  If you have a monochrome monitor, you
  1280.                may need to type "INSTALL/b" to force the program into black
  1281.                and white mode.  This may be required for some monochrome
  1282.                boards, as these boards sometimes tell programs
  1283.                (erroneously) that they are color boards.  "INSTALL/c" will
  1284.                force the program into color mode.
  1285.  
  1286.  
  1287.  
  1288.                                          13
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.             4. You can exit the installation program, at any time, by
  1296.                pressing the "Ctrl" and the "C" keys simultaneously
  1297.                (<CtrlC>), or by pressing the "Ctrl" and the "Break" keys
  1298.                simultaneously (<Ctrl-Break>).  If the program has not
  1299.                completely installed the program, you may have to start
  1300.                over.
  1301.  
  1302.             5. After pressing a key, you will be asked for the directory
  1303.                where you will be putting the program.  If you have only two
  1304.                disk drives, the program can be installed onto either one of
  1305.                the two drives.  The program will suggest a drive, but you
  1306.                can change it if you want (e.g., to change it to drive A,
  1307.                delete the suggested name by pressing the function key
  1308.                <F10>, then typing "a:", then press <Enter>).  If you have a
  1309.                hard disk, the program will install the files onto the
  1310.                directory that you specify.  The program will suggest
  1311.                installation onto "C:\VARGRADE", but you can change it to
  1312.                any other directory and/or drive.  If you get a "beep" and
  1313.                error message, it probably means that you haven't yet put a
  1314.                disk into the drive.
  1315.  
  1316.             6. The program will now install the program.  If it does not
  1317.                find the disks or files it needs, it will request that you
  1318.                put them into the appropriate drives.  If the disk does not
  1319.                have enough room on it for the VAR Grade files, you will be
  1320.                asked what to do.  There are three options: (a) You can
  1321.                format the disk.  This is probably the best option. (b) You
  1322.                can tell the program to write the files to another disk, or
  1323.                (c) You can tell the program to write the disk anyway.
  1324.                Choose this option if you have changed the disk or if you
  1325.                are installing VAR Grade onto a previous version of the
  1326.                program.  If a previous version of the program is present,
  1327.                the installation program will ask if the existing files
  1328.                should be replaced (overwritten).  Note that you will only
  1329.                be asked this once:  if you say yes, all the duplicate files
  1330.                will be replaced.
  1331.  
  1332.  
  1333.                During the installation, the program will ask you to pick
  1334.                your printer.  NOTE: if your computer cannot display
  1335.                graphics, this part will be skipped by the installation
  1336.                program.  To do this, you will need the name and model
  1337.                number of your printer.  Use the arrow, page up, and page
  1338.                down keys to traverse the list and find your printer.  Then
  1339.                press the <spacebar> to select it.  You can repeat this
  1340.                process until you have picked up to 5 printers.  When you
  1341.                have picked all your printers, press <F10>.  A file called
  1342.  
  1343.  
  1344.                                          14
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.                                                             Installation
  1351.                GRADE.PDT will be created that has the necessary
  1352.                information.
  1353.  
  1354.             7. If there is not enough room on the new disk for all the
  1355.                fonts, they will be put on the disk with the Manual.  If you
  1356.                decide not to use all the fonts, there should be room on the
  1357.                disk for a couple of the fonts.
  1358.  
  1359.             8. When the installation is completed, a message will be
  1360.                displayed explaining how to label the disks and how to start
  1361.                VAR Grade.
  1362.  
  1363.             9. When you run VAR Grade, the disk with the overlays needs to
  1364.                be in the drive at all times.  Part of the program is in
  1365.                "overlays", which means that some of the program is on the
  1366.                disk and is read into the program when needed.  NOTE: If you
  1367.                have removed the overlay disk, the program will print a
  1368.                message asking you to insert the overlay disk, as it needs
  1369.                the overlay file to continue.  Also, do not move the disk
  1370.                with the overlays from one drive to another.  It must always
  1371.                be in the drive that it was in when you started VAR Grade.
  1372.  
  1373.           B. Installation Without INSTALL
  1374.  
  1375.             To install the program without INSTALL, follow the instructions
  1376.             below.
  1377.  
  1378.             1. You need up to 1.2 megabytes of disk space.
  1379.             2. The simplest method is just to copy all of the files from
  1380.                the disks onto a directory of your drive.  Then type
  1381.                "PKUNZIP GRADE1" and then "PKUNZIP GRADE2".  This will cause
  1382.                the archiving program PKUNZIP to extract all the files.  If
  1383.                LHARC is on disk #1 instead of PKUNZIP, extract the files
  1384.                with "LHARC x GRADE1" and "LHARC x GRADE2".
  1385.             3. If you don't have enough room on that drive, the files you
  1386.                need are:
  1387.  
  1388.                GRADE.EXE, GRADE.OVR: which needn't be on the same disk.
  1389.                A .BGI file:  Which one you need depends upon your display
  1390.                  adapter.  The name of the file corresponds to the display
  1391.                  adapter (e.g., HERC.BGI is for Hercules adapters).  This
  1392.                  and the following files are needed only if you want to
  1393.                  view graphs of the grades.
  1394.                A .PDT file:  You need to run INSTALLP to install your
  1395.                  printer.  Start it by typing "INSTALLP GPRTDRV.PDT
  1396.                  GRADE.PDT 5", then select your printer(s) (see step A6,
  1397.                  above).  If you have a monochrome monitor, you need to add
  1398.                  start the program with "INSTALLP GPRTDRV.PDT GRADE.PDT 5 -
  1399.  
  1400.                                          15
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.                  m" to force INSTALLP into monochrome mode.  To add or
  1408.                  delete printers from VAR Grade, INSTALLP and GPRTDRV.PDT
  1409.                  need to be with the program.
  1410.                *.CHR files:  To change fonts for the graphs, the CHR files
  1411.                  need to be with the program.
  1412.  
  1413.                These files can be removed from the archives GRADE1 or
  1414.                  GRADE2 archives (as listed above), by typing "PKUNZIP
  1415.                  GRADEx filename", where GRADEx is one of the two GRADE
  1416.                  archive files, and filename is the name of the file.  If
  1417.                  LHARC is included instead of PKUNZIP, type "LHARC x GRADEx
  1418.                  filename".
  1419.  
  1420.                  Example: to dearchive GRADE.EXE, type "PKUNZIP GRADE1
  1421.                     GRADE.EXE".
  1422.                  NOTE: Chapter II, section B, lists which archive contains
  1423.                  which VAR Grade files.
  1424.  
  1425.             4. The only files that are absolutely required are the program
  1426.                (GRADE.EXE) and the overlays (GRADE.OVR).
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.                                          16
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.                                                                First Use
  1463.  
  1464.  
  1465.                              IV. FIRST USE OF VAR GRADE
  1466.  
  1467.  
  1468.  
  1469.                In general, you move around the program by choosing options
  1470.           on menus.  The "Main Menu" is the menu that appears after
  1471.           specifying a class name.  If you choose one of the options on the
  1472.           Main Menu, the program goes to another set of menus ("secondary
  1473.           menus"), etc.  Below is a short description of how to enter data
  1474.           for a new class, as well as a list of some of the features of the
  1475.           program.
  1476.  
  1477.           A. Printing the Manual
  1478.  
  1479.             You can print the manual by typing, at the DOS prompt:
  1480.  
  1481.                A> COPY GRADE.MAN PRN
  1482.  
  1483.                NOTE:  The manual is over 100 pages long.
  1484.  
  1485.           B. Starting the Program
  1486.  
  1487.             1. Type "GRADE" when in DOS (i.e., at the prompt:  A>  ).  If
  1488.                you have a monochrome monitor, type "GRADE/B".  For more
  1489.                details, see Chapter V, Starting the Program.
  1490.  
  1491.             2. You will then be asked for the name of a class.  A class
  1492.                will be highlighted on the screen.  Press <Rtn> to select
  1493.                that class, or use the arrow keys to move the highlight to a
  1494.                new class before pressing <Rtn>.  To access any class not
  1495.                listed on the screen, type the name and press <Rtn>.  If the
  1496.                program cannot find the class, it will make a new class with
  1497.                that name.  Class names can be corrected with the
  1498.                <Backspace> key.  After a class has been selected, the Main
  1499.                Menu then appears.  This chapter will describe both how to
  1500.                start a new class and how to use the class supplied with the
  1501.                program.
  1502.  
  1503.           C. Using an Existing Class: Tutorial
  1504.  
  1505.             Start the program as in section A.  Next, you will see four
  1506.             classes highlighted, GSample, A, B, and C.  Move the highlight
  1507.             to GSample.  Press <Rtn>.  VAR Grade will now read the students
  1508.             into the program.
  1509.  
  1510.  
  1511.  
  1512.                                          17
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.             A menu will appear.  This menu is called the Main Menu.  On it
  1520.             are several options.  These options are separated into four
  1521.             categories.  First, there are several options involved with
  1522.             entering data.  Second, there are options regarding analyzing
  1523.             the student data.   Third, there are other options, such as
  1524.             changing how parts of the program work, seeing the help
  1525.             screens, and running other programs.  Last, there are options
  1526.             for leaving the class and program.  You can use the arrow keys
  1527.             to move the highlight to a different menu choice.  To pick a
  1528.             choice, either move the highlight to the desired choice, then
  1529.             press <Rtn>, or just press the key shown on the left side of
  1530.             the highlight.  If you have a mouse, you can move the mouse
  1531.             cursor to the desired choice, then press the <left button>.
  1532.  
  1533.             1. Entering data
  1534.  
  1535.                Press "D" on the Main Menu.  You will see a list of students
  1536.                in the class and scores for several of the tasks that have
  1537.                been defined.  Use the arrow keys on the keypad to move
  1538.                around the class.
  1539.  
  1540.                (a) Names
  1541.  
  1542.                  Move to the second name, "Axelsen, Diana".  The cursor
  1543.                  will be at the end of the name.  Press the backspace key.
  1544.                  Next press an "e".  The name will now read "Axelsen,
  1545.                  Diane".
  1546.  
  1547.                (b) Number tasks
  1548.  
  1549.                  Move down to "Crick, Francis".  Now move right two cells
  1550.                  to the number "80.00".  If you look to the top of that
  1551.                  column, it will say that it is task #1, with the name
  1552.                  "Number 1".  The cursor will be at the end of the number.
  1553.                  Press the backspace key 4 times.  Now type a "5".  The
  1554.                  number should read "85".  Move down one cell with the down
  1555.                  arrow.  Notice the 85 stays in the previous cell.  You do
  1556.                  not have to type a <Rtn> to signal the end of input; just
  1557.                  moving to another cell with the cursor keys is sufficient.
  1558.  
  1559.                  NOTE: Scores higher than the allowed points for a task
  1560.                  will not be accepted.  A beep or noise will tell you this
  1561.                  has happened.
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.                                          18
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.                                                                First Use
  1575.                (c) Letter tasks
  1576.  
  1577.                  Now move to "Darwin, Charles".  Move right three cells, to
  1578.                  a "B".  This is in the column: task #2, "Lette".  The
  1579.                  "Lette" is the first five letters of "Letter 2", the name
  1580.                  of task #2.  Only the first few letters of each task name
  1581.                  is shown (to show all the letters takes too much screen
  1582.                  space).  To change the task score, use the backspace key
  1583.                  to delete the B, then put in a new grade, from A to F.
  1584.                  Notice that if you type any other letters, they will be
  1585.                  ignored by the program.  Only valid letters are accepted.
  1586.  
  1587.                (d) Scrolling to the right
  1588.  
  1589.                  From "Darwin, Charles", task #2, move right four cells
  1590.                  with the right arrow key.  Notice that when you moved to
  1591.                  the fourth cell, the screen shifted to the right.  The
  1592.                  names are still listed on the left, but a slightly
  1593.                  different set of tasks is shown.  If you want, you can
  1594.                  change the score as before.
  1595.  
  1596.                (e) Scrolling down
  1597.  
  1598.                  Just as in the previous example, you can also scroll down.
  1599.                  This time you will see more names.  Use the down arrow on
  1600.                  the keypad to go all the way to the last person in the
  1601.                  class.  Notice that the screen shifts as you do so.  You
  1602.                  can scroll through the students and tasks until you find
  1603.                  the data you want to change.
  1604.  
  1605.                (f) Changing which data is displayed
  1606.  
  1607.                  To change which data is listed on the screen, press
  1608.                  <AltC>.  You will see the Display Menu, which asks whether
  1609.                  to display the name, ID, or both.  Choose "B", for both.
  1610.                  If there had been more than one section of students in the
  1611.                  class, you would be asked whether to display section
  1612.                  numbers.  In GSample, there is only one section of
  1613.                  students.  Next, you will be asked whether to display
  1614.                  notes.  Press "Y".  Last, you will be asked which tasks to
  1615.                  display.  Type "1 3:2", then <Rtn>.  You have told the
  1616.                  program to list tasks 1, 3, and then 2 on the screen.
  1617.  
  1618.                  You will now see the names, IDs, notes, and task scores
  1619.                  for tasks 1, 3, and 2.  You can display any regular tasks
  1620.                  (number, letter, or extra credit), in any order.
  1621.  
  1622.                  You could now alter the data, if you wished.
  1623.  
  1624.                                          19
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.                (g) Exiting
  1632.  
  1633.                  To leave this part of the program, type an <AltS>.  The
  1634.                  data you changed will be saved into memory.
  1635.  
  1636.             2. Analyzing grades
  1637.  
  1638.                We can see a plot of the scores on task #1 by pressing "P"
  1639.                when we are on the Main Menu.  Next, press a "T" (for three
  1640.                dimensional).  You will be asked which task to plot.  Type
  1641.                in a "1", then a <Rtn>.  Next, you will be asked for the
  1642.                high score to plot.  Just type a <Rtn> to allow the program
  1643.                to choose the highest score.  Next, you are asked for the
  1644.                low score to plot.  Again, just type a <Rtn>.  You have told
  1645.                the program to pick the highest and lowest scores in the
  1646.                class as the highest and lowest points to plot.  You will
  1647.                next see a menu, the Print Menu, that will list several
  1648.                options, such as printing to a printer, disk file, etc.
  1649.                Just press "S".  The program will display the plot.  At the
  1650.                bottom right of the screen is a message: "Press any key to
  1651.                continue."  When you are through looking at the plot, press
  1652.                a key.  You will return to the Plot Menu.  Press an "X" or
  1653.                <Esc> to exit back to the Main Menu.
  1654.  
  1655.             3. Writing scores
  1656.  
  1657.                If you want to list some of the task scores of the class on
  1658.                the screen, press a "W" when on the Main Menu.  You will see
  1659.                another menu, the Write Data Menu.  Press an "S".  This will
  1660.                display the scores of all the students in the class.  You
  1661.                will be asked whether you want to display task scores,
  1662.                attendance, etc.  Pick "T", task scores.  You will then be
  1663.                asked for the list of tasks to display.  Type "1:4", then
  1664.                <Rtn>.  You have just told the program to list the first
  1665.                four tasks in the class.  Next, you will be asked if you
  1666.                want to display the student names, and/or IDs.  Press "B" to
  1667.                display both.  Last, you will see the Print Menu.  Press "S"
  1668.                on the Print Menu to see the scores.  The listing will stop
  1669.                at every screenful of students.  When the screen stops,
  1670.                press a key to see some more data.  When you have seen all
  1671.                the scores, the Write Data Menu will appear again.  Press
  1672.                "X" or <Esc> to go back to the Main Menu.
  1673.  
  1674.             4. Quitting the program
  1675.  
  1676.                Press "Q" on the Main Menu to leave the class.  Since we
  1677.                changed some of the data, the program will ask you if you
  1678.  
  1679.  
  1680.                                          20
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.                                                                First Use
  1687.                want to save the data before exiting.  Press "N" (don't save
  1688.                the data).
  1689.  
  1690.           D. Starting a New Class
  1691.  
  1692.             Start the class as in section A.  This time, instead of
  1693.             pressing <Rtn>, type in a name of a class.  The Main Menu will
  1694.             then appear.
  1695.  
  1696.             1. First, if there are more than one section of students in
  1697.                your new class, you will need to increase the number of
  1698.                sections.  You can have up to 99 sections of students in
  1699.                each class.  Press "Z" when on the Main Menu.  On the second
  1700.                menu, press "S" (change the number of sections).  Type in
  1701.                the new number, from 2 to 99, then <Rtn>.  Then exit back to
  1702.                the Main Menu by pressing "X" or <Esc>.  If you have several
  1703.                classes that use the same tasks and turn in the same
  1704.                assignments, calling them different "sections" of the same
  1705.                class lets you easily compare them.
  1706.  
  1707.             2. Next, you want to enter the names of the students.  Enter
  1708.                the names by pressing "N" on the Main Menu.  There are
  1709.                several choices.  You can type in only names ("N"), type in
  1710.                names and IDs ("I"), or load the class names from a files
  1711.                ("F", "A", "C").  Name, IDs, and sections can be changed at
  1712.                any time.  If you choose "N" or "I", you will be asked for
  1713.                the section in which to add students.  If you are typing in
  1714.                the names, just enter the names (ending each name with
  1715.                <Rtn>).  If you are also typing in IDs, type them in, too.
  1716.                If the previous name was entered incorrectly, you can delete
  1717.                it by typing <F2>.  When you have finished entering names,
  1718.                press <Esc>.
  1719.  
  1720.                Example:  If you are on the Main Menu, type an "N", then "N"
  1721.                again.  The program will ask for the section number.  Type
  1722.                in the section number, then <Rtn>.  You can now type in
  1723.                names, ending each with a <Rtn>.  If you misspelled a name,
  1724.                but did not notice until you were on the next name, press
  1725.                <F2> to delete the previous name.  Retype it in correctly.
  1726.                After the last name has been entered, press an <Esc>, and an
  1727.                <Esc> again when the program asks for the section number.
  1728.  
  1729.                NOTE: The program sorts the names alphabetically.  If the
  1730.                  names are entered last name first, they will be sorted by
  1731.                  last name.  If they are entered with the first name first,
  1732.                  they will be sorted by first names.  The program will
  1733.                  check for duplicate names, so you cannot put the same name
  1734.                  into the same section twice.
  1735.  
  1736.                                          21
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.                If you are entering names from a file, the program will ask
  1745.                for the name of the file.  Flat files are ones where the
  1746.                names, IDs and exam scores are in columns.  For the "F"
  1747.                (flat file) option, you need to tell the program where the
  1748.                names and IDs are located in the file.  Names longer than 20
  1749.                characters will be truncated, as will IDs longer than 15
  1750.                characters.  If there are no IDs, sections, or exams, just
  1751.                tell the program to start at "0" for them.  For the "A"
  1752.                (automatic flat file) and "C" (comma) options, the program
  1753.                will try to make sense of the names.  Comma and quote
  1754.                delimited files are readable by most spreadsheets.  See
  1755.                below, Chapter VI, Entering Students, for more details on
  1756.                loading students from files.
  1757.  
  1758.             3. Tasks are assignments for students.  They can be exams,
  1759.                tests, homework, projects, etc.  If you have task scores to
  1760.                enter into the program, press "T" when on the Main Menu to
  1761.                define the new assignments.  The second menu will ask you
  1762.                for the number of the task.  You will then be asked the name
  1763.                and total points of the task (if it is a number exam).  You
  1764.                can continue to define as many tasks as you like.  There are
  1765.                ten different types of tasks that can be defined.  You must
  1766.                define a task before you can enter task scores.  Note that
  1767.                if you are grading by numbers, no scores can be entered that
  1768.                are either higher than the total points of the task.  If you
  1769.                are using letter grades, only letters defined by you can be
  1770.                used (the "default" grades are A to F, with + and - grades,
  1771.                but these can be changed).
  1772.  
  1773.             4. Next, you can use either the letters as defined by you, or
  1774.                the "default" grades to enter the scores.  Pick the number
  1775.                of the task or tasks that you want to use.  You may enter
  1776.                scores for multiple tasks or for only one.  You then can
  1777.                enter the scores "by individual" ("I" on the Main Menu), or
  1778.                "by section" ("D" on the Main Menu). "By individual" lists
  1779.                all the tasks for one student, while "by section" or class
  1780.                lists for every student in the class only those tasks that
  1781.                you have picked.  With either method, the program lists the
  1782.                students by the whichever sort method you have chosen (e.g.,
  1783.                alphabetically by name).  You can use the cursor keys (up,
  1784.                down, etc.) to move to a new task or student.  Pressing
  1785.                <Rtn> will cause the program to move to the next task, while
  1786.                using the cursor keys will move you up, down, or over to new
  1787.                tasks.
  1788.  
  1789.                NOTE: If you are "using" edit keys, you move between
  1790.                students with <Ctrl>-cursor keys.
  1791.  
  1792.                                          22
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.                                                                First Use
  1799.  
  1800.             5. When you are finished entering data, press <AltS> to exit
  1801.                the section and save the data to memory.  Next, when on the
  1802.                Main Menu, type an "S" to save the data to a disk file.  The
  1803.                program will ask for the class name.  Most of the time, you
  1804.                will just type <Rtn>.  If you want to change the name of the
  1805.                class or the directory where it is located, you can do so
  1806.                before pressing <Rtn>.
  1807.  
  1808.           E. Entering Data
  1809.  
  1810.             In general, if you are asked to "enter" data, end it with
  1811.             "<Rtn>" or a cursor key, when you are asked to "press" a key,
  1812.             only one key needs to be pressed.
  1813.  
  1814.             1. Menu choices
  1815.  
  1816.                The program accepts as input only the keys listed on the
  1817.                menu, and will respond to the key when it is pressed.
  1818.  
  1819.                When you are asked for a menu choice, to select it you can
  1820.                (a) press the key, OR (b) use the cursor keys to pick the
  1821.                correct choice and press the Return or Enter key, OR (c) use
  1822.                a mouse to select the choice and press the left button.
  1823.  
  1824.             2. Entering numbers
  1825.  
  1826.                When you type numbers in, you must press the return key
  1827.                (<Rtn>) or, a cursor key (arrow, page up and down, etc.) to
  1828.                signal the end of your data.
  1829.  
  1830.                A <Rtn> alone, with no number, tells the program:
  1831.  
  1832.                     (a) do not change the current value;    OR
  1833.                     (b) end current input of the number;    OR
  1834.                     (c) let the program choose the appropriate number.
  1835.  
  1836.                Which possibility (a, b, or c)  that the program will use is
  1837.                stated when the data is requested.
  1838.  
  1839.             3. Selecting and entering names
  1840.  
  1841.                When you enter words or names, you must press either the
  1842.                return key (<Rtn>) or a cursor key (arrow, page up and down,
  1843.                etc.) to signal the end of your data.
  1844.  
  1845.                When names of classes or students are listed on the screen,
  1846.                the cursor keys can be used to select the student or class
  1847.  
  1848.                                          23
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.                name.  Select the desired name with the cursor keys, then
  1856.                press <Rtn>.
  1857.  
  1858.           F. If You are Lost
  1859.  
  1860.                If you are lost, or want to return to the Main Menu, you can
  1861.                usually reach it by repeatedly pressing the <Esc> key.
  1862.  
  1863.           G. Exiting the Program
  1864.  
  1865.                Normally, you exit the program by going thru the Main Menu.
  1866.                To exit, pick the "Q" (quit the program) option.  If any
  1867.                data has been changed, the program will ask if you want the
  1868.                changes to be saved.  You can also exit from almost anywhere
  1869.                in the program by pressing Ctrl-C (the Control key and the
  1870.                "C" key simultaneously: <CtrlC>).  Again, if student data
  1871.                has been changed, you will be prompted about saving it
  1872.                before leaving the  program.  The key combination Ctrl-Break
  1873.                has no effect while in the program.
  1874.  
  1875.           H. How Special Keys are Used
  1876.  
  1877.             These keys are not used in all parts of the program, but will
  1878.             be used in most parts.  Other keys are also used, but these are
  1879.             listed on the screen when they can be used.
  1880.  
  1881.                Key       Name of key      Program Function
  1882.                <Esc>     Escape           Exit this program section.
  1883.                <Rtn>     Return, Enter    End of input.
  1884.                <Pg Up>   Page Up          List previous screen.
  1885.                <Pg Dn>   Page Down        List next screen.
  1886.                <Home>    Home             Go to the first screen.
  1887.                <End>     End              Go to the last screen.
  1888.                <F1>      Function key 1   Use all choices, or select the   
  1889.                                           next available choice.
  1890.                <F2>      Function Key 2   Delete previous entry.
  1891.                <F10>     Function Key 10  To delete current entry.
  1892.                <AltH>    Alt-H            HELP--always available.
  1893.  
  1894.                Key       Name of key      Program Function
  1895.                <AltU>    Alt-U            Undo that field when entering    
  1896.                                           numbers or words.
  1897.                <CtrlE>   Control E        Switch between how the cursor    
  1898.                                           keys work (see below).
  1899.                <CtrlC>   Control C        Exit from the program.  If data  
  1900.                                           has been changed, you will be
  1901.  
  1902.  
  1903.  
  1904.                                          24
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.                                                                First Use
  1911.                                           asked whether it should be saved
  1912.                                           before exiting the program.
  1913.                <CtrlS>   Control S        Stop writing to a printer or     
  1914.                                           disk.
  1915.  
  1916.           I. How the Cursor Keys Work
  1917.  
  1918.             You have options as to how you want the cursor keys to work.
  1919.             If you do not redefine the functions of the cursor keys, they
  1920.             will work as follows:
  1921.  
  1922.             Key(s)                 Movement
  1923.             <Home>, <Ctrl-Pg Up>   Go to the first name or cell
  1924.             <End>, <Ctrl-Pg Dn>    Go to the last name or cell
  1925.             <Pg Up>                Go up one screen
  1926.             <Pg Dn>                Go down one screen
  1927.             <Left Arrow>           Go left one cell or column
  1928.             <Right Arrow>          Go right one cell or column
  1929.             <Ctrl-Home>            Go up one half column
  1930.             <Ctrl-End>             Go down one half column
  1931.             <Up Arrow>             Go up one name or line
  1932.             <Down Arrow>           Go down one name or line
  1933.             <Ctrl-Left Arrow>      Go left two columns
  1934.             <Ctrl-Right Arrow>     Go right two columns
  1935.             <Backspace>            Delete previous character
  1936.  
  1937.             You can switch between using or not using edit keys by pressing
  1938.             <Ctrl-E> (simultaneously press the "Ctrl" and "E" keys) anytime
  1939.             you are entering numbers or names (strings of characters).
  1940.             Furthermore, if you choose to use edit keys, you can use
  1941.             "insert" or "overstrike" modes.  Just press the <Ins> key to
  1942.             switch between these modes.  In insert mode, the characters are
  1943.             inserted at the position of the cursor, with the rest of the
  1944.             characters pushed to the right.  In overstrike mode, the
  1945.             character typed replaces the one at the cursor.
  1946.  
  1947.             If you "use" edit keys, by redefining their functions, you will
  1948.             be able to move left or right in the data with the cursor keys
  1949.             functioning as they would in a word processor.  If you switch
  1950.             to "using" the edit keys, they will be redefined as follows:
  1951.  
  1952.                Key(s)              Movement
  1953.                <Home>              Go to the first character.
  1954.                <End>               Go to the last character.
  1955.                <Left Arrow>        Go left one character.
  1956.                <Right Arrow>       Go right one character.
  1957.                <Ctrl-Left Arrow>   Go left one name or cell.
  1958.                <Ctrl-Home>         Go left four names or cells.
  1959.  
  1960.                                          25
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.                <Ctrl-Right Arrow>  Go right one name or cell.
  1968.                <Ctrl-End>          Go right four names or cells.
  1969.                <Del>               Delete the character at the cursor.
  1970.                <Ins>               Switch between Insert and Overwrite
  1971.                                    modes.
  1972.  
  1973.           J. Using a Mouse
  1974.  
  1975.             If you have a mouse, it can be used by the program.  The mouse
  1976.             cursor is a box, larger than a character, and is seen on the
  1977.             screen as having different colors than the surrounding text.
  1978.             Both two and three button mice are supported.
  1979.  
  1980.                Mouse button(s)     Meaning
  1981.                <Left button>       Select.  If the button is pressed while
  1982.                                    the mouse cursor is at a menu choice,
  1983.                                    that choice will be selected.  If the
  1984.                                    mouse cursor is at a number or name, the
  1985.                                    cursor will move to that place.  If the
  1986.                                    mouse cursor is outside the current
  1987.                                    window, this will usually cause that
  1988.                                    window to close.  If the mouse cursor is
  1989.                                    inside a window, but at no choice,
  1990.                                    number, or name, nothing will happen.
  1991.                                    If there is more information than can be
  1992.                                    seen on one screen, "mouse bars" will
  1993.                                    appear on the right and/or bottom of the
  1994.                                    current window.  Pressing on these bars
  1995.                                    will move you the screen to a different
  1996.                                    part of that information.
  1997.                <Right button>      Escape.  This is equivalent to pressing
  1998.                                    the escape key.
  1999.                <Left & right buttons>   Return (enter).  This is equivalent
  2000.                                    of pressing the <Rtn> key.  Where the
  2001.                                    cursor is located determines what action
  2002.                                    is taken by the program.
  2003.                <Center button>     [Three button mice, only.]  Clear the
  2004.                                    name or number.  Equivalent to pressing
  2005.                                    the <F10> key.
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.  
  2015.  
  2016.                                          26
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.                                                     Starting the Program
  2023.  
  2024.  
  2025.                                V. STARTING THE PROGRAM
  2026.  
  2027.  
  2028.  
  2029.                This part of the manual tells you how to start the program,
  2030.           including  where to place your files, where to put your class
  2031.           grades, and how to locate class files from the program.  It will
  2032.           also explain how to access help and the manual from the program.
  2033.           You should have already installed the program (see Chapter II).
  2034.  
  2035.           A. Where Should the Program Files Be?
  2036.  
  2037.  
  2038.             1. For DOS beginners
  2039.  
  2040.                Before starting the program, make sure that all the program
  2041.                files listed above in Chapter II, Requirements, are in the
  2042.                current directory of one disk, or, if the program has been
  2043.                installed onto floppy disks, on the current directories of
  2044.                two disks.
  2045.  
  2046.                At the DOS prompt, type: "GRADE"
  2047.  
  2048.                If you are not a DOS expert, go to section B.
  2049.  
  2050.             2. For DOS experts
  2051.  
  2052.                The program will search the current environment for the
  2053.                program files.  This means that the search for the files are
  2054.                in the following order:
  2055.  
  2056.                (i) It searches the current directory first.
  2057.                (ii) It then searches for the files in the directory where
  2058.                  the "GRADE.EXE" file was found.
  2059.                (iii) It then searches the directories specified by the DOS
  2060.                  PATH command.
  2061.  
  2062.                  NOTE: The PATH command tells DOS which directories to
  2063.                     search for executable files:  those ending in ".COM",
  2064.                     ".EXE", or ".BAT".
  2065.  
  2066.                (iv) If it still hasn't found the files, it searches the
  2067.                  default directories on each drive in your computer.
  2068.                (v) If the program files are still not found, the program
  2069.                  will halt with an error message.
  2070.  
  2071.  
  2072.                                          27
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.                The required files, therefore, are most logically placed in
  2080.                one directory of a hard disk or on two floppy disks, as is
  2081.                done by INSTALL.
  2082.  
  2083.                (a) MS-DOS 3.X or above
  2084.  
  2085.                  The program can be started from any directory by just
  2086.                  typing the directory and "GRADE".  For example, if the
  2087.                  program is in the directory c:\class, just type
  2088.                  "c:\class\GRADE".  If the program files are in the same
  2089.                  directory as the GRADE.EXE file, the program will find the
  2090.                  files it needs.  Note that this will only work in DOS 3.X,
  2091.                  not in DOS 2.X.
  2092.  
  2093.                (b) MS-DOS 2.X
  2094.  
  2095.                  Because the program can find the necessary files if the
  2096.                  program has been installed correctly, you can then keep
  2097.                  the program files in one directory, and the class files in
  2098.                  another.  Just make sure that the PATH command specifies
  2099.                  the directory where the program is located.  Read your MS-
  2100.                  DOS manual for directions on how to use the PATH command.
  2101.  
  2102.                  If you know the name of the class that you want to grade
  2103.                  before you enter the program, you can enter the class name
  2104.                  as a parameter on the command line:  e.g., if the class is
  2105.                  called "BIOLOGY", type "GRADE BIOLOGY" at the DOS prompt.
  2106.                  The BIOLOGY class data will automatically be read into the
  2107.                  program.  The class name can include a path, so, if the
  2108.                  BIOLOGY class is located in the c:\science directory, you
  2109.                  can start the program with "GRADE C:\SCIENCE\BIOLOGY".
  2110.  
  2111.                (c) Examples
  2112.  
  2113.                  (i) If the program is on the same drive as the class (the
  2114.                     "A>" is the DOS prompt):
  2115.  
  2116.                       For example, type:
  2117.  
  2118.                          A>  GRADE
  2119.  
  2120.                     If the program is on a different drive, type the drive,
  2121.                     colon, GRADE.
  2122.  
  2123.                       For example, if you are on drive A, and the program
  2124.                       is on drive B, type:
  2125.  
  2126.                          A> B:GRADE
  2127.  
  2128.                                          28
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.                                                     Starting the Program
  2135.  
  2136.                     The program will find the overlay, print, and help
  2137.                     files if they are on the default directory or on any
  2138.                     directory specified by the path command.
  2139.  
  2140.                  (ii) If you know the name of the class that you want to
  2141.                     use, enter it on the DOS command line:
  2142.  
  2143.                          A> GRADE classname OR
  2144.                          A> GRADE \path\classname
  2145.  
  2146.                  (iii) If you are using a hard disk, you may want to set up
  2147.                     a batch file that will do the typing for you:
  2148.  
  2149.                     Batch file example:
  2150.  
  2151.                       If GRADE (including the necessary files) is in the
  2152.                       directory, C:\CLASS, prepare a batch file that says:
  2153.  
  2154.                          SET PATH=C:\CLASS;
  2155.                          GRADE
  2156.  
  2157.                               OR
  2158.  
  2159.                          SET PATH=C:\CLASS;
  2160.                          GRADE classname
  2161.  
  2162.                  (iv) If you are using DOS 3.X, you can start the program
  2163.                     by typing the directory and "GRADE":
  2164.  
  2165.                     If VAR Grade is in the directory C:\CLASS, type
  2166.  
  2167.                          C:\CLASS\GRADE
  2168.  
  2169.                               OR
  2170.  
  2171.                          C:\CLASS\GRADE classname
  2172.  
  2173.                  (v) If you have a monochrome monitor, you may need to
  2174.                     start the program with:
  2175.  
  2176.                          GRADE/B classname
  2177.  
  2178.                     This will force the program into monochrome mode.  Many
  2179.                     Hercules compatible display adapters erroneously tell
  2180.                     programs that a color monitor is attached.  The results
  2181.                     are that some color combinations are invisible to you.
  2182.  
  2183.  
  2184.                                          29
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.                     You can also force the program into monochrome mode
  2192.                     with a DOS SET command:
  2193.  
  2194.                          A> SET VMON=BW;
  2195.  
  2196.                     You can set up a batch file for VAR Grade as follows
  2197.                     (assuming the program is in the directory C:\VARGRADE):
  2198.  
  2199.                          SET VMON=BW;
  2200.                          SET PATH=C:\VARGRADE;%PATH%;
  2201.                          GRADE
  2202.  
  2203.                     If you have a monochrome monitor, you probably want to
  2204.                     add that command to your AUTOEXEC.BAT file.  This file
  2205.                     is executed every time you start your computer.
  2206.  
  2207.                (d) Using one drive to run the program
  2208.  
  2209.                  You can start the program from one 360K drive by putting
  2210.                  the program disk in the drive, and typing "GRADE".  When
  2211.                  the program cannot find the overlay file, you will be
  2212.                  asked to put the disk containing the file into a drive.
  2213.                  If you now put it in the same drive that the program disk
  2214.                  was in, the program will continue and run correctly.
  2215.  
  2216.           B. Picking a Class
  2217.  
  2218.             When the program starts, the first screen shows the program
  2219.             name, a comment about registering the program, the class files
  2220.             and directories listed on the directory from which the program
  2221.             was invoked, and a prompt for the class.
  2222.  
  2223.             If there are any files on the disk that have the extension
  2224.             ".PAR", they will be listed by the program on the opening
  2225.             screen.  The ".PAR" file contains the parameters of your class:
  2226.             task names, default settings for the program, etc.  To help you
  2227.             find the right class, sub-directories are also listed.
  2228.  
  2229.             You can either type in the name of the class, or you can use
  2230.             the cursor keys to locate the class.
  2231.  
  2232.             1. Using the cursor keys
  2233.  
  2234.                One of the class files or a directory will be highlighted.
  2235.                If you have a monochrome monitor and do not see a class
  2236.                highlighted, try starting the program with "GRADE/B" to
  2237.                force the program into monochrome mode.  To pick the correct
  2238.                class, use the cursor keys to move the highlight to the
  2239.  
  2240.                                          30
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.                                                     Starting the Program
  2247.                correct class or directory.  Then press <Rtn>.  If you chose
  2248.                a directory, a new listing of classes will be shown.  Repeat
  2249.                the above process until a class is chosen.
  2250.  
  2251.                NOTE: If any characters have been typed on the prompt line,
  2252.                  the program will use them as the class name.  You can
  2253.                  delete these by using the <F10> key.
  2254.  
  2255.             2. Typing in the name
  2256.  
  2257.                (a) If the class that you want is not listed, you can change
  2258.                  directories and search for the class.  There are two ways
  2259.                  to change directories:
  2260.  
  2261.                  i)  Press <F5>, then type in the name of the new drive or
  2262.                     directory.  You can continue to change directories
  2263.                     until you find the desired class.
  2264.  
  2265.                  ii) Type the new drive or directory instead of the class
  2266.                     name.  The program first tests to determine whether
  2267.                     what you have typed is a directory.  If it is, the
  2268.                     directory is changed.
  2269.  
  2270.                     NOTE: The new directory must end in a backslash ("\"),
  2271.                       or the new drive must end in a colon (":").
  2272.  
  2273.                (b) If and when your class is listed, just type the name in.
  2274.                  The ".PAR" is not needed, and any extensions, like .PAR,
  2275.                  are discarded.  The program will read in the class
  2276.                  parameters, and, if a file with the same name with the
  2277.                  extension ".DAT" is also there, the student scores will be
  2278.                  read into the program.
  2279.  
  2280.             3. Starting new classes
  2281.  
  2282.                Type in the name of the class.  When the program does not
  2283.                find the ".PAR" file, it will creat a new class.
  2284.  
  2285.                Each class has two files.  Each starts with the name of the
  2286.                class (e.g. "BIOLOGY").  They have the extensions ".PAR" and
  2287.                ".DAT" (e.g. "BIOLOGY.PAR" and "BIOLOGY.DAT").  There may
  2288.                also be backup files with the extensions ".PAX" and ".DAX"
  2289.                (see the Appendix for further details).
  2290.  
  2291.             4. Using the DOS command line
  2292.  
  2293.                You may also enter the class name from the command line by
  2294.                listing it as a parameter: e.g. if the class name is "MATH",
  2295.  
  2296.                                          31
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.                start the program by typing: "GRADE MATH".  If the class
  2304.                exists, it will be read into the program.  If it does not, a
  2305.                new class will be created.
  2306.  
  2307.           C. Converting Old Classes Into New Classes
  2308.  
  2309.             If you want to use the same exams and class information for two
  2310.             different classes, just copy the "CLASSNAME.PAR" file to a new
  2311.             classname (e.g., copy "BIOLOGY.PAR" to the file "MATH.PAR" by
  2312.             typing, at the DOS prompt: "COPY BIOLOGY.PAR MATH.PAR".  Math
  2313.             will now be set up exactly the same way as Biology).  The new
  2314.             class is now set up the same as the previous class, except that
  2315.             no students will be in the new class.  This feature can allow
  2316.             you to set up your class once and use the set-up for many
  2317.             classes in the future.
  2318.  
  2319.           D. Classes Too Big for the Memory
  2320.  
  2321.             After the classname is entered, the program will read in the
  2322.             class data and student information.  If there are more students
  2323.             than can fit in the available memory, the program will warn you
  2324.             and ask if you want to continue.  If you continue, the program
  2325.             will read ONLY as many students into the class as there is
  2326.             memory.
  2327.  
  2328.             WARNING: If you then use the program and save the data, the
  2329.                students that were not read into the program will be lost.
  2330.  
  2331.             To find out approximately how many students can be read into
  2332.             the program, enter a "Z" when in the Main Menu.  At the top of
  2333.             the second menu you will see how many students are currently in
  2334.             the class and how many could be in the class if all the
  2335.             available memory is used and if the current tasks are not
  2336.             increased.  There are essentially an unlimited number of
  2337.             students and tasks allowed.  The limitations are that all the
  2338.             data must be able to fit into the available memory.
  2339.  
  2340.             Part of the program is in overlays.  This means that part of
  2341.             the program is on disk, not in memory.  When the program
  2342.             starts, it leaves a certain amount of memory free, and uses the
  2343.             rest for overlays.  You can change how much of the program is
  2344.             in memory with a DOS SET command.  If you need more memory,
  2345.             enter the following command at the DOS prompt:
  2346.  
  2347.                A> SET OMEM=0;
  2348.  
  2349.  
  2350.  
  2351.  
  2352.                                          32
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.                                                     Starting the Program
  2359.             This command will shrink the program to its minimum size.
  2360.             Conversely, to put all the program into memory, use the
  2361.             command:
  2362.  
  2363.                A> SET OMEM=250000;
  2364.  
  2365.             You can add either SET command to your AUTOEXEC.BAT file that
  2366.             is executed when you start your computer.  This way, the
  2367.             program will always use the amount of memory you want.  You can
  2368.             vary the number from 0 to 250000 to get variable amounts of the
  2369.             program in memory.
  2370.  
  2371.             If you have more than 640K of memory installed in your
  2372.             computer, you may be able to use that extra memory as EMS
  2373.             memory.  VAR Grade can use EMS memory for some parts of the
  2374.             program.  If you are short of memory, this will let VAR Grade
  2375.             have more room for students and grades.
  2376.  
  2377.           E. Setting Up the Class
  2378.  
  2379.             Anytime that you want to change some of the current settings of
  2380.             the program, you can use the "Z" option on the Main Menu.
  2381.  
  2382.             1. The number of sections
  2383.  
  2384.                The number of sections is initially set at 1 when you first
  2385.                start a new class.  For example, if you teach 3 English
  2386.                classes that have identical exams and assignments, you can
  2387.                call them different sections of the same class.  You can
  2388.                then compare the different classes as "sections".  Each
  2389.                section uses the same set of exams, but the program can do
  2390.                statistics on any combination of sections.  The program
  2391.                keeps track of what sections you last used, and will, by
  2392.                default, use whatever sections that were last used by you.
  2393.  
  2394.                To set the number of sections, go to the "Z" option of the
  2395.                Main Menu, then into "S".  Just enter the number of sections
  2396.                that you have in the class.
  2397.  
  2398.             2. Colors
  2399.  
  2400.                Yes, the colors of the program can be changed!  This can be
  2401.                done in the "Z" option of the Main Menu, then "C". There are
  2402.                several colors used, designated:
  2403.  
  2404.                  (i) Normal colors:  The text is in this color.
  2405.                  (ii) Background color:  The background is this color.
  2406.  
  2407.  
  2408.                                          33
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.                  (iii) Highlight color:  Foreground color used for plotting
  2416.                     scores.
  2417.                  (iv) Highlight background: This color is the background
  2418.                     corresponding to the highlight.
  2419.                  (v) Error colors:  Foreground color for error messages.
  2420.                  (vi) Error background: This color is the background for
  2421.                     the error messages.
  2422.                  (vii) Help colors: Foreground color used by the Help
  2423.                     screens.
  2424.                  (viii) Help background: This color is the background for
  2425.                     the help screens.
  2426.  
  2427.                Some of these colors are used in pop-up menus and messages,
  2428.                as well.  To change the colors, press "Z" on the Main Menu,
  2429.                then "C" (color) on the second menu.  You will be asked for
  2430.                the new colors.  The bottom lines of the screen show what
  2431.                the colors would look like.  Needless to say, if you are
  2432.                using a monochrome monitor, you will only see black and
  2433.                white colors.  Some monochrome adapter boards tell the
  2434.                program that they are color boards.  This results in some
  2435.                things becoming invisible or not highlighted when they
  2436.                should be.  If this is the case for you, you can force VAR
  2437.                Grade into monochrome mode by either of two methods:
  2438.  
  2439.                (a) Start the program with "GRADE/B".  The /B tells the
  2440.                program that you are using a black and white monitor.
  2441.                You can force the program into color mode with "/C" when
  2442.                starting VAR Grade.
  2443.  
  2444.                  Example: C> GRADE /B GSAMPLE
  2445.  
  2446.                  This will force the program into monochrome mode and load
  2447.                  the data from the class GSample into the program.
  2448.  
  2449.                (b) Set a DOS command:  "SET VMON=BW;".  At the DOS prompt
  2450.                (e.g., "A>"), type the above statement.  This tells the
  2451.                program you are using a black and white monitor.  This
  2452.                command can also be put into your AUTOEXEC.BAT file that is
  2453.                run when your computer is turned on.
  2454.  
  2455.                After changing the colors, you are asked if you want to make
  2456.                these new colors the default colors.  If you say "Y" (yes),
  2457.                all future classes will have the new colors as their initial
  2458.                colors.  Lastly, the program keeps two sets of colors, one
  2459.                for monochrome monitors (black and white), the other for
  2460.                color monitors.  This feature is for those who switch back
  2461.                and forth between color and monochrome monitors.
  2462.  
  2463.  
  2464.                                          34
  2465.  
  2466.  
  2467.  
  2468.  
  2469.  
  2470.                                                     Starting the Program
  2471.             3. Printers
  2472.  
  2473.                You can tell the program which printer you are using.  In
  2474.                fact, to be able to print graphs and plots, you need to pick
  2475.                a printer during installation or in the "P" section of the
  2476.                "Z" option of the Main Menu.  Virtually every printer is now
  2477.                supported by VAR Grade for printing graphs and plots.  Most
  2478.                are also supported for printing files in pica, elite, or
  2479.                compressed printing (if your printer supports them), and
  2480.                bold and high quality.  For unsupported printers, if you can
  2481.                find the codes in your printer manual, you can enter the
  2482.                necessary printer codes to support your printer (See Chapter
  2483.                X: Printing the Grades).
  2484.  
  2485.             4. Passwords
  2486.  
  2487.                If many people have access to your computer and its disks,
  2488.                you may worry about someone's altering your class files.  To
  2489.                greatly reduce the chances of this happening, you can
  2490.                require that a password be used for your class.  To define a
  2491.                password, use the "W" option in the "Z" section of the Main
  2492.                Menu.
  2493.  
  2494.                NOTE: The default value is not to have a password.  The
  2495.                  password can have up to 15 characters, numbers, and/or
  2496.                  punctuation characters.  Should you forget your password,
  2497.                  you can contact us at the address at the end of the manual
  2498.                  to get instructions on how to defeat the password.  The
  2499.                  password is not foolproof, but greatly reduces the
  2500.                  likelihood of snooping.
  2501.  
  2502.           F. Entering Students, Tasks, Attendance, and Grades
  2503.  
  2504.             There are two kinds of prompts in the program.  The first, like
  2505.             the prompt asking for the classname, asks you to Enter the name
  2506.             and then type a <Rtn> to signify the end of the data.  The
  2507.             second type only asks for one key--this option is usually used
  2508.             for the menu selections.  To save keystrokes, the program will
  2509.             respond immediately when the key is pressed--no <Rtn> is
  2510.             necessary.  When you are presented with a list of choices, you
  2511.             can use the cursor keys to move to the desired choice, then
  2512.             type <Rtn> to select that choice.
  2513.  
  2514.             NOTE: In many parts of the program, if you enter a <Rtn> with
  2515.                no data entered, the program will assume either that: (a)
  2516.                you did not want to enter data--the program will continue;
  2517.                or (b) you want to exit this section and go back to a higher
  2518.                level menu; or (c) the number to be entered is zero.
  2519.  
  2520.                                          35
  2521.  
  2522.  
  2523.  
  2524.  
  2525.  
  2526.  
  2527.  
  2528.             In general, if the program asks you to enter data, you should
  2529.             end with a <Rtn>. If you are choosing a menu option or between
  2530.             two alternatives, press only the appropriate key.  When you
  2531.             have to enter a long list of numbers, such as designating Task
  2532.             80 as the sum of Tasks 1 to 79, the program will allow you to
  2533.             enter them with an inclusive colon:  "1:79" would be 1 through
  2534.             79, rather than requiring you to enter all the numbers from 1
  2535.             to 79.  This situation arises in three places: when entering
  2536.             lists of tasks, as noted in the example, when entering lists of
  2537.             sections to use, and when entering attendance days.  Colons can
  2538.             be used to enter a list of numbers from high to low, as well.
  2539.             Entering "79:1" will tell the program to use tasks 79 down to
  2540.             1.
  2541.  
  2542.             Example: To enter tasks 1 thru 5 and 8, type:
  2543.                "1:5<Rtn>8<Rtn><Rtn>".
  2544.  
  2545.             NOTE: When entering a list of separate numbers, you can
  2546.                separate them with <Rtn>s,  commas, or spaces.  For the
  2547.                above example, typing "1:5,8,<Rtn>" or "1:5 8 <Rtn>" will
  2548.                give the same result as the example above.
  2549.  
  2550.             Later chapters in this Manual will tell you how to enter
  2551.             students, tasks, attendance, and grades.
  2552.  
  2553.           G. Reading the Manual and Help screens
  2554.  
  2555.             If the files GRADE.HLP and/or GRADE.MAN are present in the
  2556.             default directory of any drive or in any directory specified by
  2557.             the DOS path command, then you can read them from the program
  2558.             (See Chapter V Section A, above).  When the program is on the
  2559.             Main Menu, type an "H" for help or an "M" for the manual.  The
  2560.             help screen is much shorter and less detailed than this manual.
  2561.             The help screen can also be reached from anywhere in the
  2562.             program by typing <AltH> (press the ("Alt" and the "H" keys
  2563.             simultaneously).  The help reached from <AltH> is context
  2564.             sensitive.  This means that VAR Grade will try to find the
  2565.             relevant material from the help file.  You can browse at will
  2566.             through the file by using the cursor keys.  When in Help or the
  2567.             Manual, typing <AltK> will show you a list of the keys and
  2568.             features supported.  If there is not enough memory to display
  2569.             the file, an error message will appear.  To view the file, you
  2570.             would then have to reduce memory use (See Section D, above).
  2571.  
  2572.             Moving with the keys in HELP or the MANUAL:
  2573.  
  2574.                Key                 Movement
  2575.  
  2576.                                          36
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.                                                     Starting the Program
  2583.                <Up Arrow>          Up one line
  2584.                <Down Arrow>        Down one line
  2585.  
  2586.                <Page Up>           Up one screen
  2587.                <Page Down>         Down one screen
  2588.  
  2589.                <Ctrl-Home>         Up one-half screen
  2590.                <Ctrl-End>          Down one-half screen
  2591.  
  2592.                <Home>, <Ctrl-Pg Up>     Beginning of the file
  2593.                <End>, <Ctrl-Pg Down>    End of the file
  2594.  
  2595.                <AltL>              GO TO LINE:  The top line will be the
  2596.                                    line that you designate.  In the center
  2597.                                    of the screen a box will appear that
  2598.                                    will ask for the line number.  At the
  2599.                                    bottom right of the screen, you can see
  2600.                                    which line you are on and how many lines
  2601.                                    there are in the file.
  2602.                                    Example: type "<AltL>4<Rtn>" to go to
  2603.                                    line 4.
  2604.                <AltS>              GO TO SCREEN:  The top line will be the
  2605.                                    first line of any screen that you enter.
  2606.                                    In the center of the screen a box will
  2607.                                    appear that will ask for the screen.
  2608.                                    The total number of screens and the
  2609.                                    screen that you are currently on are
  2610.                                    shown at the bottom right corner of the
  2611.                                    screen.
  2612.                                    Example: type "<AltS>8<Rtn>" to go to
  2613.                                    screen 8.
  2614.             To locate text:
  2615.  
  2616.                Key                 Movement
  2617.                <AltF>              Find a string
  2618.                <AltN>              Find the next matching string
  2619.                <AltB>              Find the previous matching string
  2620.                <AltK>              Show the supported keys
  2621.                <AltR>              Return to the previous screen
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.                                          37
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.                                 VI. ENTERING STUDENTS
  2642.  
  2643.  
  2644.  
  2645.                One of the first things that you will do when starting a new
  2646.           class is to enter the names of students into the program.  This
  2647.           Chapter tells you how to enter new students into the class, add
  2648.           IDs, change the names of students, and sort and list the students
  2649.           in the class.
  2650.  
  2651.           A. General Methods
  2652.  
  2653.             When the Main Menu is on the screen, choose the "N" (Name)
  2654.             option.  Several options will be listed on a new menu, the Add
  2655.             Student Menu.  You can type the names into the program via
  2656.             options Name only ("N"), or by Name and ID ("I").  You can
  2657.             import (read) names into the class from flat files ("F" and
  2658.             "A"), or comma and quote files ("C").
  2659.  
  2660.           B. Names and IDs
  2661.  
  2662.             The student names can be up to 20 characters long, and can
  2663.             include spaces and punctuation.  The program can sort the
  2664.             students alphabetically by their names for printing out scores,
  2665.             so it is usually better to enter the names last name first.
  2666.             Spelling is retained exactly as you enter it, except that
  2667.             leading and trailing spaces are ignored.  When sorting,
  2668.             however, lower and upper case letters are not distinguished, so
  2669.             "Sue" is considered to be the same as "sue".
  2670.  
  2671.             ID numbers or other names (nicknames, etc.) can be entered as
  2672.             "IDs".  At some colleges and universities, students are given
  2673.             their grades by student numbers rather than by name.  You can
  2674.             use IDs for first or last names and the "name" for the last or
  2675.             first name.  You can change IDs, or add them later in the
  2676.             several sections of the program.  IDs can be up to 15
  2677.             characters long, and can include spaces and punctuation.  The
  2678.             program can sort by IDs as well as names.  Spelling is
  2679.             retained, but, as in sorting names, sorts do not distinguish
  2680.             between lower and upper case letters.
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.                                          38
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.                                                        Entering Students
  2695.           C. Typing in Names and IDs
  2696.  
  2697.  
  2698.             1. Names only
  2699.  
  2700.                You add names on the "N" option on the Add Students Menu.
  2701.                You first need to tell the class which section you want to
  2702.                enter students.  Pick a number from 1 to 99.  To enter
  2703.                names, you just need to type in the name, ending with a
  2704.                <Rtn>.  If the name is already present in the section, it is
  2705.                NOT reentered and an error message results.  The same name
  2706.                can be used in two different sections of the same class.
  2707.                To delete the letters you have typed, and hence remove the
  2708.                name, type an <F10>.  The <F10> command works in all parts
  2709.                of the program.  Names can be changed later in several parts
  2710.                of the program (see below).  If you added the previous name
  2711.                in error, you can delete it with an <F2> (backup) command.
  2712.                When you have added all the names, press the escape key
  2713.                (<Esc>).  You will exit back to where you are asked for the
  2714.                section numbers again.  To exit, press <Esc> again.
  2715.  
  2716.             2. Names and IDs
  2717.  
  2718.                This option, "I" on the Add Students Menu, works the same as
  2719.                for adding names only.  The only difference is that you are
  2720.                asked for the ID, as well.  Deleting an ID or Name with <F2>
  2721.                will remove the previous student from the class.
  2722.  
  2723.             3. Adding, changing, and deleting names, IDs, and notes
  2724.  
  2725.                Names, IDs, and notes can also be added, changed, or deleted
  2726.                in four other places of the program.  The details are
  2727.                described in later chapters.  The four places are: (i) "I"
  2728.                on the Main Menu: Individual students; (ii) "D" on the Main
  2729.                Menu: Data entry for tasks of the class; (iii) "A" on the
  2730.                Main Menu, then "I": Adding attendance for individual
  2731.                students; and (iv) "A" on the Main Menu, then "C": Data
  2732.                entry for class attendance.
  2733.  
  2734.                Student notes are a field in the student records that can be
  2735.                used to enter up to 20 characters.  Notes can be used to
  2736.                enter seating arrangements, comments, nicknames, or anything
  2737.                else you may want.  They can be printed, but otherwise are
  2738.                not used much by VAR Grade.  They can be entered and changed
  2739.                in the same four places of the program mentioned above.
  2740.  
  2741.  
  2742.  
  2743.  
  2744.                                          39
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.                (a) When individuals are listed
  2752.  
  2753.                  In the attendance by individual students (iii, above) or
  2754.                  Tasks by individual students (i, above), all the tasks or
  2755.                  attendance for a student are listed.  If you press the
  2756.                  <AltI> key (insert student), you will be presented with a
  2757.                  blank form to enter the new name.  Entering any letters
  2758.                  will add the student to the class.  An "Empty" or blank
  2759.                  name will be deleted or not entered into the class, and
  2760.                  the deletion can be quickly done by using the <F10> key.
  2761.  
  2762.                  NOTE: when a student has been deleted, his or her name and
  2763.                     all associated data are deleted.
  2764.  
  2765.                  Changing the spelling of the name, ID, or note, or
  2766.                  changing the section number for the student, is also
  2767.                  possible here.
  2768.  
  2769.                  NOTE: only sections that have been defined are allowed as
  2770.                     sections for the student.
  2771.  
  2772.                  You can increase the number of sections in the "Z" section
  2773.                  of the program.
  2774.  
  2775.                (b) When the whole class is displayed
  2776.  
  2777.                  If you need to add a new name when in parts ii or iv
  2778.                  (above), use the key <AltI>.  A new line will be displayed
  2779.                  on the screen.  As above, removing a student name will
  2780.                  remove that student and the associated data from the
  2781.                  class.  Blank names are removed from the class only when
  2782.                  you leave that section of the program.
  2783.  
  2784.                  A second way to delete the student is with the <AltD> key.
  2785.                  The student will be deleted immediately, and the rest of
  2786.                  the class moved up one line.
  2787.  
  2788.                  NOTE: when a student has been deleted, his or her name and
  2789.                     all associated data are deleted.
  2790.  
  2791.                  You can also change the names, IDs, notes, or sections for
  2792.                  a student by using the cursor keys or a mouse to move to
  2793.                  the cell with the name, ID or section and typing in the
  2794.                  new name or ID for that student.  To see any students not
  2795.                  listed on the screen, use the cursor or Alt keys (as
  2796.                  listed at the top of the screen).  The cell highlighted is
  2797.                  the one that will be used for data input.  You can use the
  2798.                  <F10> key to completely delete the ID or name.
  2799.  
  2800.                                          40
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.                                                        Entering Students
  2807.  
  2808.                  If you start altering the data, then decide the original
  2809.                  data was correct, you can retrieve the data if you haven't
  2810.                  moved from that cell.  Use the <AltU> (undo) key to get
  2811.                  the original data back.
  2812.  
  2813.                (c) Recovering deleted data
  2814.  
  2815.                  Data that has been changed or deleted is normally lost.
  2816.                  There are, however, two ways to recover the data if you
  2817.                  immediately decide to "undelete" it:
  2818.  
  2819.                     (i)  quit the program without saving the data to disk.
  2820.                       Any data entered in this session will not be saved.
  2821.  
  2822.                     (ii) if you have already saved the data from the class,
  2823.                       use the backup files to recover the data from the
  2824.                       previous session.  More information on how to do this
  2825.                       is located in the Appendix.
  2826.  
  2827.                (d) Removing groups of students
  2828.  
  2829.                  The Add Students Menu ("N" on the Main Menu) has two
  2830.                  options that can be used to remove groups of students.
  2831.                  You can remove all students from any section, or you can
  2832.                  delete all students from the class.  Be careful when you
  2833.                  use these options, as all the data for the students that
  2834.                  were removed is lost.
  2835.  
  2836.           D. Importing Students from Files
  2837.  
  2838.             You can also enter names via text files.  VAR Grade will import
  2839.             data that is written by many other programs, including most
  2840.             spreadsheet programs.
  2841.  
  2842.             When data is imported into VAR Grade, either a student name or
  2843.             an ID must be included for each line.  If a student name is
  2844.             included, the program will check whether the name is already
  2845.             present (as well as whether the section is correct, if used).
  2846.             If the name is present, the data will included with that
  2847.             students' data.  If the name is not present, the program will
  2848.             add a new student.  If you do not include a name on each line,
  2849.             the program will check the ID to see if it matches a student
  2850.             in the class.  If so, the new data will be added.  Otherwise,
  2851.             all of the data will be discarded.  If a student name and ID is
  2852.             included, the name will be checked.  If the student exists, the
  2853.             ID will be changed to the new ID.  For student notes, if new
  2854.             notes are included, they will replace the old student notes.
  2855.  
  2856.                                          41
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.             For tasks, the program will try to match the task number or
  2864.             task name.  If it matches either as being identical to a task
  2865.             already defined, the new data will be entered into that task.
  2866.             Otherwise, a new task will be defined and added to the class.
  2867.             For those tasks, the new data will replace the old data.
  2868.  
  2869.             1. Importing flat files
  2870.  
  2871.                Many spreadsheets will export (write) data in a flat file.
  2872.                A flat file is one where the data is listed in columns.  All
  2873.                the names of students are in one column, all the IDs in
  2874.                another, etc.  In the "F" option of the Add Students Menu,
  2875.                you can pick a flat file of student names, IDs, sections,
  2876.                and/or task scores, tell VAR Grade which columns the name,
  2877.                IDs, sections, and tasks are in, and have the data
  2878.                automatically loaded into the class.  The file must have
  2879.                been previously prepared by deleting lines that do not have
  2880.                student names on them, or else the program will try to load
  2881.                those lines as well.  An example of a flat file is listed
  2882.                below:
  2883.  
  2884.                     Jones, Fred   123   1     34.5   23.5   B   44
  2885.                     Smith, Ann    321   2     43.5   18.3   B   43
  2886.  
  2887.                To load new students into the class, the program will first
  2888.                ask for the filename of the flat file.  It will then display
  2889.                the contents of the file across the top of the screen, along
  2890.                with a ruler.  You now have to tell the program what data is
  2891.                where.  First, you need to tell the program where the
  2892.                student names are.  An answer of 0 tells the program that
  2893.                data is missing from the file.  Next you tell the program
  2894.                where the IDs, notes, sections, and tasks are located.  For
  2895.                the tasks, you will also be asked for the number of the
  2896.                task.  Data then will be read into the program.  For the
  2897.                tasks, if the data is numeric, it will be read in as number
  2898.                tasks; if it is not numeric, the data will be read in as
  2899.                letter tasks.  In the above example, suppose the first
  2900.                column is the names, the second the IDs, the third the
  2901.                sections, and the next four are tasks.  The sixth column
  2902.                (third task) would be read in as a letter task.  The tasks
  2903.                would be numbered as the first four unused tasks in your
  2904.                class, and given names (e.g., Number task 1, Number task 2,
  2905.                Letter task 3, and Number task 4).
  2906.  
  2907.             2. Importing comma & quote files
  2908.  
  2909.                Many spreadsheets also can read in data from files where the
  2910.                data is not in columns, but is instead separated by commas.
  2911.  
  2912.                                          42
  2913.  
  2914.  
  2915.  
  2916.  
  2917.  
  2918.                                                        Entering Students
  2919.                Data that has commas in it, e.g., student names, are kept
  2920.                together by double quotes ("").   The "C" option of the Add
  2921.                Students Menu lets you import data from these files.   An
  2922.                example of data in the file might be:
  2923.  
  2924.                     "Jones, Fred", "123", 1, 34.5, 23.5, B, 44
  2925.                     "Smith, Ann", "321", 2, 43.5, 18.3, B, 43
  2926.  
  2927.                The program will assume that the student names are in the
  2928.                first field, the IDs in the next, and the next five are
  2929.                tasks.  For the tasks, the fourth one will be a letter task;
  2930.                the others will be number tasks.  As in the flat files, the
  2931.                names of the exams will be made by the program, and the
  2932.                first five unused tasks will be used for the new tasks.  If
  2933.                this is not what you want, you have another option.  You
  2934.                might include this as the first line of the file:
  2935.  
  2936.                     "Name", "ID", "Section", "One", "Two", 8, "#4"
  2937.  
  2938.                This line would tell the program that the first field is the
  2939.                name, the second is the ID, the third is the section, the
  2940.                fourth and fifth are number tasks (they are numbers) with
  2941.                the names One and Two, the sixth is a Letter task 8, and the
  2942.                last field is a number task with the name #4.
  2943.  
  2944.                NOTE: Whether they are letter or number tasks is determined
  2945.                  by the student data, not from the first line.
  2946.  
  2947.                On the first line, "Name" tells the program that field is
  2948.                student names, "ID" tells it is IDs, "Notes" means student
  2949.                notes, "Section" refers to sections, and any other words are
  2950.                treated as tasks.  These need to be the entire label for the
  2951.                fields, but whether the labels are in upper and/or lower
  2952.                case letters is not important.  For the tasks, anything that
  2953.                is a number (like 8) is taken as the desired number of the
  2954.                task (the program will make up a name for the task), and
  2955.                anything that is not a number will be taken as the name
  2956.                (with its number being the first unused task).  Whether the
  2957.                tasks are made number or letter tasks are determined by the
  2958.                data on line two (the first student).
  2959.  
  2960.             3. Automatic flat file imports
  2961.  
  2962.                The "A" option on the Add Students Menu works like the
  2963.                previous one ("C"), except that the fields are separated by
  2964.                one or more spaces, not by commas.  The method of
  2965.                determining the type of data is the same as that used for
  2966.                the comma and quote files.
  2967.  
  2968.                                          43
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.             4. Entering scores of one task
  2976.  
  2977.                The "G" option on the Add Students Menu is designed to be a
  2978.                simple import of grades from one task.  The main purpose of
  2979.                this option is for instructors in large classes.  They can
  2980.                easily import grades on an assignment from their teaching
  2981.                assistants.  Either names or ID's are matched with students
  2982.                in the class, then the new grade will replace the previous
  2983.                one.  The files imported need to have either the name or ID
  2984.                listed first, then a comma, then the task scores.  If the
  2985.                names have commas in them, you can surround them with double
  2986.                quotes (e.g., "Darwin, Charles").  When you enter this part
  2987.                of the program, you are asked for the file name, the task
  2988.                number, and whether to match names or ID's.  If the teaching
  2989.                assistants use VAR Grade, it is easier to export and import
  2990.                via a comma and quote file, as the import is done
  2991.                automatically.
  2992.  
  2993.                The file format should have names or ID's like the following
  2994.                example (listing ID's, then the task score):
  2995.  
  2996.                     A1234567, 66
  2997.                     Z6543210, 44
  2998.  
  2999.             5. GrUtil
  3000.  
  3001.                The utility program GrUtil can load students from text files
  3002.                into the class via all three ways as VAR Grade can.  It will
  3003.                also print "grids" for the students.  Grids are empty boxes
  3004.                for entering data.  There are, therefore, four different
  3005.                things GrUtil can do.  For the examples below, the DOS
  3006.                prompt is assumed to be "A>", although your prompt may be
  3007.                "B>", "C>", "C\VARGRADE>", or any other prompt.  It is also
  3008.                assumed that you are reading students into the class
  3009.                GSAMPLE.  If you have a monochrome monitor, you can start
  3010.                the program with an extra "/B", e.g., start with GRUTIL/B
  3011.                instead of GRUTIL for the examples below.
  3012.  
  3013.  
  3014.  
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.                                          44
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.                                                        Entering Students
  3031.                (a) Printing grids
  3032.  
  3033.                  To print grids, you need to tell the program what class to
  3034.                  use, and that it needs to print grids.  To print grids of
  3035.                  the class GSAMPLE, type, at the DOS prompt:
  3036.  
  3037.                     A> GRUTIL GSAMPLE GRID
  3038.  
  3039.                  Be sure your printer is on when you run this program.
  3040.                  This is a quick way to get a list of the students and to
  3041.                  get boxes to put their grades.  You can print attendance
  3042.                  grids (twice as many boxes) by replacing "GRID" with
  3043.                  "AGRID".
  3044.  
  3045.                (b) Loading students from flat files
  3046.  
  3047.                  GrUtil can load students from flat files, the same as VAR
  3048.                  Grade, but you must specify the columns for the names,
  3049.                  IDs, and sections when you invoke the program.  If the
  3050.                  column for the student names starts or ends with a 0, the
  3051.                  program assumes that it should figure out what data is
  3052.                  where, and loads as do the comma and quote files (see
  3053.                  below).  If there are no IDs or sections, then entering a
  3054.                  0 for the start of their data will cause the program to
  3055.                  not load them into the class.  For example, to load from
  3056.                  the flat file FLAT.TXT into the class GSAMPLE, type the
  3057.                  following at the DOS prompt type (the numbers are the
  3058.                  names, etc):
  3059.  
  3060.                     A> GRUTIL GSAMPLE FLAT.TXT 1 20 21 40 0 0 41 44
  3061.  
  3062.                  This will tell the program to load students from the
  3063.                  FLAT.TXT file into GSAMPLE, with the names starting at
  3064.                  column 1 and ending at column 20, the IDs starting at
  3065.                  column 21 and ending at column 40, and the sections at
  3066.                  column 41 and ending at column 44.  Student notes are not
  3067.                  in the file.
  3068.  
  3069.                  If you are just loading names into the program, type:
  3070.  
  3071.                     A> GRUTIL GSAMPLE FLAT.TXT 1 20
  3072.  
  3073.                (c) Loading students from comma and quote files
  3074.  
  3075.                  Students from comma and quote files will be read by GrUtil
  3076.                  the same way that VAR Grade does.  Type, at the DOS
  3077.                  prompt:
  3078.  
  3079.  
  3080.                                          45
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.                     A> GRUTIL GSAMPLE COMMA.TXT COMMA
  3088.  
  3089.                  This tell GrUtil to load students into the class GSAMPLE
  3090.                  from the file COMMA.TXT.  COMMA tells the program it is a
  3091.                  comma and quote file.
  3092.  
  3093.                (d) Loading students from other files
  3094.  
  3095.                  If you start GrUtil with only the names of the class and a
  3096.                  text file, or with those plus a 0 for the where the
  3097.                  student names start, GrUtil will assume you are loading a
  3098.                  flat file.  It will try to make sense of the file in the
  3099.                  same manner as the quote and comma files, except that
  3100.                  spaces separate the cells.  To load students this way:
  3101.  
  3102.                     A> GRUTIL GSAMPLE TEXT.TXT
  3103.  
  3104.                See the section "Automatic Flat file Imports" above for more
  3105.                details.
  3106.  
  3107.             6. Large classes
  3108.  
  3109.  
  3110.                (a) Transferring scores between classes
  3111.  
  3112.                  For classes with many sections, teaching assistants
  3113.                  usually grade the sections.  You can have them export
  3114.                  grades from their section as a comma and quote file, then
  3115.                  import them into the program (again as a comma and quote
  3116.                  file).  To do this, you need to make sure that (a) the
  3117.                  section numbers are exported along with the grades, and
  3118.                  that (b) the task (exam) names that the teaching
  3119.                  assistants use are all identical.  So, for example, they
  3120.                  must all use "Midterm #1" and not "Exam #1" or "Midterm
  3121.                  1", etc.  Other ways to export and import scores are
  3122.                  suggested above.
  3123.  
  3124.                (b) Moving students between sections
  3125.  
  3126.                  You can move all the students from one section to another
  3127.                  one by pressing "M" on the Add Students Menu.  You will
  3128.                  need to enter the old and new section numbers.  Every
  3129.                  student in the old section will be moved into the new
  3130.                  section.
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.                                          46
  3137.  
  3138.  
  3139.  
  3140.  
  3141.  
  3142.                                                        Entering Students
  3143.                (c) Deleting Sections
  3144.  
  3145.                  You can remove one or more sections of a class by pressing
  3146.                  "N" on the Main Menu, then "S".  Every student in the
  3147.                  section or sections that you choose will be removed from
  3148.                  the class.  All student in the class can also be deleted
  3149.                  from this menu.
  3150.  
  3151.           E. Sorting Students
  3152.  
  3153.             Students can be sorted by a variety of methods, including by
  3154.             name only, by name and section, by ID only, by ID and section,
  3155.             by section only, by the scores of any defined task, or by no
  3156.             sorts.  You can change the method of sorting in the "Z" option
  3157.             of the Main Menu, then "A" (alter the method of sorting the
  3158.             class).  The change is "permanent" in that the program will
  3159.             remember which sorting method was used and will continue to use
  3160.             that method until told differently.  Sorts are not done until
  3161.             you are finished altering data, so if you add new students, the
  3162.             names will not be alphabetized or sorted until you exit back to
  3163.             the Main Menu.
  3164.  
  3165.             You can have the program list the students via their names OR
  3166.             by their IDs.  This affects how the students are listed when
  3167.             you see lists of students on the screen.  When you print the
  3168.             scores, you are also asked how you want the class listed to the
  3169.             printer.
  3170.  
  3171.           F. Transferring Names to a New Class
  3172.  
  3173.             If you have entered names into one class, and need to have the
  3174.             same list of students entered into a second class, there are
  3175.             several ways it can be done.
  3176.  
  3177.             First, if no tasks have been entered, you can simply save the
  3178.             names of the first class, then save them again with a different
  3179.             name.  Saving is done in the "S" option of the Main Menu.  When
  3180.             you save the class, it first lists the name of the class.  Just
  3181.             change it to the second class name.
  3182.  
  3183.             WARNING: When you change the name of the class, the program
  3184.                assumes that the new name is the one you are using.  So if
  3185.                the first class was English, and the second Physics, the
  3186.                program will use the Physics name for the class currently in
  3187.                memory.
  3188.  
  3189.  
  3190.  
  3191.  
  3192.                                          47
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.             Second, if tasks have been entered, you can do the same
  3200.             procedure as the first one, except that you then remove all the
  3201.             tasks from the second class.  This is done on the "T" option of
  3202.             the Main Menu, then "R".
  3203.  
  3204.             Third, you can export the class names as either a comma and
  3205.             quote file or as a flat file.  Then you can read the names back
  3206.             in to the new class.
  3207.  
  3208.             Example: When in English, save the class as a flat file in the
  3209.                "W" option of the Main Menu.  Then exit the class ("X" on
  3210.                the Main Menu), and choose the Physics class.  Then, in the
  3211.                "N" option of the Main Menu, tell the program to import a
  3212.                flat file, and choose the one you just wrote.
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.  
  3244.  
  3245.  
  3246.  
  3247.  
  3248.                                          48
  3249.  
  3250.  
  3251.  
  3252.  
  3253.  
  3254.                                                           Defining Tasks
  3255.  
  3256.  
  3257.                                  VII. DEFINING TASKS
  3258.  
  3259.  
  3260.  
  3261.                Tasks are graded assignments for students.  They can be
  3262.           homework, exams, tests, papers, or anything else that is graded.
  3263.           There are ten different predefined types of tasks in VAR Grade.
  3264.           The tasks are divided into two categories: (1)  Regular tasks are
  3265.           those where you enter grades.  There are three types of regular
  3266.           tasks.  (2) Special tasks are those that you do not enter grades
  3267.           into.  These include sums, averages, percentages, etc.  There are
  3268.           seven types of special tasks.  Defining, removing, and redefining
  3269.           tasks can be done from the Task Type Menu, the "T" option of the
  3270.           Main Menu.
  3271.  
  3272.           A. Regular Tasks
  3273.  
  3274.             You can enter tasks as numbers (Number tasks), you can enter
  3275.             them as letters (Letter tasks), or you can enter them as extra
  3276.             credit (Extra credit tasks).  These can be defined in the "T"
  3277.             section of the Main Menu.  You give a task a name, then, if it
  3278.             is a number task, the total allowed points for that task.
  3279.  
  3280.             1. Number tasks
  3281.  
  3282.                  Number tasks are ones in which you enter numbers as the
  3283.                  grades.  The maximum allowed points for any regular task
  3284.                  is one million!  The program checks the scores of every
  3285.                  student when you put in the scores to make sure they do
  3286.                  not exceed the maximum allowed points.  If the score does
  3287.                  exceed it, that score is rejected, and a new score must be
  3288.                  entered.  This validation of scores reduces the number of
  3289.                  errors made while entering student scores.  Tasks that
  3290.                  have 0 or less total points are ignored by Special tasks.
  3291.                  Note that the program will assume the task has 100 total
  3292.                  points unless you alter the number.  You can also "fast
  3293.                  define" a sum task by pressing <F1>.  The next available
  3294.                  task number will be defined as a Number Task having 100
  3295.                  points.  All you need to enter is the name of the task.
  3296.                  The next available task number means that if you have
  3297.                  defined tasks 1 through 10, the new one will be 11.  If
  3298.                  you have defined tasks 1 thru 5 and 10 thru 15, the new
  3299.                  one will be task 6 (not 16).
  3300.  
  3301.  
  3302.  
  3303.  
  3304.                                          49
  3305.  
  3306.  
  3307.  
  3308.  
  3309.  
  3310.  
  3311.                  If you decide to increase or decrease the total points of
  3312.                  a number task, you can do so without changing the student
  3313.                  scores.  You need to redefine the task.
  3314.  
  3315.                  For example, if task 5 is worth 50 points, and you want to
  3316.                  change this to 100, you define task 5 by pressing "N" on
  3317.                  the Task Menu.  You will be asked for the name of the task
  3318.                  (with the old name shown).  You will then be asked for the
  3319.                  total points (enter 100).  Last, you will be asked if the
  3320.                  student scores should be deleted.  At this point, say NO.
  3321.                  The new total points will be 100, and the student scores
  3322.                  will be the same.
  3323.  
  3324.                  WARNING: If you decrease the total points, student scores
  3325.                     greater than the new total will be reduced to that
  3326.                     total.
  3327.  
  3328.             2. Letter tasks
  3329.  
  3330.                Letter tasks are ones where the scores are entered as
  3331.                letters.  The program will converts them to numbers, but the
  3332.                score can be entered, printed, and manipulated as a letter
  3333.                grade.  The standard or default grading system is an A is
  3334.                4.0, a B is 3.0, a C is 2.0, etc.  Plusses are 0.3 points
  3335.                higher (except A+), and minuses are 0.3 points below the
  3336.                grade (e.g. B- = 2.7;  C+ = 2.3).  You can, however, define
  3337.                any grading system that you want, including the names and
  3338.                points for each grade, as long as the total grade types does
  3339.                not exceed 50 (see Chapter XI, Section ).  If you do change
  3340.                the grading system, you should do it before you enter any
  3341.                letter grades.  The program stores the grades as numbers,
  3342.                not as letters.  Thus, changing the points allowed for
  3343.                letter grades after some letter grades have been assigned
  3344.                can result in incorrect scores.
  3345.  
  3346.             3. Extra credit tasks
  3347.  
  3348.                Extra credit tasks are ones where the points can be added to
  3349.                a number task, but the total points of the number task are
  3350.                not altered.  Extra credit tasks are treated in special ways
  3351.                by the program.  The extra credit tasks need to have the
  3352.                total points be specified, just like number tasks.  However,
  3353.                this number is used only to check data entry.  As far as the
  3354.                special exams (below) are concerned, extra credit tasks have
  3355.                0 total task points, but the student scores are used in the
  3356.                calculations for special tasks.  In the case of discarding
  3357.                the lowest of a list of tasks, if the extra credit score is
  3358.                one of lowest scores, it will be discarded.  This may not be
  3359.  
  3360.                                          50
  3361.  
  3362.  
  3363.  
  3364.  
  3365.  
  3366.                                                           Defining Tasks
  3367.                what you want, so you should consider this potential problem
  3368.                before you include extra credit tasks in the definitions of
  3369.                Highest Tasks.
  3370.  
  3371.           B. Special Tasks
  3372.  
  3373.             The second type of tasks are called Special tasks. These can
  3374.             also be specified in the "T" section of the Main Menu.  Special
  3375.             tasks are Sums, Averages, Highest, Percentages, etc., of other
  3376.             tasks.  You do not enter scores into special tasks.  Instead,
  3377.             you define the task as the sum (average, percentage, highest,
  3378.             etc.) of other tasks.  The program then calculates the scores
  3379.             for you.  These scores will be recalculated each time you
  3380.             change student scores.
  3381.  
  3382.             Note: Unentered tasks can either be ignored by special exams or
  3383.             they can count as 0 total points.  Which of these the program
  3384.             will use can be set on the Grading Menu ("G" on the Main Menu,
  3385.             then "Z").  Scores less than the fewest allowed points, which
  3386.             can also be set on the Grading Menu, will always be ignored.
  3387.  
  3388.             For example: at the end of the term, you probably want to add
  3389.             up all the task scores in the class.  You can specify a task,
  3390.             e.g. #30, as the sum of all the previous tasks (#1 through
  3391.             #29).  Task #30 is a special task called a "sum task".  Since
  3392.             any of the 10,000 possible task numbers can be either a special
  3393.             or regular task, you can, for example, define special tasks as
  3394.             the sums of quizzes, tests, and/or homework.
  3395.  
  3396.             One limitation for defining special tasks is that they can be
  3397.             defined only as tasks acting on other tasks with lower numbers.
  3398.             Allowing you to add or sum tasks with the same or higher
  3399.             numbers could result in circular definitions that would confuse
  3400.             the computer and produce nonsense or variable results.  A
  3401.             second limitation applies only to sums of tasks.  The total
  3402.             points allowed for a "sum task" (like task #30 above), is
  3403.             9,999,999 (less than 10 million points).  The ability to
  3404.             specify any task as the sums of others is a very powerful
  3405.             feature that should allow great flexibility when you analyze
  3406.             student scores.
  3407.  
  3408.             NOTE:  Tasks can be removed by using the "R" (remove) option on
  3409.             this second menu or by redefining the task as a new task.  To
  3410.             remove, choose the "R" (Remove) option.  Then choose the task
  3411.             number or numbers at the prompt.  Since all student data for
  3412.             the task(s) is also removed, you will be asked again to make
  3413.             sure that you want to remove the task(s).
  3414.  
  3415.  
  3416.                                          51
  3417.  
  3418.  
  3419.  
  3420.  
  3421.  
  3422.  
  3423.             1. Sum tasks
  3424.  
  3425.                These are tasks that are the sums of other tasks.  Tasks can
  3426.                be summed multiple times.
  3427.  
  3428.                Example: Task 5 can be the sum of task 1 + task 1 + task 1.
  3429.                This would be the equivalent of multiplying the task by 3.
  3430.  
  3431.                Tasks that are not yet entered can be included in the list
  3432.                of tasks that will be summed.  When the tasks are then
  3433.                defined, they will be included in the sums.  The total
  3434.                points possible for each student includes only those tasks
  3435.                that have scores entered.
  3436.  
  3437.                Example: Task 12 is the sum of tasks 3, 5, and 7.  Each has
  3438.                100 possible points.  Mary had 90 points on task 3, and 85
  3439.                on task 5.  She has 175 of 200 points.  When her score for
  3440.                task 7 is entered, there will then be 300 total points
  3441.                possible.
  3442.  
  3443.                NOTE: The sums of all the tasks in a Sum task must be less
  3444.                  than 10 million points.
  3445.  
  3446.             2. Averaged tasks
  3447.  
  3448.                These are tasks that are the average of other tasks.  Task 5
  3449.                can be the average of tasks 1 through 4.  If you use letter
  3450.                grades, the averages are reported as scores between the
  3451.                highest (e.g. A) and the lowest tasks (e.g., F), but the
  3452.                average is shown with numbers, not letters.  Any tasks that
  3453.                have not yet been entered are NOT averaged, so the averages
  3454.                reflect only those tasks for which the student has had
  3455.                scores entered.
  3456.  
  3457.             3. Percentage tasks
  3458.  
  3459.                These are tasks that average other tasks, then convert the
  3460.                scores to percentages of the total points.
  3461.  
  3462.                Example:  If task 10 is the percentage of tasks 5 and 6
  3463.                (which each have 100 points), the program adds up the scores
  3464.                from 5 and 6, then divides the scores by the total points of
  3465.                5 and 6 (200 points).  The score is then converted to a
  3466.                percent by multiplying by 100.  Hence, the scores range from
  3467.                0 to 100 percent.
  3468.  
  3469.                Like sum and average tasks, any tasks that have not yet been
  3470.                entered are not used in the conversions, so the percentages
  3471.  
  3472.                                          52
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478.                                                           Defining Tasks
  3479.                reported for the students are for the tasks that have
  3480.                already had scores entered.
  3481.  
  3482.             4. Highest tasks:  Throwing out the lowest scores
  3483.  
  3484.                Throwing out low tasks seems to be a popular phenomenon with
  3485.                students.  Unfortunately, it is a fairly tedious thing to do
  3486.                for instructors.  You can throw out the lowest of a set of
  3487.                tasks in VAR Grade.  In the "T" section of the Main Menu,
  3488.                option "H" will allow you to define a task that will throw
  3489.                out the lowest task(s) of a special task.
  3490.  
  3491.                Example: You can throw out the lowest two out of ten tasks.
  3492.  
  3493.                Highest tasks discard the lowest one or more scores of a
  3494.                sum, average, or percentage tasks ("throw out the lowest of
  3495.                several scores").  The special task that is used must have a
  3496.                number lower than the highest task.  This is a very common
  3497.                grading option that is used in many classrooms.
  3498.  
  3499.                For a highest task, the program will find the lowest scores
  3500.                of a list of tasks and add up only the highest of those
  3501.                scores.  You need to tell the program how many tasks to
  3502.                discard (the lowest 1, the lowest 5, etc.).  Scores that are
  3503.                unentered are discarded first, then the lowest scores that
  3504.                have been entered are discarded.
  3505.  
  3506.                You can throw out scores on any sum, average, or percentage
  3507.                task.  The "highest" task will report the score with the
  3508.                same type.  Therefore, if you discard the lowest of an
  3509.                average task, the scores will be reported as an average.
  3510.  
  3511.             5. Weighted tasks
  3512.  
  3513.                You can define a task as the sum of other tasks, each times
  3514.                a weight.  For example, you can define task 20 as the sum of
  3515.                task 10 with a weight of 0.2, task 11 with a weight of 0.3,
  3516.                and task 12 with a weight of 0.5.  This will give "true"
  3517.                weighting of tasks.  Unentered tasks are always given a
  3518.                score of 0 for the weighting.  You will first be asked for
  3519.                the total points the task will be worth, after weighting.
  3520.                Then, you will be asked which tasks to weight.  Last, you
  3521.                will be asked for the relative weights for each of those
  3522.                tasks.  The relative weights can be percentages, or in
  3523.                arbitrary numbers.
  3524.  
  3525.                Example: If you have three exams in your class, each worth
  3526.                100 points, and want to weight them 30%, 30%, and 40%, you
  3527.  
  3528.                                          53
  3529.  
  3530.  
  3531.  
  3532.  
  3533.  
  3534.  
  3535.                can define task 4 as the weight of task 1 with a final
  3536.                weight of 30, task 2 with a weight of 30, and task 3 with a
  3537.                weight of 40.
  3538.  
  3539.                The calculation for the weights is done by taking the
  3540.                weights you give for each task and dividing them by the
  3541.                total points for each task.  These numbers are then added up
  3542.                and adjusted so that the maximum possible points is equal to
  3543.                the total points of the weight task.  For the example above,
  3544.                assuming you want the total points to be 100, the students
  3545.                scores are calculated as:
  3546.  
  3547.                  100 * (((Task #1 score) * 30 / 100) + ((Task #2 score) *
  3548.                     30 / 100) + ((Task #3 score) * 40 / 100))
  3549.  
  3550.                The parentheses denote calculations that are kept together.
  3551.                In the example, "*" means "multiplied by".
  3552.  
  3553.             6. Final task
  3554.  
  3555.                You can define a task as a final task.  This task will
  3556.                assign letter grades based upon scores of another task.
  3557.                These scores are only assigned after cutoffs have been
  3558.                assigned.  This is done either by defining automatic cutoffs
  3559.                in the "G" option of the program before you define the task,
  3560.                or by assigning new cutoffs, also in the "G" option.  The
  3561.                final grades are recalculated each time new scores are
  3562.                entered.  If you don't want the grades recalculated, you can
  3563.                either change the task to a letter task after the
  3564.                assignments, or you can transfer the scores to a new letter
  3565.                task.
  3566.  
  3567.  
  3568.             7. Attendance task
  3569.  
  3570.                If you use attendance in your classes, you can define a task
  3571.                that will automatically calculate a score based upon their
  3572.                attendance.  To do this, you first specify how many points
  3573.                the task will be worth.  Next, you need to pick which
  3574.                attendance days to use.  Note that pressing <F1> will choose
  3575.                all the attendance days.  Last, you can assign relative
  3576.                weights for each type of attendance (there are six different
  3577.                types), and how many days to ignore (for example, if you
  3578.                allow two absences per grading period, you can tell the
  3579.                program to discard the lowest two attendance scores).  For
  3580.                assigning the relative weights for the different types of
  3581.                attendance, you can assign "default" values on the
  3582.                Attendance Menu ("A" on the Main Menu).
  3583.  
  3584.                                          54
  3585.  
  3586.  
  3587.  
  3588.  
  3589.  
  3590.                                                           Defining Tasks
  3591.  
  3592.             NOTE: If there are other types of special tasks that you would
  3593.             like to have the option of using, send a note to us and explain
  3594.             how this type of task would be calculated.  We will try to
  3595.             accommodate you.
  3596.  
  3597.           C. Scaling Tasks
  3598.  
  3599.             In the "G" option of the Main Menu, there is an option that
  3600.             lets you add any number of points to a regular task, or
  3601.             multiply the scores of any regular task by a number.   Since
  3602.             the primary purpose of scaling scores is to adjust the scores
  3603.             before giving final grades, further details are given in
  3604.             Chapter XI, Assigning and Printing the Final Grades.
  3605.  
  3606.           D. Memory Limitations
  3607.  
  3608.             Each task that is defined takes up space.  In cases where
  3609.             memory is limited, you may find that you cannot define a new
  3610.             task.  You may need to delete an old task to be able to add a
  3611.             new one.  A second option to increase your memory is by
  3612.             removing any TSR (terminate and stay resident) programs like
  3613.             SidekickTM (Borland International) from memory BEFORE running
  3614.             the program.  A third option is to tell VAR Grade to use less
  3615.             memory for overlays (See Chapter V, Section B3, above).  VAR
  3616.             Grade uses very little memory per student, so, for example,
  3617.             classes of 30 students with 30 tasks or of 90 students and 10
  3618.             tasks would take up less than 15K of memory over and above that
  3619.             used by the program.  If you are having memory problems,
  3620.             contact us at the address below for possible solutions.
  3621.  
  3622.           E. Manipulating Tasks
  3623.  
  3624.             Tasks can easily be moved, copied, removed, and so forth.
  3625.  
  3626.             1. Copying tasks
  3627.  
  3628.                Tasks may by copied to new tasks that have higher task
  3629.                numbers.  To do this, go the "T" option of the Main Menu,
  3630.                then press "C".
  3631.  
  3632.                The definition of the task is copied exactly, even if the
  3633.                task is a special task.  The students scores are copied as
  3634.                well.  You will be asked for a new name for the task,
  3635.                however.
  3636.  
  3637.  
  3638.  
  3639.  
  3640.                                          55
  3641.  
  3642.  
  3643.  
  3644.  
  3645.  
  3646.  
  3647.                Example:  If the task to be copied is a number task, the new
  3648.                task will have the same total points and student scores as
  3649.                the first task.
  3650.  
  3651.                Example:  If the task to be copied is defined as the
  3652.                percentage of tasks 1 through 3, the new task will also be
  3653.                defined as the percentage of tasks 1 through 3.
  3654.  
  3655.             2. Transferring tasks
  3656.  
  3657.                When tasks are transferred, the student scores are
  3658.                transferred but the task definition is not.  The task to
  3659.                transfer to is defined as a number or letter task, depending
  3660.                upon the definition of the task to be transferred.  The
  3661.                student scores are copied from the first task to the second.
  3662.  
  3663.             3. Transfer one task definition
  3664.  
  3665.                You can transfer the definition of a single task, but not
  3666.                any student scores (which will be set as not yet entered).
  3667.                It is equivalent to copying the task, then clearing all the
  3668.                student scores.
  3669.  
  3670.             4. Transfer a group of task definitions
  3671.  
  3672.                You can also transfer the definitions of a group of tasks.
  3673.                The group is specified be entering the beginning and ending
  3674.                numbers of the tasks, then specifying where to transfer
  3675.                them.  Like the previous option, the task definitions will
  3676.                be transferred, but no student scores will be transferred.
  3677.                If any of the tasks that are transferred are special tasks,
  3678.                their definitions will be adjusted as follows: if the
  3679.                special tasks include any tasks that are also transferred,
  3680.                the new tasks will be redefined to include those tasks
  3681.                rather than the original tasks.
  3682.  
  3683.                  Example: Task 6, Week 1 average, is the average of tasks 1
  3684.                  through 5 (Monday thru Friday grades).  You decide to
  3685.                  transfer the definitions for Week 2.  You transfer tasks 1
  3686.                  thru 6 to 11 through 16.  Task 16 will now be defined as
  3687.                  the average of tasks 11 through 15 (not 1 through 5).
  3688.  
  3689.             5. Moving tasks
  3690.  
  3691.                You can move one or more tasks.  To move one task, press "M"
  3692.                on the Task Type Menu.  To move a group of several
  3693.                consecutive tasks, press "G".  When a task is moved, the
  3694.                task is renumbered, and all the special tasks that use that
  3695.  
  3696.                                          56
  3697.  
  3698.  
  3699.  
  3700.  
  3701.  
  3702.                                                           Defining Tasks
  3703.                task are redefined to refer to the new number, as well.
  3704.                When you move a group of tasks, you are asked for the first
  3705.                and last numbers of the tasks to move.  All the tasks
  3706.                between and including those two numbers are moved.  Student
  3707.                scores, of course, move along with the task.
  3708.  
  3709.             6. Clearing student scores
  3710.  
  3711.                To redefine all student scores for a task as unentered, use
  3712.                the "K" option on the Task Type Menu.  The task remains
  3713.                defined the same way as previously.  You can clear only
  3714.                regular tasks, as the others are recalculated each time
  3715.                scores are entered into the class.
  3716.  
  3717.             7. Show task definition
  3718.  
  3719.                To help you remember how you have defined tasks, the "V"
  3720.                option on the Task Type Menu will list the current
  3721.                definition of the task.
  3722.  
  3723.             8. Removing tasks
  3724.  
  3725.                You can remove one or more tasks from the class.  The "R"
  3726.                option on the Task Type Menu asks you for a list of all the
  3727.                tasks to remove.  After you specify the tasks to be removed,
  3728.                the program will ask you if you really want to remove them.
  3729.                If you say "D" (delete), the task and the student scores
  3730.                will be deleted from the class.  Using the option with the
  3731.                <F1> key to select all tasks will start the class over for
  3732.                you.  If you have the same students from one grading period
  3733.                to the next, removing all the tasks will start the class
  3734.                over for you, while keeping the students in the class.
  3735.  
  3736.           F. Examples of Task Definitions
  3737.  
  3738.             Example #1: I gave three tests.  The first was worth 100
  3739.                points, the second was worth 130 points, and the third was
  3740.                worth 211 points.  I want the exams to be worth 25%, 25%,
  3741.                and 50%, respectively, and the total points to be 100.
  3742.             Solution: Define the tests as Tasks 1 through 3, all number
  3743.                tasks.  Define task 4 as a Weight Task.  For task 4, make
  3744.                the task worth 100 points.  Then pick tasks 1 through 3, and
  3745.                assign task 1 a weight of 25, task 2 a weight of 25, and
  3746.                task 3 a weight of 50.
  3747.  
  3748.  
  3749.  
  3750.  
  3751.  
  3752.                                          57
  3753.  
  3754.  
  3755.  
  3756.  
  3757.  
  3758.  
  3759.             Example #2: For each test, I give two versions to my students.
  3760.                Half the students take one version, half the other.  I want
  3761.                to keep track of each version separately, yet calculate the
  3762.                final averages in the semester for the students in my class.
  3763.             Solution: For each test, define three tasks.  The first two are
  3764.                the two versions of the tests.  The third one is an Average
  3765.                Task, which averages the first two tasks.  The third task
  3766.                will be the average of one task that has an entered score
  3767.                and one that is unentered, hence equivalent to the entered
  3768.                score (see the definition of Average Tasks, above).
  3769.  
  3770.             Example #3: I give a homework assignment, then give students
  3771.                extra credit for turning it in early.  At the end of the
  3772.                semester, I discard the lowest homework assignment.
  3773.                However, I don't want the extra credit discarded, just the
  3774.                lowest homework.
  3775.             Solution: When the homework is graded, define the homework
  3776.                task, the extra credit task, and a third task, the sum of
  3777.                the homework and extra credit.  When you discard the lowest
  3778.                homework assignment, use the third task in the definition,
  3779.                not the first two tasks.
  3780.  
  3781.             Example #4: I want to distinguish between unentered grades and
  3782.                excused grades.  How do I do it?
  3783.             Solution:  The program keeps track of the lowest allowed score.
  3784.                When the program is first run, the lowest allowed score is
  3785.                0.  You can, however, enter scores less than 0.  You can
  3786.                always enter scores down to -1,000,000.  NOTE:  You can tell
  3787.                the program the lowest score to use for statistics in the
  3788.                "G" option on the Main Menu, then "F" for fewest. The
  3789.                program, when calculating statistics, assumes that scores
  3790.                less than the fewest allowed points are unentered scores.
  3791.                The scores you entered, however, are displayed correctly (as
  3792.                scores less than the fewest allowed) when printing or
  3793.                entering scores.  Hence, if you enter a -100, it will be
  3794.                ignored for the plots, printing, etc., but written as a -100
  3795.                when entering data.
  3796.  
  3797.             Example #5: I want to assign grades to students halfway through
  3798.                the semester.  I then want to assign final grades at the end
  3799.                of the semester.
  3800.             Solution: Define a Final Task at the half way point that
  3801.                assigns grades based on the first half scores.  Then assign
  3802.                grades in the "G" option of the Main Menu.  Define a second
  3803.                Final Task that assigns grades based on the grades for the
  3804.                entire class.
  3805.  
  3806.  
  3807.  
  3808.                                          58
  3809.  
  3810.  
  3811.  
  3812.  
  3813.  
  3814.                                                           Defining Tasks
  3815.             Example #6: I defined a number task as having 100 points.  I
  3816.                entered grades, then decided to redefine it as having 110
  3817.                points.  Yet, I do not want to lose the previously entered
  3818.                grades.
  3819.             Solution: When you redefine a task, the program asks whether to
  3820.                delete any previous grades.  If you say no, the grades will
  3821.                not be changed.  The only exception is if you decrease the
  3822.                number of points, and a student has more than that number.
  3823.                That student score will be decreased to the new maximum
  3824.                points for the task.
  3825.  
  3826.             Example #7: I give three quizzes each week.  Then I define a
  3827.                task as the sum of these three scores.  It's tedious to keep
  3828.                defining the tasks each week.  Is there an easier way?
  3829.             Solution: Define the tasks for the first week.  Thereafter,
  3830.                transfer the task definitions (section E4, above).  If the
  3831.                first week tasks were 1 through 4, transfer the group to
  3832.                tasks 5 through 8.  The new task 5 through 7 definitions
  3833.                will be the same as tasks 1 through 3, and task 8 will sum
  3834.                tasks 5 through 7.
  3835.  
  3836.             Example #8: Halfway through the semester, I like to give the
  3837.                students a handout that tells them their current grades,
  3838.                including a tentative final grade.
  3839.             Solution: Define a task that sums, averages, or calculates the
  3840.                percentages of the scores on the tasks.  Define the
  3841.                automatic cutoffs in the "G" option of the Main Menu.  Use
  3842.                your standard grade cutoffs.  Then define a final task,
  3843.                using the previous task.  This task will now calculate final
  3844.                grades based upon only those scores that have been entered.
  3845.  
  3846.             Example #9: I set up my class so that tasks 1 through 10 are
  3847.                quizzes, 11 through 20 are tests, and 21 through 40 are
  3848.                homework.  I just gave my eleventh quiz.  What do I do?
  3849.             Solution: Move tasks 11 through 40 to higher numbers.  For
  3850.                example, move them to tasks 21 through 50.  This is done
  3851.                with the "M" option on the Task Menu (see section E5,
  3852.                above).
  3853.  
  3854.             Example #10: I gave three exams, each worth 100 points.
  3855.                However, the third exam should have been worth 150 points.
  3856.                How can I fix this?
  3857.             Solution: Scale the task, "S" on the Grading Menu, by telling
  3858.                the program to multiply the scores by 1.5.  The new scores
  3859.                will each be 1.5 the original scores, and the exam total
  3860.                points will be 150.
  3861.  
  3862.  
  3863.  
  3864.                                          59
  3865.  
  3866.  
  3867.  
  3868.  
  3869.  
  3870.  
  3871.             Example #11: I used one class for the fall semester ("Fall"),
  3872.                and another for the spring semester ("Spring").  I want to
  3873.                consolidate the grades from the two classes so that I can
  3874.                calculate a final grade for the year.  How can I do this?
  3875.             Solution: One way is to define a third class, "Year".  Enter
  3876.                and export, via a comma and quote file ("W" on the Main
  3877.                Menu, then "Q"), the task scores you need for the final
  3878.                grades from each of the two classes "Fall" and "Spring".
  3879.                Make sure, before you export the tasks, that the names of
  3880.                the tasks from the two classes are different.  Then, when in
  3881.                "Year", import those two files ("N" on the Main Menu, then
  3882.                "C").
  3883.  
  3884.             Example #12: I want attendance to count for 20% of the grade in
  3885.                my class, tests 40%, and homework 40%.  In addition, I allow
  3886.                three absences in the semester.  How do I do this?
  3887.             Solution:  First, define a task that totals the homework (e.g.,
  3888.                #20), and one that totals the tests (#21).  Nest, define an
  3889.                attandance task (#22).  Make the task worth, for example,
  3890.                100 points.  Pick which days to use for the attendance.
  3891.                Then, specify three days of attendance to be discarded.
  3892.                Last, assign weights for each attendance type (e.g., 2.0 for
  3893.                present and excused, 1.0 for late, and 0 for the rest).
  3894.                Next, define tasks that total the homework and tests.  Last,
  3895.                define a weight task (#30), and assign the attendance task
  3896.                (#22) a weight of 20, homework (#20) a weight of 40, and
  3897.                tests (#21) a total of 40.  If you want final grades
  3898.                assigned, define a final task that uses the scores of the
  3899.                weight task (#30).  Whew!
  3900.  
  3901.  
  3902.  
  3903.  
  3904.  
  3905.  
  3906.  
  3907.  
  3908.  
  3909.  
  3910.  
  3911.  
  3912.  
  3913.  
  3914.  
  3915.  
  3916.  
  3917.  
  3918.  
  3919.  
  3920.                                          60
  3921.  
  3922.  
  3923.  
  3924.  
  3925.  
  3926.                                                          Entering Grades
  3927.  
  3928.  
  3929.                                 VIII. ENTERING GRADES
  3930.  
  3931.  
  3932.  
  3933.                Grades can be entered into the program in either of two
  3934.           ways.  Either the whole class can be listed for a list of tasks,
  3935.           the "D" option of the Main Menu, or every grade for an individual
  3936.           student can be listed, the "I" option on the Main Menu.
  3937.  
  3938.           A. Entering Data for the Whole Class
  3939.  
  3940.             The "D" option of the Main Menu lets you enter task data for
  3941.             all students in the class.
  3942.  
  3943.             1. Moving around the screen
  3944.  
  3945.                Students, IDs, sections, and tasks can be listed on the
  3946.                screen.  To enter scores, the tasks must have already been
  3947.                defined in the "T" option on the Main Menu.  Only number,
  3948.                letter, and extra credit tasks can have scores entered.  The
  3949.                others are calculated by VAR Grade.
  3950.  
  3951.                To change which data is listed on the screen, use the key
  3952.                <AltC>.  You will be asked (a) if you want to list the
  3953.                students by name, ID, or both; if you pick both, there will
  3954.                be one column for each on the screen.  (b) Next, if there is
  3955.                more than one section of students in the class, you will be
  3956.                asked if you want the sections to be listed.  (c) Next, you
  3957.                will be asked if student notes should be listed.  (d)
  3958.                Finally, you can pick which tasks are listed on the screen.
  3959.  
  3960.                The options you select are saved by the program, so that the
  3961.                next time you use the program, the same list is shown.  Any
  3962.                time you define a regular task, it will be added to the end
  3963.                of the list of tasks.  Only the first characters of the task
  3964.                name (how many depends upon the total points for the task),
  3965.                as well as its number, are listed at the top of the columns,
  3966.                while the student names, and/or IDs, notes, and sections are
  3967.                listed on the left.
  3968.  
  3969.                A cell is a piece of data.  It can be a task score, a name,
  3970.                etc.  To move between cells, use the cursor keys.  The
  3971.                cursor keys are the ones on the keypad, including the arrows
  3972.                and the home, end, etc. keys.  If you "use" cursor keys,
  3973.                then use <Ctrl>-cursor keys to move between cells.
  3974.                Otherwise, use the left, right, etc. keys to move between
  3975.  
  3976.                                          61
  3977.  
  3978.  
  3979.  
  3980.  
  3981.  
  3982.  
  3983.                the cells.  You can change between "using" and not using
  3984.                cursor keys for editing by pressing <Ctrl-E> at any time.
  3985.                If you move past the right end of the screen, the tasks are
  3986.                scrolled to the left.  The student names (or IDs), however,
  3987.                always stay listed on the screen.  If there too many
  3988.                students to fit on one screen, the list will scroll up as
  3989.                you move down the screen.  The top of the screen lists some
  3990.                special keys.   They are:
  3991.  
  3992.                Key(s)    Movement
  3993.                <AltB>    Move to the beginning, left hand column.
  3994.                <AltE>    Move to the end column, that furthest right.
  3995.                <AltI>    Insert a new student before the student where the
  3996.                          cursor is.  If the cursor is at the end of the
  3997.                          line, insert the new student after the current
  3998.                          one.
  3999.                <AltD>    Delete the student where the cursor is.  This
  4000.                          immediately deletes the student.
  4001.                <AltC>    Change columns (discussed above).
  4002.                <AltS>    Save the data to memory.  It is not saved to disk.
  4003.                          To do that, use the "S" option on the Main Menu.
  4004.                <AltU>    Restore (undo) the data in that cell.  This works
  4005.                          only if you have not left the cell.
  4006.                <F10>     Delete the data in that cell.
  4007.                <AltZ>    Change sections for entering data.
  4008.  
  4009.                Alternatively, you can move around the screen with a mouse.
  4010.                The left mouse button moves the mouse to the position on the
  4011.                screen.  The middle button (for three-button mice), deletes
  4012.                the data in the current cell.  The right button is
  4013.                equivalent to pressing <Esc>.  Lastly, pressing both the
  4014.                left and right buttons simultaneously is equivalent to
  4015.                pressing the <Rtn> key.  If "mouse bars" are present on the
  4016.                right or bottom of the window, pressing the left button on
  4017.                the bars will move you to a different part of the data.
  4018.  
  4019.             2. Enter the data
  4020.  
  4021.                You can use the cursor keys to move around the class and
  4022.                screen.  Unentered scores are left blank.  You can enter the
  4023.                new scores in the appropriate places.  To keep the same
  4024.                score, type only a <Rtn> or use the cursor keys to move to
  4025.                the next cell.
  4026.  
  4027.                To enter a new number score, put in a new number between the
  4028.                minimum allowed points and the total allowed points of that
  4029.                task.  Other numbers are rejected.  The minimum allowed
  4030.                points are -1,000,000, while the maximum for any task is
  4031.  
  4032.                                          62
  4033.  
  4034.  
  4035.  
  4036.  
  4037.  
  4038.                                                          Entering Grades
  4039.                1,000,000.  You can use decimal points in number scores.  To
  4040.                enter a zero, you must type a "0".  Cells for tasks that are
  4041.                left blank revert to unentered scores.
  4042.  
  4043.                NOTE: Scores higher than the allowed points for the task
  4044.                  will not be accepted.  A noise will occur when you leave
  4045.                  the cell.  The noise can be altered in the "Z" section of
  4046.                  the Main Menu.
  4047.  
  4048.                If you are entering letter grades, only letters that are in
  4049.                the names of the grades are allowed (e.g., for grades from A
  4050.                to F, only the letters A, B, C, D, and F are allowed).
  4051.  
  4052.                Press <Esc> or <AltS> to stop entering scores.  With <Esc>,
  4053.                the data in the current cell is discarded and you can quit
  4054.                without saving any of the changes (except deleting students
  4055.                by the <AltD> key), while <AltS> automatically saves it to
  4056.                memory, but not to the disk.  You can also alter the student
  4057.                name, ID, and section numbers.  To delete a student, delete
  4058.                the name (e.g., with <F10>), or use <AltD>.
  4059.  
  4060.                If you are low on memory, you might not be able to enter
  4061.                data for all the students.  You can make the program use
  4062.                less memory by either:
  4063.  
  4064.                  (a) Pressing <AltC> to change what coloumns are listed.
  4065.                     Not listing ID, section number, student notes, or
  4066.                     listing fewer tasks will save memory.
  4067.                  (b) If there is more than one section of students in the
  4068.                     class, press <AltZ> to have the program list fewer
  4069.                     classes (e.g., list only section 2).
  4070.                  (c) Reduce the amount of memory the program uses for
  4071.                     overlays (see Chapter V, Section D).
  4072.  
  4073.             3. Hints
  4074.  
  4075.                (a) It is helpful to give the tasks unique names.  The names
  4076.                  can be up to 20 characters long.  You can enter scores
  4077.                  into any defined task whether or not the task name exists.
  4078.                  However, names will help you make sure you are entering
  4079.                  scores into the correct task.  When entering data for the
  4080.                  whole class, only the beginning of the task names is
  4081.                  listed.
  4082.                (b) VAR Grade can be used to add up points on any task.  To
  4083.                  use VAR Grade to add up scores for questions on a test,
  4084.                  for example, you can define Task 20 as question 1, Task 21
  4085.                  as question 2, etc, in the "T" option on the Main Menu.
  4086.                  Then, define Task 22 as the Sum of Tasks 20 and 21.
  4087.  
  4088.                                          63
  4089.  
  4090.  
  4091.  
  4092.  
  4093.  
  4094.  
  4095.                  Voila!  You can then use the program to add up the points
  4096.                  on questions 1 and 2 of the task.  You could then also use
  4097.                  VAR Grade to do statistics on each individual question.
  4098.                  If you have a large number of questions on the task, this
  4099.                  could get a little tedious, as you need to define each
  4100.                  question and enter the grades for each task.
  4101.  
  4102.           B. Entering Individual Student Data
  4103.  
  4104.             The "I" option of the Main Menu lets you enter task data for
  4105.             all tasks of individual students.  The program will list all
  4106.             the number, letter, and extra credit tasks for one student.
  4107.             Use the cursor keys to move around the screen.  You can alter
  4108.             any of the tasks, as well as the student names, IDs, or
  4109.             sections.  Unentered scores are left blank.  To delete a score,
  4110.             make the cell blank (e.g., with the <F10> key).  To keep the
  4111.             same score, type only a <Rtn> or use the cursor keys to move to
  4112.             the next cell.
  4113.  
  4114.             To enter a new score, put in a new number between the fewest
  4115.             allowed points and the total allowed points.  To enter scores
  4116.             less than zero, you need to change the fewest allowed points in
  4117.             the "G" option on the Main Menu.  The minimum allowed points
  4118.             are -1,000,000, while the maximum points are 1,000,000.  To
  4119.             enter a zero, you must type a "0".  Press <Esc> or <AltS> to
  4120.             stop entering scores.  With <Esc>, you can quit without saving
  4121.             the changes, while <AltS> automatically records the changes.
  4122.             You can also alter the student names, IDs, and section numbers.
  4123.             To delete a student, delete the name (e.g., with <F10>).  The
  4124.             top of the screen lists some special keys.  They are:
  4125.  
  4126.             Key     Movement
  4127.             <AltB>  Move to the first student in the class.
  4128.             <AltL>  Move to the last student in the class.
  4129.             <AltP>  Move to the previous student.
  4130.             <AltN>  Move to the next student.
  4131.             <AltI>  Insert a new student before the student where the
  4132.                     cursor is.  If the cursor is at the end of the line,
  4133.                     insert the new student after the current one.
  4134.             <AltD>  Delete the student where the cursor is.  This takes
  4135.                     immediate effect."
  4136.             <AltF>  Find a student.  You will pick from a list of all the
  4137.                     students in the class.
  4138.             <AltS>  Save the data to memory.  It is not saved to disk.  To
  4139.                     do that, use the "S" option on the Main Menu.
  4140.  
  4141.  
  4142.  
  4143.  
  4144.                                          64
  4145.  
  4146.  
  4147.  
  4148.  
  4149.  
  4150.                                                          Entering Grades
  4151.           C. Saving Entered Data to Disk
  4152.  
  4153.             It is strongly recommended that you save the data you have just
  4154.             entered as soon as possible after entering it.  Although the
  4155.             program won't let you exit without saving changes, in case of
  4156.             power failures or computer failure, you will have a copy on
  4157.             disk of your new data.  You save entered data in the "S" option
  4158.             on the Main Menu.  You will be asked for the filename to save
  4159.             the data to.  The current filename is listed on the line, and
  4160.             just pressing <Rtn> will do the trick.  If you want to change
  4161.             the name, change it, then press <Rtn>.  If you change the name,
  4162.             further updates will be made to the new name.
  4163.             WARNING: When you "save" data in the "D" or "I" options of the
  4164.                program, you are saving it to memory, not to a disk file.
  4165.             NOTE:  The file that contains your student data is normally
  4166.                made a "read-only" file.  This means that you cannot delete
  4167.                it with the DOS del or erase commands.  You can tell the
  4168.                program to write your files "read-only", as "hidden" (the
  4169.                DOS dir command will not even list the file), or "normal".
  4170.                Normal files can be deleted in DOS.  The program also makes
  4171.                backup files "normal", hence they can easily be deleted.
  4172.                Details on how to change the way the program saves the data
  4173.                are in Chapter V, Starting the Program.
  4174.  
  4175.             It is also recommended that you keep two copies of your class
  4176.             data on disk.  To encourage this practice, the "F" (file)
  4177.             option on the Main Menu has a backup ("W") option to write the
  4178.             class to another directory or disk.  The program will suggest
  4179.             writing the file to either drive A or B, so that the data will
  4180.             be on floppy disks.  If you are using drive A for your class,
  4181.             the program will suggest drive B, otherwise it will suggest
  4182.             writing to drive A.  You may pick any other drive or directory.
  4183.  
  4184.             Some users use VAR Grade on two different computers.  If one of
  4185.             these has limited memory (less than 300K), versions 4 and above
  4186.             of the program will not be able to fit into memory.  You can
  4187.             save your data in a format that earlier versions of the program
  4188.             will understand.  To do so, when on the Main Menu, press <Alt2>
  4189.             (simultaneously press the "Alt" and "2" keys) to write the data
  4190.             in a way that is understandable to version 2, or <Alt3> to
  4191.             write version 3 files, or <Alt4> for version 4.
  4192.             WARNING: Some of the information in your class may be lost.
  4193.                Specifically, any task types that do not exist in the
  4194.                previous versions will be converted to ones that are
  4195.                understandable to that version (hence may not be what you
  4196.                want).  If you do use this option, use only features in this
  4197.                version that exist in the previous version.
  4198.  
  4199.  
  4200.                                          65
  4201.  
  4202.  
  4203.  
  4204.  
  4205.  
  4206.  
  4207.  
  4208.  
  4209.                                    IX. ATTENDANCE
  4210.  
  4211.  
  4212.  
  4213.                Attendance dates can be defined and attendance entered for
  4214.           up to 240 different days.  The attendance is entered by a whole
  4215.           class, or by individual students in a manner analogous to those
  4216.           for entering data for tasks.  Attendance is found in the "A"
  4217.           option of the Main Menu.
  4218.  
  4219.           A. Defining Attendance Days
  4220.  
  4221.             You define attendance days in the "D" option of the Attendance
  4222.             Menu.  There are two methods by which to define a new
  4223.             attendance day.  First, to choose the next undefined day, press
  4224.             <F1>.   Second, you can type in any number (from 1 to 240) as
  4225.             the day you want to define.
  4226.  
  4227.             In either case, you need to give the day a name or date.  In
  4228.             fact, it is required that you enter a name or date before the
  4229.             attendance is defined.  To make it easy to enter dates, the
  4230.             function keys <F3> through <F8> can be used to automatically
  4231.             enter the dates.  The keys are defined as the following:
  4232.  
  4233.             Key       Meaning
  4234.             <F3>      The date two days ago.
  4235.             <F4>      The date yesterday.
  4236.             <F5>      The date today.
  4237.             <F6>      The date tomorrow.
  4238.             <F7>      The date in two days.
  4239.             <F8>      The date any number of days from todays date, up to
  4240.                       365 days away.  Enter the days.
  4241.                       Example:  To enter the date one week earlier, enter a
  4242.                       -7.
  4243.  
  4244.             The dates that are entered are in whatever format you have
  4245.             chosen.  These can be changed in the "Z" option on the Main
  4246.             Menu.  With this option you can change how dates will be
  4247.             printed on documents as well as how they are entered in
  4248.             attendance.
  4249.  
  4250.           B. Changing Defaults
  4251.  
  4252.             By default, when attendance days are added, the student
  4253.             attendance is made "Present".  There are six categories of
  4254.             attendance: Present, Excused, Unexcused, Late, Not Entered, and
  4255.  
  4256.                                          66
  4257.  
  4258.  
  4259.  
  4260.  
  4261.  
  4262.                                                               Attendance
  4263.             Other.  These have the characters " ", "E", "U", "L", "_", and
  4264.             "O", respectively.  The default student attendance and the
  4265.             characters associated with them can be altered on the "A"
  4266.             (Attendance) option of the Main Menu, then "Z".
  4267.  
  4268.             The screen will list the current values.  The default new
  4269.             student attendance will be highlighted or, if you have a
  4270.             monochrome monitor, underlined (unless you've changed the
  4271.             default colors).  Use the cursor keys (or <Ctrl>-cursor keys)
  4272.             to move around the menu.  To select a new default student
  4273.             attendance, press <Rtn>.  The new value will now be
  4274.             highlighted.  To change the letters for the different types of
  4275.             attendance, pick the new key.  To simplify matters, any
  4276.             lowercase letters will be converted to uppercase letters.  The
  4277.             allowed keys are the uppercase letters and the characters ".",
  4278.             "_", "-", and " ".
  4279.  
  4280.           C. Entering Class Attendance
  4281.  
  4282.             To enter attendance for all students in your class, use the "C"
  4283.             option of the Attendance Menu.  This option works like the "D"
  4284.             option of the Main Menu for entering task data.
  4285.  
  4286.             1. Choose the dates
  4287.  
  4288.                Students and days will be listed on the screen.  Just as in
  4289.                entering task scores, to change the columns, use the key
  4290.                <AltC>.  You can then pick which days to list on the screen,
  4291.                as well as whether to list the names, IDs, and sections.
  4292.                See Chapter VIII, Section A1 for more details.  The most
  4293.                recently defined list of names and days are saved by the
  4294.                program.  If you define new attendance days, they will
  4295.                automatically be added to the end of the list of days to
  4296.                display.  The top of the screen lists valid keys and key
  4297.                codes for the attendance.  Next the days are listed by name
  4298.                and number.  The names are listed by the first several
  4299.                letters of the date.  Student names and/or IDs are on the
  4300.                left of each row.  If you have numerous days you want
  4301.                displayed, not all of them may fit on the screen at once.
  4302.                If you move to the right, more may be displayed.  The names
  4303.                or IDs in the leftmost column are always displayed.
  4304.  
  4305.             2. Enter the data
  4306.  
  4307.                You can use the cursor or <Ctrl>-cursor keys to move around
  4308.                the class and screen.  The valid keys are listed at the top
  4309.                of the screen.  Only those keys will be accepted.  To delete
  4310.                a student, delete the name (e.g., with <F10>), or use
  4311.  
  4312.                                          67
  4313.  
  4314.  
  4315.  
  4316.  
  4317.  
  4318.  
  4319.                <AltD>.  To add a new student, type <AltI>.  When quitting
  4320.                this section, any changes made to the screen are recorded by
  4321.                the program by <AltS>, or possibly by exiting with <Esc>.
  4322.  
  4323.           D. Entering Individual Student Attendance
  4324.  
  4325.                To change attendance for just one student, use the "I"
  4326.                option of the Attendance Menu.  The program will list all of
  4327.                the currently defined attendance days for a student.  You
  4328.                can alter the attendance for any day, as well as the student
  4329.                name, ID, or section.   To keep the same attendance, type a
  4330.                <Rtn> or use the cursor keys to move to another day.  To
  4331.                enter a new attendance value, put in a new letter (from the
  4332.                list near the top of the screen).  Press <Esc> to erase the
  4333.                data or <AltS> to save it when finished.  To delete a
  4334.                student, delete the name (e.g., with <F10>), or use <AltD>.
  4335.                To add a new student, type <AltI>.  For more details, see
  4336.                Chapter VIII, Section B.
  4337.  
  4338.  
  4339.           E. Default Attendance Task values
  4340.  
  4341.                When you define an attendance task, the program will suggest
  4342.                value for the number of days to discard and the weights for
  4343.                the various types of attendance.  You can change these
  4344.                values on the Attendance Menu (the "V" option).  The number
  4345.                of days you can discard is one less than the number of
  4346.                attendance days.  The weights can be any number greater than
  4347.                or equal to zero.
  4348.  
  4349.  
  4350.  
  4351.  
  4352.  
  4353.  
  4354.  
  4355.  
  4356.  
  4357.  
  4358.  
  4359.  
  4360.  
  4361.  
  4362.  
  4363.  
  4364.  
  4365.  
  4366.  
  4367.  
  4368.                                          68
  4369.  
  4370.  
  4371.  
  4372.  
  4373.  
  4374.                                                     Analyzing the Grades
  4375.  
  4376.  
  4377.                                X. ANALYZING THE GRADES
  4378.  
  4379.  
  4380.  
  4381.                Grades can be analyzed a variety of ways.  These are listed
  4382.           in the sections below.  Furthermore, all the statistics and plots
  4383.           listed below can be printed on a printer or sent to a disk file.
  4384.           Chapter XI, Printing the Grades, explains the printing.  The
  4385.           analyses in this chapter are generally from the "G" and "P"
  4386.           options of the Main Menu.
  4387.  
  4388.  
  4389.           A. Default Values for Analysis
  4390.  
  4391.             After you pick several of the options listed below, a screen
  4392.             will appear that asks how you want to proceed.  Several options
  4393.             will be listed, including: (a) which printer to use; (b) what
  4394.             sections to use; (c) whether to print to the screen or to a
  4395.             printer or disk file; (d) whether to temporarily drop students
  4396.             from the statistical analysis.   Picking a printer and deciding
  4397.             where the data should be displayed are discussed in Chapter XI,
  4398.             Assigning and Printing the Grades.  The others are discussed
  4399.             here.
  4400.  
  4401.             1. Sections
  4402.  
  4403.                If you have only one section of students in the class, this
  4404.                option is not displayed.  Otherwise, the most recently
  4405.                selected sections will be listed.  Each time you enter the
  4406.                program, the program will default to using all of the
  4407.                current sections of the class.  If you change the list of
  4408.                sections to use, this new list will become the default
  4409.                sections for all parts of the program during the current
  4410.                session with the program.  If you choose to use no sections,
  4411.                an error message will result and you will exit back to the
  4412.                Main Menu as there are no usable data.
  4413.  
  4414.             2. Temporarily dropping students
  4415.  
  4416.                You can tell the program to temporarily drop students from
  4417.                the calculations for statistics and/or plots.  This option
  4418.                can be used for students that have incomplete data.  The
  4419.                number of students currently ignored are shown on the Print
  4420.                Menu screen.  These students are ignored only for
  4421.                statistical purposes.  You can still enter data, write
  4422.  
  4423.  
  4424.                                          69
  4425.  
  4426.  
  4427.  
  4428.  
  4429.  
  4430.  
  4431.                scores to printers, etc., unless statistical measures are
  4432.                needed (e.g., all plots).
  4433.  
  4434.                When you need to increase or decrease the numbers of
  4435.                students to ignore, two lists of students will be shown: (1)
  4436.                all the students in the class, and, (2) those students who
  4437.                are temporarily dropped from the statistics calculations.
  4438.                You drop students by using either the cursor keys or by
  4439.                typing in the student names.  The <F3> key can be used to
  4440.                switch between adding and decreasing the number of students
  4441.                to be ignored.  These students will be ignored for any
  4442.                further statistics during the current session with the
  4443.                program or until they are no longer ignored in this part of
  4444.                the program.
  4445.  
  4446.             3. Font selection
  4447.  
  4448.                You can change fonts from the Plot Menu.  Font files must
  4449.                end in "CHR".  You will be asked for the directory for the
  4450.                font files.  The program will suggest "*.CHR".  This will
  4451.                list all the font files in the DOS PATH.  You can, however,
  4452.                change which drive to search by replacing *.CHR with, for
  4453.                example: "A:*.CHR".  This will cause the program to search
  4454.                drive A for the font files.
  4455.  
  4456.                WARNING: Some fonts will not look good on some video
  4457.                monitors.
  4458.  
  4459.             4. 2D versus 3D plots
  4460.  
  4461.                Most plots can be done either with bars that look two
  4462.                dimensional (2D), or with bars that look three dimensional
  4463.                (3D).  The plots are otherwise the same.
  4464.  
  4465.           B. Plotting the Scores of a Class
  4466.  
  4467.             By selecting the "P" (plot) option on the Main Menu, the scores
  4468.             for any of the tasks can be plotted.  The program lists the
  4469.             tasks and asks for a task to be plotted.  On the Plot Menu, "P"
  4470.             will plot the scores, and "T" will give the same plot with 3-D
  4471.             bars.  Plotting the scores follows the sequence below.
  4472.  
  4473.             1. Choose a task
  4474.  
  4475.                You will see a list of all the tasks.  To see any that are
  4476.                not listed on the screen, use the cursor or <Ctrl>-cursor
  4477.                keys.  If you pick task zero or <Esc>, the program will exit
  4478.  
  4479.  
  4480.                                          70
  4481.  
  4482.  
  4483.  
  4484.  
  4485.  
  4486.                                                     Analyzing the Grades
  4487.                this section without plotting an task.  Otherwise, the task
  4488.                will be plotted.
  4489.  
  4490.             2. Score ranges
  4491.  
  4492.                If you grade with numbers, you must specify the range of
  4493.                scores to plot (the high and low scores).  The program will
  4494.                ask for these numbers.  If you just type <Rtn> when asked
  4495.                for the high and/or low scores, the program will choose the
  4496.                highest or lowest score in the class.  If there are no
  4497.                students in the range of scores you have chosen, an error
  4498.                message will result and no scores will be plotted.
  4499.  
  4500.                By picking different ranges of scores, you can zoom in on
  4501.                various groups of students to see how they have done, rather
  4502.                than seeing scores only for the entire class.  One of the
  4503.                most useful features of picking the low range is to prevent
  4504.                a very low score from skewing the plot.
  4505.  
  4506.                Student scores not yet entered or lower than the fewest
  4507.                allowed points are not used for the plots.
  4508.  
  4509.             3. Defaults
  4510.  
  4511.                As discussed above, after picking the task and a range of
  4512.                scores, you can pick which sections of students to use and
  4513.                where to print the scores.  See Part A of this chapter for
  4514.                more details.
  4515.  
  4516.             4. Plotting the scores
  4517.  
  4518.                The plot separates the scores into up to 25 categories of
  4519.                scores.  It also shows the mean, median, and standard
  4520.                deviation of the scores for the task (see the section on
  4521.                "Calculating Statistics" below for a more complete
  4522.                explanation of what these statistics mean).  It plots the
  4523.                numbers of students with the various scores.  The statistics
  4524.                calculated are only for those scores in the range of scores
  4525.                you choose.  If you vary the high or low range of the scores
  4526.                used, these statistical measures will change.  On the plot,
  4527.                the mean and median are shown with arrows.  At one standard
  4528.                deviation above and below the mean are additional arrows
  4529.                (listed as "+1", "-1").  If the standard deviations fall
  4530.                outside the range of scores plotted, they may not be
  4531.                displayed.
  4532.  
  4533.  
  4534.  
  4535.  
  4536.                                          71
  4537.  
  4538.  
  4539.  
  4540.  
  4541.  
  4542.  
  4543.             5. Listing the scores
  4544.  
  4545.                After the plot is shown, you will be asked if you want to
  4546.                see the list of students' scores.  If you decide to see
  4547.                them, the program will list the students scores in two
  4548.                columns: (a) class order (dependent upon your method of
  4549.                sorting students) and (b) by scores on that task, from high
  4550.                to low.  The rank order of the students is also printed, if
  4551.                you choose that option on the Print Menu (the program
  4552.                defaults to printing the ranks).  If you just want to list
  4553.                the scores, but not plot the scores, pick "L" on the Plot
  4554.                Menu.
  4555.  
  4556.           C. Plotting the Scores of an Individual
  4557.  
  4558.             You can follow how a student is doing in your class by plotting
  4559.             the scores for that student on a set of tasks.  By selecting on
  4560.             the Plot Menu the "I" for 2D bars, or "B" for 3D bars, you can
  4561.             plot trends for scores of any of the class tasks for an
  4562.             individual student.
  4563.  
  4564.             1. Picking the tasks
  4565.  
  4566.                The program will list the tasks and asks you to pick which
  4567.                ones to plot.  You have the option of plotting (a) the
  4568.                percentages of each task, (b) the sums (totals) of each
  4569.                task, (c) the T-scores, or (d) the standard deviations from
  4570.                the mean for each task.
  4571.  
  4572.             2. Listing the scores
  4573.  
  4574.                The program will then plot the task scores and calculate the
  4575.                statistics.  The program assumes that the student trend is a
  4576.                straight line: either the scores increase or decrease.  Note
  4577.                that this is frequently not the case, hence, these results
  4578.                should be interpreted with caution.  The program then
  4579.                calculates the best-fitting line for that trend, and plots
  4580.                it on the graph.  The correlation coefficient for the tasks,
  4581.                and the mean, median and standard deviations are also
  4582.                calculated.  These all may or may not be useful for
  4583.                understanding how a student is doing in the class.  The
  4584.                statistics are listed on the screen after the graph is
  4585.                plotted.  If you choose more tasks than fits on one screen,
  4586.                you will need to press a key to proceed through all the
  4587.                tasks.
  4588.  
  4589.  
  4590.  
  4591.  
  4592.                                          72
  4593.  
  4594.  
  4595.  
  4596.  
  4597.  
  4598.                                                     Analyzing the Grades
  4599.           D. Calculating Statistics
  4600.  
  4601.             You can calculate statistics without having to plot the scores.
  4602.             Rather than plotting each task to calculate the mean, median,
  4603.             and standard deviation, you can pick the "G" (grade) option on
  4604.             the Main Menu, then pick the "M" option on the Grading Menu.
  4605.             You can then see these statistics for any combination of tasks.
  4606.             To calculate statistics, you need to choose which tasks to
  4607.             calculate statistics, and pick which sections to use.  The data
  4608.             will be calculated only for those sections you have told the
  4609.             program to use.  This allows comparisons between different
  4610.             sections or combinations of sections.  Statistics will not be
  4611.             calculated if a task has not been defined or if the task has
  4612.             less than the fewest allowed points.
  4613.  
  4614.             The median is the score for the person exactly in the middle of
  4615.             the class, i.e., exactly half the scores are above that number
  4616.             and half are below that number.  The mean is the number
  4617.             calculated by adding up all the student scores and dividing by
  4618.             the number of students in the class.  If you have a "normal" or
  4619.             "bell-shaped" distribution of scores, the mean and median
  4620.             should be the same number.  In practice they are usually
  4621.             different.  The standard deviation is a measure of how the
  4622.             scores are dispersed.  The larger the standard deviation, the
  4623.             greater the range in the scores.  A score that is equal to the
  4624.             mean plus the standard deviation (called "one standard
  4625.             deviation above the mean") is approximately in the top 16% of
  4626.             the scores.  For a normal distribution, two thirds of the
  4627.             scores should be within one standard deviation of the mean.
  4628.             How many standard deviations away from the mean a student has
  4629.             scored, therefore, is a measure of how the student did on the
  4630.             task in relation to everybody else.  You can then compare
  4631.             scores between tests by comparing the deviations from the means
  4632.             for each student.
  4633.  
  4634.           E. Correlating Different Tasks
  4635.  
  4636.             By selecting the "C" or "3" options on the Plot Menu, you can
  4637.             plot the scores for any of the tasks against the scores for any
  4638.             of the other tasks.  This helps you to see if there were any
  4639.             problems on one or both of those tasks.  If the tasks are
  4640.             measuring different things, the scores will be widely
  4641.             scattered.  This may be an indication that one or both of the
  4642.             tasks did not measure what you hoped it would.  If the tasks
  4643.             are measuring similar abilities, the scores will tend to
  4644.             cluster near the diagonal.
  4645.  
  4646.  
  4647.  
  4648.                                          73
  4649.  
  4650.  
  4651.  
  4652.  
  4653.  
  4654.  
  4655.             1. 2D or 3D plots
  4656.  
  4657.                In contrast to the other plots, the two different plots for
  4658.                correlations look quite different.  In the 2D plot, the
  4659.                scores are shown as x's.  If two or more x's are on the same
  4660.                place, the x becomes thicker.  For the 3D plot, 3D bars are
  4661.                plotted.  The more students on a point, the higher the bars.
  4662.                To make the plot easier to interpret, it is slightly skewed.
  4663.                This makes it easier to tell the difference between tall
  4664.                bars and bars at different points on the graph.
  4665.  
  4666.             2. Choose the tasks
  4667.  
  4668.                You must choose the tasks to plot on each of the axes.  Any
  4669.                task can be plotted against any other task.  To help in your
  4670.                selection, the program lists the tasks.  If you pick task
  4671.                zero for either axis, the program will give an error message
  4672.                and ask again.  To exit this section without plotting, type
  4673.                an <Esc>.
  4674.  
  4675.             3. Pick a range of scores for each task
  4676.  
  4677.                If you grade with number grades, for each task that you have
  4678.                picked, you must pick the high and low scores to plot.  If
  4679.                you just type <Rtn>, the program will pick the highest or
  4680.                lowest score in the class (whichever is appropriate).  If no
  4681.                students are in the ranges of scores that you pick, no
  4682.                scores will be plotted and an error message will result.
  4683.  
  4684.             4. Defaults
  4685.  
  4686.                As discussed above, after picking the task and range of
  4687.                scores, you can pick the sections, decide whether to ignore
  4688.                students, and change how to print the scores.  See Part A of
  4689.                this chapter (above).
  4690.  
  4691.  
  4692.             5. Correlation plot
  4693.  
  4694.                The plot shows a 20 X 20 matrix of the distribution of the
  4695.                scores.  The correlation coefficient is calculated and
  4696.                shown.  The coefficient ranges from 1.0 (the scores on the
  4697.                X-axis predict exactly the scores on the Y-axis) to 0.0 (the
  4698.                scores on the two axes are completely random with respect to
  4699.                each other) to -1.0 (the low scores on the X-axis predict
  4700.                high scores on the Y-axis, and vice versa).  The closer the
  4701.                coefficient is to 1.0, the more closely the two tasks
  4702.                measured the same parameters or abilities (and hence the
  4703.  
  4704.                                          74
  4705.  
  4706.  
  4707.  
  4708.  
  4709.  
  4710.                                                     Analyzing the Grades
  4711.                students scored more nearly the same on both the tasks).  If
  4712.                the correlation coefficient is close to 0 or below it, then
  4713.                students who did well on one task did poorly on the other.
  4714.                If you decide that this result indicates a flaw in one or
  4715.                both of the test, the program will allow you to delete one
  4716.                or both tasks.  For the 2D plot, two or more scores on the
  4717.                same point will show up as a thicker "x", while on the 3D
  4718.                plot, the bars will get higher and higher with each score.
  4719.  
  4720.           F. Statistical Plots of the Classes
  4721.  
  4722.             The last type of plot, the "S" option on the Plot Menu, shows
  4723.             plots of the mean, median, and standard deviations for one or
  4724.             more tasks.  Furthermore, the "1" option on the Plot Menu will
  4725.             show how an individual student scored on those tasks compared
  4726.             with the entire class.
  4727.  
  4728.             1. Pick the tasks
  4729.  
  4730.                The program lists the tasks and asks for which ones you wish
  4731.                to plot.  You can choose to plot from one to forty tasks.
  4732.                If you want to plot an individual student against the
  4733.                scores, you will also be asked for a student record to plot.
  4734.  
  4735.             2. Plotting the statistics
  4736.  
  4737.                The program will show the range of scores as bars. The mean
  4738.                is a wide line all the way horizontally across the bar.  The
  4739.                median is a horizontal bar halfway across the bar, with some
  4740.                vertical lines in it.  The standard deviation is shown as
  4741.                the vertical line, extending one standard deviation above
  4742.                and below the mean.  At one standard deviation above and
  4743.                below the mean are horizontal lines extending halfway across
  4744.                the bar.  If you are plotting the scores of a student as
  4745.                well, that student's scores are shown as arrows.  The tip of
  4746.                the arrow is the position of the student's score.  If you
  4747.                plot tasks that have a wide range of scores, some or all of
  4748.                these measures may end up compressed.  The range of scores
  4749.                that are plotted are from the lowest to the highest obtained
  4750.                scores.  The Y axis may extend down to 0 points, however,
  4751.                even if no scores are that low.  The widths of the bars
  4752.                changes depending upon how many tasks are plotted; the more
  4753.                tasks, the narrower the bars.  The X-axis shows the numbers
  4754.                of the tasks that were plotted.
  4755.  
  4756.  
  4757.  
  4758.  
  4759.  
  4760.                                          75
  4761.  
  4762.  
  4763.  
  4764.  
  4765.  
  4766.  
  4767.           G. Scaling the Tasks
  4768.  
  4769.             If you grade using number grades, you can scale the regular
  4770.             tasks differently. Pick the "G" (grade) option of the Main
  4771.             Menu, then the "S" (scale) option in the Grading Menu.  You may
  4772.             add any number of points to an task, or multiply the task by
  4773.             any positive number. The total points for the task, after the
  4774.             scaling, must be less than or equal to one million and greater
  4775.             than or equal to the lowest allowed score.  Point totals less
  4776.             than the allowed scores are summed as the lowest allowed score,
  4777.             while scores greater than the total task points are set at the
  4778.             total points.  Students with scores that have not been entered
  4779.             are not changed (the score is still undefined).  This part of
  4780.             the program allows you to conveniently change point totals for
  4781.             any task.  It also allows you to add points to one section and
  4782.             not to others, as the scaling occurs only for those sections
  4783.             you choose.  You cannot scale special tasks.  The total points
  4784.             for the task, after scaling, will not change.  If desired, you
  4785.             can readjust the total points manually in the "T" section of
  4786.             the Main Menu either before or after scaling the task.
  4787.  
  4788.           H. Setting the Fewest Allowed Points
  4789.  
  4790.             When the program starts, the fewest points that a student can
  4791.             have on a task is 0 points.  If you want to enter scores less
  4792.             than 0, you can set the fewest allowed points to be less than
  4793.             zero.  On the "G" option of the Main Menu, the "F" option
  4794.             allows this.  You can reset the number to as few as -1,000,000
  4795.             points.  Even though the fewest allowed points may be 0 (or any
  4796.             other number), you can still put in scores less than the fewest
  4797.             allowed points.  Students with scores less than the fewest
  4798.             allowed points will always be ignored for statistical tests,
  4799.             and are considered to be equivalent to unentered scores.  The
  4800.             difference from unentered scores is that unentered scores can
  4801.             either be ignored or set to 0 for special tasks, while numbers
  4802.             below the fewest allowed points will always be ignored.  When
  4803.             you print the numbers, both types of scores will be blank or
  4804.             print as "Not submitted".  If you set unentered scores to zero,
  4805.             numbers below the fewest allowed points will print as "*Not
  4806.             submitted".  This will let you distinguish between the two
  4807.             types of scores.
  4808.  
  4809.           I. Assigning Standard Deviations and T-Scores
  4810.  
  4811.             Standard deviations and T-scores tell you how a student did in
  4812.             relation to the other students in the class.  You can calculate
  4813.             the standard deviations and/or T-scores of a task for the
  4814.             class, and assign these numbers to a number task.  Go to the
  4815.  
  4816.                                          76
  4817.  
  4818.  
  4819.  
  4820.  
  4821.  
  4822.                                                     Analyzing the Grades
  4823.             "G" option on the Main Menu.  On the Grading Menu, press "V"
  4824.             for standard deviations, or "T" for T-scores.
  4825.  
  4826.             You will be asked which task to use for the calculations, and
  4827.             to which task to assign the new scores.  WARNING: The new task
  4828.             will be redefined as a number task.  If you assign standard
  4829.             deviations and T-scores, approximately half of the scores will
  4830.             be below zero.  Make sure that you change the fewest allowed
  4831.             points to a number below the lowest standard deviation or T-
  4832.             score (see Section H, above).
  4833.  
  4834.           J. Adjusting the Statistics of a Task
  4835.  
  4836.             In unusual circumstances, you may want to manually adjust the
  4837.             mean, median, and standard deviation of a task.  The "A" option
  4838.             on the Grading Menu lets you do this.  The "D" option lets you
  4839.             remove those adjustments.
  4840.  
  4841.             To adjust the statistics, you need to pick the task to use.
  4842.             Student scores are adjusted by changing the standard deviation
  4843.             and the mean.  The current values are then displayed.  You can
  4844.             change one or more of these values to any numbers you want.
  4845.             The student scores are now also adjusted to reflect the new
  4846.             mean and standard deviation.  These numbers are then used by
  4847.             all the other parts of the program that calculate these values.
  4848.             To return to the true values, use the "D" option on the Grading
  4849.             Menu.  Note that, if you revert to the original scores, they
  4850.             may be slightly different than the true original value due to
  4851.             rounding off errors.
  4852.  
  4853.           K. Changing the Grading Names
  4854.  
  4855.             VAR Grade can use just about any grading system you want.  The
  4856.             program defaults to the grading system commonly used in the
  4857.             United States:  A through F, with + and - scores.  However, you
  4858.             can define any grading system that has up to 50 grades (plus a
  4859.             "unentered" or "incomplete" grade).  Each grade can have a name
  4860.             of up to two characters long.  The grading system can have the
  4861.             highest grade as the highest score, or the highest grade as
  4862.             having the lowest score.  Furthermore, you can assign point
  4863.             totals to the grades.
  4864.  
  4865.             To change the grading system, go to the "G" option on the Main
  4866.             Menu.  Choose the "N" option on the Grading Menu.  Next, you
  4867.             will be asked whether to use one of a few pre-defined grading
  4868.             systems, or to define your own system.  If you define your own
  4869.             grading system, you will be asked to enter the grade names,
  4870.             then the point totals for the grades.  These point totals are
  4871.  
  4872.                                          77
  4873.  
  4874.  
  4875.  
  4876.  
  4877.  
  4878.  
  4879.             the values for the grades, not the scores that are needed to
  4880.             obtain the grade (see Section L to do this).  Grade names and
  4881.             point totals can be changed at any time.  The program converts
  4882.             all letter grades to numbers and stores the numbers.
  4883.  
  4884.             WARNING: If you change the grading system after assigning
  4885.             letter grades, the new numbers may translate into a different
  4886.             grade than you want.
  4887.  
  4888.           L. Picking Automatic Grade Cutoffs
  4889.  
  4890.             If you always use the same grading system, you may want to set
  4891.             the grading system in the "C" option of the Grading Menu.  For
  4892.             instance, you can tell the program that 90% is an A, 80% is a
  4893.             B, etc.  Alternatively, you can tell the program that 90 points
  4894.             is an A, 80 points a B, etc.  When you assign grades, VAR Grade
  4895.             will use these values, either as percentages or points, as the
  4896.             point system to use when assigning grades.  You can change the
  4897.             grading system at any time.  To remove the cutoff points needed
  4898.             for various grades assigned in the "C" option, use the "R"
  4899.             (remove) option of the Grading Menu.  The program will again
  4900.             ask you for the lowest scores for each grade every time you
  4901.             assign grades in the "G" option of the Main Menu.  If you
  4902.             define a Final grade task, it will use, by default, the values
  4903.             of the cutoofs in effect when the task is defined to compute
  4904.             grades.  If you change or remove the cutoffs, this will not
  4905.             change the grades in any Final grade tasks that have already
  4906.             been defined.  Any new Final grade tasks will use the latest
  4907.             cutoffs.  To change the cutoffs of Final grade tasks that have
  4908.             already been defined, use the "G" option of the Main Menu to
  4909.             assign new grades.
  4910.  
  4911.  
  4912.  
  4913.  
  4914.  
  4915.  
  4916.  
  4917.  
  4918.  
  4919.  
  4920.  
  4921.  
  4922.  
  4923.  
  4924.  
  4925.  
  4926.  
  4927.  
  4928.                                          78
  4929.  
  4930.  
  4931.  
  4932.  
  4933.  
  4934.                                                      Printing the Grades
  4935.  
  4936.  
  4937.                 XI. ASSIGNING AND PRINTING THE GRADES AND ATTENDANCE
  4938.  
  4939.  
  4940.  
  4941.             You can print out the grades and attendance of a class by four
  4942.             methods:
  4943.  
  4944.             1. Plot the scores of a task.  The program will list the
  4945.                student scores for that task in numerical order and in
  4946.                sorted order (see Chapter X, Analyzing the Grades).
  4947.             2. Print grades or attendance for any combination of tasks and
  4948.                sections or names with the "W" (write) option on the Main
  4949.                Menu--discussed below.
  4950.             3. Assign and print the grades with the "G" (grade) option on
  4951.                the Main Menu. This method is also discussed below.
  4952.             4. Write a report form, then use the "W" option on the Main
  4953.                Menu to select the form to write the data.
  4954.  
  4955.           A. Default Values for Analysis
  4956.  
  4957.             After picking several of the options listed below, a menu will
  4958.             appear that asks how you want to proceed.  Listed on the menu
  4959.             will be several options, including: (a) which printer to use;
  4960.             (b) what sections to use; (c) whether to print to the screen or
  4961.             to a printer or disk file.  The options listed will vary in
  4962.             different parts of the program.  Some of the options are listed
  4963.             above, in Chapter X, Analyzing the Grades.
  4964.  
  4965.             1. Choosing a printer
  4966.  
  4967.                When you install the program, you are asked which printer
  4968.                you will be using.  If you want to change which printer will
  4969.                be used or how to print (single or double spacing; pica or
  4970.                elite; etc.), press "Q" on the Print Menu to get to the
  4971.                Printer Menu.  The Printer Menu can also be reached in the
  4972.                "Z" option of the Main Menu.
  4973.  
  4974.                NOTE: Any time you are printing to a disk file or a printer,
  4975.                you can stop the printing by pressing <CtrlS>.  You will be
  4976.                asked whether to stop printing.  If you answer yes, no more
  4977.                printing will be done.
  4978.  
  4979.                (a) Installation of a printer
  4980.  
  4981.                  To install a new printer, press "P" on the Printer Menu.
  4982.                  The program INSTALLP must be on a disk or directory that
  4983.  
  4984.                                          79
  4985.  
  4986.  
  4987.  
  4988.  
  4989.  
  4990.  
  4991.                  the program can find, and there must be enough memory to
  4992.                  run the program INSTALLP.  It will list all the currently
  4993.                  supported printers.  Use the cursor keys to locate the
  4994.                  printer(s) that you wish to install.  When you find each
  4995.                  one, press the space bar.  After you have picked up to 5
  4996.                  different printers, press the <F10> key to install the
  4997.                  printers.  To quit before installing the printers, press
  4998.                  <F3>.  This will install the Graphics printer codes.  If
  4999.                  yours is not listed, your printer manual should list the
  5000.                  printer(s) that it emulates.
  5001.  
  5002.                  NOTE: The list of supported printers will be continually
  5003.                  updated.  If yours is not supported with the version that
  5004.                  you have, an update may be available that will explicitly
  5005.                  support your printer.
  5006.  
  5007.                  When you install the printers, the program will change the
  5008.                  file GRADE.PDT.  For many of the printers, the Line
  5009.                  printer codes will also be installed.  For others,
  5010.                  however, you also need to tell the program which printer
  5011.                  codes to use.  Pick the "L" option on the Printer Menu.
  5012.                  Listed will be several different printers that are
  5013.                  frequently emulated.  Most printers emulate the Epson FX-
  5014.                  80 printer.  If yours does, pick that.  If not, it may
  5015.                  emulate one of the other printers listed below.  Some
  5016.                  printer manufacturers and the printers they usually
  5017.                  emulate is listed below.  If your printer is not listed,
  5018.                  or if you want to change the printer codes for your
  5019.                  printer, use the "U" option on the Printer Menu to put in
  5020.                  the printer codes.  The program will keep track of the
  5021.                  line printer codes for each of the five printers that can
  5022.                  be installed.
  5023.  
  5024.                  Line Printer Definition     Printers Supported
  5025.  
  5026.                  Epson FX-80            Most Epson printers, including the
  5027.                                         EX, FX, MX, and RX series.  Also,
  5028.                                         many printers from Brother,
  5029.                                         Citizen, Panasonic, and others.
  5030.                  IBM Graphics Printer   IBM dot matrix, Okidata with IBM
  5031.                                         emulation, Star Micronics, and
  5032.                                         others.
  5033.                  HP Laser Jet           HP LaserJet, Plus, Series II,
  5034.                                         DeskJet, PaintJet, and most laser
  5035.                                         printers.
  5036.                  NEC P-2200             Most NEC printers.
  5037.                  Okidata 92             Okidata 84, 92, 93, 192, 193, 292,
  5038.                                         and others.
  5039.  
  5040.                                          80
  5041.  
  5042.  
  5043.  
  5044.  
  5045.  
  5046.                                                      Printing the Grades
  5047.                (b) Changing the line printer codes
  5048.  
  5049.                  To change the printer codes, press "U" on the Printer
  5050.                  Menu.  Listed will be the current printer codes.  To
  5051.                  change them, use the cursor keys to move to the code that
  5052.                  you want, then press the correct codes.  Your printer
  5053.                  manual will list the codes needed to use pica, elite, etc.
  5054.                  printing.  NOTE: Some of the keys work differently in this
  5055.                  part of the program, as you need to be able to enter any
  5056.                  possible printer code.  To enter escape (#27), press the
  5057.                  <Esc> key.  The backspace key will enter <CtrlH> (#8).
  5058.                  The enter or <Rtn> key will enter <CtrlM> (#13).  To enter
  5059.                  codes below 32 or above 127, hold down the <Alt> key, then
  5060.                  use the keys on the numeric keypad to enter the number.
  5061.                  You can enter up to 10 characters for each of the codes.
  5062.                  To backspace (remove the previous character), use the <F2>
  5063.                  key.  After you exit with <AltS>, the new codes will be in
  5064.                  effect.  Pressing <AltE> will switch between listing the
  5065.                  codes as hex numbers or as text.
  5066.  
  5067.                (c) Changing the graphic printer codes
  5068.  
  5069.                  If your printer is not supported, or if the printer codes
  5070.                  that are used by the program are not producing the results
  5071.                  that you want, the program BDE (Baby Driver Editor) can be
  5072.                  used to change the codes.  To change the codes, exit VAR
  5073.                  Grade.  Put the Utility disk into a drive, and type "BDE
  5074.                  \path1\GRADE.PDT".  Path1 is the directory where the file
  5075.                  GRADE.PDT is located.  If BDE cannot find GRADE.PDT, there
  5076.                  will be no codes to modify.  If you have a monochrome
  5077.                  monitor, you need to add a " -m" at the end, so type: "BDE
  5078.                  \path1\GRADE.PDT -m".  When the program starts, you will
  5079.                  see a list of all the installed printers.  You can change
  5080.                  any of the listed printer codes or values by finding the
  5081.                  printer, pressing <Rtn> to select it, then altering any of
  5082.                  those values.  If you need help, press <F1>.  When you are
  5083.                  finished, press <F10> to install the new codes, or <F3> to
  5084.                  exit.
  5085.  
  5086.                  NOTE: The program BDE is sent to registered users.  All
  5087.                  other users can obtain a copy of it by sending $10 (US) to
  5088.                  the address listed above for registering the program.
  5089.  
  5090.                (d) Printer errors
  5091.  
  5092.                  If there are problems with your printer (not turned on,
  5093.                  out of paper, etc.), the program will put out an error
  5094.                  message.  Sometimes the error message may mistakenly state
  5095.  
  5096.                                          81
  5097.  
  5098.  
  5099.  
  5100.  
  5101.  
  5102.  
  5103.                  that the error is a "disk" error instead of a printer
  5104.                  error.  In either case, try to correct the error before
  5105.                  telling the program to continue.  If the error is not
  5106.                  correctable, output to the printer will stop.  In most
  5107.                  cases, the printing is just turned off.
  5108.  
  5109.                (e) Changing installed printers
  5110.  
  5111.                  After you choose your printer, the choice is written to a
  5112.                  file called "GRADE.PRT".  This file also contains the
  5113.                  various line printer codes, and is written to the current
  5114.                  directory.  To change the printer, go to the Printer Menu,
  5115.                  then select the number of the printer you want to use.  If
  5116.                  the printer is not listed, it is not installed, and must
  5117.                  be installed before it can be chosen.
  5118.  
  5119.                  If you have your classes each in different directories,
  5120.                  you can have each class set up to print differently.  The
  5121.                  program searches for the GRADE.PRT file in the current
  5122.                  directory first, then searches for the file in the
  5123.                  directory where the program is located,  then, if still
  5124.                  not found, searches for the file in a directory specified
  5125.                  by the DOS PATH command.
  5126.  
  5127.                (f) Changing the printer ports
  5128.  
  5129.                  The program assumes that you are using the first parallel
  5130.                  printer port, called LPT1 (also called LST or PRN).  To
  5131.                  change this, you can pick either of several parallel or
  5132.                  serial ports as the destination of the printing for each
  5133.                  of the five allowed printers.  No checking is done by the
  5134.                  program for the presence of the port, so if the port you
  5135.                  choose does not exist, you will not be able to print data.
  5136.  
  5137.             2. Print options
  5138.  
  5139.                The "Z" option of the Printer Menu lets you change how the
  5140.                page is output to a printer or disk file.
  5141.  
  5142.                (a) Line Spacing
  5143.  
  5144.                  Single, double, and even greater spacing of lines can be
  5145.                  printed.  Changes from single line spacing occur when
  5146.                  output is sent to a disk or the printer, never on the
  5147.                  screen.  Also note that the plots are always single
  5148.                  spaced.
  5149.  
  5150.                (b) Margins
  5151.  
  5152.                                          82
  5153.  
  5154.  
  5155.  
  5156.  
  5157.  
  5158.                                                      Printing the Grades
  5159.                  You can set up the left, right, top, and bottom margins of
  5160.                  the pages.  The left margin is the number of characters to
  5161.                  leave blank on the left side of the page.  The right
  5162.                  margin is set indirectly:  you specify the number of
  5163.                  characters on a line.  If you decrease the number of
  5164.                  characters, the line is shorter, hence you have a larger
  5165.                  right margin.  The header and footer set the lines at the
  5166.                  top and bottom of the page.  The page numbers are written
  5167.                  in the footer, while the running head on the top right of
  5168.                  the page is written in the header.  Setting either to 0
  5169.                  will prevent them from being written.  You can also stop
  5170.                  page numbers from being written by telling the program to
  5171.                  stop printing page numbers.  Lastly, you can specify the
  5172.                  number of lines on a page.  A typical 8 1/2" by 11" page
  5173.                  in pica mode has 80 characters on a line and 66 lines.
  5174.                  Elite has 96 characters and 88 lines, while compressed has
  5175.                  136 characters and 110 lines.  Some laser printers only
  5176.                  print 60 lines in pica, 80 in elite, and 100 in
  5177.                  compressed.
  5178.  
  5179.                  This flexibility also can cause problems.  If you have set
  5180.                  the number of characters to a very small number, you can
  5181.                  truncate some of the data sent to the printer.  If only
  5182.                  the left part of the graph has been written, check the
  5183.                  margins that you have set to see if that is the problem.
  5184.                  If the program doesn't break the pages in the correct
  5185.                  place, try increasing or decreasing the lines on a page.
  5186.  
  5187.                (c) Listing ranks
  5188.  
  5189.                  You can have VAR Grade print out the rank of each student
  5190.                  when listing the students in the class.  This option can
  5191.                  be turned on or off in the Print Menu.  Student ranks will
  5192.                  be listed by whatever sorting method you have chosen (see
  5193.                  Chapter VI, Section E, above).  For example, if you have
  5194.                  sorted the class by student names, the ranks printed will
  5195.                  be the alphabetical order of the class.  If you sort by
  5196.                  the score on an task, the ranks will be by the score on
  5197.                  that task.  Note that if you sort the class without regard
  5198.                  to sections, then print them by sections, the numbers will
  5199.                  not necessarily be consecutive for each student in each
  5200.                  section.
  5201.  
  5202.  
  5203.  
  5204.  
  5205.  
  5206.  
  5207.  
  5208.                                          83
  5209.  
  5210.  
  5211.  
  5212.  
  5213.  
  5214.  
  5215.                (d) Printing Notes
  5216.  
  5217.                  You often enter notes that you do not want printed out.
  5218.                  VAR Grade, therefore, will print the notes only if you
  5219.                  tell it to.  You can toggle (switch on and off) whether to
  5220.                  show the notes.  If the toggle is on (the notes will be
  5221.                  shown), when data is printed, the notes will also be
  5222.                  printed.  NOTE: When printing final grades from the "G"
  5223.                  option of the Main Menu, the notes may not all fit onto
  5224.                  the lines when printing both the student ID and names and
  5225.                  may be truncated.
  5226.  
  5227.                  To print out notes that you have entered into the student
  5228.                  records, you need to tell the program to "show" the notes.
  5229.                  Pressing "T" on the Write Data Menu will let you indicate
  5230.                  whether to show the notes.  You can also indicate whether
  5231.                  to show the notes in the Print Menu that is always seen
  5232.                  before you print your data.  For those parts of the
  5233.                  program where you can print notes, there is an option on
  5234.                  the Print Menu that lets you toggle whether to show the
  5235.                  notes.
  5236.  
  5237.                (e) Decimal places
  5238.  
  5239.                  When printing classes by sections, you can specify how
  5240.                  many decimals to print the scores.  Number, sum, extra
  5241.                  credit, and highest tasks are set, when you first run the
  5242.                  program, to 0 decimal places.  Average, weight,
  5243.                  attendance, and percentage tasks are set to 2 decimal
  5244.                  places for printing.  You can change either set to between
  5245.                  0 and 5 decimal places in the "Z" section of the Main
  5246.                  Menu.
  5247.  
  5248.             3. Disk files
  5249.  
  5250.                When you print files to disk, they are printed as ASCII
  5251.                files.  This means that you can then use a word processor to
  5252.                alter them in any way that you want, or use the word
  5253.                processor to print the files.  If you pick the "D" (print to
  5254.                disk) option, you will be asked the name of the file.  Any
  5255.                name can be used, as long as it is a valid MS-DOS filename.
  5256.                Pressing <Rtn> will cause the default disk file listed to be
  5257.                written; pressing <Esc> will turn off the printing to a disk
  5258.                file.  In case of a syntax error in the file name, the
  5259.                program will ask for a new name.  The program checks to see
  5260.                whether there is enough space on your disk and to see if a
  5261.                file with that name already exists.  If there is not enough
  5262.  
  5263.  
  5264.                                          84
  5265.  
  5266.  
  5267.  
  5268.  
  5269.  
  5270.                                                      Printing the Grades
  5271.                space on the disk, the program will stop sending files to
  5272.                the disk.  If you are printing a graph or plot, the program
  5273.                will write the plots to a file with the same filename, but
  5274.                the extension (the part after the period), will be changed.
  5275.  
  5276.                NOTE: The plots are not written in ASCII letters, but will
  5277.                  be written for whichever printer you specify.  These can
  5278.                  be printed from disk to your printer by typing "COPY
  5279.                  file.ext PRN".
  5280.  
  5281.                Each type of plot has a different letter in the extension
  5282.                (the first letter of the suggested extension), with a number
  5283.                from 00 to 99 after it.  For example, printing a plot to a
  5284.                disk file for the class GSAMPLE will produce a file
  5285.                "GSAMPLE.P00".  If that file already exists, it would be
  5286.                written to "GSAMPLE.P01", etc.  The disk file that you
  5287.                specify will contain a line in it telling you the name of
  5288.                the file for the plot.
  5289.  
  5290.             4. Class name
  5291.  
  5292.                In addition, in the "Z" option of the Main Menu, there is an
  5293.                option that will let you rename the class with up to 15
  5294.                characters.  This rename is for printing purposes only, and
  5295.                will not change the file name of the class.  When VAR Grade
  5296.                prints data to a printer or disk file, it also prints the
  5297.                name of the class.  Renaming the class will override the
  5298.                default name (which is the one used when starting the
  5299.                program).
  5300.  
  5301.                Example:  The class is called "BIO" when you tell VAR Grade
  5302.                to use it.  The default name for printing would be  "BIO".
  5303.                You can change it to anything else, e.g. "Biology 100", for
  5304.                printing purposes, but the file name(s) will still be BIO
  5305.                (plus the extensions ".PAR" and ".DAT").
  5306.  
  5307.           B. Printing the Student Scores and Attendance
  5308.  
  5309.             If you want to print out a list of the students and their task
  5310.             scores, select the Main Menu choice "W" (write).   This is the
  5311.             Write Data Menu.  You can print out all the task scores or
  5312.             attendance for one student ("by name") or for whole sections of
  5313.             students ("by section"); you can print a grid for entering
  5314.             scores; or, you can export data in formats that can be read by
  5315.             other programs.
  5316.  
  5317.  
  5318.  
  5319.  
  5320.                                          85
  5321.  
  5322.  
  5323.  
  5324.  
  5325.  
  5326.  
  5327.             1. By name
  5328.  
  5329.                After you select these options, you will see a list of
  5330.                students in the class.  If there are more students than fit
  5331.                on one screen, you can use the cursor keys to locate the
  5332.                desired student.  The highlighted name can be chosen by
  5333.                typing <Rtn>.  You can also pick a name by typing it in at
  5334.                the prompt.  If you are searching for a student in the
  5335.                class, you only have to type in the first characters of the
  5336.                name that match the desired name and that do not match any
  5337.                other names.
  5338.  
  5339.                Example: if you type "ken" when picking a student, the first
  5340.                student with the letters "ken" in the name will be found.
  5341.                "ken" would find "Kravitz, Ken" in the GSample class.
  5342.                However, it could also find a name like "Kendrow, John".
  5343.  
  5344.                Note that you can also use the cursor keys to find any name.
  5345.                If you type in the name, and there is more than one section
  5346.                of students in the class, you must enter the section number
  5347.                for the student (or <F1> to search for the section--note
  5348.                that the program will find only the first occurrence of the
  5349.                name).  If you want to print scores for all the students,
  5350.                press <F1> when the program asks for the student names.  You
  5351.                will be asked whether to print them one student per page.
  5352.                If you answer "y", a new page will be started for each
  5353.                student.  If you answer "n", the program will fit as many
  5354.                students on a page as it can.
  5355.  
  5356.                If you picked the "L" option on the Print Scores Menu, you
  5357.                will need to choose which tasks to list for the student(s).
  5358.                If you pick the "N" option, all the tasks will be listed for
  5359.                the student(s).
  5360.  
  5361.                If you use attendance in your class, you also need to choose
  5362.                whether you want to write attendance, tasks scores, or task
  5363.                scores and a summary of attendance.  The program first lists
  5364.                the name of the student, the ID, the section, and the date
  5365.                the data was printed (i.e., the current date).  It will then
  5366.                list the defined tasks by number and name as well as the
  5367.                scores for the student, the total points for the task, and
  5368.                the percentage of the total points for the student score.
  5369.                If you grade with letter grades, the total points and
  5370.                percentages are not listed, since they are meaningless.  If
  5371.                no score was entered for the student, it is listed as "not
  5372.                submitted".  For attendance, VAR Grade will list all the
  5373.                dates and attendance.  For the attendance summary, a list of
  5374.                the totals for each attendance category will be printed.  If
  5375.  
  5376.                                          86
  5377.  
  5378.  
  5379.  
  5380.  
  5381.  
  5382.                                                      Printing the Grades
  5383.                you list the scores to a printer or to a disk file, VAR
  5384.                Grade will break the listing into pages.  You can change
  5385.                such things as margins, type styles, etc. before you print
  5386.                the class from the Print Menu (see above).
  5387.  
  5388.             2. By section
  5389.  
  5390.                If you select this option, you must pick the tasks or
  5391.                attendance days to print, ending the input with a <Rtn>,
  5392.                followed by a second <Rtn> (with no other characters) or "0"
  5393.                <Rtn>.  This tells the program that you are finished putting
  5394.                in task or attendance numbers.
  5395.  
  5396.                NOTE:  If there are too many tasks or attendance days to
  5397.                  print on one screen, the program will print out as many as
  5398.                  fits across the page for a whole section, then more, etc.,
  5399.                  until all tasks and students have been printed.
  5400.  
  5401.                If you are printing more than one set of tasks, or more than
  5402.                one section of students, the program will ask if you want to
  5403.                print them one set per page.  If you answer "y", the program
  5404.                will start a new page for each new set of tasks or section
  5405.                of students.  If you answer "n", the program will fit as
  5406.                many on a page as it can.  After specifying what to print,
  5407.                you reach the Print Menu.  If the wrong section, printer, or
  5408.                other options are listed, change them before specifying
  5409.                where to print the data.  If you are printing the student
  5410.                notes, they will be printed after any tasks that you have
  5411.                chosen.  We always recommend that you print the scores on
  5412.                your printer immediately after entering task scores, just in
  5413.                case there is a computer or disk malfunction.  If you print
  5414.                the scores on your printer, using elite type and single
  5415.                spacing will allow more scores to be printed per page than
  5416.                pica printing.  As mentioned above, you can set decimal
  5417.                places, margins, page lengths, characters per line, etc.
  5418.                from the Printer Menu.  Although you may have entered scores
  5419.                using several decimal places, they will be printed using the
  5420.                number of places to the right of the decimal that you
  5421.                specify.  NOTE: The program keeps grades using 15
  5422.                significant digits, but may not print that many.  When
  5423.                printed to the printer, page lengths are calculated and the
  5424.                printing formatted accordingly.  The date is also printed so
  5425.                that you know when you last printed your class data.
  5426.  
  5427.             3. Printing grids
  5428.  
  5429.                For entering student data, it is often useful to list the
  5430.                students with a blank grid.  You can then use it to record
  5431.  
  5432.                                          87
  5433.  
  5434.  
  5435.  
  5436.  
  5437.  
  5438.  
  5439.                the grades.  The grid can make it easier to enter the
  5440.                student grades into the computer.  The program will just
  5441.                list all the students in the class and empty boxes (grids)
  5442.                for entering student data.  Attendance grids have twice as
  5443.                many boxes as regular grids.
  5444.  
  5445.           C. Calculating and Printing Grades
  5446.  
  5447.             To calculate and print grades on a task (or final grades) use
  5448.             the "G" (grade) option on the Main Menu, then "G", "P", or "3"
  5449.             on the Grading Menu.
  5450.  
  5451.             1. Choose a task
  5452.  
  5453.                First, pick which task to grade.  The program lists all the
  5454.                valid tasks.  If there are more tasks than can be listed on
  5455.                one screen, use the cursor keys to see more tasks.  Task 0
  5456.                or <Esc> is interpreted as no task (exit).  Only non-letter
  5457.                grades can be picked (the others already have the grades
  5458.                assigned).  If you pick a final task, the grades will be
  5459.                assigned to it.  Otherwise, the grades are printed, but no
  5460.                record is made of the grades.
  5461.  
  5462.             2. Defaults
  5463.  
  5464.                As discussed above, after picking the task and range of
  5465.                scores, you can pick the sections and how to print the
  5466.                scores.
  5467.  
  5468.             3. Plot and cutoffs
  5469.  
  5470.                If you selected the "P" or "3" options on the Grading Menu,
  5471.                all the scores for the sections specified will be plotted;
  5472.                otherwise, the "G" option skips the plotting.  You then must
  5473.                select the LOW cutoffs for each grade (unless you have
  5474.                already set the cutoffs in the "C" option of the Grading
  5475.                Menu).  Depending upon your grading system, up to 49 cutoffs
  5476.                need to be entered.  If you just press enter for a cutoff,
  5477.                the program will select the same cutoff as the previous
  5478.                cutoff (hence nobody will receive that particular grade, and
  5479.                the totals for that grade will not be listed at the end of
  5480.                the class).  You can use <F2> to backup one or more grades.
  5481.  
  5482.             4. Listing the grades
  5483.  
  5484.                The program will list the total points (or averages) and
  5485.                grades, by section, for the selected task.  A table of
  5486.                numbers of students with each grade and the cutoffs are then
  5487.  
  5488.                                          88
  5489.  
  5490.  
  5491.  
  5492.  
  5493.  
  5494.                                                      Printing the Grades
  5495.                listed.  The program will ask whether these grades are
  5496.                acceptable.  If you choose no ("N"), the plot and cutoffs
  5497.                will continue to be repeated, with new cutoffs, until you
  5498.                say they are acceptable ("Y").  When the data is printed
  5499.                out, the classname, section, task, and date are also
  5500.                printed.  If you have picked a task defined as a Final task,
  5501.                the program will save the grades for the students on that
  5502.                task, as well as the new cutoffs.  The grades for that task
  5503.                will then be recalculated each time you enter scores.  If it
  5504.                is not a Final task, it does not store the assigned grades
  5505.                and cutoffs anywhere in the program.  If you print notes,
  5506.                they will be listed on the right hand side of the page.
  5507.  
  5508.                WARNING: If you are printing with both names and IDs, the
  5509.                notes may be truncated.
  5510.  
  5511.           D. Exporting Data
  5512.  
  5513.             You can export data from a VAR Grade class in three different
  5514.             formats.  Other programs can then read the data.
  5515.  
  5516.             For all three methods of export, you can specify whether to
  5517.             write names, IDs, and sections, as well as any combination of
  5518.             tasks.  If you want student notes to be written, make sure that
  5519.             the you have you have told the program to show the notes (i.e.,
  5520.             set the toggle) before you export the data.
  5521.  
  5522.             1. Comma and quote file
  5523.  
  5524.                A quote and comma file is an ASCII file where strings
  5525.                (names) are enclosed in double quotes (""), while numbers
  5526.                are not.  Cells of data are separated by commas.  Many
  5527.                spreadsheets can import this type of file.  Each cell get
  5528.                imported into one cell in a spreadsheet.  Each line in the
  5529.                file ends up as one line in the spreadsheet.
  5530.  
  5531.             2. Flat file
  5532.  
  5533.                A flat file is an ASCII file where data is separated into
  5534.                columns.  The columns are separated by spaces.  Many
  5535.                spreadsheets can import data in this format.
  5536.  
  5537.             3. Byte file
  5538.  
  5539.                This type of file is not an ASCII file.  It is included
  5540.                either as a last resort, so you can write your own
  5541.                converter, or to work with report card programs that may be
  5542.                on the market.  The names are written with 20 characters,
  5543.  
  5544.                                          89
  5545.  
  5546.  
  5547.  
  5548.  
  5549.  
  5550.  
  5551.                then the IDs with 15 characters, student notes with 20
  5552.                characters, sections as 2-byte cardinal numbers, and tasks
  5553.                as 2-byte letter grades for letter and final tasks or 8-byte
  5554.                floating point numbers for all other tasks (1 sign bit, 11
  5555.                exponent bits, and 52 bits for the significand).  If
  5556.                specified, the order is: name, ID, notes, section (written
  5557.                if there is more than 1 section in the class, otherwise not
  5558.                written), then the list of tasks, in the order you chose.
  5559.  
  5560.           E. Reports
  5561.  
  5562.             A simple programming language, named VRL (VAR Grade Report
  5563.             Language) has been added to VAR Grade so that you can write
  5564.             reports that include your class data.  The language will allow
  5565.             you to write just about any report that you might want.  The
  5566.             reports are written in plain text (ASCII characters) that are
  5567.             called report forms.  These forms are translated by VAR Grade
  5568.             into complete reports.  Included with the program are several
  5569.             forms that can be used by you for your classes, or used as
  5570.             examples to help you write your own reports.  The language used
  5571.             for the forms can be used to emulate any of the types of output
  5572.             that VAR Grade already does.  It also lets you write reports
  5573.             that can include data on students from more than one class, so
  5574.             that you can have the program write reports that will
  5575.             consolidate the grades for your students that are taking more
  5576.             than one of your classes.
  5577.  
  5578.             Overview of the VRL language
  5579.  
  5580.                The purpose of VRL is to let you access just about any piece
  5581.                of data of your class.  It is also a forgiving language, in
  5582.                that if you make a mistake, the program will not blow up or
  5583.                go into computer heaven.  Instead, mistakes will show up as
  5584.                reports that do not look how you want them, and will usually
  5585.                result in the incorrect commands appearing in square
  5586.                brackets in the output.  Each command in the VRL language
  5587.                starts with a left square bracket "[", and ends with a right
  5588.                square bracket "]".  The only exception to this are
  5589.                comments, which start with a left curly bracket "{" and end
  5590.                with a right curly bracket "}".  The form that tells VAR
  5591.                Grade what to do is read line by line.  This means that
  5592.                commands must be entirely on one line.  You can have as many
  5593.                commands on one line as will fit.  Each line in the form can
  5594.                have up to 255 characters, with no limit on the number of
  5595.                lines.
  5596.  
  5597.                The commands can be broken down into several categories.
  5598.                First, there are comments.  The comments are ignored by VAR
  5599.  
  5600.                                          90
  5601.  
  5602.  
  5603.  
  5604.  
  5605.  
  5606.                                                      Printing the Grades
  5607.                Grade, but are useful for commenting on what you have done.
  5608.                Second, there are printer and format commands.  Printer
  5609.                commands tell the printer to do something, such as print the
  5610.                next part with bold type.  Format commands tell the program
  5611.                to change the way things are written, such as to go to the
  5612.                next page (called a "formfeed").  Third, there are commands
  5613.                that let you write class data.  These let you write student,
  5614.                task, and attendance data.  Fourth, there are commands that
  5615.                tell the program to change something.  These are used to
  5616.                change or switch data, like changing the class, to switch to
  5617.                a different task, and so forth.  Fifth, there are commands
  5618.                that tell the program to repeat things.  These allow you to
  5619.                easily write lists of students and tasks.  Last, you can
  5620.                write out text.  Anything that is not in brackets is written
  5621.                exactly as it is in the report form.
  5622.  
  5623.                Commands can also be formatted.  This means that you can
  5624.                specify not only to write a particular score or name, but
  5625.                also how to write it (spaces, how many decimals, etc.).
  5626.                Different commands need different types of formatting, so
  5627.                the relevant formatting will be discussed with each command.
  5628.  
  5629.                In the explanations, the commands need to have square
  5630.                brackets around them.  Subcommands, like those in the Print
  5631.                command, need to have the command and the subcommand between
  5632.                the square brackets.  Although spelling is important for the
  5633.                commands, they can be in any mixture of upper and lower case
  5634.                letters.  If you want to write a left square bracket in your
  5635.                text, you can do so by writing two consecutive square
  5636.                brackets ("[[").  Extraneous material that is written after
  5637.                the commands, but inside the brackets, is generally ignored.
  5638.  
  5639.             Writing report forms
  5640.  
  5641.                Before writing report forms, you should do three things.
  5642.                First, read the following sections on what the commands do.
  5643.                This will let you know what types of things you can do, as
  5644.                well as what some of the funny looking commands mean.
  5645.                Second, browse through some or all of the forms included
  5646.                with the program.  This will help you see how somebody else
  5647.                has accomplished what you might want to do.  Feel free to
  5648.                copy, modify, and discard anything in the forms.  Last,
  5649.                write the form in plain text (also called "ASCII"
  5650.                characters).  Most, if not all word processors and all
  5651.                editors will write what you have written in plain text.  If
  5652.                not, there are a number of good shareware word processors
  5653.                that can.
  5654.  
  5655.  
  5656.                                          91
  5657.  
  5658.  
  5659.  
  5660.  
  5661.  
  5662.  
  5663.                In the "W" (write) option of the Main Menu, there are
  5664.                several options for writing and editing forms.
  5665.  
  5666.                Designating an editor
  5667.  
  5668.                  The "D" option on the Write Data Menu will let you
  5669.                  designate whichever editor or word processor you want to
  5670.                  use to edit or view report forms.  The editor should be
  5671.                  capable of writing plain text (i.e., in ASCII characters).
  5672.                  You should enter the editor with whatever command you use
  5673.                  to invoke the editor.  If you have a hard disk or EMS
  5674.                  memory, any word processor can be called from VAR Grade.
  5675.                  If you do not have either, only word processors or editors
  5676.                  that take up little memory can be called from the program.
  5677.                  If your word processor takes up too much memory to be
  5678.                  called from the program, you will not be able to edit
  5679.                  report forms from inside VAR Grade.  You could, however,
  5680.                  exit the program and then edit the report forms.
  5681.  
  5682.                Editing forms
  5683.  
  5684.                  The "F" option on the Write Data Menu will invoke the
  5685.                  editor you have designated.  VAR Grade will invoke your
  5686.                  editor so that you can edit or view report forms.  Forms
  5687.                  can have any name.  However, it is suggested that you use
  5688.                  the extension ".FRM" for the forms.  The forms included
  5689.                  with the program all have that extension.  If you use a
  5690.                  consistent ending for the forms, it will be easier to find
  5691.                  the one that you want.  When the editor is invoked, it is
  5692.                  invoked with: "editor *.FRM", where 'editor' is the name
  5693.                  of your editor or word processor.
  5694.  
  5695.                Class reports
  5696.  
  5697.                  This option, "C", is intended for using forms that write
  5698.                  reports for all the students in your class.  It will ask
  5699.                  you for the name of the form to use, then will ask where
  5700.                  to print the class data.  If you use this option to print
  5701.                  a form intended for individual students (see the next
  5702.                  section), the first student in the class will be used as
  5703.                  the "correct" student.  Examples of class forms are listed
  5704.                  below.
  5705.  
  5706.  
  5707.  
  5708.  
  5709.  
  5710.  
  5711.  
  5712.                                          92
  5713.  
  5714.  
  5715.  
  5716.  
  5717.  
  5718.                                                      Printing the Grades
  5719.                     Form                Use
  5720.                     Consolid.FRM        Lists all the students grades on
  5721.                                         one task in each of three classes.
  5722.                                         This shows the capability of the
  5723.                                         report writer in being able to find
  5724.                                         and write the grades of students
  5725.                                         (having identical names) from
  5726.                                         different classes.
  5727.  
  5728.                     Flat.FRM            Emulates flat files.  This writes
  5729.                                         all the students' names, IDs,
  5730.                                         sections, and notes as a flat file.
  5731.  
  5732.                     Quote.FRM           Emulates quote and comma files.
  5733.                                         This writes all the students'
  5734.                                         names, IDs, sections, and notes as
  5735.                                         a quote and comma file.
  5736.  
  5737.                     Section.FRM         Lists all the grades for all the
  5738.                                         students in the class.  This
  5739.                                         emulates the "Write students in
  5740.                                         sections" option of the Write Data
  5741.                                         Menu.
  5742.  
  5743.                Individual reports
  5744.  
  5745.                  This option, "I", is intended for using forms that write
  5746.                  reports on individual students.  A second menu will
  5747.                  appear, asking if you want to write a report on one
  5748.                  student, all students below a designated score on a task,
  5749.                  or all students above a designated score on a task.  If
  5750.                  you choose to write a report on one student, you will be
  5751.                  asked for the name of the student.  If you pick either of
  5752.                  the other two options, you will be asked for the task and
  5753.                  the cutoff score.  Each student in the class that is above
  5754.                  or below the cutoff (whichever option you chose), will
  5755.                  have the form printed for him or her.  This will let you
  5756.                  write a report telling the low students to shape up and a
  5757.                  different report praising the top students, each listing
  5758.                  the relevant grades for the student.  Examples of class
  5759.                  forms are listed below.
  5760.  
  5761.                     Form                Use
  5762.                     Classes.FRM         Lists the grades for a student from
  5763.                                         three separate classes.  This shows
  5764.                                         how to write a report that
  5765.                                         consolidates the class data for one
  5766.                                         student into one report.
  5767.  
  5768.                                          93
  5769.  
  5770.  
  5771.  
  5772.  
  5773.  
  5774.  
  5775.  
  5776.                     Form                Use
  5777.                     Low.FRM             This is an example of a report that
  5778.                                         will tell the parents of students
  5779.                                         that their child is not doing well
  5780.                                         enough in your class.
  5781.  
  5782.                     Name.FRM            Lists all the grades and data for
  5783.                                         one student.  This emulates the
  5784.                                         "Write data for a student" option
  5785.                                         of the Write Data Menu.
  5786.  
  5787.                     Report.FRM          This shows the capability of
  5788.                                         writing a free form report that
  5789.                                         tells the students in your class
  5790.                                         how they are doing.
  5791.  
  5792.             Comments
  5793.  
  5794.                Comments are words bracketed by "{" and "}" (see example 1,
  5795.                below).  When the form is printed, the comments are removed
  5796.                from the form.  The purpose of comments, therefore, is to
  5797.                let you state what you have done in plain English so that
  5798.                the next time you look at the form, you will remember why
  5799.                you wrote it.  Comments can be anywhere in the form.
  5800.                However, they cannot be nested (see example 2).  If you want
  5801.                to put a left curly bracket into your text, put it in as two
  5802.                consecutive left brackets ("{{") (example 3).  For a
  5803.                comment, if the right curly bracket is not present, the rest
  5804.                of the line is not printed (example 4).
  5805.  
  5806.                  Examples:
  5807.  
  5808.                  #   Statement in Form       Program Output
  5809.                  1   {This is a comment}
  5810.                  2   {This is {a} comment}    comment}
  5811.  
  5812.                  #   Statement in Form       Program Output
  5813.                  3   {{This is a comment}    {This is a comment}
  5814.                  4   {This is a comment
  5815.  
  5816.                NOTE: For comments that take up an entire line, like example
  5817.                4, that line will not be printed.
  5818.  
  5819.  
  5820.  
  5821.  
  5822.  
  5823.  
  5824.                                          94
  5825.  
  5826.  
  5827.  
  5828.  
  5829.  
  5830.                                                      Printing the Grades
  5831.             Printer and format commands
  5832.  
  5833.  
  5834.                Printer Commands
  5835.  
  5836.                  Printer commands tell your printer to do special things.
  5837.                  You can tell your printer to print things in bold type, or
  5838.                  even enter printer commands directly into your forms.
  5839.                  These commands have the form: [Print"subcommand"] or
  5840.                  [Print'subcommand'], where subcommand is one of the
  5841.                  subcommands listed below.
  5842.  
  5843.                  SubCommand   Description
  5844.                  ''           Anything between the single quotes is sent to
  5845.                               the printer.  The purpose of this command is
  5846.                               to send any special printer codes to the
  5847.                               printer that you want.  A "#" tells the
  5848.                               program to print the next number(s) as ASCII
  5849.                               codes.  Example: [Print'#100'] means to print
  5850.                               ASCII character 100 ("d").  A "@" tells the
  5851.                               program to print the following characters
  5852.                               exactly as they are listed.  Example:
  5853.                               [Print'@100'] means to print "100" (not "d").
  5854.  
  5855.                  NOTE: All the commands listed below start and end with
  5856.                  double quotes ([Print"command"]).
  5857.  
  5858.                  BoldOn       Sets the printer to start printing with bold
  5859.                               characters.
  5860.  
  5861.                  BoldOff      Turns off bold printing.
  5862.  
  5863.                  Chars=#      Sets the number of characters on a line,
  5864.                               where "#" is a number.  Example:
  5865.                               [Print"Chars=50"] tells the program to set
  5866.                               the number of characters on a line to 50.
  5867.  
  5868.                  Compressed   Sets the printer to print in compressed text
  5869.                               (17.1 characters per inch, 8 lines per inch).
  5870.  
  5871.                  Elite        Sets the printer to print in elite text (8
  5872.                               characters per inch, 8 lines per inch).
  5873.  
  5874.                  High         Sets the printer to high quality text.
  5875.  
  5876.                  SubCommand   Description
  5877.  
  5878.  
  5879.  
  5880.                                          95
  5881.  
  5882.  
  5883.  
  5884.  
  5885.  
  5886.  
  5887.                  Lines=#      Sets the number of lines on a page, where "#"
  5888.                               is a number.  Example: [Print"Lines=44"] sets
  5889.                               the number of lines on a page to 44.
  5890.  
  5891.                  Normal       Sets the printer in draft (normal) quality
  5892.                               text.
  5893.  
  5894.                  Offset=#     Sets the number of spaces to be printed at
  5895.                               the beginning of each line, where "#" is a
  5896.                               number.  The higher the number, the further
  5897.                               from the left side of the page the document
  5898.                               is printed.  Example: [Print"Offset=5"]
  5899.                               prints five spaces at the beginning of each
  5900.                               line.
  5901.  
  5902.                  Pica         Sets the printer to print in pica text (6
  5903.                               characters per inch, 6 lines per inch).
  5904.  
  5905.  
  5906.                Format commands
  5907.  
  5908.                  These commands alter how the printed form will look.
  5909.  
  5910.                  Command      Description
  5911.                  EndOfPage    Write a formfeed (end of page character).
  5912.                               This starts a new page on the printer.  Any
  5913.                               forms longer than the number of lines on a
  5914.                               page are automatically broken into pages.
  5915.                               The EndOfPage command lets you pick where the
  5916.                               pages will break if you want certain items to
  5917.                               end up on the same page.
  5918.  
  5919.                  Just         Left justify strings.  Names, dates, etc. can
  5920.                               be written with a defined length (e.g., you
  5921.                               can have the student names written with 25
  5922.                               characters).  Left justification will write
  5923.                               the names starting with the first character.
  5924.                               Example: "Student Name............." (the
  5925.                               periods are there for illustration purposes,
  5926.                               only).  This is the standard way of writing
  5927.                               names, etc.
  5928.  
  5929.                  NotOnePerPage     More than one student or set of students
  5930.                               per page (default setting).  See "OnePerPage"
  5931.  
  5932.                  OnePerPage   One student or set of students per page of
  5933.                               output.  Page breaks will be inserted after
  5934.                               each student or set of students.
  5935.  
  5936.                                          96
  5937.  
  5938.  
  5939.  
  5940.  
  5941.  
  5942.                                                      Printing the Grades
  5943.  
  5944.                  Command      Description
  5945.                  RJust        Right justify strings.  Names, dates, etc.
  5946.                               can be written with a defined length (e.g.,
  5947.                               you can have the student names written with
  5948.                               25 characters).  Right justification will
  5949.                               write the names from the rightmost character.
  5950.                               Example: ".............Student Name" (the
  5951.                               periods are there for illustration purposes,
  5952.                               only).
  5953.  
  5954.             Commands to write or switch data
  5955.  
  5956.                There are quite a number of commands for accessing or
  5957.                switching data.  These are listed below in several groups:
  5958.                student data, task data, and class or generic data.
  5959.  
  5960.                For most of the data, you can tell the program how to format
  5961.                the output.  For almost all of the commands, you can tell
  5962.                the program how many characters to write the data.  This is
  5963.                useful for formatting columns.  Example: [Name:25] tells the
  5964.                program to write the student name 25 characters wide.  Since
  5965.                the name is less than 25 characters, the rest will be
  5966.                written with blanks.  [Name] will write only the name, with
  5967.                no extra blanks.  For numeric data, you can tell the program
  5968.                how many numbers should be written after the zero.  Example:
  5969.                [TaskScore:10:3] will write the data 10 characters wide,
  5970.                with 3 numbers after the zero: xxxxxx.xxx, where x is any
  5971.                number (notice that one space is taken by the period). If
  5972.                you specify a length that is less than the required spaces,
  5973.                the entire piece of data is written.  Example:
  5974.                [TaskScore:0:3] will write the data with as many spaces as
  5975.                needed, but including three numbers after the decimal.
  5976.  
  5977.                NOTE: Formatting of commands, which are the ":#" seen after
  5978.                  the commands listed below, are optional.
  5979.  
  5980.                Class or Generic Data
  5981.  
  5982.                  These commands access class data, switch between classes,
  5983.                  or access things like the current date.
  5984.  
  5985.                  Command      Description
  5986.                  "":#         Anything between the double quotes ("") is
  5987.                               printed.  The only reason you will probably
  5988.                               need to use this command is to specify the
  5989.                               width of headers, etc. when formatting
  5990.                               tables.
  5991.  
  5992.                                          97
  5993.  
  5994.  
  5995.  
  5996.  
  5997.  
  5998.  
  5999.  
  6000.                  Command      Description
  6001.                  AttTotal:#   Prints the total number of class days.
  6002.  
  6003.                  Class=#      Switches the class to another one.  The "#"
  6004.                               must either specify a valid name of a class,
  6005.                               or specify nothing.  It is specifies nothing,
  6006.                               the original class will be used as the
  6007.                               current class.  Up to 7 classes in addition
  6008.                               to the original one can be kept in memory at
  6009.                               once (unless you run out of memory).  If you
  6010.                               have the same students in several classes or
  6011.                               subjects, this can let you write one report
  6012.                               form that will put all their data onto one
  6013.                               printout.
  6014.  
  6015.                  ClassName:#  Prints the name of the current class (Note:
  6016.                               it does not print the filename, but instead
  6017.                               the name you specify for printouts in the "Z"
  6018.                               option of the Main Menu).
  6019.  
  6020.                  Date:#       Prints the current date.
  6021.  
  6022.                Student Data
  6023.  
  6024.                  These commands access the student data, including grades
  6025.                  and attendance.
  6026.  
  6027.                  Command      Description
  6028.                  AttExcused:# Prints the number of days the student has had
  6029.                               an excused absence.
  6030.  
  6031.                  AttLate:#    Prints the number of days the student has
  6032.                               been late.
  6033.  
  6034.                  AttNotPres:# Prints the number of days the student has
  6035.                               been absent from the class.
  6036.  
  6037.                  AttOther:#   Prints the number of days the student has
  6038.                               been "other" from the class.  Other can be
  6039.                               used for any meaning by you.
  6040.  
  6041.                  AttPresent:# Prints the number of days the student has
  6042.                               been present in the class.
  6043.  
  6044.                  AttTotal:#   Prints the total number of class days.
  6045.  
  6046.  
  6047.  
  6048.                                          98
  6049.  
  6050.  
  6051.  
  6052.  
  6053.  
  6054.                                                      Printing the Grades
  6055.                  Command      Description
  6056.                  AttUnex:#    Prints the total number of unexcused absences
  6057.                               by the student.
  6058.  
  6059.                  ID:#         Prints the ID of the current student.
  6060.  
  6061.                  Name:#       Prints the name of the current student.
  6062.  
  6063.                  Note:#       Prints the notes of the current student.
  6064.  
  6065.                  Section:#    Prints the section of the current student.
  6066.  
  6067.                  TaskPer:#:#  Prints the percentage score that the current
  6068.                               student scored on the current task.
  6069.  
  6070.                  TaskScore:#:#     Prints the score on the current task for
  6071.                               the student.
  6072.  
  6073.                Task Data
  6074.  
  6075.                  These commands are used to change or specify the tasks to
  6076.                  use.  In general, you want to change or specify the
  6077.                  current task with Task or DTask, then print the data with
  6078.                  the other commands.
  6079.  
  6080.                  Command      Description
  6081.                  DTask        Defines a task as the current one.  No data
  6082.                               is printed.  The task can be specified many
  6083.                               ways:
  6084.                               (1) [DTask#x], where x is the number of the
  6085.                               task.
  6086.                               (2) [DTask@x], where x is the xth task you
  6087.                               have defined.
  6088.                               (3) [DTask(x)], where (x) is the total number
  6089.                               of tasks in the class /x.  Example: If there
  6090.                               are ten tasks defined, [DTask(2)] is the
  6091.                               fifth task.
  6092.                               (4) [DTask?].  "?" means that the program
  6093.                               will ask you to select the task when it
  6094.                               reaches that point.
  6095.                               (5) [DTask+].  The "+" can be added to any of
  6096.                               the first three definitions, and tells the
  6097.                               program to increment the number by one.
  6098.                               [DTask+] will increment the current task by
  6099.                               one.  [DTask(2)+] will, if there are 16
  6100.                               tasks, make the current task the ninth one
  6101.                               (16/2 = 8, then add one).
  6102.                               (6) [DTask"name"], where name is any word or
  6103.  
  6104.                                          99
  6105.  
  6106.  
  6107.  
  6108.  
  6109.  
  6110.  
  6111.                  Command      Description
  6112.                  DTask (cont) characters, will select the first task that
  6113.                               matches the characters.  So [DTask"First"]
  6114.                               will select any task with first in the name
  6115.                               (e.g., "First Exam" or "The first test").
  6116.                               (7) In some circumstances, like the [Loop]
  6117.                               command described below, just a plain
  6118.                               [DTask], without any designation of a number,
  6119.                               is required.  When [Loop] is used, the plain
  6120.                               [DTask] is modified to have the required
  6121.                               number for the loop.
  6122.  
  6123.                  Task:#:#     This works like DTask, except that, after the
  6124.                               current task has been changed, the score for
  6125.                               the current student on that task is printed.
  6126.  
  6127.                  TaskName:#   Prints the name of the current task.
  6128.  
  6129.                  TaskNum:#    Prints the number of the current task.
  6130.  
  6131.                  TaskPer:#:#  Prints the percentage score that the current
  6132.                               student scored on the current task.
  6133.  
  6134.                  TaskPts:#:#  Prints the total attempted points of the
  6135.                               student on the current task.  If all the task
  6136.                               scores have been entered, it will be the same
  6137.                               as TaskTotal, below.
  6138.                  TaskScore:#:#     Prints the score on the current task for
  6139.                               the student.
  6140.  
  6141.                  TaskTotal:#:#     Prints the total points of the current
  6142.                               task.
  6143.  
  6144.             Repetitive commands
  6145.  
  6146.                These are commands that are used to write lists of students
  6147.                or tasks.   There are three commands: repeat, loop, and
  6148.                students.  There is also a related command: header.
  6149.  
  6150.                  Command      Description
  6151.                  Header       For the following repetitive commands,
  6152.                               [Header] will print whatever is on the header
  6153.                               line at the beginning of any new page.  This
  6154.                               command will let you write long lists of
  6155.                               students or task scores, each with a header
  6156.                               on the top of any new pages.
  6157.  
  6158.  
  6159.  
  6160.                                          100
  6161.  
  6162.  
  6163.  
  6164.  
  6165.  
  6166.                                                      Printing the Grades
  6167.                  Command      Description
  6168.                  Loop         Repeat more than one line.  Any lines between
  6169.                               [Loop] and [Loopend] will be repeated.  Note
  6170.                               that the lines containing [Loop] and
  6171.                               [Loopend] are not printed.  Tasks specified
  6172.                               with the commands [Task] and [DTask] that are
  6173.                               found between the [Loop] and [Loopend]
  6174.                               commands are incremented between repetitions
  6175.                               Note: [DTask#1], [Task@1], etc, will not be
  6176.                               incremented within Loop, so use plain [DTask]
  6177.                               and [Task].  The [Loop] command can be
  6178.                               modified by telling the program how to
  6179.                               increment the Tasks.  [Loop:#:#] is used
  6180.                               specify, in order the beginning task to use
  6181.                               and how much to increase the task numbers
  6182.                               each loop.  Example: [Loop:3:2] will print
  6183.                               tasks, starting with the third task and
  6184.                               increasing the task numbers by 2 each time
  6185.                               the loop is repeated.  If the "#" numbers are
  6186.                               omitted, it is assumed that the loop should
  6187.                               start at the first task and increment them by
  6188.                               one each time.  [Loopend] can also be
  6189.                               modified.  In [Loopend:#], the "#" is the
  6190.                               number of the last task to be printed.
  6191.                               Example:  [Loop:3:2]
  6192.                                         [Task]
  6193.                                         [Loopend:7]
  6194.                               will print out the scores for the third,
  6195.                               fifth, and seventh tasks.  The loop will end
  6196.                               when the last task in the class is reached.
  6197.                               So, in the above example, if there were only
  6198.                               five tasks in the class, only scores for the
  6199.                               third and fifth tasks will be printed.
  6200.  
  6201.  
  6202.  
  6203.  
  6204.  
  6205.  
  6206.  
  6207.  
  6208.  
  6209.  
  6210.  
  6211.  
  6212.  
  6213.  
  6214.  
  6215.  
  6216.                                          101
  6217.  
  6218.  
  6219.  
  6220.  
  6221.  
  6222.  
  6223.                  Command      Description
  6224.                  Repeat#      Write the information on the line, but
  6225.                               increment the task numbers on the line by one
  6226.                               each time the line is repeated.  "#" is a
  6227.                               number.  If "#" is not present, the line will
  6228.                               be repeated once for each task in the class.
  6229.                               If "#" is a number, the line will be repeated
  6230.                               that number of times.  If "#" is a number in
  6231.                               parentheses, like "(2)", the line will be
  6232.                               repeated by the quantity: the total number of
  6233.                               tasks in the class / that number.  Examples:
  6234.                               If a class has 16 tasks that have been
  6235.                               defined, [Repeat] will repeat the line 16
  6236.                               times; [Repeat(2)] will repeat the line 8
  6237.                               times; [Repeat5] will repeat the line 5
  6238.                               times.  Note that, in each case, any task
  6239.                               numbers on that line will be incremented by
  6240.                               one each time the line is repeated.  If "#"
  6241.                               is a question mark, you will be asked, when
  6242.                               the form is printed, for a list of the tasks
  6243.                               to write.  The line will be repeated enough
  6244.                               times to write out that list.
  6245.  
  6246.                  Students     Write the information on the line for each
  6247.                               student in the class, from the first student
  6248.                               to the last one.  The purpose of this command
  6249.                               is to easily write out a list of students'
  6250.                               data.
  6251.  
  6252.                               Example: [Students][Name] will write the
  6253.                               names of all the students in the class, one
  6254.                               per line,  starting with the first student
  6255.                               and ending with the last student.
  6256.  
  6257.  
  6258.  
  6259.  
  6260.  
  6261.  
  6262.  
  6263.  
  6264.  
  6265.  
  6266.  
  6267.  
  6268.  
  6269.  
  6270.  
  6271.  
  6272.                                          102
  6273.  
  6274.  
  6275.  
  6276.  
  6277.  
  6278.                                                   Other Program Features
  6279.  
  6280.  
  6281.                              XII. OTHER PROGRAM FEATURES
  6282.  
  6283.  
  6284.  
  6285.  
  6286.           A. File Maintainance
  6287.  
  6288.             VAR Grade has a complete file maintainance section: "F" on the
  6289.             Main Menu.  The intention of this section is to allow you to
  6290.             copy, move, delete, etc. any or all of your class files.
  6291.  
  6292.             Alter the current class file name ("A")
  6293.  
  6294.                This option will change the name of the class that is
  6295.                currently in memory.  Both the class files and the backup
  6296.                files, if present, are renamed to the new name.  Note that
  6297.                this is different than changing the class name for
  6298.                printouts.  The name listed on printouts can be changed in
  6299.                the "Z" option of the Main Menu.
  6300.  
  6301.             Write the class to a backup disk ("W")
  6302.  
  6303.                This option will write the current class to a different
  6304.                directory or, preferably, drive.  This will allow you to
  6305.                keep a copy of the current class on another drive.  It is
  6306.                highly recommended that you keep copies of your class on at
  6307.                least two different drives.  In the unlikely case of disk
  6308.                failure, you will have another copy of your class data.  It
  6309.                is also advisable to keep a printed copy of your grades.
  6310.  
  6311.             Maintainance of one or more classes:
  6312.  
  6313.                The next five options can be used for file maintainance of
  6314.                any and all your classes, not just the current class as in
  6315.                the above two options.  For each option, you can specify one
  6316.                or more files, and can use the DOS wildcard characters * and
  6317.                ? to help specify the files.  You can also specify files on
  6318.                any drive or directory of your computer.
  6319.  
  6320.                The DOS wildcard character "*" means all files, while the
  6321.                character "?" means any character can be in that position of
  6322.                the filename.  DOS extensions, those characters after the
  6323.                period (e.g., .PAR), are ignored.  Instead, all class files
  6324.                associated with that name are renamed.
  6325.  
  6326.  
  6327.  
  6328.                                          103
  6329.  
  6330.  
  6331.  
  6332.  
  6333.  
  6334.  
  6335.                  Example: If you specify "*", this would mean to do a
  6336.                  particular operation on ALL class files.
  6337.  
  6338.                  Example: If you specify "ART??", it would mean all classes
  6339.                  starting with the letters "ART" and then having up to two
  6340.                  more characters, like "ART10" or "ARTS".
  6341.  
  6342.                When you use one of the five options, you can use the cursor
  6343.                keys to move to the desired class, or use them to change
  6344.                directories or drives, or move the cursor to the line "Files
  6345.                to use:" and type in the file specifications.  Whichever
  6346.                field is highlighted when you press <Rtn> will be the field
  6347.                that will determine what action is taken.  The options and
  6348.                their actions are listed below.
  6349.  
  6350.                Rename class files ("R")
  6351.  
  6352.                  This option can be used to rename one or more files.  You
  6353.                  are first asked for the file(s) to rename, then are asked
  6354.                  for the new name(s).  All files that match the listed file
  6355.                  names will be renamed.  Only the first of two or more
  6356.                  classes that should be renamed to duplicate names will be
  6357.                  renamed.
  6358.  
  6359.                Update class files ("U")
  6360.  
  6361.                  This option will look at all class files in the first
  6362.                  directory or drive that you choose, then copy them to a
  6363.                  second directory or drive if they are more recent than
  6364.                  those in that second one.  If you have more than one class
  6365.                  in a directory, this will let you update (or backup) all
  6366.                  those files at once, rather that one at a time as in "W",
  6367.                  above.
  6368.  
  6369.                Copy class files ("C")
  6370.  
  6371.                  This option will copy all class files that you specify to
  6372.                  new drives or directories.  This differs from update in
  6373.                  that update only copies classes that are also in the
  6374.                  second directory or drive, while copy copies them whether
  6375.                  or not they already exist in the specified directory or
  6376.                  drive.
  6377.  
  6378.  
  6379.  
  6380.  
  6381.  
  6382.  
  6383.  
  6384.                                          104
  6385.  
  6386.  
  6387.  
  6388.  
  6389.  
  6390.                                                   Other Program Features
  6391.                Move class files ("M")
  6392.  
  6393.                  Moving class files will copy the specified classes into
  6394.                  the new directory or drive, then delete them from the
  6395.                  first.  This option is useful for archiving classes after
  6396.                  the semester or year is finished.
  6397.  
  6398.                Delete class files ("D")
  6399.  
  6400.                  This option will delete all the specified class files.
  6401.                  WARNING: This option will remove whatever class files you
  6402.                  specify.  Be sure you have picked the ones you really want
  6403.                  to delete.  Note that you are asked if you are sure that
  6404.                  you want to delete those classes before the program
  6405.                  actually removes them.
  6406.  
  6407.             Write/Not write backup files ("B")
  6408.  
  6409.                Backup files are normally made of your grades.  These
  6410.                backups contain the data from the previous time that you
  6411.                saved your data.  The backup files have the same name as the
  6412.                class, but have the extensions ".DAX" and ".PAX".  NOTE: The
  6413.                appendix gives more information on these files.  No matter
  6414.                in which type of file the class data is written (read-only,
  6415.                hidden, or normal), the backup files are made normal files.
  6416.                This means that they can be deleted should you not want to
  6417.                clutter up your disk with them.  However, if you prefer not
  6418.                to have the program make backup files, you can use this
  6419.                option to prevent backups.  It is strongly recommended that
  6420.                you let back-up files be made and that you let the program
  6421.                write the class files as read-only.  The combination of
  6422.                these two options will give your data much greater security.
  6423.  
  6424.             Change class protection ("P")
  6425.  
  6426.                The class grade files are, by default, written in what is
  6427.                known as "read-only" files.  This means that if you are in
  6428.                DOS and ask that the files be deleted, they will not be
  6429.                deleted by DOS.  The program does this to prevent accidental
  6430.                deletions of the data, but this can sometimes cause problems
  6431.                with other programs, most notably some backup programs.  You
  6432.                can change the way files are written by specifying that they
  6433.                be written normally (they can be deleted by DOS), as read-
  6434.                only files, or that they be "hidden" files (DOS will not
  6435.                even list the files on a "dir" command).  Hidden files will
  6436.                still be seen by VAR Grade, but not by anyone casually
  6437.                snooping around your disk.
  6438.  
  6439.  
  6440.                                          105
  6441.  
  6442.  
  6443.  
  6444.  
  6445.  
  6446.  
  6447.           B. Running Other Programs from VAR Grade
  6448.  
  6449.             If necessary, you can use the "R" option on the Main Menu to
  6450.             run other programs from VAR Grade. This feature was put into
  6451.             the program to allow you to delete files or format disks
  6452.             without exiting the program.  These may be necessary if you run
  6453.             out of disk space before writing data to a disk file.  With
  6454.             this option, however, if you have enough memory you can run any
  6455.             program.   To remind you that you are still in VAR Grade, the
  6456.             prompt will be preceded by a message:  "To return to VAR Grade,
  6457.             type EXIT."  You should be warned that certain programs may
  6458.             cause problems.  The major problems can come from programs that
  6459.             are memory resident or that will (inadvertently) stall ("hang")
  6460.             the computer.  Because there is no reasonable way for VAR Grade
  6461.             to prevent you from running these types of programs, it is
  6462.             advised that you save your data before running programs other
  6463.             than those of the DOS operating system (del, format, dir,
  6464.             etc.).
  6465.  
  6466.             When running other programs from VAR Grade, or when choosing
  6467.             new printers or editing reports forms (see below), VAR Grade
  6468.             will try to free up as much memory as possible.  It will
  6469.             therefore try to move itself into EMS memory or onto a disk (if
  6470.             you have a hard/fixed disk), and will give a message to you as
  6471.             to what it is doing (e.g., "Swapping to disk") when it is doing
  6472.             so.  This will free up much more memory for running these other
  6473.             programs.  In fact, VAR Grade will use less than 10K of memory
  6474.             when running other programs if it is able to swap itself to
  6475.             either EMS or a hard disk.  If you do not want VAR Grade to
  6476.             swap the data in memory to a disk file, you can prevent this.
  6477.             On the Parameters Menu ("Z" on the Main Menu), you can tell the
  6478.             program not to use a disk file to save memory.
  6479.  
  6480.           C. Dates
  6481.  
  6482.             You can redefine the method of writing the date.  You can
  6483.             define dates a variety of ways, including American, Japanese,
  6484.             and European style dates.  This can be found on the "Z" option
  6485.             of the Main Menu.  These dates are used for writing data.  It
  6486.             is also used in defining attendance days.
  6487.  
  6488.           D. Video Displays
  6489.  
  6490.             VAR Grade supports all standard displays.  There are some
  6491.             points below that may help you.
  6492.  
  6493.  
  6494.  
  6495.  
  6496.                                          106
  6497.  
  6498.  
  6499.  
  6500.  
  6501.  
  6502.                                                   Other Program Features
  6503.             1. Monochrome displays
  6504.  
  6505.                Some monochrome display adapters tell programs that they are
  6506.                color boards.  This causes the program to write data to the
  6507.                screen that looks funny or unreadable.  If you have a
  6508.                monochrome board and the opening screen has a lot of
  6509.                underlined characters, there are two things you can do to
  6510.                improve the display.
  6511.  
  6512.                (a) Start the program with a switch
  6513.  
  6514.                  Instead of starting the program with "GRADE", start it
  6515.                  with "GRADE/B".  The /B is a switch that tells the program
  6516.                  that you have a black and white display.  This has to be
  6517.                  done each time you run the program.  An analogous switch,
  6518.                  "GRADE/C" will force the program into color mode.
  6519.  
  6520.                (b) Set a DOS environment variable
  6521.  
  6522.                  Rather than typing /B all the time, you can set a DOS
  6523.                  variable, instead.  Before
  6524.                  running the program, type "SET VMON=BW;".  This tells the
  6525.                  program that you have a black and white display.  The best
  6526.                  thing would be for you to set this variable in the
  6527.                  AUTOEXEC.BAT file that DOS reads when booting the
  6528.                  computer.
  6529.  
  6530.                  Example:  You can do this by typing, at the DOS prompt,
  6531.                     "COPY CON AUTOEXEC.BAT" then <Rtn>.  Then type "SET
  6532.                     VMON=BW;", then <CtrlZ>.  This will add one line to
  6533.                     your AUTOEXEC.BAT file.
  6534.  
  6535.                  Alternatively, set up a batch file that starts VAR Grade:
  6536.  
  6537.                  Example: Prepare a file called G.BAT the has the following
  6538.                  lines:
  6539.  
  6540.                     SET VMON=BW;
  6541.                     GRADE
  6542.                     SET VMON=;
  6543.  
  6544.                  This will set the variable, run the program, then remove
  6545.                  it from the environment.  Some suggested batch files for
  6546.                  use with VAR Grade are given later in this chapter.
  6547.  
  6548.  
  6549.  
  6550.  
  6551.  
  6552.                                          107
  6553.  
  6554.  
  6555.  
  6556.  
  6557.  
  6558.  
  6559.             2. EGA
  6560.  
  6561.                If you have an EGA board, you can display 43 lines on the
  6562.                screen.  Go to the "Z" option of the Main Menu, then pick
  6563.                "V".   You can pick whether to show 25 or more lines.
  6564.  
  6565.             3. VGA and Super VGA
  6566.  
  6567.                For VGA boards, you can display 50 lines.  For most super
  6568.                VGA boards, you can display even more lines.
  6569.  
  6570.                If you have a Video 7, Paradise, Orchid, or Tseng Labs Super
  6571.                VGA video adapter boards, the program will automatically
  6572.                allow you to print with 800x600 graphics.  In addition,
  6573.                super VGA boards from these companies, as well as ATI
  6574.                Technologies, Chips and Technologies, Genoa, and Trident,
  6575.                will allow you to have more than 80 characters on a line.
  6576.  
  6577.                If the program doesn't correctly recognize your board, you
  6578.                can set a DOS variable to tell the program which board you
  6579.                have.  You can have up to 132 characters per line and up to
  6580.                60 lines per screen, depending on the board.  For Video 7
  6581.                boards, type the following line (or put it in your
  6582.                AUTOEXEC.BAT file): "SET VMON=VIDEO7;".  If you have a Video
  6583.                7 board and black-and-white monitor, add the line:  "SET
  6584.                VMON=VIDEO7;BW;".  For the Orchid boards, replace "VIDEO7"
  6585.                in the above examples with "ORCHID".  For the Paradise
  6586.                boards, replace "VIDEO7" with "PARADISE", and for the Tseng
  6587.                Labs boards, replace it with "TSENG".  For Genoa boards, use
  6588.                "GENOA", for ATI Technologies, use "ATI", for Trident
  6589.                boards, use "TRIDENT", and for Chips and Technologies, use
  6590.                "CHIPS".  Many video boards from other companies use the
  6591.                chips from one of these manufacturers.  For example, EMK
  6592.                boards use the Paradise VGA chips.  NOTE: If the screen
  6593.                looks funny after changing the display, your board will not
  6594.                go into the mode you chose.  You need to set the display
  6595.                back to one that your board is capable of using by pressing
  6596.                "V" and then "1".
  6597.  
  6598.             4. Other Graphics
  6599.  
  6600.                Some video adapters are not detectable by VAR Grade.  In
  6601.                those cases, you will get funny looking plots.  To let you
  6602.                use the correct BGI driver for your adapter, an additional
  6603.                command has been added.  Type "SET BGI=x;", where x is the
  6604.                name of the BGI driver, at the DOS prompt before using the
  6605.                program.  If you need this command, you will probably want
  6606.  
  6607.  
  6608.                                          108
  6609.  
  6610.  
  6611.  
  6612.  
  6613.  
  6614.                                                   Other Program Features
  6615.                to add it to your Autoexec.bat file so that you don't have
  6616.                to type it in each time you use your computer.
  6617.  
  6618.                  Example: A> SET BGI=Herc;
  6619.  
  6620.                  This example will tell the program to use the Hercules
  6621.                  video driver (Herc.BGI).
  6622.  
  6623.                For some drivers, there is more than one option (called
  6624.                "MODE") for how to set your screen for graphics.  You can
  6625.                tell the program which mode to put the screen into by
  6626.                entering the number after the name of the BGI driver.
  6627.  
  6628.                  Example: A> SET BGI=VGA16 8;
  6629.  
  6630.                  This example will tell the program to use the VGA16 video
  6631.                  driver (VGA16.BGI), and set the screen mode to mode 8 (for
  6632.                  Video7 800x600 mode).
  6633.  
  6634.                The VGA16.BGI file (written by John Sieraski) is currently
  6635.                the only driver that needs to be set at different modes for
  6636.                different video adapters.  Note that if your display is
  6637.                compatible with modes 4 through 9, VAR Grade should
  6638.                automatically use the 800x600 mode.  The VGA16 modes are as
  6639.                follows:
  6640.  
  6641.                VGA16 Mode     Description    Screen Resolution
  6642.                    0          EGA/VGA             320x200
  6643.                    1          EGA/VGA             640x200
  6644.                    2          EGA/VGA             640x350
  6645.                    3          VGA                 640x480
  6646.                    4          ATI VGA             800x600
  6647.                    5          Orchid VGA          800x600
  6648.                    6          Paradise VGA        800x600
  6649.                    7          VEGA VGA            800x600
  6650.                    8          Video7 VGA          800x600
  6651.                    9          SOTA VGA-16         800x600
  6652.  
  6653.           E. GrUtil.Exe
  6654.  
  6655.             If you want a simple way to print empty grids for entering
  6656.             student grades or to load students from text files into a
  6657.             class, you can either use VAR Grade or GrUtil.  GrUtil can be
  6658.             used as a batch file or you can use VAR Grade, and follow the
  6659.             directions. Batch files can be set up for your standard grid
  6660.             and loading conditions.
  6661.  
  6662.  
  6663.  
  6664.                                          109
  6665.  
  6666.  
  6667.  
  6668.  
  6669.  
  6670.  
  6671.             1. Writing grids with GrUtil
  6672.  
  6673.                Grids are lists of student names and empty cells for
  6674.                entering scores.  The program needs to know the name of the
  6675.                text file of students, the name of the class, and whether to
  6676.                print names, IDs, or both.  The syntax is as follows:  Start
  6677.                the program with "GrUtil", then put the classname on the
  6678.                command line, followed by the word GRID (in upper or lower
  6679.                case).  If you want to print IDs (I) or both names and IDs
  6680.                (B), put the appropriate letter after GRID.
  6681.  
  6682.                Examples ("A>" is the MS-DOS prompt):
  6683.  
  6684.                     A> GRUTIL Classname GRID
  6685.  
  6686.                Prints names and a grid for the students in Classname.
  6687.  
  6688.                     A> GRUTIL Classname GRID B
  6689.  
  6690.                Prints names AND IDs and a grid for students in Classname.
  6691.  
  6692.                Classname is any VAR Grade class.  Attendance grids, which
  6693.                have twice as many boxes as regular grids, can be printed by
  6694.                using "AGRID" instead of "GRID".
  6695.  
  6696.             2. Loading students with GrUtil
  6697.  
  6698.                Section D of Chapter VI, Entering Students, explains how VAR
  6699.                Grade can be used to enter student data into the class.  You
  6700.                can do the same types of imports with GrUtil.  However,
  6701.                GrUtil runs as a batch file.  Batch files require no
  6702.                keyboard input from you.  Preparation of the files is the
  6703.                same as described above.
  6704.  
  6705.                (i)   Pick the name of the file that has the student names.
  6706.                  The file should be a text file of one student per line.
  6707.                  The names and IDs can be anywhere on the line, and
  6708.                  extraneous characters won't interfere with this utility.
  6709.                  Ideally, all lines in the text file not containing
  6710.                  students should be removed.
  6711.  
  6712.                (ii)  If the file is a comma and quote file, type the
  6713.                  following:
  6714.  
  6715.                     A> GRUTIL Classname CommaFile COMMA
  6716.  
  6717.  
  6718.  
  6719.  
  6720.                                          110
  6721.  
  6722.  
  6723.  
  6724.  
  6725.  
  6726.                                                   Other Program Features
  6727.                  Classname is the name of the class in which to add the new
  6728.                  students.  CommaFile is the full name (with extension) of
  6729.                  the comma and quote file.
  6730.  
  6731.                (iii)  If the file is a flat file, type one of the
  6732.                  following:
  6733.  
  6734.                     A> GRUTIL Classname FlatFile
  6735.                          or
  6736.                     A> GRUTIL Classname FlatFile # # # # # # # #
  6737.  
  6738.                  Classname is the name of the class in which to add the new
  6739.                  students.  Flatfile is the full name (with extension) of
  6740.                  the flat file.  You can add up to eight numbers.  The
  6741.                  first two are the beginning and ending columns of the
  6742.                  Names.  The next two are the beginning and ending of the
  6743.                  IDs, the next two are the beginning and ending of notes,
  6744.                  and the last two are the beginning and ending of the
  6745.                  sections.  If no numbers are there, or if one of the first
  6746.                  two numbers is 0, GrUtil tries to make sense of the data,
  6747.                  with the same method that VAR Grade uses when
  6748.                  automatically importing flat files.  Otherwise, GrUtil
  6749.                  uses the columns you have specified to load the names,
  6750.                  IDs, and sections.  A zero in the beginning of the IDs or
  6751.                  sections tells GrUtil that no IDs or sections are in the
  6752.                  file.
  6753.  
  6754.                  Examples ("A>" is the MS-DOS prompt):
  6755.  
  6756.                     A> GRUTIL Classname Flatfile 1 20 22 36
  6757.  
  6758.                  Loads names from Flatfile into section 1 of class.  The
  6759.                  names start at character 1 and end at 20, the IDs start at
  6760.                  22 and end at 36.
  6761.  
  6762.                     A> GRUTIL Classname Flatfile 1 10 0
  6763.  
  6764.                  Loads names from Flatfile into section 1 of classname.
  6765.                  The names start at character 1 and end at 10, the IDs
  6766.                  start at 0, hence do not exist.
  6767.  
  6768.                     A> GRUTIL Classname Flatfile 21 35 1 15 16 18
  6769.  
  6770.                  Loads names from Flatfile into sections found in
  6771.                  characters 16 to 18 of classname.  The names start at
  6772.                  character 21 and end at 35, the IDs start at character 1
  6773.                  and end at 15.
  6774.  
  6775.  
  6776.                                          111
  6777.  
  6778.  
  6779.  
  6780.  
  6781.  
  6782.  
  6783.           F. Examples of VAR Grade Batch Files
  6784.  
  6785.             If you are familiar with MS-DOS, the following are examples of
  6786.             how to set up batch files to do what you want with VAR Grade.
  6787.             For all the examples, it is assumed that you are using MS-DOS
  6788.             3.0 or later, and that the program is in the directory
  6789.             C:\VARGRADE.  Classname is a name of any valid VAR Grade class.
  6790.  
  6791.             Preparing Batch files:
  6792.  
  6793.                The easiest way to prepare the following files is to use a
  6794.                word processor that will write the data to disk files in
  6795.                ASCII format.
  6796.  
  6797.                To prepare the batch files from MS-DOS, type the following
  6798.                (A> is the DOS prompt, the material between the [], below,
  6799.                tells you what to do):
  6800.  
  6801.                     A> COPY CON batchfilename<Rtn>
  6802.                     [type in one of the batch files listed below]
  6803.                     <CtrlZ>  [simultaneously press the <Ctrl> key and "Z"]
  6804.                     A>
  6805.  
  6806.             GR.BAT:  Batch file to run VAR Grade from any directory.  Put
  6807.                it in your directory where DOS is, or in one specified by
  6808.                the PATH command.  Start it from DOS by typing "GR
  6809.                Classname".
  6810.  
  6811.                @ECHO OFF
  6812.                @REM CALL WITH "GR Classname"
  6813.                IF %1Z == Z GOTO ERR
  6814.                SET LASTPATH=%PATH%
  6815.                SET PATH=C:\VARGRADE;%PATH%
  6816.                C:\VARGRADE\GRADE %1
  6817.                SET PATH=%LASTPATH%
  6818.                GOTO END
  6819.                :ERR
  6820.                ECHO ERROR! RUN GR WITH:  "GR Classname"
  6821.                :END
  6822.  
  6823.  
  6824.  
  6825.  
  6826.  
  6827.  
  6828.  
  6829.  
  6830.  
  6831.  
  6832.                                          112
  6833.  
  6834.  
  6835.  
  6836.  
  6837.  
  6838.                                                   Other Program Features
  6839.             You may want to add parts of some of the following batch files
  6840.             to GR.BAT to fit your needs.
  6841.  
  6842.                GM.BAT: Batch file if you have a monochrome monitor.  Put it
  6843.                  in your directory where DOS is, or in one specified by the
  6844.                  PATH command.  Start it from DOS by typing "GM Classname".
  6845.  
  6846.                  SET VMON=BW;
  6847.                  C:\VARGRADE\GRADE %1
  6848.  
  6849.                GMin.BAT: Batch file to reduce the memory used by VAR Grade.
  6850.                  Put it in your directory where DOS is, or in one specified
  6851.                  by the PATH command.  Start it from DOS by typing "GMin
  6852.                  Classname".
  6853.  
  6854.                  SET OMEM=0;
  6855.                  C:\VARGRADE\GRADE %1
  6856.  
  6857.                GMax.BAT:  Batch file to increase the memory used by VAR
  6858.                  Grade, thereby reducing the disk accesses, and increasing
  6859.                  the speed of parts of the program.  Put it in your
  6860.                  directory where DOS is, or in one specified by the PATH
  6861.                  command.  Start it from DOS by typing "GMem Classname".
  6862.  
  6863.                  SET OMEM=250000;
  6864.                  C:\VARGRADE\GRADE %1
  6865.  
  6866.                GRID.BAT:  Batch file to print grids of any class.  Put it
  6867.                  in your directory where DOS is, or in one specified by the
  6868.                  PATH command.  Start it from DOS by typing "GRID
  6869.                  Classname".
  6870.  
  6871.                  @ECHO OFF
  6872.                  @REM CALL WITH "GRID Classname"
  6873.                  @REM WRITES AN EMPTY GRID FOR DATA ENTRY IN CLASSNAME
  6874.                  IF %1Z == Z GOTO ERR
  6875.                  GRUTIL %1 GRID
  6876.                  GOTO END
  6877.                  :ERR
  6878.                  ECHO ERROR! RUN GRID WITH:  "GRID Classname"
  6879.                  :END
  6880.  
  6881.  
  6882.  
  6883.  
  6884.  
  6885.  
  6886.  
  6887.  
  6888.                                          113
  6889.  
  6890.  
  6891.  
  6892.  
  6893.  
  6894.  
  6895.                LOAD.BAT:  Batch file to load students from a flat file into
  6896.                  VAR Grade.  The example below uses numbers for the
  6897.                  starting and ending positions of the names and IDs.  These
  6898.                  are examples.  Your file will probably have different
  6899.                  starting and ending positions for the data.  Start it from
  6900.                  DOS by typing "LOAD Classname".
  6901.  
  6902.                  @ECHO OFF
  6903.                  @REM CALL WITH "LOAD Classname Flatfile.ext"
  6904.                  @REM READS FLATFILE OF NAMES INTO SECTION 1 OF CLASSNAME
  6905.                  IF %1Z == Z GOTO ERR
  6906.                  IF %2Z == Z GOTO ERR
  6907.                  GRUTIL %1 %2 1 20 25 39
  6908.                  GOTO END
  6909.                  :ERR
  6910.                  ECHO ERROR! RUN LOAD WITH:  "LOAD Classname Flatfile.ext"
  6911.                  :END
  6912.  
  6913.  
  6914.  
  6915.  
  6916.  
  6917.  
  6918.  
  6919.  
  6920.  
  6921.  
  6922.  
  6923.  
  6924.  
  6925.  
  6926.  
  6927.  
  6928.  
  6929.  
  6930.  
  6931.  
  6932.  
  6933.  
  6934.  
  6935.  
  6936.  
  6937.  
  6938.  
  6939.  
  6940.  
  6941.  
  6942.  
  6943.  
  6944.                                          114
  6945.  
  6946.  
  6947.  
  6948.  
  6949.  
  6950.                                                                 Appendix
  6951.  
  6952.  
  6953.                                    XIII. APPENDIX
  6954.  
  6955.  
  6956.  
  6957.  
  6958.           A. Program Parameters--Defaults and Limits
  6959.  
  6960.             The default values are those that are there when the program
  6961.             starts.
  6962.  
  6963.             Parameter                      Default         Maximum
  6964.  
  6965.             Students                             0           16000
  6966.             Sections                             1             250
  6967.             Tasks (total)                        0            2000
  6968.             Total points for a number task       0         1000000
  6969.             Total points per sum task            0         9999999
  6970.             Attendance Days                      0             240
  6971.             Backups made                       Yes               -
  6972.             Password used                       No               -
  6973.  
  6974.             Printing--default values (modifiable):
  6975.  
  6976.             Lines per page                      60           30000
  6977.             Characters per line                 80             255
  6978.             Type size                         Pica
  6979.             Type quality                     Draft
  6980.             Line spacing                    Single
  6981.             Left margin                          0
  6982.             Lines in header                      5
  6983.             Lines in the footer                  5
  6984.             Page numbers printed               Yes
  6985.  
  6986.           B. Backup Files
  6987.  
  6988.  
  6989.             1. Preventing Data Loss
  6990.  
  6991.                It is very important to prevent data from being lost.  There
  6992.                are several things that the program does to prevent this
  6993.                loss.
  6994.  
  6995.                1. You cannot exit the program without telling it whether
  6996.                  you want your data saved.
  6997.  
  6998.  
  6999.  
  7000.                                          115
  7001.  
  7002.  
  7003.  
  7004.  
  7005.  
  7006.  
  7007.                2. You cannot accidentally exit the program (e.g. disk drive
  7008.                  door open, printer not turned on), except from a power
  7009.                  failure or by rebooting the computer.
  7010.  
  7011.                3. Files are written in read-only format by default.  You
  7012.                  cannot delete or erase these files in DOS.  The default
  7013.                  can be changed to "normal" (if you do not fear deleting
  7014.                  your class grades), or "hidden".
  7015.  
  7016.                4. When files are written to disk, the program checks to
  7017.                  make sure the files were written with the correct size
  7018.                  (hence were probably correctly written).
  7019.  
  7020.                5. When files are written to disk, the previous class data
  7021.                  is turned into backup files.  The file CLASSNAME.PAR is
  7022.                  changed to CLASSNAME.PAX.  The file CLASSNAME.DAT is
  7023.                  changed to CLASSNAME.DAX.  These backup files are not
  7024.                  read-only, and can be deleted by DOS.  Should you want to
  7025.                  delete old class files, use the DOS 3.x command Attrib to
  7026.                  change the file attribute to "normal", then delete the
  7027.                  file.
  7028.  
  7029.                  Example, type:
  7030.  
  7031.                     A> ATTRIB -RH CLASSNAME.*
  7032.                     A> DEL CLASSNAME.*
  7033.  
  7034.                  You can tell the program to stop making backup files, but
  7035.                  we recommend that you do this only if disk space is at a
  7036.                  premium.
  7037.  
  7038.                6. If a fatal error occurs during program execution, VAR
  7039.                  Grade will try to save any new data put into the program.
  7040.                  Its success depends upon the nature of the fatal error.  A
  7041.                  fatal error is one that prevents the program from
  7042.                  executing correctly.  Although great care has been taken
  7043.                  to prevent such errors, they may still occur.  Therefore,
  7044.                  it is suggested that you immediately save your data to
  7045.                  disk when you have entered new data.  It is also
  7046.                  recommended that you also print the data on your printer
  7047.                  to have another copy of it.
  7048.  
  7049.             2. Recovering Old Data
  7050.  
  7051.                To recover the information in the backup files, you must
  7052.                first exit VAR Grade.  When in DOS, rename them so that the
  7053.                file that ends in ".PAX" ends in ".PAR" and the file that
  7054.  
  7055.  
  7056.                                          116
  7057.  
  7058.  
  7059.  
  7060.  
  7061.  
  7062.                                                                 Appendix
  7063.                ends in ".DAX" ends in ".DAT".  Both files must have the
  7064.                same classname.  At the MS-DOS prompts (A>), type:
  7065.  
  7066.                     A>  RENAME ACLASS.PAX ACLASS2.PAR
  7067.                     A>  RENAME ACLASS.DAX ACLASS2.DAT
  7068.  
  7069.                ACLASS2 will have the data from the PREVIOUS update of the
  7070.                data--NOT the most recent update.
  7071.  
  7072.           C. Beeps or Noises
  7073.  
  7074.             If the computer beeps or makes a noise, there are two possible
  7075.             reasons.  First, you could have entered a number too high or
  7076.             low for the task.  This warning can either be changed to a
  7077.             louder pitch or turned off in the "Z" section of the Main Menu.
  7078.             Second, the memory may be quite low, so that the information in
  7079.             a screen window could not be saved.  When the current window is
  7080.             finished, it probably will not be able to redraw the underlying
  7081.             window correctly.  Pressing <AltR> will usually redraw the
  7082.             screen.  The program should run correctly when memory is low;
  7083.             however, not all students, tasks, or attendance days may be
  7084.             listed when memory is low.  If you get one beep, more will
  7085.             probably occur due to the limited memory.  Since memory is low,
  7086.             you should probably exit the program, free up some memory, and
  7087.             then re-run VAR Grade.
  7088.  
  7089.             One way to free up memory is by setting a MS-DOS variable
  7090.             OMEM=0, then reentering the program.
  7091.  
  7092.             Example:  At the DOS prompt (A>), type:
  7093.  
  7094.                A> SET OMEM=0;
  7095.  
  7096.           D. Menus
  7097.  
  7098.             The following is a list of the major Menus in VAR Grade.  They
  7099.             are arranged in a hierarchy, so an indent is one menu down in
  7100.             the hierarchy.
  7101.  
  7102.             Add Names Menu                     Add Names Menu (cont)
  7103.                Type in names                      Move section
  7104.                Type in names and IDs              Delete section
  7105.                Import flat files                  Delete all students
  7106.                Import flat files               Individual Task Form
  7107.                  automatically                 Student Task Form
  7108.                Import comma and quote          Task Type Menu
  7109.                  files
  7110.                Import one task
  7111.  
  7112.                                          117
  7113.  
  7114.  
  7115.  
  7116.  
  7117.  
  7118.  
  7119.             Attendance Menu                    Plot Menu (cont)
  7120.                Student Attendance Form            Correlate two tests with
  7121.                Individual Attendance                3D bars
  7122.                  Form                             Plot class statistics
  7123.                Define new attendance              Plot an individual versus
  7124.                  dates                              class statistics
  7125.                Default Attendance Task            Change fonts
  7126.                  Values                        Grading Menu
  7127.                Attendance defaults                Assign grades
  7128.             Save Class Data                       Plot and assign grades
  7129.             File Maintainance                     Plot with 3D bars and
  7130.                Alter class file name                assign grades
  7131.                Write backup file                  Scale tasks
  7132.                Rename classes                     Assign T-scores
  7133.                Update classes                     Assign standard
  7134.                Copy classes                         deviations
  7135.                Move classes                       Change grade names
  7136.                Delete classes                     Assign cutoffs
  7137.                File protection                    Remove cutoffs
  7138.                Toggle backups                     Adjust statistics for a
  7139.             Write Data Menu                         task
  7140.                Print by section                   Delete adjustments of
  7141.                Print by name                        statistics
  7142.                Pick tasks, list by name           Set the fewest allowed
  7143.                Print grids                          points
  7144.                Print attendance grids          Parameters Menu
  7145.                Write individual reports           Time and dates
  7146.                Write class reports                Video display lines
  7147.                Edit reports                       Color
  7148.                Designate editor                   Passwords
  7149.                Export quote and comma             Beep on input error
  7150.                  file                             Class name
  7151.                Export flat file                   Decimal places
  7152.                Export byte file                   Printer Menu
  7153.                Help                                 Pick a new printer
  7154.             Manual                                  Set user defined line
  7155.             Plot Menu                                 codes
  7156.                Plot the scores in 2D                Line printer codes
  7157.                  bars                               Set character size
  7158.                Plot the scores in 3D                Set print quality
  7159.                  bars                               Set the printer port
  7160.                List students on a task              Page and line settings
  7161.                  (no plot)                        Sorting
  7162.                Plot individual trends in          Default sections
  7163.                  2D bars                          Numbers of sections
  7164.                Plot individual trends in       DOS shell
  7165.                  3D bars                       Quit the class
  7166.                Correlate two tests             Get another class
  7167.  
  7168.                                          118
  7169.  
  7170.  
  7171.  
  7172.  
  7173.  
  7174.                                                                 Glossary
  7175.  
  7176.  
  7177.                                     XIV. GLOSSARY
  7178.  
  7179.  
  7180.  
  7181.           Archive             Files that have been compressed so that they
  7182.                               take up less space on the disk.  They need to
  7183.                               be unarchived to be used.
  7184.  
  7185.           ASCII               A standard code that translates normal
  7186.                               characters and symbols into 7 bit binary
  7187.                               computer code.
  7188.  
  7189.           Autoexec.BAT        When you start your computer, it looks for
  7190.                               this file to get information about the
  7191.                               operating environment.
  7192.  
  7193.           Bars                Squares used to depict student scores in the
  7194.                               plots.  They can look two dimensional or
  7195.                               three dimensional.
  7196.  
  7197.           Batch               One of three types of files that MS-DOS can
  7198.                               execute.  Batch files are written in ASCII
  7199.                               characters, with each line telling MS-DOS
  7200.                               what to do.
  7201.  
  7202.           Cell                A highlighted area of the screen that holds
  7203.                               one piece of data.
  7204.  
  7205.           Comma & Quote Files Files that have strings of characters between
  7206.                               double quotes (""), and commas separating
  7207.                               pieces of data.  Numbers are separated only
  7208.                               by commas.
  7209.  
  7210.           Cursor Keys         Keys that move the position of the cursor on
  7211.                               the screen.  They include the arrow keys, the
  7212.                               home, end, page up, and page down keys.
  7213.  
  7214.           Default             The value when the program starts.
  7215.  
  7216.           Directory           Group of files on a disk.   Files on hard
  7217.                               disks are usually grouped together in
  7218.                               directories to make it easier to find the
  7219.                               file you need.  Drives are also directories.
  7220.  
  7221.  
  7222.  
  7223.  
  7224.                                          119
  7225.  
  7226.  
  7227.  
  7228.  
  7229.  
  7230.  
  7231.           Display Adapter     A card in the computer that controls the
  7232.                               monitor.  It can be a Hercules card, CGA,
  7233.                               EGA, or VGA card, as well as other cards.
  7234.  
  7235.           Edit Keys           When edit keys are used, the left and right
  7236.                               arrow cursor keys move within a cell instead
  7237.                               of between cells, and the home and end keys
  7238.                               move to the beginning and end of the cell.
  7239.                               To "use" edit keys means that you can use the
  7240.                               left and right arrow, home, and end keys to
  7241.                               move around a cell.  To move between cells
  7242.                               when "using" edit keys, you need to use
  7243.                               <Ctrl>-arrow keys.
  7244.  
  7245.           EMS memory          Memory above 640K.  If you have 1 megabyte or
  7246.                               more memory and a program that can map this
  7247.                               memory for DOS commands, like EMM.SYS or
  7248.                               EMM386.SYS, programs like VAR Grade can make
  7249.                               use of this memory.
  7250.  
  7251.           Fixed Disk          A disk that cannot be removed from the
  7252.                               computer.
  7253.  
  7254.           Flat Files          Files that have data in columns, separated by
  7255.                               spaces.
  7256.  
  7257.           Floppy Disk         A disk that can be removed from a drive.
  7258.  
  7259.           Hard Disk           A disk that cannot be removed from the
  7260.                               computer.
  7261.  
  7262.           Install             Put the files needed by a program onto new
  7263.                               disks such that the new disks have the
  7264.                               program files in the places needed by that
  7265.                               program.
  7266.  
  7267.           Line Printer        A printer that prints non-graphics
  7268.                               characters.  All printers are line printers.
  7269.  
  7270.           Main Menu           The menu that lists the major sections of the
  7271.                               program.
  7272.  
  7273.  
  7274.           Menu-driven         Uses menus to let you reach all parts and
  7275.                               features of the program.
  7276.  
  7277.           Monochrome          Black and white.
  7278.  
  7279.  
  7280.                                          120
  7281.  
  7282.  
  7283.  
  7284.  
  7285.  
  7286.                                                                 Glossary
  7287.           Overlay             The part of the program that is in memory
  7288.                               only when needed.  It is read in from a disk
  7289.                               when it is needed.
  7290.  
  7291.           Path                A list of directories that tells MS-DOS where
  7292.                               executable programs are.  The path is set by
  7293.                               typing "SET PATH=directory1;directory2;" at
  7294.                               the DOS prompt, where directory1 and
  7295.                               directory2, etc., are names of directories.
  7296.  
  7297.           Ports               Printers are connected to either serial or
  7298.                               parallel cards in your computer.  Each card
  7299.                               has a different designation for its address.
  7300.                               These addresses are the ports.
  7301.  
  7302.           Printer Codes       Codes sent to the printer to control how it
  7303.                               prints data.
  7304.  
  7305.           Regular tasks       Those tasks that you can put in new data.
  7306.                               They are the number, letter, and extra credit
  7307.                               tasks.
  7308.  
  7309.           Special keys        Special keys are those that do not print
  7310.                               normal (ASCII) keys.  The function keys (<F1>
  7311.                               through <F10>), the <Alt>, <Ctrl>, <Ins>,
  7312.                               <Del>, and the cursor keys.
  7313.  
  7314.           Special tasks       Those tasks that are calculated by the
  7315.                               program.  You cannot put in new scores into
  7316.                               these tasks.
  7317.  
  7318.           Task                A graded assignment for the class.
  7319.  
  7320.           Toggle              Turn on and off.
  7321.  
  7322.           Wildcard            The characters * and ? are used by MS-DOS to
  7323.                               match more than one character, as a wild
  7324.                               card, when playing cards, can match any other
  7325.                               card.
  7326.  
  7327.  
  7328.  
  7329.  
  7330.  
  7331.  
  7332.  
  7333.  
  7334.  
  7335.  
  7336.                                          121
  7337.