<!-- Fragment document type declaration subset:
Arbortext, Inc., 1988-2005, v.4002
<!DOCTYPE BOOK PUBLIC "-//Sun Microsystems//DTD SolBook 3.1//EN" [
<!ENTITY % TCKentities SYSTEM "TCKentities.ent">
%TCKentities;
]>
-->
<?Pub UDT _bookmark _target>
<?Pub CX book(title()subtitle()bookinfo()chapter()>
<appendix id="GBFYD"><?Pub Dtl><?Pub Caret1><title>Frequently Asked Questions</title>
<sect1 id="GBFYQ"><title>Where do I start to debug a test failure?</title>
<para>From the JavaTest GUI, you can view recently run tests using the Test Results
Summary, by selecting the red Failed tab or the blue Error tab. See <olink type="custom-text" targetptr="GBFUV">Chapter 6</olink> for more information.</para></sect1>
<sect1 id="GBFYR"><title>How do I restart a crashed test run?</title>
<para>If you need to restart a test run, you can figure out which test crashed the
test suite by looking at the <filename>harness.trace</filename> file. The <filename>
harness.trace</filename> file is in the report directory that you supplied to the
JavaTest GUI or parameter file. Examine this trace file, then change the JavaTest
GUI initial files to that location or to a directory location below that file, and
restart. This will overwrite only <filename>.jtr</filename> files that you rerun.
As long as you do not change the value of the GUI work directory, you can continue
testing and then later compile a complete report to include results from all such
partial runs.</para></sect1>
<sect1 id="GBFWU"><title>What would cause tests be added to the exclude list?</title>
<para>The JavaTest exclude file (<filename>*.jtx</filename>) contains all tests that
are not required by Sun Microsystems to be run. The following is a list of reasons
for a test to be included in the Exclude List:</para>
<itemizedlist>
<listitem><para>An error in a Sun Microsystems reference implementation that does
not allow the test to execute properly has been discovered.</para></listitem>
<listitem><para>An error in the specification that was used as the basis of the test
has been discovered.</para></listitem>
<listitem><para>An error in the test has been discovered.</para></listitem>
</itemizedlist>
</sect1>
</appendix>
<?Pub *0000002148 0>
