TCAT/Java for UNIX, Ver. 1.0.
© 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
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
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.
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 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.