3-21-89

Please register so we may send you information about update,
corrections and enhancements. 

Note:this version will not produce graphics on Hercules-type 
monitors.  However, there are some inexpensive programs such 
as SIMCGA that will allow you to simulate CGA graphics on 
your Hercules monitor, and will thus allow you to use the 
graphic capabilities of this program. 

Before beginning to use PC-CAI, please be sure to run the 
CAI-UTIL program to set up default drives, colors, and 
other options for the editor and for CREATE.

ADDITIONAL COMMAND ADDED:

The .RECORD command has been added to allow you to record 
answers.  Its format is as follows:

.RECORD (*TEXT*) FILE=outfilename

Within the TEXT field, you may use (.INF #) to record any
information you have previously gathered with the .INF 
command, and use (.) to record the last answer entered by 
the user.  For example, the .RECORD command may be:

.RECORD (*(.INF 1) answered (.) to Question 1*) FILE=GRADE.OUT

See example below:

A related command to use with the .RECORD command is the
GRADE option in the @STOP command.  Here is an example of 
how it works along with the .RECORD command. Suppose you
have a tutorial as listed below: (it is on disk as 
TESTGRA.CAI): 
---------------------------------------------------------- 
.cls
.INF 1 (*Please enter your name:*)

@BEGIN
@TRIES 3
This is a test question, (.INF 1)

@READ(*Who invented the telephone?*)
@RIGHT (*BELL*) nocase keyword

That is correct!!!
.RECORD (*(.INF 1):TELEPHONE ANSWER:RIGHT:(.)*) FILE=GRADE.OUT

@WRONG

Try again
.RECORD (*(.INF 1):TELEPHONE ANSWER:WRONG:(.)*) FILE=GRADE.OUT

@WRONG FINAL

The answer is Alexander Graham Bell

@end question
@stop grade file=GRADE.OUT screen
----------------------------------------------------------  

Notice the .RECORD statements and the @STOP statment.  The 
.RECORD statement causes information to be written to the
file GRADE.OUT recording the specific right and wrong 
answers as they are given.  The @STOP command causes summary 
information to also be output to the file GRADE.OUT. 

Suppose you ran this tutorial.  The person's name running 
it is Watson (stored in (.INF 1)).  Watson answers "Edison"
the first time the question is asked (wrong), the second 
time they answer "Bell" (right).  The tutorial would end, 
and the following message would appear on the screen: 

1  Questions asked

You answered 1 correctly
Your percentage score is 100 %

In the file GRADE.OUT, the following information would
have been recorded:

Watson:TELEPHONE ANSWER:WRONG:Edison
Watson:TELEPHONE ANSWER:RIGHT:Bell
Watson
Q#: 1 TRY: 2 

The first two lines record the specific answers given by
"Watson".  These lines were caused by the .RECORD command. 
The 3rd and 4th lines are a result of the GRADE option in 
the @STOP command.  First, a list of all (.INF) information 
is recorded.  In this case, only one INF -- Watson. Then 
each question is summarized.  The Q# means the questions 
number.  The TRY: records which try the question was answere 
correctly (second time in this case). If it was never 
answered correctly, TRY will be 0.
ich try the question was answere 
correctly (second time in this case). If it was never 
answe