APPENDIX B1

************************************************************
*                 SETTING-UP YOUR HOMEPAGE                 *
************************************************************

IMPORTANT: I have created a new, generic, setup program,
called setup, stored in my MSG directory, in my jclevin 
account. Once you have copied this setup program to your
login account, you can execute setup followed by the name of
your course. For example, type:

      setup MCIS661

to setup a homepage for your MCIS661 course.

This setup program should only be executed by new students 
setting up their homepage for the first time.

************************************************************
*               HOMEPAGE SET-UP INSTRUCTIONS               *
************************************************************

A) Copy the set-up program for your course to your account.
   From the Unix prompt, in your login directory, type

   cp /home/jclevin/MSG/setup setup

   This will copy the set-up program, for your course, to 
   your account.

B) Verify that the setup file was copied to your account 
   with the 'ls' command.

C) WARNING TO STUDENTS WHO TOOK A PRIOR CLASS WITH ME:

   If you already have a public_html directory and, in it, 
   an index.html file, you need to remove both before 
   running the setup script.

   WARNING! MAKE SURE YOU ARE IN YOUR LOGIN DIRECTORY 
   (that is the directory you are when you log in on scis) 
   TO EXECUTE the setup file.

   To execute the setup file, just type from your Unix 
   prompt (replace MCIS661 by your course_id):

         setup MCIS661

D) If you want to follow step by step the setup procedure,
   you can view the content of the setup file by typing: 

         cat setup

   *  The first 3 lines, starting with a # symbol, are used 
      as comments.

   *  The fourth line: mkdir $1

      will create a directory, called $1 (in fact MCIS661), 
      where you will create your homepage.

      EXPLANATIONS: mkdir $1 is automatically translated as: 
      mkdir MCIS661 (or whatever course_id you provide).
      In other words, the $1 symbol is replaced by the 
      parameter your provide on the command line when you 
      typed setup MCIS661 (or whatever course_id you 
      provided).

   *  The fifth line: chmod 755 $1 
      (translated into chmod 755 MCIS661)

      will open the directory to the outside world.

   *  The sixth line: 

      ln -s $1 public_html
      (translated into: ln -s MCIS661 public_html)

      will create a public directory in your account,
      and link it to the MCIS661 directory.

   *  The seventh line:

      cp /home/jclevin/MSG/main.html $1/main.html
      (translated into: 
      cp /home/jclevin/MSG/main.html MCIS661/main.html)

      will create your homepage, in your MCIS661 directory, 
      by copying the course schedule of assignments from my
      account to your account.

   *  The eighth line: 

      cd $1
      (translated into: cd MCIS661)

      will change directory to your MCIS661 directory.

   *  The ninth line: 

      ln -s main.html index.html

      will create a file: index.html
      and link it to your homepage, main.html

   *  The tenth line: chmod 755 *

      will open to the outside world the files you copied to 
      your MCIS661 directory.

E) Now you can see the results of the setup program:

   Go to the MCIS661 subdirectory, by typing:

        cd MCIS661

   Then type 'ls' (without the quotes) to list the files you 
   copied. You should have 1 file, but two file names (it is
   in fact the same file) main.html and index.html.

   use the command: ls -l    to check the file permissions.
.bp