ClassQue Advanced User's Guide

This is a guide to some of the more advanced features of ClassQue. These features are illustrated using the ClassQue Simulator.
This simulator is a single program that shows t teacher window and a class of eight students, three of whom have signed in. You can start the simulator from the included calssquesimulation.jar file or from the web by accessing the following web page:
If all goes well, starting the simulator this will bring up four windows, a teacher and three students.

Response Display Formats

In the main teacher (or assistant) window, the menu Display -> Responses has three options: Summary, By Name, and By Answer.

Figure 1 shows the results for the three types of response display for Choice, Checkbox and Integer queries.

Display Response Type
Query TypeSummaryBy NameBy Answer
Choice Figure 1a Figure 1b Figure 1c
Checkbox Figure 1a Figure 1b Figure 1c
Integer Figure 1a Figure 1b Figure 1c
Figure 1: The three types of display for Choice, Checkbox, and Integer queries.

The Summary Display

The By Name Display

The By Answer Display

Except for Choice and Checkbox summaries, the student name or the answer is displayed as a link.
Click on that link will turn on or off the display of reviews of that answer.

For freeform and code types of queries, these all do the same thing. A list of students is given, each with that student's answer, similar to the Name response type below.


Once a student gives an answer to a query (referred to as a response), that response may be reviewed by one or more teachers, assistants, or other students.

In all but the Summary display for Choice and Checkbox, the reviews for a given response can be displayed by clicking on the name or answer link. This toggles the display of the reviews for that response. Alternatively, the all reviews can be displayed in these modes by using:
     Display -> Review -> Show Reviews
and turned off with
     Display -> Review -> Hide Reviews

Reviews are displayed with the same formatting they were entered in. Lines too long for the window in which they are displayed will be truncated. You can force these reviews to wrap using
     Display -> Review -> Wrap Reviews
or turn off the wrapping of reviews with
     Display -> Review -> No Wrap Reviews

Teacher Reviews

A teacher or assistant can review a response in several ways.
When responses to a query are being shown (except for Summary display for Choice and Checkbox) an additional Review link can be shown with each response. The Review link is turned on with
     Display -> Review -> Show Review Link
and turned off with
     Display -> Review -> Hide Review Link
Clicking on the Review link will bring up a review window for that response.

A review window shows the question and answer being reviewed. Type your review in the box labeled Comment.
When done, push the Send button.

You can show quick review links with
    Display -> Review -> Show Correction Link
This will show two additional links in the response window labeled Correct and Incorrect.
Clicking on one of these creates a corresponding one-word review.

For Choice, Checkbox, and Integer queries, a review is associated with an answer, not with a student.
When a review is generated for one of these, the review is attached to the responses of all students that gave that answer.

Student Reviews

A teacher can allow students to see their reviews with
    Student Options -> Review -> Allow See
This causes a See Reviews button to appear on the student's main window. Pushing this button brings up a window that shows all of the reviews of the student's current answer. The window should refresh automatically when new reviews are generated, or the student can push the Refresh button to get all current reviews.

A teacher can allow students to generate reviews for other student's answers by using
    Student Options -> Review -> Allow Create
This causes a Create Review button to be displayed. Pushing this button brings up a window that allows students to request to review answers of other students to the current query. Reviews are anonymous from the student's point of view. Students do not see whose answer they are reviewing and cannot see which students wrote reviews for their answers.
Reviews generated by the teacher or assistant are marked accordingly so student and distinguish these from student reviews.


A share consists of a common area in which a group of students can enter text, along with a chat area.

Figure 2 shows a share window.

Figure 2
Figure 2: A student share window.

Student Created Shares

A teacher can allow students to create shares using
    Student Options -> Share -> Allow Create
This gives the students a Create Share button. When a share is created, it is given a name at the time of creation. Each share must have a unique owner-name combination.

