sun.com docs.sun.com | My Sun Worldwide Sites

|  | Products |  | Downloads |  | Service & Solutions |  | Support |  | Training |  | Research

| Contents Next
# Technology Compatibility Kit User's Guide for SOAP with Attachments API for Java 1.3 ### For Technology Licensees # Preface This guide describes how to install, configure, and run the Technology Compatibility Kit (TCK) that is used to test the Common SOAP with Attachments API for Java 1.3 (SAAJ 1.3) technology. The SAAJ TCK is designed as a portable, configurable automated test suite for verifying the compatibility of a licensee's implementation of the SAAJ 1.3 Specification (hereafter referred to as the licensee implementation). The SAAJ TCK uses the JavaTest harness version 3.2.1 to run the test suite Note - 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. Refer to the Java Partner Engineering Web site for answers to frequently asked questions and send questions you may have to your Java Partner Engineering contact. ## Who Should Use This Book This guide is for licensees of Sun Microsystems's SAAJ 1.3 technology to assist them in running the test suite that verifies compatibility of their implementation of the SAAJ 1.3 Specification. ## Before You Read This Book Before reading this guide, you should familiarize yourself with the Java programming language and the SAAJ 1.3 Specification. A good resource for the Java Programming language is the Sun Microsystems, Inc. Web site. The SOAP with Attachments API for Java 1.3 is based on the SAAJ Specification 1.3. Links to the specification and other product information can be found on the Web at http://jcp.org/aboutJava/communityprocess/maintenance/jsr067/index2.html. Sun Microsystems recommends that before you run the tests in the SAAJ TCK you have read and are familiar with the SAAJ 1.3 Specification and the JavaTest User's Guide, which describes the main JavaTest harness. The JavaTest User's Guide is located at `<install_dir>``/docs/javatest/javatest.pdf` in the SAAJ TCK distribution. ## How This Book is Organized If you are installing and using the SAAJ TCK for the first time, it is recommended that you read Chapter 1 and Chapter 2 completely for the necessary background information, and then perform the steps outlined in the remaining chapters, while referring to the appendix as necessary. Chapter 1 gives an overview of the principles that apply generally to all Technology Compatibility Kits (TCKs) and describes the SAAJ TCK. It also includes a listing of the basic steps needed to get up and running with the SAAJ TCK. Chapter 2 describes the conformance testing procedure and testing requirements. Chapter 3 explains how to install the SAAJ TCK. Chapter 4 describes how to set up the SAAJ TCK and how to start and configure the JavaTest harness software to be used with the SAAJ TCK. Chapter 5 describes how to start the JavaTest harness and use the SAAJ TCK. Chapter 6 describes several approaches for dealing with tests that fail to execute properly. Appendix A provides answers to frequently asked questions. ## Typographic Conventions The following table describes the typographic conventions that are used in this book. Table P-1 Typographic Conventions
Typeface | Meaning | Example
--- | --- | ---
`AaBbCc123` | The names of commands, files, and directories, and onscreen computer output | Edit your `.login` file. Use `ls `-a`` to list all files. `machine_name% you have mail.`
`AaBbCc123` | What you type, contrasted with onscreen computer output | `machine_name%` `su` `Password:`
aabbcc123 | Placeholder: replace with a real name or value | The command to remove a file is `rm` filename.
AaBbCc123 | Book titles, new terms, and terms to be emphasized | Read Chapter 6 in the User's Guide. A cache is a copy that is stored locally. Do not save the file. Note: Some emphasized items appear bold online.
## Shell Prompts in Command Examples The following table shows the default UNIX® system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell. Table P-2 Shell Prompts
Shell | Prompt
--- | ---
C shell | `machine_name%`
C shell for superuser | `machine_name#`
Bourne shell and Korn shell | `$`
Bourne shell and Korn shell for superuser | `#`
## Related Documentation Table P-3 Related Documentation Titles
Application | Title
--- | ---
Using JavaTest software | JavaTest User's Guide and JavaTest online help (located in the `TS_HOME/docs` directory in the SAAJ TCK distribution)
SAAJ reference | The SOAP with Attachments API for Java 1.3 Specification
Using Java technology | Java Programming Language, Java Language Specification Second Edition, Java Virtual Machine Specification Second Edition, Java 2 Platform
## Accessing Sun Documentation Online The Java Developer ConnectionSM Web site enables you to access Java platform technical documentation. ## Sun Welcomes Your Comments We are interested in improving our documentation and welcome your comments and suggestions. You can email your comments to us at mailto:docs@java.sun.com.
| Contents Next

Company Info Contact Terms of Use Privacy Copyright 1994-2006 Sun Microsystems, Inc.