Return to s-guidedtour.tex CVS log

Up to [LON-CAPA] / capa / capa51 / Manual

- added the manual

%
%
%******************************************************************************
% Guided Tour
%*******************************************************************************
\newpage
\hrule 
\vskip 0.2in
%{{\noindent \bf \it \LARGE Section 4: Guided Tour of the \capa\ v. 5.0 System }}
\section{Guided Tour of the \capa\ System }
\vskip 0.2in
\hrule 
\vskip 0.2in
\noindent This section presents a guided tour through the \capa\ software system by relying on the files that are part of the
distribution package.  This tour assumes that the user is logged in as 
``teacher'' and owns the {\sl nsc121s9} class directory.  If you do not have
permission to login as ``teacher'', you will be unable to complete sections of 
the tour which involve writing files to the ``teacher'' owned directories 
(i.e. creating {\sl .db} headers and {\sl .dvi} files, printing, generating class records, etc.).
\footnote{\fbox{Boxed} items denote Clicking on a Menu selection}
  
\begin{enumerate}
\item {\bf  Guided Tour of {\sf Quizzer}} \hfil
\epsffile{figures/quizzer50.ps} \label{GQuizzer}

	\begin{itemize}
	\item Instructions for running the {\sf Quizzer} application:
		\begin{itemize}
		\item Prior to opening the {\sf Quizzer} application,  set up your X-server software to
		interact with your server.  See the section on using \capa\ via
		eXceed, X-win32 or MacX.
	\item Through your X-server software, open an rlogin (or telnet)
		session to your server.			
		\item Start the application by entering the command {\sf
		Quizzer} at the prompt.
		\end{itemize}
	\item Select the Source of the problem set. 
		\begin{itemize}
		\item The {\sf Quizzer} main menu will be placed in the upper
		left corner of your screen.
		\item Select \fbox{File}, then \fbox{Open}.
		\item A pop-up screen displaying your
		current directory will allow you to browse. 
		The file filter, which for quizzer will read {\sl *.qz},
		selects only {\sl setx.qz} files  for editing with the {\sf Quizzer} application.
		