Students need to be invited before they can join a share. The owner of the share (or a teacher) may invite others to join the share. Students can invite users to join the share using the Invite menu option of the share. This brings up a list of checkboxes, one for each student. After students have been invited they can join the share using the Join Share button on their main window. This button appears if a teacher has done:     Student Options -> Share -> Allow Join
The Join Share button brings up a list of shares that the student has been invited to. Each share is references by the share owner and the share name.

The student owner of a share can remove student users or destroy the share.

A teacher can join any share (without invitation) using:
    Windows -> Share -> Join Share
This will bring up a list of all shares that the teacher does not currently belong to.
A teacher share window is similar to the student window except that it has an Options menu item instead of Invite and Remove.
The options are:

Using Shares

The owner or a teacher can write in the main share window at any time. All users see the same contents of this window as changes are made. The share frame shows the owner and the name of the share below the menu. Below this is the current writer of the share. Only one user can write at a time.

A student user who is not the owner, must push the Request Write menu item before writing. This changes the menu item to End Write which the student can select when done writing. At any time the owner (or a teacher) can begin writing and lock out other users until they request write again. At any time a student user can push the Submit button to make a permanent copy of the current contents of the share window in the log file. A teacher user has a similar button labeled Log.

Shares have a chat feature. Use the Show Chat menu item to show a chat window below the main window. On the teacher share, the chat window replaces the share window. The chat window has two parts, one for entering text, and one for showing a history of all text entered. After typing in the chat window, push the Send button to send the contents to all users of the share. Each entry is labeled with the name of the user that entered the text.

When the chat area is show, the share frame has three parts: the main share window, the chat entry area, and the chat history area. You can change the relative size of these by dragging the boundaries with the mouse.

Teacher Created Shares

A teacher can create a share using
    Windows -> Share -> Create New Share
This creates a share with the teacher as the owner. The teacher can then invite or add users to the share.

The teacher can use
    Windows -> Share -> Combine Shares
to combine all of the shares that the teacher belongs to into a single frame. This frame has two additional menu items: Join and Layout. The Join menu item lists all of the shares that the teacher does not belong to and allows the teacher to join these and add them to the combined share frame. The Layout menu item allows for selecting the number of columns of shares shown.

The Group Manager

The group manager allows a teacher to divide the class in to groups, each group having its own share.
Figure 3 shows a group manager frame created with
    Windows -> Share -> Group Manager
The right side of the frame shows the groups. Each group has a group number (starting with group 1), a size, and a name. The group name is just the Group Base Name followed by the group number. Below the list of groups are two additional entries, called unassigned and group leaders.
The left side of the frame shows a list of student whoa re currently signed in. Each is preceded by the number of the group that student has been assigned to. If you click on one of the group names, that group name is shown in red and the members of the group are highlighted in the student list. Members are shown in red with the owner in green. If you click on unassigned, the unassigned students are shown in red. Clicking on group leaders shows the group leaders in green.

Figure 3a Figure 3b
Figure 3: Two versions of the group manage window, one using distribute by size and the other using distribute by number.
Two methods are provided for automatically dividing up the class into groups Choose one with the Distribute by menu item.
Once groups are created (either by using Distribute by Size or by setting the number of groups), the teacher can move students around in the groups. You can change the group that a student has been assigned. CLick on the group in``name in the Group List. Will show that name in red. Current members of the group are shown in red or green. The green member is the group leader. Click on another student to add it to this group.

Click on unassigned in the Group List and the unassigned students will appear in red. Click on another student to remove it from its current group.

Click on group leaders and the group leaders will appear in green. Click on any student who is in a group and that student becomes the current leader of his/her group.

There are two Actions available from the menu. Remove Students removes all students from the groups. Create Sjares creates shares from the current groups.

The students.txt configuration file

The teacher uses the student.txt configuration file to describe the students in the class.
The first line of the file contains the name of the course. Additional lines describe the students, one per line. A student line starts with an optional seat number and blank followed by the last name of the student, a comma, and the rest of the name of the student. The name can be followed by an optional colon and a sequence of keyword-value pairs in the form keyword=value.
If the value contains blanks, the entire value string should be enclosed in double quotes.

