GiveSpec: Term

/home/cs9999/yyT{0,1,2,3}.work/give.spec
e.g. 24T2.work/give.spec

[ 1 Example ] [ 2 &loginmap ] [ 3 &authorisation ] [ 4 &smsdb ] [ 5 &subkey/&subgroup ] [ 6 &withhold ] [ 7 &assignmap ]

Example

&#  This is a template file for the give.spec file
&#  in the working directory for the current period.
&#  It is used to set any parameters for the current period.

&#  It must include &assignmap if any assignments are to be submitted.

&#  loginmap
&#  Only needed for "unofficial" mappings (automatic
&#  for normal students with real logins)
&#  entries are 
&#      login  studentID

&loginmap
&end

&# add tutor logins for access to Xmark and sms
&# cs9999 MARK RSMS
&authorisation
xyz MARK RSMS
abc MARK RSMS
cs9999 MARK RSMS
&end

&#  assignmap - added during installation. Entries are
&#      name [aliases...]
&#  where aliases are alternative names that
&#  students can use to identify the assignment

&smsdb = /home/cs9999/24T2.work/24T2db.sms
&# subkey and subgroup describe how to handle submissions
&subkey = stuID
&subgroup = sms tut_lab
&withhold
final_q1
final_q2
final_q3
final_q4
final_q5
&end
&assignmap
assignment
final_q1
final_q2
final_q3
&end

Below are some directives common to the term wide give.spec file:

&loginmap

&loginmap xyz 3123456 &end
where xyz is tutor's account and 3123456 is student's id
- Use this directive when students emailed their tutors the files because of problems with submission. Tutors can submit students' assignment from their personal account this way.
- Any submission by the tutor become the student's submission. Remove the loginmap entry when the tutor has submitted.
- Another way to submit the student's problematic assignment is from the class account by specifying the -u option in the classrun command:
- classrun -u studentID -give assignment files...

&authorisation

Specify who have access to Xmark and sms

&authorisation abc MARK RSMS xyz MARK RSMS cs9999 MARK RSMS &end
Tutors type the following commands to run Xmark and sms:
- For COMP courses:
  - 9999 classrun -mark
    - for marking assignments
  - 9999 classrun -rsms
    - for entering lab marks
- For non COMP courses:
  - ssss9999 classrun -mark
  - ssss9999 classrun -rsms
    - where ssss is subject area e.g. engg1811

&smsdb

Specify where sms database is located

&subkey/&subgroup

&withhold

Specify which assignments to withhold from being collected by students.

Assignments are collectable by students as soon as they are committed in Xmark. Adding an assignment to the withhold directive stops the collection.
As well as withholding the assignment, the sms field for the corresponding assignment must be private so that students can't see their mark.

&assignmap

List of assignments, added by give-install assignment