Making Changes to the Names File

General Information

There are times when changes need to be made to the Names File used by the GRADER/ROSTER programs. There is a CHANGES command in the ROSTER program that has options to add new students, drop students, changes scores, change a student's name, and change a student's ID number.

If you are not familiar with the KSUVM environment, there is handout available from the Test Scoring Coordinator at Computing and Network Services in Nichols Hall. It explains the basics of Xedit, OSJ, DEPRINT, QUERY READER ALL (Q RDR ALL), and how to print, etc.

Basic Procedure to Make Changes

1. Log on to KSUVM. With Xedit create a file containing the sample program that appears later.

2. Enter the change data into the program after the MANAGE.CHGFILE DD * line. Each option of the CHANGES command starts with the same basic three fields in common: the student ID number, reference number of the course, and the student name. The reference number in this case is the first four numbers of the course reference from the Directory of Classes (Class Schedule).

Generally, only the student ID numbers is required, any exceptions are noted. A comma is required to separate all fields, even if empty. After these fields is a command indicating the action to take. Depending upon the action, additional parameter fields may be required. Each change option is entered on a separate line.

3. After entering all the changes, use the OSJ command to execute the job. When the job has finished, examine the job output to see if the changes were executed properly.

Change Command Options

ADD - Adding New Students

The "ADD" command option is used to add new students to the names file. Only in this case are all three basic fields required. Also up to five scores may be entered for the new student. corresponding to score columns 1-5. These scores are entered by listing up to five scores after the command, separated by commas. The first example just adds a new name. The second example add a new name with five scores.

Example:  123456789, 1234, 'LASTNAME, FIRSTNAME', ADD
Example:  123456789, 1234, 'LASTNAME, FIRSTNAME', ADD, 12, 34, 56, 75, 20

DROP - Dropping Students

The "DROP" command option will delete the student from the names file.

Example:  123456789,,,DROP

CHG - Changing Student Scores

The "CHG" command option will change a student's current score. The command is followed by two parameter fields. The first field is the number of the score column to be changes. The second field is the new score to be entered. The example will change a student's score in column "1" to a new score of "85."

Example:  123456789,,,CHG, 1, 85

NEWNAME - Changing a Student's Name

The "NEWNAME" command option will change the name in the student name field. The command is followed by the new name enclosed within apostrophes. The example will change the student name to "NEWLAST, NEWFIRST."

Example:  123456789,,,NEWNAME, 'NEWLAST,NEWFIRST'

NEWSSN - Changing a Student's ID Number

The "NEWSSN" command option will change the number in the student ID field. The command is followed by the new ID number. The example will change the student ID number to "987654321."

Example:  123456789,,, NEWSSN, 987654321

Sample ROSTER Change Program

Here is a sample ROSTER Change program with some sample changes.

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
//*++ TIME ,09 VMMSG ENQ OMRGRADE EXPAND
//OMRGRADE EXEC OMRGRAD,ACTNOF4=044,IDNO=xxxx,PRM='ROSTER'
//MANAGE.CONTROL  DD  *
CHANGES
//MANAGE.CHGFILE  DD  *
123456789,1234,'LASTNAME,FIRSTNAME',ADD
234567890,1234,'LASTNAME,FIRSTNAME',ADD,84,56
345678901,,,DROP
456789012,,,CHG,1,92
456789012,,,CHG,2,90
567890123,,,NEWNAME,'NEWLAST,NEWFIRST'
678901234,,,NEWSSN,432109876
/* (END OF PROGRAM FILE)

Note: The xxxx on the EXEC line of the program must be replace with a four digit number. The number will be given to you by the Test Scoring Coordinator.