University of California at Berkeley Department of Electrical Engineering & Computer Sciences Instructional Support Group Sep 15, 2016 /share/b/pub/register.help /share/b/pub/submit.help /share/b/pub/glookup.help Student Procedures for using register, submit and glookup ----------------------------- CONTENTS: Overview The Commands If you are using a 'Class' Account If you are using a 'Named' Account Controlling the Size of Homework Submissions More Information Overview -------- CS classes use the grading programs originally written by Professor Paul Hilfinger for CS61B in Spring 1998. The programs manage student data that is used for the submission of assignments and the recording of grades. This data is stored on the EECS Instructional UNIX systems. It does not interact with the Registrar, but instructors can print reports that aid in the reporting of grades. Students are initialized in the grade database for a class by the 'register' program. They can submit assignments using 'submit' and display their records from the grade database using 'glookup'. Class accounts are configured automatically to use the grading utilities. As of Fall 2000, a web-based interface is available to named accounts for some upper division classes. Instructors and TAs can review the submissions with the help of optional filtering software. Then they run the 'grade' program to record grades for each student and to generate reports. The Commands ------------ These are the commands you can use to initialize yourself into the classes grade database, to submit assignments and to see your grades: * register The 'register' program prompts you for identification that will link you and your account in the local grading software. 'register' does nothing if the data has already been collected. Most students are linked to the grading software for their EECS classes when they obtain an account from our WebAcct site (http://inst.eecs.berkeley.edu/webacct). They don't need 'register'. The 'register' program is only needed by accounts that were not issued from WebAcct (notably, that is the teaching staff, who get their accounts from the instructor and not from WebAcct). When you login to a class account, it runs 'register' for you if the data has not already been collected. (Note: Having an EECS account does *not* ensure that you are officially enrolled in the class. If you have any questions about whether you are enrolled, ask your instructor.) * re-register The 'register' program does nothing if you are already registered. Run re-register to correct an error in your registration information. * check-register Prints out your registration information so that you can see if it is correct. * submit ASSIGN Submit the assignment named ASSIGN. This gathers selected files from your current directory and sends them the automated grader. It will automatically find and submit files that are required for the assignment and prompt you about submitting others in the directory. If the assignment involves working with a partner, it will ask for the logins of all your partners. In some cases, it will perform a small test of your program before submitting it. Look at the messages from submit carefully; if they seem to suggest errors, DO NOT assume that your submission succeeded. If you are using your named account and the web-based interface to submit assignments, please note. This interface does *not* automatically find files and partners. Read the instructions carefully and follow them completely or your submission will not succeed. * bug-submit ASSIGN Submits a bug report (a request for assistance) for the assignment named ASSIGN. This is like submit, but just packages up all files in the current directory without asking about them, and performs no checking. There must be a file named ERROR in the current directory, in which you should have written a brief description of the problem you are having, INCLUDING how to reproduce it. Please use this command WHENEVER you want to ask a question about something in your program that is not working. Even people who have been programming for years are TERRIBLE at guessing exactly what part of their program is really malfunctioning, so trying to send just the part of your program that you think is problematic is nearly ALWAYS wrong. It's also hard to reproduce a problem without all the text. * glookup Displays up your currently recorded grades. Each entry indicates your score, the nominal maximum score, and the weight. Multiplying your score times the weight gives the number of points you get for that assignment. 'glookup' needs to know what class you are looking for. You must have run 'register' first to add your account to the local grading database for the class. Then you can run: '/share/b/bin/glookup' (asks for the class if needed) '/share/b/bin/glookup-all' (looks for you in all classes for which you have registered) If you are using a 'Class' Account ---------------------------------- If you are using a "class" account (such as "cs61b-aa"), 'register' is runs automatically when you first login (it asks you questions), and 'glookup' assumes you are asking about that class. You can type "re-register" to update the information it is stored about you in the local grading database for that class. If you are using a 'Named' Account ---------------------------------- If you are using a 'named' account (such as "jdoe"), you have to run 'register' and tell it what class you want your account to be added to. Then you can run '/share/b/bin/glookup', which will ask you the class. Note that 'register' is only for the local grading software; it does not officially register you in the class. For using 'submit', you still need to tell it what class it is for by typing "setenv MASTER cs123" (for example) before you run 'submit'. When you are ready to submit, cd to the assignment directory and type submit ASSIGN (e.g. submit hw1) Controlling the Size of Homework Submissions -------------------------------------------- Some classes require that students use 'submit' to deliver a PDF file of a printout that the student has scanned or photographed. These files may be rejected by the 'submit' program if they are too large. If you have created a PDF file that is more than 500KB per page, you should try to compress it before submitting it. To do that: 1) Get Acrobat Pro (free from https://software.berkeley.edu/adobe) 2) Load your file into Acrobat Pro and save it in compressed mode You can find scanners and Acrobat Pro on Windows computers in 199 Cory. More Information ---------------- /share/b/pub/grading.help - general reference Questions to inst@eecs.berkeley.edu EECS Instructional Support 378/384/386 Cory, 333 Soda inst@eecs.berkelkey.edu