This semester all programming assignments will be submitted electronically. The programs will be compiled and executed automatically on the Department's HPUX systems. The grading template (the criteria included in the problem statement) will be inserted into your source code and filled in by the grader. Your source program will then be returned via e-mail and/or returned in class depending on the homework project.

This file contains the general turn-in instructions. There will be additional instructions that are specific to each programming project in that programming project's statement document. (filenames, etc.)

The turnin script sends your program to the TA's grading account by packaging up everything that is the directory you are currently in (and everything that is below that directory) and sending that package to the TA. It is very important that you execute the turnin script from the correct directory.

To ensure that this process goes smoothly please follow the steps described here. FAILURE TO DO SO WILL CAUSE AT LEAST 20% OF THE POINTS FOR THE HW TO BE DEDUCTED FROM YOUR SCORE. If you have any questions about turning in your program, please feel free to come see one of the course staff, send e-mail to the TA's, or bring the question up in recitation. It is the students' responsibility to get his or her question answered 24 hours before the programming project is due.

You must be on one of the following Computer Science machines: stimpy, shazam or popeye. You could physically be using one of the terminals in Atanasoff 115/116 or you could telnet to one of these machines. (This does not include the terminals along the west wall of 115 Atanasoff that have floppy disk drives.) Your prompt will normally tell you what machine you are on, but if you are unsure you can enter the following:

hostname


The first name before the ".cs.iastate.edu" is the name of the machine you are on.

The first time you use the turnin script please do the following:

mkdir ~/turnin


You will find adding the following line to your .cshrc file helpful.

alias turnin /home/course/cs228/public/bin/turnin


This will allow you to avoid typing the fully qualified path to the turnin script every time you run the script. You will need to logoff and re-login in order for this alias to work.

When you are ready to turn in the programming assignment do the following:

1. clean out old programs from the turnin directory

cd ~/turnin

rm *


(Of course, you don't want to play the "rm *" game in the wrong directory.)

2. cd into the directory in which you wrote your program

cd ~/hw-directory

(where hw-directory would be the path and/or name of the directory in which you wrote your program)

3. copy your SOURCE program files into the turnin directory. (NO EXECUTABLES or object .o FILES!!!)

cp fileName.h fileName1.C fileName2.C ~/turnin/


(where fileName.h, fileName2.C, etc. are your SOURCE program files. This may be one or more files depending on the programming project. Use the naming convention specified in the statement document for the specific programming project.)

4. go back to the turnin directory

cd ~/turnin


5. execute the turnin script. If you have not aliased the turnin script, you will need to type:

/home/course/cs228/public/bin/turnin cs228 hw-name


If you have set up the alias, you can just type

turnin cs228 hw-name


Note that the argument cs228 pertains to the account "catching" your submission and the second argument, hw-name, specifies the directory at "our end" into which we will move the received files. Neither of these arguments have anything to do with your directory structure. The exact names of these arguments will be stated in the statement file for each programming project. Do not change these names.

(for example, do not enter: turnin cs228 hw-name.C)

The following is a typescript showing a sample turnin for a FICTITIOUS homework called 'hello'.

shazam:~> cd turnin

shazam:~/turnin> ls

shazam:~/turnin> cd ~/hello

shazam:~/hello> g++ -ansi -o hello hello.C

shazam:~/hello> ls

hello hello.C

shazam:~/hello> cat hello.C

// hello.C


#include <iostream.h>


int main()

{

cout << "Hello World!\n";

} // end main


shazam:~/hello> cp hello.C ~/turnin/

shazam:~/hello> cd ~/turnin

shazam:~/turnin> ls

hello.C

shazam:~/turnin> /home/course/cs228/public/bin/turnin cs228 hello

Mail sent!

shazam:~/turnin> exit

script done on Thu Aug 25 10:15:36 1996


When the TA account has received your homework it will send you a message to that effect on your Computer Science account. When you receive this message you can be sure that the files from the directory you were in when you ran the turnin script have reached us. Receipt of this message does not mean that you submitted "the right files", or that the files you submitted constitute a correct solution to the HW.

If you have any problems with the turnin script, please contact one of the TA's as soon as possible so we can correct the problem. If you are unsure of how this turnin procedure works, see one of the TAs at their office hours BEFORE the programming project is due. We will be very strict about turn-ins. FAILURE TO FOLLOW THE TURNIN INSTRUCTIONS WILL RESULT IN A PENALTY TO YOU GRADE.