The program calculates the following information from the student line, using defaults when no explicit value is given. The following table shows the values calculated and the keyword to override the default calculation method.
ValueRule for calculating defaultKeyword
last name The string after the optional seat number and before the first comma.
Leading and trailing blanks are removed, but not internal blanks.
first name The string after the last name and until the next blank with leading and trailing blanks removed. first
middle name The string after the first name until the end of the line or a colon.
Leading and trailing blanks are removed, but not internal blanks.
login name The first letter of the first name followed by the last name with blanks removed
up to a maximum of 8 characters, converted to lower case.
picture filename The last name followed by an underscore, followed by the first name,
followed by the extension .JPG with all blanks removed.
email address The login name followed by "@" and the default email domain from the report configuration file.

Additonal Windows Menu Options

Student List Window

Windows -> Student List
to display a window containing a list of students. The list is generated from the teacher's students.txt and from the students who have signed in. Six different types of lists are controlled by the Type menu option. Most of these can be sorted in different ways using the Sort menu option. Save Report can save a report in a file. The report inclused all of the report types.
In the simulator, the Create Students allows you to create additional students.

The Student List lists the students with the ones signed in first. It allows you to remove students who are logged in. In the simulator you can also sign in (add) a student.
The Students Signed In lists shows only the students signed in. It shows their first name, last name, login name, assigned seat adn actual seat. Similarly, the Students Not Signed In lists those students who are not currently signed in.
The Students In Correct Seats and Students In Incorrect Seats show the corresponding lists. The Students Not In List shows those students who have signed in but do not appear in the treacher list.


Windows -> Pictures
to display pictures of the students in the class. Students who are currently connected will have their names displayed with a yellow background. Pictures must be stored in the pictures subdirectory of the teacher's directory, the one from which the teacher program is run. Pictures can be in GIF, JPG, or PNG format, but the default picture file name is generated from the student name with .JPG appended. If you use a different extension on the picture filename, or use a different naming convention, then the name of each student picture file must be included in the corrsponding line of the students.txt configuratiobn file.


Windows -> Messages
to display the Send Message To Students frame.

Messages can be sent to individual students or groups of students. The message appears at the top of the student's window and will stay there until acknowledged. Messages are of two types, those which just need to be acknowledged, and those that require a response.

The left window of Figure 4 shows the Send Message To Students frame in its default configuration. Seats with students who have signed in are shown in yellow. Clicking on one of these changes it to blue, selecting that stdudent to receive the message. Select any combination of students, enter the message, and push Send. The selected blue seats will change to pink. When a studet responds, the color changes to green. The right window of Figure 4 shows a message that has been sent to students in seats 1 and 26. The student at seat 1 has responded, but the on in seat 26 has not.

By default, student only need to acknowledge having recieved the message.

By clicking the Ack button at the bottom of the frame, it will change to Reply. This requires students to send a reply back. If the message requires a reply, clicking on a green seat will show the corresponding reply.

Figure 4a Figure 4b
Figure 4: Two versions of the Send Message To Students frame, one by seat number and the other by name.

The window on the right of Figure 4 shows the result of clicking the By Seat button, which is changed to By Name. Now students to receive the message can be chosen by clicking on their name under click to add. They can be removed by clicking on their name onder click to remove. You are allowed to choose students who have not yet logged in. In this case, messages will be held and delivered to them when they log in. Once the message has been sent, the state of the message is displayed next to the student name. The possible states are pending for students who have not yet signed in, sent for messages that have been sent but not acknowledged, and replied for those that have sent a reply. Clicking on the name of a student who has replied shows the reply that was sent. The right windowof Figure 4 show a reply-type message has been sent to three students, on of whom has replied and one has not yet logged in.

Figure 5 show student windows corresponding to a message that requires only an acknowledgement (on the left) and one that require a reply (on the right).

Figure 4a Figure 4b
Figure 5: Two versions of the student window after a message has been sent. The first message only requires an acknowledgement. The second requires a reply.


This pops up a teacher's review window, allowing a teacher to enter reviews.


This feature lets you see which students have password set and allows you to see or clear the passwords. Passwords are usualy only used when student log in through a wbe interface.


