TCAT/Java for UNIX, Ver. 1.0. RELEASE NOTES © Copyright 1999-2006 by Software Research, Inc.

This Release Note describes changes and additions to TCAT for Java Ver. 1.0 for SPARC/SOLARIS platforms.

• Run install.tcatjava in place of install scripts as described in Section 1.5.4, step 2 of the installation manual (page 20).

• The Java Development Kit (JDK) must be installed to use the TCAT for Java instrumentor (ijava). The reason for this is that the instrumenter calls the javac command to convert submitted Java files *.java into the corresponding instrumented class files *.class.

• Enter ijava-TCAT-help from the command line to see the options available from this version of the Java instrumentor.

• TCAT for Java will only accept valid Java syntax. Otherwise, unexpected results may occur.

• S1 instrumentation is not supported in the present version.

• Some constructors may not be instrumented and/or may be instrumented incorrectly.

• Static blocks, of the form shown below in the fragment below, are NOT instrumented.

  
  	static {
   	 ...
  	 (static executable code)
  	 ...
  	}
  

  Static methods invoked by static blocks WILL be instrumented, however.

• The instrumented Java code must be executed as either a standalone application (i.e. java myapp.class) or in the appletviewer. Execution in the Java Virtual Machine of a web browser is not supported at this time.

• When executing the instrumented code in the appletviewer the class file of the applet and the TCAT for Java runtime classes must be in a directory that is listed in the current CLASSPATH.

• The file "mdf.pro", generated during instrumentation, must be in the same directory as the instrumented Java class file.

• Right now we only support Java 1.02. Even though Java 1.1 is out it is not yet supported by any browsers...We will add Java 1.1 support later.

• Buffering Options for Java Runtime: We supply versions of jrun.class that are buffered with various buffer lengths. You have to copy the correct jrun[?].class file into your copy of jrun.class to get the right effect; the default version is jrun.class = jrun1.class.

  The supplied versions buffer at the level of 1, 100, 10,000 and (infinite) buffering. Buffering is accomplished based on the total number of hits made of segments and/or call-pairs.

  WARNING: If the Java applet does not terminate normally then you may lose as much as one (i.e. the last) test tracefile bufferload of coverage data.

• Selecting the correct version of the Java runtime. The various versions are named as follows:

  Hits per Buffer	Class Name
  1	jrun1.class
  100	jrun100.class
  10,000	jrun10000.class
  Infinite	jruninf.class

  These jrun classes are stored in the $SR/lib directory. Copy the class that implements the desired buffering size to jrun.class in the same directory before executing the applet or application.