<!-- Fragment document type declaration subset:
Arbortext, Inc., 1988-2006, v.4002
<!DOCTYPE SOLBOOK PUBLIC "-//Sun Microsystems//DTD SolBook 3.1//EN" [
<!ENTITY % TCKentities SYSTEM "TCKentities.ent">
%TCKentities;
<!ENTITY typeconv SYSTEM "typeconv.sgm">
]>
-->
<?Pub UDT _bookmark _target>
<?Pub CX solbook(>
<preface id="GBFTI"><?Pub Dtl><?Pub Caret><title>Preface</title>
<highlights>
<para>This guide describes how to install, configure, and run the Technology
Compatibility Kit (TCK) that is used to test the Common &TechnologyFullName; (&TechnologyShortName; &TechnologyVersion;)
technology.</para>
<para>The &TCKShortName; is designed as a portable, configurable automated
test suite for verifying the compatibility of a licensee's implementation
of the &TechnologyShortName; &TechnologyVersion; Specification (hereafter
referred to as the licensee implementation). The &TCKShortName; uses the JavaTest
harness version &JavaTestVersion; to run the test suite</para>
<note><para>Note  All references to specific Web URLs are given for the sake
of your convenience in locating the resources quickly. These references are
always subject to changes that are in many cases beyond the control of the
authors of this guide.</para></note>
<para>Refer to the &JavaPartnerURL; Web site for answers to frequently asked
questions and send questions you may have to your Java Partner Engineering
contact.</para></highlights>
<sect1 id="GBFUS"><?Pub Dtl><title>Who Should Use This Book</title>
<para>This guide is for licensees of Sun Microsystems's &TechnologyShortName; &TechnologyVersion; technology
to assist them in running the test suite that verifies compatibility of their
implementation of the &TechnologyShortName; &TechnologyVersion; Specification.</para>
</sect1>
<sect1 id="GBFPO"><?Pub Dtl><title>Before You Read This Book</title>
<para>Before reading this guide, you should familiarize yourself with the
Java programming language and the &TechnologyShortName; &TechnologyVersion; Specification.
A good resource for the Java Programming language is the <ulink
url="http://java.sun.com" type="text_url">Sun Microsystems, Inc.</ulink> Web
site.</para>
<para>The &TechnologyFullName; is based on the &TechnologyShortName; Specification &TechnologyVersion;.
Links to the specification and other product information can be found on the
Web at &SpecURL;. Sun Microsystems recommends that before you run the tests
in the &TCKShortName; you have read and are familiar with the &TechnologyShortName; &TechnologyVersion; Specification
and the JavaTest User's Guide, which describes the main JavaTest harness.
The JavaTest User's Guide is located at <varname>&lt;install_dir></varname><filename>
/docs/javatest/javatest.pdf</filename> in the &TCKShortName; distribution.</para>
</sect1>
<sect1 id="GBFQI"><?Pub Dtl><title>How This Book is Organized</title>
<para>If you are installing and using the &TCKShortName; for the first time,
it is recommended that you read <olink type="custom-text" targetptr="GBFOW">Chapter
1</olink> and <olink type="custom-text" targetptr="GBFSN">Chapter 2</olink> completely
for the necessary background information, and then perform the steps outlined
in the remaining chapters, while referring to the appendix as necessary.</para>
<itemizedlist><?Pub Dtl>
<listitem><para><olink type="custom-text" targetptr="GBFOW">Chapter 1</olink> gives
an overview of the principles that apply generally to all Technology Compatibility
Kits (TCKs) and describes the &TCKShortName;. It also includes a listing of
the basic steps needed to get up and running with the &TCKShortName;.</para>
</listitem>
<listitem><para><olink type="custom-text" targetptr="GBFSN">Chapter 2</olink> describes
the conformance testing procedure and testing requirements.</para></listitem>
<listitem><para><olink type="custom-text" targetptr="GBFTP">Chapter 3</olink> explains
how to install the &TCKShortName;.</para></listitem>
<listitem><para><olink type="custom-text" targetptr="GBFVV">Chapter 4</olink> describes
how to set up the &TCKShortName; and how to start and configure the JavaTest
harness software to be used with the &TCKShortName;.</para></listitem>
<listitem><para><olink type="custom-text" targetptr="GBFWO">Chapter 5</olink> describes
how to start the JavaTest harness and use the &TCKShortName;.</para></listitem>
<listitem><para><olink type="custom-text" targetptr="GBFUV">Chapter 6</olink> describes
several approaches for dealing with tests that fail to execute properly.</para>
</listitem>
<listitem><para><olink type="custom-text" targetptr="GBFYD">Appendix A</olink> provides
answers to frequently asked questions.</para></listitem>
</itemizedlist>
</sect1>&typeconv;
&TCKdocs;
</preface>
<?Pub *0000004730 0>
