Submitting Programs using the Turnin Utility

 

To submit programming projects on pooh, a utility named turnin is employed. Turnin takes the files specified in the command and places them in a subdirectory belonging to your course instructor that is reserved for your submissions. This will allow submission and grading of programs to occur as efficiently as possible.

 

Invoking turnin:

For each programming project, you will submit all requested files using the turnin command, as follows:

 

turnin<class #>     <file­1>    <file­­­2>    …    <filen>

 

where:

¨       <class #> is the CIS number for this course

¨       <filei> is the name of a file in the present directory or the name of a file that includes a full pathname.

There is no limit to the number of files that may be turned in via the turnin command. The names of the files are separated by whitespace (at least one blank); do not use any character to delimit file names.

 

For example, if a student in CIS 235 intends to turn in the files project1.cpp and ReadMe.txt, the command would be:

 

turnin235  project1.cpp  ReadMe.txt

 

Note that there is no blank between the turnin and the 235.

 

Setting up turnin:

To set up the turnin utility for your use, you will run a perl script that alters your .login file and creates or updates your .alias file. This script is to be run once only each term. To run this script, issue the following command from your root directory on pooh:

 

perl   /export/home/public/spiegel/turnin.pl    <course>    <section>

 

where:

¨       <course> is the course number. If you are in CIS 135, this argument would be 135 (no CIS)

¨       <section> is your section number. This is necessary in order that your submission be placed in the area for your particular section of the course.

¨       the blanks are entered as implied

 

If you are in CIS 135 section 045, you would set up turnin using the command:

 

perl   /export/home/public/spiegel/turnin.pl    135     045

 

Notes:

Ø      The perl script turnin.pl must be run from your login, or root directory (the directory you start in when you log in to pooh). If you run it from any other directory, you won't be able to use turnin. Remember, it is run only once per semester. You are responsible to set up turnin BEFORE the first project is due. Turnin not set up is NOT a legitimate excuse to turn in late work.

Ø      The section number used in setting up turnin must be a 3-digit number, even if the first digit is 0.

Ø      You may turn in a file any number of times. Each submission will overwrite the previous version submitted.

Ø      You can't access the subdirectory to which files were turned in. Any concerns should be directed to the course instructor.

Ø      After each execution of turnin, you will receive an e-mail containing a listing of the files you have turned in (now or previously) for this project. If you don't receive this mail, it is possible that the turnin failed.

Ø      After login, a menu is presented, with options accessed via number or by using the arrow keys. To access turnin, you must quit this menu using the q key. Or, issue the following command, which should activate turnin: source   ~/.alias

Ø      Please report any difficulty with setting up or using turnin to the course instructor as quickly as possible.