\item In this pop-up screen, open the \fbox{CAPA5} directory.
\item Find and select the sample class file \fbox{nsc121s9}.
		\item Open the \fbox{set1.qz} file.  ({\sl set1.qz}
		is identical to the Set of Sample Problems in
		this manual).  
		\item The contents of this file will show up in  
		{\sf Quizzer's} editing window.  
		Browse through the contents of this question file. Be careful
		not to make any changes at this time, or at least {\bf not} 
		to Save any changes.  If you think you did accidently make changes, choose \fbox{Quit} from the main menu and click \fbox{No} if you are asked to save. 
		\item Click on a highlighted imported file.  A reference file pops up in a new window.  Close this window by choosing \fbox{File} then \fbox
{Close}.  A dialog box will appear to confirm your selection.
		\item You may wish to use the \fbox{Save As...} under \fbox{File} in the menu option and save the set as {\sl set99.qz}, then close it and open {\sl set1.qz} again.
		\item If you make an inadvertent change or
		if you are not sure of a change, then just \fbox{Quit} the {\sf
		Quizzer} application without saving and restart it by entering the command {\sf Quizzer}.
		\end {itemize}
	\item Preview the example question file in enscript mode.
		\begin {itemize}
		\item Choose \fbox{Enscript} mode button from the options at the top of the
		{\sf Quizzer} edit window.
		\item Click the \fbox{Preview} button.  A dialog window will
		appear to ask you to select a specific 
		student from the class list.  The choice may be made by randomly
		selecting a student from a specified section or by entering the 
                student number of a particular student in the class.
		    \item Before previewing, click \fbox{File} in the menu and select \fbox{Open Reference File...}. Find and open the \fbox{classl} file in the {\sl nsc121s9} folder.  You will see all the students in the class, including ``Student Jamie .'' Select \fbox{Close} under the \fbox{File} menu in the {\sl classl} 
file window.
		\item Select the random-selection button and click \fbox{Preview}. 
		\item Note: To  select a specific student, first, click  the
		\fbox{Preview} button, select \fbox{Specify the student by}, and then enter the 
		Student Number {\tt A87654321} into the text entry panel {\em
		followed by a carriage return}. If the Student 
		number is not in the class list file  ({\sl
		teacher/CAPA5/nsc121s9/classl}) an error message is returned.
		\item A preview window will appear. This window displays the
		text 
		from the translated question file as it would be presented to
		the students during a terminal session.  
		The instructor can use this display to determine if the coding
		is correct and if the presentation on the 
		remote terminal  will be adequate.  
		\item If any changes  have been made to 
		the {\sl set1.qz} file in the editor, {\sf Quizzer} will ask you to
		save the file. {\bf Don't} save the
		file at this point unless you are absolutely sure that the file
		has not been damaged, instead select \fbox{Cancel}, 
		\fbox{Quit} {\sf Quizzer}, answer \fbox{No} if asked to save, and start again.
		\end {itemize}
		\item Close the preview window by clicking on the \fbox{Dismiss}
		button at the top of the window.
	\item Preview the example question file in \TeX\  mode.
		\begin {itemize}
		\item Change the {\bf Mode} of the preview output by clicking on
		the \fbox{TeX} mode button on the upper part 
		of edit window and then click the \fbox{Preview} button as
		before. 
		\item Select a particular student, this time type the student
		number {\tt A87654321} into the text panel, 
		then $<$return$>$, select the \fbox{Specify the student by} button, and click \fbox{Preview}. 
		\item  The preview window will
		display the contents of the 
		{\sl nsc121s9/quiztemp.tex}  file that will be used later by
		\LaTeX\ to typeset the problem set for the 
		selected  student, in this case ``Jamie Student''. 
		\item Click on \fbox{Dismiss} to close this window.
		\end {itemize}
		\item Preview the set of sample problems in Web mode similar to how enscript and \TeX\ modes were viewed. 
			\begin{itemize}
			\item This mode will generate a preview window displaying
			the web specific version of your source file.  (This is not
			the complete {\sl .html} file.) 
			\end{itemize}
	\item Specify the date limits in the database header. 
		\begin {itemize}
		\item The database header (DB header) for {\sl set1.qz} is present
		from the distribution.  However, you can 
		bring up a window to modify that information by clicking on the
		\fbox{DB Header} button at the top of the 
		main edit window.  {\bf Note}:  You must preview the set 
		in enscript prior  to
		setting or changing the DB Header information.  (We have already done this.)  
		Three dates and times must be set:
			\begin{enumerate}
			\item {\bf Open date/time}: when the students can begin
			to enter answers to this problem set.
			\item {\bf Due date/time}: the time by which students
			must finish entering answers and properly 
			log out of \capa, i.e., when all answer-recording stops.
			\item {\bf Answer date/time}: when the answers to the
			problems will be made available to the 
			students.  This should be {\em after} the Due
			date/time.
			\end{enumerate}
		
		\item Use  \fbox{Load} to view the current values for
		this problem set.  If the values were not present in the 
		{\sl set1.db} file, you would have recieved a warning.   
		\item Setting the DB Header is necessary for each new problem
		set before students log in.  
		Without the proper date information, students will not be
		allowed to enter their answers.  
			\begin{enumerate}
			\item The database header may be set as the number of problems change, but it {\em must} be
			set  {\em after} the number of problems in the set is 
			finalized, otherwise serious errors in the grade records
			will occur.  If you have found it
			necessary to make major changes in your source file,
			such as changing the problem value or
			the grading option to hand graded ({\tt hgr=on} inside 
			the {\tt /ANS()} command)
			be certain to reset the DB Header prior to
			printing the final version for distribution to your
			students.
			\item  Once  the
			problem sets have been distributed to students and students begin logging in, 
			do {\em not} change the number of problems in the set
			and reset the database header.  
			\end{enumerate}
		\item The dates and times must be entered with the numerical
		format of {\tt YYYY/MM/DD} and {\tt HH:MM} on the appropriate
		lines.  The hours of the day are based on a 24 hour clock.
		\item You can specify different dates for different sections.  Click on \fbox{Add} and add different due dates for section 1.  You can also choose to get the default dates for section 1.  
		\item In the ``adddate'' window, click on \fbox{More Options}.  You can then add a duration time in hours and minutes.  This lets the student choose their own due date.  Once the students log in, they only have the set duration of time to work one the set (such as on a take home quiz).  You also have the choice to give your students no feedback by inhibiting correct/incorrect responces.  Click \fbox{Cancel} to not change any of the options.
		\item The ``Creating DB Header'' window also has a cancel button to exit the window without
		changing the dates already present in the records folder.
		Close the ``db Header'' window by selecting \fbox{Cancel}.
		\end{itemize}
	\item Viewing the file as it will be printed. 
		\begin {itemize}
		\item  
		Select \fbox{Create .dvi} from the main {\sf Quizzer} menu.  
		(The creation of a {\sl *.dvi file} is a necessary 
		step before printing any \TeX\ document.) There are no {\sf
		Quizzer} errors in the {\sl set1.qz} file, and
		{\sf Quizzer} will generate a file called {\sl
		quiztemp.tex} 
		\item  You will
		again be prompted to select either a random student or a
		specific student determined by student number.  Make your choice, then click \fbox{Preview}.
		\item {\sf Quizzer} invokes the \LaTeX\ program to typeset the 
		{\sl quiztemp.tex} file.
		\item {\sf Quizzer}  will create the 
		{\sl quiztemp.dvi} file for viewing the appearance of the printed document.  You should now have two new windows open.  The {\sl quiztemp.dvi} file is automatically
		opened and displayed once it is created. 
		This process takes only a few seconds to complete depending on
		the computer. All of the {\sl quiztemp.*} files are in the
		{\sl nsc121s9/} directory.  The quiztemp files are rewritten every time a new {\sl .dvi file} is created.
		\item After you are done viewing both windows, dismiss the \LaTeX\ output window and the quit the quiztemp window.
		\item Note that new problem sets may have coding errors in their \capa\
		grammar, \LaTeX\ grammar, or HTML grammar.
		These are independent languages.  Therefore, previewing in 
enscript, creating a {\sl .dvi} file, and viewing the problem set in a web browser are necessary to detect and locate each kind of error.
		
		\end{itemize}


	\item Printing the set of sample problems through {\sf Quizzer}. 
		\begin {itemize}
		\item From the main {\sf Quizzer} menu, choose \fbox{Print...}.
		\item The pop-up screen will indicate your options.  Choose one of the following:
			\begin{enumerate}
			\item \fbox{Print current .dvi}: This option will print
			the most recent .dvi file you have generated using
			the ``Create .dvi'' menu option, i.e. the {\sl quiztemp.dvi} file listed in your
			directory.
			\item \fbox{Randomly select one student from section}:  This will generate a random assignment from the section you specify to be
			printed.
			\item \fbox{Specify the... Student Number}:  This will print out a set for the specified student.  Once the
			student number is entered into the field, be certain to
			press $<$return$>$ to call the student name from the
			{\sl classl} file.
			\item \fbox{Print section}:  This will print the
			entire specified section's papers.
			\item \fbox{Print multiple sections}:  This will open
 a menu for choosing the sections to be printed.	
		\item \fbox{Print whole class}:  This option will print
			the assignments for the entire class.
			\end{enumerate}
			\item {\bf Note:} Once you 
                        have entered a command for
			printing, another pop-up screen will appear
			allowing a choice of printers.  The printer options are 
			defined in the {\sl capa.config} file. (See discussion of {\sl capa.config file} in the Software Components section.)
			\item Click \fbox{Select} and then click \fbox{Print} in the ``Print Command'' window.  You may also have a choice of printers and printing options to choose from in this window.	
			\item After the printing has finished, note the \capa\
			ID number at the top of the printed page.
			\end{itemize}
		\item Viewing the set on the Web
			\begin{itemize}
			\item Open a browser and point it to the approriate class.html URL
			\item Select the class {\sl nsc121s9} by clicking on ``class'' box and selecting {\sl nsc121s9} from the drop-down menu.  This will allow you to view "Jaime Student's" problem set 1.
			\item Enter {\tt A87654321} for the student number and {\tt 2318} for the CAPA ID
			\item Click on the button to try the problem set.  Close the browser when you are done browsing.
			\end{itemize}
		\item Other {\sf Quizzer} main menu items:
			\begin{itemize}
			\item All {\sf Quizzer} submenus can be ``torn off". 
			The submenus have a dashed line at the top.  If you
			click on the dashed line, the submenu becomes a
			separate, static window which can positioned anywhere
			on
			your screen.
			\item \fbox{File}:  This was discussed above, but also includes ``Open Reference File'' a useful
			option allowing copying and pasting from any file into the quiz set.
			\item \fbox{Edit}:  This submenu contains the standard
			editing commands (cut, copy, paste, select all, undo, 
			and find).  The \fbox{Find} option allows you to find 
			and/or replace using different criteria.  
			\item \fbox{Prefs}:  This feature can be used to
			choose what style of output is displayed, such as				just problems, problems and answers, or
			answers only. This also determines what is
			printed on the paper through the print command, so be
			certain to set it to ``problems
			only" prior to
			printing the entire classes papers.  You can also edit
			the HTML and \TeX\ header and footer files through the
			preferences menu by clicking on the menu that displays 
			\fbox{HTMLheader}.  However, for most applications of 
			\capa\, you should not need to edit these files.
			\item \fbox{Windows}:  This submenu displays all the
			currently open windows in the {\sf Quizzer}
			application.  If ever a smaller window is hidden by a
			larger one, you can shuffle the smaller window to the
			top by selecting it in this menu.

			\item \fbox{Analyze Set}:  This allows you to view the
			range of anwers a certain problem will generate.  While
			{\sl set1.qz} is open, select \fbox{Analyze Set}.  From
			the new window, select
			\fbox{Run Random}, enter the number 10, then click 
			\fbox{continue}.  When the set is finished being
			analyzed, you can select different problem numbers and
			view the range of answers generated for the \capa\
			problems.  Dismiss this window and try it again, but 
			this time select \fbox{Run Class}.
			\item \fbox{Remap}:    You have the option of remapping
			either the
			backspace or the delete key to suit your particular
			preference.
			\fbox{Xdvi Options}:  This allows you to resize the
			display of the {\sl .dvi} file on your monitor.  These
			changes will not affect printing.

		\end{itemize}
	\item Select \fbox{Quit} from the menu to leave the {\sf Quizzer} 
	program.
	\item A ``MakeSure Prompt'' window will appear.  You have the option \fbox{Cancel}  to continue
	editing or \fbox{Yes} to quit {\sf Quizzer}.  If you made changes, you
will be asked if you want to save them.  Answer \fbox{No} at this time.
	\item The {\sf Quizzer} main menu then disappears.
	\end{itemize}
\item {\bf  Guided Tour of \large \sf Capalogin} \label{Gcapalogin}  

After the instructor has created a question set ({\sl set1.qz} in this 
example) and  the {\sl records/set1.db} file has the relevant dates and
times, students can login through the network.  The students can use equipment
or a communication program that emulates a vt100 terminal to enter their
answers and view the hints.  Note that the emulation is very specifically 
vt100 and not vt102, vt200, etc.  

At Michigan State University, the students log into the system from a large
number of remote locations on and off campus.  They have used a variety of
computers, IBM, Mac, etc., that emulate a vt100 terminal.  For the guided tour,
you will open a terminal window on your host computer.

	\begin{itemize}
	\item Login Instructions: An example of a login instruction handout
	which has been used at MSU is included in 
	the next section of this manual. 
	\item A student logs in by entering the class account user name, such as
	{\tt nsc121s9}.  This account does not have a password. Therefore,
	anyone can get in, but they are `captured' by the code {\sf Capalogin}
	and have limited access to the machine (see details in
	the software component section).
	\item The student is then asked to enter his or her student number and
	the  \capa\ ID  number of any assignment.   
		\begin{itemize}
		\item The student number has 9 characters. At MSU the last 8 are
		digits, but the 9 characters can be a mixture of digits and letters. The 
		\capa\ ID number is unique for each problem set for a given
		student in a given course.  It has 4 digits 
		and will be printed on a student's individual assignment sheet. 
		\item Each student has a different \capa\ ID number for each
		problem set.  The {\sf Capalogin} code will 
		select the {\sl set$x$.qz} file that corresponds to the CAPA ID.
		 Previous sets can be reviewed anytime.
		\item If the current date and time are within the allowed time
		range specified in the DB Header file, 
		students can enter their answers. The answers are recorded  as they are submitted.  
		\item Problems arise when students open multiple sessions.   If
		two sessions for one student 
		are active at the same time, the computer records the
		distribution of correct and incorrect answers of 
		the last session to log-out, not necessarily the session with
		the most credit earned. This is one the reasons for  
		 limiting the number of active sessions by one student. 
		\end{itemize}
	\item {\bf Sample login:[A]} 
		\begin{itemize}
		\item Exit your server and then open a new telnet (or {\bf rlogin}) session into the server.  The method for this
		varies depending upon the type of
		X-server software being used.  (See  Section 3 on
		configuration of X-server software.)
		\item At the prompt {\tt login:}, enter the classname.  Example:
		 {\tt nsc121s9}
		\item The capalogin screen will be displayed.
		\item Enter: {\tt A87654321} for the student number and then hit			$<$return$>$. Note that
		the cursor should be positioned after
		 the colon following the words {\tt Student Number} near the
		 middle of the screen.  If it is not, 
		 particularly if it is at the bottom of the screen, the
		 terminal emulation is not vt100 and 
		 needs to be reset in the terminal emulator. 
		\item Enter {\tt 2318}, the CAPA ID printed on the homework page
		for student A87654321. The CAPA ID 
		number must correspond to the one printed on the problem set for
		this student,  or the login will not be 
		allowed. 
		\item The student's name is displayed at the top of the screen
		and the main \capa\ menu near the center. 
		\item Enter: {\tt S} (or {\tt s}, as the menu is not case
		sensitive) to view the student's summary for 
		the course. No credit should have yet been earned. 
		\item Enter: {\tt M} to return to the main menu.
		\item Enter: {\tt T} to try the problem set. 
		\item Enter: {\tt 1} to try problem 1.
		\item Problem 1 of set 1 will appear on the screen.
		\item Follow the instructions, noting that if you put in a wrong
		answer, a {\tt :H} to receive a hint may 
		become an option.  Note that the colon in this screen
		differentiates a command from a problem answer.
		\item After answering a few questions, enter {\tt :m} to return
		to the main menu.
		\item Enter: {\tt s} You can now see the updated student
		summary. 
		\item Enter: {\tt x} to exit.  This ends the session, records
		the student responses, and closes the
		connection to the server.  The {\sl goodbye.msg} file is then
		displayed .
		\end{itemize}
\item {\bf Sample login:[B]} 
		\begin{itemize}
		\item Open a web browser session into the server.  
		\item Select the sample class {\sl nsc121s9} from the pop-up menu.
		\item Enter: {\tt A87654321} for the student number. Note that
		you must click in the window.  
		\item Enter the \capa\ ID {\tt 2318} (as was printed on the homework page
		for student number A87654321). The \capa\ ID 
		number must correspond to the one printed on the problem set for
		this student,  or the login will not be 
		allowed. 
		\item Click on the `` Click \fbox{here} to work on \capa\ '' 
button.
		\item  The next document you will see will be the main menu where you can select to try the current
		problem set.
		\item Set 1 will appear on the screen.
		\item Note that if you put in one or more wrong
		answers, a hint will be displayed if it has been included in the code. 
		\item Note that the problem numbers are listed across the page at the top and bottom of the set.  You can
		click on the problem number and go directly to that problem.   
		\item Once you're finished previewing this set, you can choose to exit the system.
		\end{itemize}
	\end{itemize}
\newpage



%**********************************************************************************

% Guided Tour of Grader
%**********************************************************************************


\item{\bf Guided Tour of {\large \sf Grader}} \hfil\epsffile{figures/grader50.ps}
\label{GGrader}
	\begin{itemize}
	\item Prior to opening the {\sf Grader} application, 
	set up your X-server software to
	interact with your server.  See  Section 3 on using \capa\ via eXceed,
	X-win32 or MacX.
	\item Through your X-server software, open an rlogin (or telnet) session
	to your server.
	\item If necessary, change directory to the directory in which the {\sf Grader}
	application is located.
	\item Start the application by entering the command {\sf Grader}.
	\item The {\sf Grader} main menu will appear in the upper left corner of
	your screen.
	\item Choose \fbox{File } then \fbox{Specify Class}
	\item A pop-up window appears with ``Please select a capa.config file'' on the title bar. Search the directory to find the class (in this case, {\sl nsc121s9}).  You may need to go back one directory (by clicking the folder button in the upper right hand corner of the window).
	Double click the \fbox{nsc121s9} directory, then double click on the 
{\sl capa.config} file. A new window will appear with {\sl nsc121s9} as the class.
	\item Specify a section number and problem set number:
	\begin{itemize}
	\item  Enter {\tt 1} for the section
	number in the text entry panel.
	\item   Enter {\tt 1} for the problem set number. 
	\item Now, click \fbox{Load Scores} button.  {\sf Grader} will scan the
	record files and the (short) list of students in 
	section 1 and their current grades will appear. Note, for example, the
	grade of student A87654321.  For classes
	with large student enrollments and long problem sets, the display of the
	section grades may take a few seconds.  
	\end{itemize}
	\item Select a student to grade:
	\begin{itemize}	
	\item	 All the students in the selected
	section are contained in the displayed list.  Click and highlight \fbox{Student Jamie .} from the list.
	\item  Click the
	\fbox{Grading} button. A new grading window will 
	appear on the  screen.  The answers to the problem set for that student
	are displayed along with rows of buttons. 
	You can choose to view questions and answers or answers only.
	\item  You can change the recorded grade for any
	problem except those already answered correctly remotely by clicking on the corresponding 
	radio button on the left hand side.  
	\item The buttons refer to whether the
	answer was remotely entered as correct 
	{\bf Y}-es: as incorrect {\bf N}-o: or excused {\bf E}-xcused.  A dash 
indicates that the problem was never attempted.  
	Lower case {\bf y} or {\bf n} are written in the {\sl set$x$.db} file  to
	indicate when a problem  was graded by teaching staff 
	using  {\sf Grader}. 
	\item Problems whose answers cannot be entered directly by students
	are hand-graded problems. Essay 
	questions or derivations are examples. (As seen in the ``\capa'' Functions'' section, they are
	identified as such in the answer format of the problem 
	as {\tt hgr=on}.)    To assign a grade, click on the box that is
	presented, assign the number of points received by the 
	student in the panel that opens, and click to enter the grade.
\item {\tt /SUBJECTIVE} questions (essay questions that were directly entered in by students) are graded seperately by selecting \fbox{File} in the {\sf Grader} main menu and then selecting \fbox{Grade Subjective}. \\
{\em This is explained in greater detail later.}
	\end{itemize}	
	\item Save results:  After changing a student's grade, click on the \fbox{Save} button (upper part of the grading window) to record the result. Confirmation of any grade change is required in a separate panel. 
	\item Grade {\tt /SUBJECTIVE()} questions:
\begin{itemize}
\item You can only grade {\tt /SUBJECTIVE()} past the due date.
\item As you get more comfortable with the {\sf Quizzer}, {\sf Grader}, and
{\sf CapaLogin} components, you should complete the steps below.  
\item Problem number 22 is a {\tt /SUBJECTIVE} question in {\sl set1.qz}.  To
view this problem, you should first enter in some essay answers for some of
the students in the class list.  You should have at least two students in a 
team with only one submission.  Make sure the student not submitting the answer
has her or his student number entered in the answer text.  Next, change the due 
date (change the DB header with {\sf Quizzer}).   
\item To grade {\tt /SUBJECTIVE()}, click on \fbox{File} in the {\sf Grader}
main menu and then select \fbox{Grade Subjective}.  
\item You will be asked to select your class by choosing the {\sl capa.config}
file from your class directory. 
\item After selecting the correct file, you will be asked for the set number
and then the problem number.
\item Two windows should appear.  One window is titled ``gradesubjective'' and 
displays the essay and the name of the student(s) who submitted the answer.
The other window is titled ``scoreandcom'' and has options for grading the 
students.
\item The buttons on the ``scoreandcom'' window do the following functions:
\begin{enumerate}
\item The buttons next to the numbers at the top are the points you can assign
for the problem.
\item \fbox{Grade}:  By clicking this button, the points selected will be
assigned to the student(s) and the box next to ``graded'' will be checked.
\item \fbox{Grade\&Next}:  Does the same as \fbox{Grade} except that it also
displays the next answer to be graded.
\item \fbox{Next}:  Displays the next answer in order of ID number.
\item \fbox{Prev}:  Diplays the previous answer in order of ID number.
\item \fbox{Find ID}:  This is not commonly used.  If one of the student numbers
are typed wrong in the essay text, then that can be corrected and the correct 
student can be found that matches the new student ID by clicking on the 
\fbox{Find ID} button.
\item \fbox{Find Name}:  Similar to \fbox{Find ID} except that the name is searced for.  Because it searches through the entire text, it may generate a long list.  You should highlight the name in the essay text before using the 
\fbox{Find Name} button.
\item \fbox{Add ID}:  Allows you to enter another student to the list in case
a particular student was not listed in the essay text.  You can select the 
student by either name or ID.
\item \fbox{GoTo}:  Allows you to go to the answer from a particular student
number, name, or an ungraded student.
\item \fbox{Exit}:  Exits both windows.
\item \fbox{wrap}:  Wraps long lines to make questions more readable.
\item \fbox{pict}:  Displays the picture if the appropriate picture files are
available.
\item \fbox{Print Response}:  Prints the essay or derivation text.
\item At the bottom of the ``scoreandcom'' window is the number of questions
graded and the number that need to be graded.
\end{enumerate}
\end{itemize}
	\item Generate reports: 
	\begin{itemize}
	\item To generate reports, select \fbox{File} from the main 
	menu, then \fbox{Create Class Summary} and follow the instructions.
	\item Two types of reports can be generated by the
	{\sf Grader} program, a class report and a 
	section report. Both types are saved in a text file with an {\sl .rpt}
	extension in the course sub-directory, 
	{\sl nsc121s9}.  These files will have a prefix {\sf ClassSet$x$} or 
{\sf Sec$x$Set$x$}. 
	\end{itemize}	
\item  Select \fbox{Quit} on the {\sf Grader} menu.
	\end{itemize}
\newpage
%**********************************************************************************

% Guided Tour of Mangager
%**********************************************************************************
\item{\bf Guided Tour of {\large \sf Manager}} \hfil\epsffile{figures/manager50.ps} \label{Gmanager}
	\begin{itemize}
	\item Prior to opening the {\sf Manager} application, 
	set up your X-server software to
	interact with your server.  See  Section 3 on using \capa\ via eXceed,
	X-win32 or MacX.
	\item Through your X-server software, open an rlogin (or telnet) session
	to your server.
	\item If necessary, change directory to the directory in which the {\sf Manager}
	application is located.
	\item Start the application by entering the command {\sf Manager}.
	\item The {\sf Manager} main menu will appear in the upper left corner of
	your screen.
	\item Choose \fbox{Actions}.  You will be given three choices:
\begin{enumerate}
	\item \fbox{Scoring}:  This is used to score Scantron \capa\ exams.
	\footnote{For more information about scantron \capa\ tests and {\sf
	Scorer}, please contact capa@capa.msu.edu.}
	\item \fbox{Generate Stats}:  This gives different ways to generate 
	statistics on scores, answer submissions, etc.  There are also options to 
	look up \capa\ IDs.  This choice is the same to the capautils application.
	\item \fbox{Randomize Seating File}:  This will randomize a user created seat
	file for exams.
\end{enumerate}
	\item Choose \fbox{Generate Stats}
	\item A pop-up window appears with ``Select the capa.config in the class
	directory'' in the title bar.  Double click on the appropriate {\sl capa.config}
	file.
	\item Another pop-up window appears which allows you to choose the following 
	{\sf CapaUtils} functions:
	\begin{itemize}
		\item \fbox{Change Class Path} allows you to switch back and
		forth between classes.
		\item \fbox{Run Capastat} gives on-line feedback to instructors 
		on the level of difficulty students have with an on-line
		assignment.
		\item \fbox{Summarize Log Files} gives information when students 
		entered in correct answers (Y), wrong answers (N), errors in significant
		digits digits (S), incorrect units (U), and no units entered or units
		entered when units were unnecessary (u).
		\item \fbox{Student Course Profile} searches the various \capa\ records
		and gives a summary of a particular student's performance in all areas
		involving \capa\, such as homework, quizzes, examinations, or supplementary
		problems.
		\item \fbox{CAPA IDs for one student} finds the \capa\ ID for 
		a particular student for one or more sets.
		\item \fbox{All CAPA IDs} generates all the \capa\ IDs for a 
		class for one or more sets.
		\item \fbox{Item Analysis} gives the level of difficulty and 
		discrimination for each of the questions.
		\item \fbox{Item Correlation} gives the correlation between
		problems in a set. (If the display is hard to read, uncheck the
		wrap button.)
		\item \fbox{View Submissions} gives all the 
		answers a student submits for a particular set.
		\item \fbox{Analyze Class Report} gives grade distributions and a
		graph of grade distributions for a previously generated class report.
		\item \fbox{Analyze Responces} analyzes output generated by scorer.
		\item \fbox{Graph a Responces Analysis}
	\end{itemize}
	\item Close the CapaUtils window by selecting \fbox{Quit}.
	\item Another feature on the Manager window is \fbox{Print}.  This print option
	is for printing assignment(s) for a specified student.
	\item \fbox{Quit} {\sf Manager}.
	\end{itemize}

%************************************************************************************
\item {\bf Guided Tour of Qzparse} \label{Gqzparse}
	\begin{itemize}
	\item {\sf Qzparse} is a feature that gives the instructor flexible printing options.  {\bf Note:} All of these printing options can be done using 
{\sf Quizzer}, while {\sf Manager} allows you to print for one student by 
searcing for either a name or a student number. Open an rlogin (or telnet) 
session as ``teacher'' and follow the script below.  The computer used in 
this example has a prompt {\small \bf capa2.nscl.msu.edu$>$}
	\item Before you begin, you must be in the appropriate class 
	directory. \\
 {\small \bf capa2.nscl.msu.edu$>$} {\tt cd /absolute/path/teacher/CAPA5/nsc121s9}

	\item Entering in {\tt qzparse -h} at the prompt will display all of
the options available to this function.  \\
  	{\small \bf capa2.nscl.msu.edu$>$} {\tt qzparse -h} 
\begingroup\small \begin{verbatim}
USAGE: qzparse [ -[T|H|A][a|b] ] [-Sec [n|n:m] | -Stu sn [-o filename] ]
          [ -Set [n|n:m] ] [-c path_to_class] [-d outputdirectory]
 Example 1: qzparse -Tb -sec 2:3 -set 2:5
            will generate tex files with both questions and answers
            for sections 2 to 3, sets 2 to 5
 Example 2: qzparse -Ha -stu A12345678 -set 3
            will generate html files with answer only 
            for student A12345678 set 3
          -T     = tex   mode
          -H     = html  mode
          -A     = ascii mode
                 = default question only
            a    = answer   only
            b    = both question and answer
          -Sec 3 = for section 3
          -Sec 3:7    = from section 3 to section 7
          -Stu A12345678 = for a specified student
          -Set 1 = output set 1
          -Set 3:4 = output from set 3 to set 4
          -c class_path
          -o output_filename_with_absolute_path (only for a student)
          -d directory_to_create_files_in (default is class_path/TeX)
-------This is version 5.0.3 @ 11:23-Apr-07-1999
------------------------------------------------------
 \end{verbatim}
\endgroup

   	\item {\small \bf capa2.nscl.msu.edu$>$} {\tt qzparse -T -sec 1:2 -set 1}\\
	 qzparse running in TeX mode, question only,  from section 1 to 2, set 1
	\item {\small \bf capa2.nscl.msu.edu$>$} {\tt Enter the ABSOLUTE path of class}\\
	{\tt /usr/users/teacher/CAPA5/nsc121s9}\begingroup\small \begin{verbatim}
Section  1: 4 students
    Student: Albertelli, Guy II            A12345678   set 1.....................
    Student: Berryman, Felicia V.          A23592320   set 1.....................
    Student: Kashy, Edwin N.               A73336318   set 1.....................
    Student: Student, Jamie .              A87654321   set 1.....................
  DONE set 1

  DONE section 1    ALL DONE
 \end{verbatim}
	\endgroup
	The above message shows that the {\sf Qzparse} application has generated
	the appropriate {\sl .tex} files from the quiz set files.
	 The {\sl .tex} files will contain questions for {\sl .qz} set 1 for section 1 and
	 section 2.
 	\item {\small \bf capa2.nscl.msu.edu$>$} {\tt cd TeX}  \\
	{\small \bf capa2.nscl.msu.edu$>$} {\tt latex section1-set1}
	\begingroup\small \begin{verbatim}
	............
	Output written on section1-set1.dvi (8 pages, 45412 bytes).
	Transcript written on section1-set1.log. \end{verbatim}
	\endgroup
	The above message shows that the {\sl .dvi} file has been created from 
	the {\sl .tex} file for section 1.
   	\item {\small \bf capa2.nscl.msu.edu$>$} {\tt dvips section1-set1.dvi -o
   	section1-set1.ps}\\
	{\footnotesize \tt ............}\\
	This command generates the .ps file which is ready for printing.
   	\item {\small \bf capa2.nscl.msu.edu$>$} {\tt ls}
 	\begingroup\small \begin{verbatim}
	section1-set1.aux  section1-set1.log  section1-set1.tex
	section1-set1.dvi  section1-set1.ps
	\end{verbatim}
	\endgroup
	The {\tt ls} command lists the files in the current working directory. 
	As seen above, there are five files created.
	The {\sl .ps} file contains problem sets for all students in
	section 1. The command to print is written below.  To specify two sided printing or any other print option, you need to find the command for your particular printer.
   	\item {\small \bf capa2.nscl.msu.edu$>$}  {\tt lpr -PLocal\_Printer
   	section1-set1.ps}
  	\item Note: Do not type a space between {\tt -P} and the name of your local printer.
	\end{itemize}
Note: It is suggested that the {\sl TeX}  classname subdirectory be cleaned at regular intervals as {\sl .ps} file can get very large. 

%**********************************************************************************

\item{\bf Guided Tour of Capautils 1.0} 
\label{Gcapautils}
	\begin{itemize}
		\item Through your X-server software, open a telnet session to
		your server.
		\item Start the application by entering the command {\tt capautils.pl}.
		\item Enter the absolute path requested, for example:\\
		{\tt /usr/users/teacher/CAPA5/nsc121s9}
 
		\item The terminal will display a menu with several items.  
These items are similar to the items from capautils 1.1 which have been explained in the guided tour of {\sf Manager}.
	

			\item All items are menu driven and some of the information which this application uses (such as printing, classnames, etc.) is  in the {\sl capa.config} file.
\end{itemize}	

%**********************************************************
\item{\bf Guided Tour of AllCapaID}
\label{GAllCapaID}
\begin{itemize}
\item Besides getting \capa\ IDs from {\sf CapaUtils} (either from a terminal 
or a window in {\sf Manager}), you can also retrieve \capa\ IDs from the 
{\sf AllCapaID} application.
\item Typing {\tt allcapaid -h} at the prompt of a telnet session will show all the options
available for this function.  \\
	 {\small \bf capa2.nscl.msu.edu$>$} {\tt allcapaid -h}
\begingroup\small \begin{verbatim}
USAGE: allcapaid [-s start-set] [-e end-set] [-stu student-number] [-c class-directory] [-d output-directory] [-h] [-i] [-sec [n|n:m]]
       start-set : default 1
       end-set   : default 10
       student-number  : no default
       class-directory : no default
       output-directory: class-directory/capaID
       -Sec 3          : for section 3
       -Sec 3:7        : from section 3 to section 7
       -i              : don't create files, print to the screen
       -h              : prints this message
       CAPA version 5.0.3, 11:23-Apr-07-1999
\end{verbatim}
\endgroup

\item An example with ``Jaime Student'' is shown below:  \\    \\
\small{\bf capa2.nscl.msu.edu$>$} {\tt allcapaid -s 1 -e 1 -stu A87654321}
\begingroup\small \begin{verbatim}
Enter the ABSOLUTE path of class from root (/)
/usr/users/teacher/CAPA5/nsc121s9

   1 
2318 
\end{verbatim}
\endgroup

\end{itemize}
\end{enumerate}