GRACE Instructor Account Maintenance

All the instructor related scripts and programs are made via the tap program. You use it as follows:

tap graceinstr

This will modify your environment ($PATH, etc...) to allow you to run the programs described below.

Important You should never have to manually add a student to a class. Students will be automagically added/removed as course registration information changes (I.e. as the drop/add classes), without you having to do anything at all. This also means that unless you except a student (see below), running the addstudent command on a student who is not in the course registration data will simply result in the student being added, and then promptly being automatically removed again.

The following is an example of how to add a student to a class. You will need to use the addstudent script, which is available by tap graceinstr. Here are several examples:

• How to add a single student, who has the glue ID bart to cmsc114 section 0101:

  addstudent 2005 fall cmsc 114 0101 bart
                      
  

• How to add 3 students, bart, lisa, and marge to the math140 class being held in summer session 2:

  addstudent 2005 summer2 math 140 0201h bart lisa marge
                      
  

• If you have many students to add, you can list them, one per line in a file, and feed that file to addstudent. For example, if you have a file called ~/students with the following contents:

  bart
  lisa
  marge
  maggie
  homer
  moe
  wiggum
                      
  

  You can add all these students with one command, like this:

  addstudent 2005 summer1a enee 893 0101 < ~/students
                      
  

Important You should never have to manually remove a student to a class. Students will be automagically added/removed as course registration information changes (I.e. as the drop/add classes), without you having to do anything at all. This also means that unless you except a student (see below), running the delstudent command on a student who is in the course registration data will simply result in the student being removed, and then promptly being automatically added again.

The following is an example of how to remove a student from a class. You will need to use the remstudent script, which is available by tap graceinstr. Here are several examples:

• How to remove a single student, who has the glue ID bart to cmsc114 section 0101:

  remstudent 2005 fall cmsc 114 0101 bart
                      
  

• How to remove 3 students, bart, lisa, and marge from the math140 class being held in summer session 2:

  remstudent 2005 summer2 math 140 0201h bart lisa marge
                      
  

• If you have many students to remove, you can list them, one per line in a file, and feed that file to remstudent. For example, if you have a file called ~/students with the following contents:

  bart
  lisa
  marge
  maggie
  homer
  moe
  wiggum
                      
  

  You can remove all these students with one command, like this:

  remstudent 2005 summer1a enee 893 0101 < ~/students
                      
  

Important This should only be used in extreme circumstances where you want to grant a student access to a course and you know that they will be let in (I.e. they are #2 on the waitlist).

The following is an example of how to except a student from a auto drop/add of a class. You will need to use the exceptstudent script, which is available by tap graceinstr. Here are several examples:

• How to except a single student, who has the glue ID bart to cmsc114 section 0101:

  exceptstudent 2005 fall cmsc 114 0101 bart
                      
  

• How to except 3 students, bart, lisa, and marge from the math140 class being held in summer session 2:

  exceptstudent 2005 summer2 math 140 0201h bart lisa marge
                      
  

• If you have many students to except, you can list them, one per line in a file, and feed that file to exceptstudent. For example, if you have a file called ~/students with the following contents:

  bart
  lisa
  marge
  maggie
  homer
  moe
  wiggum
                      
  

  You can except all these students with one command, like this:

  exceptstudent 2005 summer1a enee 893 0101 < ~/students
                      
  

The following is an example of how to add a TA to a class. You will need to use the addta script, which is available by tap graceinstr. Here are several examples:

• How to add a single TA, who has the glue ID homer to cmsc114 section 0101:

  addta 2005 fall cmsc 114 0101 homer
                      
  

• How to add 3 TA's, homer, moe, and wiggum to the math140 class being held in summer session 2:

  addta 2005 summer2 math 140 0201h homer moe wiggum
                      
  

• If you have many TA's to add, you can list them, one per line in a file, and feed that file to addta. For example, if you have a file called ~/ta with the following contents:

  bart
  lisa
  marge
  maggie
  homer
  moe
  wiggum
                      
  

  You can add all these TA's with one command, like this:

  addta 2005 summer1a enee 893 0101 < ~/ta
                      
  

The following is an example of how to remove a ta from a class. You will need to use the remstudent script, which is available by tap graceinstr. Here are several examples:

• How to remove a single TA, who has the glue ID homer to cmsc114 section 0101:

  remta 2005 fall cmsc 114 0101 homer
                      
  

• How to remove 3 TA's, homer, moe, and wiggum from the math140 class being held in summer session 2:

  remta 2005 summer2 math 140 0201h homer moe wiggum
                      
  

• If you have many TA's to remove, you can list them, one per line in a file, and feed that file to remta. For example, if you have a file called ~/ta with the following contents:

  bart
  lisa
  marge
  maggie
  homer
  moe
  wiggum
                      
  

  You can remove all these TA's with one command, like this:

  remta 2005 summer1a enee 893 0101 < ~/ta