Programmer's Guide to the Java Cmlog Browser

Checkout files from CVS on Solaris:

  1. type: source /afs/slac/g/cd/soft/dev/script/ENVS.csh
  2. cd into a local workspace: cd ~/"YourWorkArea"
  3. type: cvs checkout package/jcmlog
  4. type: cd package/jcmlog
  5. Now you should have the complete directory structure of jcmlog. The source code resides in edu/stanford/slac/jcmlog/cmlog and edu/stanford/slac/jcmlog/cmlog/gui

Compiling on Solaris:

  1. Once source files are in your local work area, locate package and type: cd package/jcmlog
    Now you should see all directories
  2. cd edu/slac/stanford/jcmlog
  3. Type: gmake
  4. To run:
    1. Type: cd ~/"YourWorkArea"/package/jcmlog
    2. Type: cd script
    3. Open up jcmlog* and make sure the classpath is correct. Require fix should be changing the first part: $CD_SOFT/ref/package/jcmlog/edu/stanford/slac/jcmlog/ TO ../edu/stanford/slac/jcmlog/
    4. Type: jcmlog
  5. See "Returning files to CVS" below

Compiling on Windows:

You can download a local copy of jcmlog from "YourWorkArea" onto your PC using WinScp or another FTP program.

  1. Open a command prompt: Start -> Run -> type: cmd
  2. Locate the jcmlog package
  3. cd into jcmlog/edu/stanford/slac/jcmlog/
  4. Type: start Makefile
  5. This will open up a new window and will produce any compile errors
  6. To run:
    1. Type: cd ../../../../script/
    2. Type: start jcmlog
  7. See "Returning files to CVS" below

After editing, make sure that you move the new version to Unix.
This process will take a few additional steps:

  1. FTP the jcmlog package to "YourWorkArea" on unix
  2. Compile all files (See "Compiling on Solaris")
  3. Give proper permissions to the jcmlog script by typing:
    1. Type: cd package/jcmlog/script
    2. Type: chmod a+rwx jcmlog
  4. See "Returning files to CVS" below

Returning files to CVS

  1. Once the code has been compiled in your work area, you must commit the changed file(s):
    1. Type: cd edu/stanford/slac/jcmlog/NameOfDirectory
    2. Type: cvs commit NameOfFileEdited
    3. **Where NameOfDirectory is the directory to which you made changes (either cmlog or gui) and NameofFileEdited is the file to which you made changes. You can also leave NameOfFileEdited blank in that command to commit all files in the directory.
    4. Type: cvs update
    5. Type: cvs commit
    6. A pico screen will be displayed with files to be committed and opportunity to write comments on what changes were made.
        If you want to write comments:
      • Press: Enter
      • Press: Up Arrow
      • Type: "your comments"
      • To save changes, Type: Control+x+c y
  2. Rebuild ref
    1. Type: cd $CD_SOFT/ref/package/jcmlog/edu/stanford/slac/jcmlog/
    2. gmake

Other helpful documentation


SLAC Last modified: 26-Aug- 2005 by Viji Ganapathi