This option promts for a file name. The contents of the selected file is included in some of the reports that can be sent to the students.

Show Frames

This options shows all of the ClassQue frames and allows you to pin one fram to another so that moving the parent causes the child to be moved along with it.

Help List

The brings up a help request list window as shown in the figure.
If the Student Option called Allow Help is set, students get a Request Help button. When they push this button, they appear in the help request list. After help has been given the teacher can remove the student from the list. If more than one teacher is active, each teacher see the same list. Pushing the Set Pending button for a student changes it to remove pending and indicatates that the student is receiving help. A change in one teacher's Help Request List is reflected in the corresponding list for other teachers.


All Queries

This brings up a window that shows all queries, similar to the All Queries window of the Query Creator.


This has 2 options and is only available from the simulator.
The options are Resume and Resume from server. The first will prompt for a state log generated by the server and will resume the program based on that log. You must move a state log file from the server to the local machine to use this option. The Resume frmo Server option requires a Classque Master Server to have been set up. It queries the server and allows the user to choose one the the previous classes to resume. A password is required. The master server password gives you access to all logs. A teacher password gives you access to those courses that use that teacher password. Setup and use of the master server is described here.

Report Configuration

This has two options Default Reports and Todays's Report. Each prompts the user for a file and that file will be used as the default or temporary report configuration file for that class. A temporary report configuration file is use once and discarded.


This has three options: Server Terminate Info, Keep Server Alive 10 minutes, and Keep Server Alive 1 hour. The first shows when the server is sechedule to terminate and the others allow you to adjust this time.

New Teacher

This is available only from the simulator and can create a new teacher or a new assistant.

Display Menu Options


This displays a toolbar in the teacher stats window that allows quick access to some of the features controlled by menus and some additional features not included in the menus. Each tollbar item has a tooltip to help understand what it does. Some toolbar items turn a feature on or off, in which case they have a red border when the feature is on. The toolbar item (in order from left to right) are:


Update Now refreshes the response list. The other option lets you Set Manual Update if Auto Update is active, or Set Auto Update if manual update is active. Auto Update behavies differently for ardinary queries and surveys. For ordinary queries, updates occur only when students send an answer. For queries, updates occur every 5 seconds.

Queries and Shares

Chooses between showing queries or shares. There are two options of queries, is to display the queries only or to also display the seating chart. When the seating chart is hidden, the names of the students in the responses are removed.
There are two options for shares, either showing only submitted shares or showing the current state of each share.


This chooses between the three types of response displays: Summary, By Student, or By Answer.


Allow you to show a Wrap button, a Size button, or an Update button. The Wrap button allows you to turn on or off the wrapping of reviews. The Size button allows you to easily change the size of the font used in the response display. The Update button allows you to froce an update.


This allows you to turn on or off five features of the response display: showing reviews, wrapping reviews, showing the review link, hiding review links for reviewed responses, and showing the correction links.
Hiding review links for reviewed responses allows the review links (including correction links) to be hidden once a teacher has reviewed the response. This feature is useful if you want to quickly correct all responses.


This has three options: Normal Size, Larger Size, and Smaller Size. They allow for change the size of the font used in the response display.

Student Options

There are three sets of student options.
The Share options, the Review options, and the Help options have already been discussed.

Query Options

There are three options under the Query menu.

The first is chooses between Browse All and Browse Current. The default is Browse Current which allows the teacher to look at the responses for the current query, or for the current survey is a survey is active. The alternative is Browse All, which allows you to look at responses from all past queries.

The next option allows you to display or hide an Export link which can appear in the response list (except the summary mode for choices and checkboxes). Clicking on the Export link brings up a window containing the response of that student. All formatting is removed so that the contents of the window can be moved elsewhere using the clipboard. This is the preferred method of moving code into a program.

The last option is Start Discussion. This is used to indicate the time at which the teacher starts discussing the current question. The logging of the student answers takes this into account and treats students answers that were generated after this time in a different manner as student notes rather than as actual responses.