CptS 203: Using the submit Utility



You will be using the submit utility to submit your programs for the "electronic assignments."  As an example of how submit is used, assume on the third homework assignment there are three separate problems that require you to write three separate programs.  So that everything is well organized, you should put each program into a separate directory and these subdirectories should be under a single (clean) parent directory.  A good name for that parent is HW3 and the subdirectories could be called prob1, prob2, and prob3.  Your material might be organize as follows:

         (HW3's parent directory)
                    |
                   HW3
                    |
      +-------------+--------------+
      |             |              |
    prob1         prob2          prob3
      |             |              |
  (code for     (code for     (code for
   problem 1)    problem 2)    problem 3)
(These directories all could have been created by issuing the command
  mkdir -p HW3/prob1 HW3/prob1 HW3/prob1
then HW3 would be a subdirectory of the directory from which you issued this command.  You could then use cd to move to each of the prob subdirectories and create the appropriate files there.)

After completing your work, the subdirectories prob1, prob2, and prob3 may contain FORTRAN files (.f files) and various input or output files.  Ultimately the contents will depend of the details of the particular assignment.  However, before you submit your work, please ensure that the directories are as clean as possible.  Remove old versions of code (if you use emacs, old versions of files are automatically created for you and they are indicated with a trailing tilde).

When you are ready to submit your work, cd to the parent directory of HW3.  Then, issue the following command:

   submit cs203 HW3
This command essentially says "bundle up all the directories and files that appears under the directory HW3 and ship them to the cs203 class account."  If get an error message about HW3 not existing, you probably didn't issue this command from the parent directory of HW3.  Try doing an ls.  If you don't see HW3 listed, you are in the wrong place.  Use cd to get to the correct location.  After your successful submission, you will receive confirmation via email of the submission.  NOTE: If, after a short time, you do not receive confirmation, you must assume that the submission did not work! However, you should also not that this confirmation is sent to your EECS email address.  You have to have set that up properly in accordance with the information supplied in the getting-started handout.  If you don't receive confirmation, try re-submitting (but don't try more than once or twice).  If that doesn't work, contact the folks at the help desk in Sloan 358, or send the TA or me email explaining the problem.

The confirmation message will look something like this:

  File HW3.tar.Z was submitted to cs203 by schneidj on Wed, 
  9 Jan 2002 10:06:29 - 0700 (PDT)
The mail will come from "CS203 - Class account."  In case you're interested, the .tar means the contents of the HW3 directory were tar'ed, meaning they were bundled into a "Tape ARchive" format, and the .Z means the tar file was compressed.  But, fortunately, you don't have to worry about these details.

IMPORTANT!  For each assignment, make sure you place your work in a directory called HW followed by the assignment number.  Your solution is the submission of that directory.  (Actually, you do not have to use uppercase letters for the directory name.  Examples of valid names are HW3, hw3, or Hw3.)  When your homework is graded, an automated "script" is employed that assumes you have used this naming convention.  If you do not use it, the TA probably won't see your work and you may not get credit.

Finally, note that you must be logged on to one of the lab machines running Linux to use the submit utility.  This is the only way to submit your work.  Any other form of submission, such as email to the TA or me, will receive zero credit.  Use the submit utility and use it prior to the submission deadline!


Back to CptS 203 homepage.

John B. Schneider, schneidj@eecs.wsu.edu, January 13, 2002.