tck.txt

java call control test kit！

JCC TCK Instructions (Rev. 1.1)
--------------------------------


Contents
--------

This package includes the Java Call Control (JCC) Test Compatibility Kit (TCK).

Subdirectories:

	jcc/bin		- tck.bat, a batch file that shows the RI passes the TCK.  
	jcc/doc		- Documentation file
	jcc/etc		- Test Description Files (TDF) files
	jcc/lib		- Compiled classes of the JCC TCK in a JAR file

Instructions
------------

To install, unzip this archive into a directory (e.g. 
the same directory in which the JCC API was unzipped). 

Description
-----------

The TCK contains 5 tests.  Some tests require stimilus, e.g. Three Stage 
Redirect requires an incomming call to redirect.  As the First Party Call 
Setup test provides this stimilus, we have combined the Three Stage Redirect 
and First Party Call Setup in one TDF file.  Invoking this TDF results in 
two signed Log files.  

For full certification a JCC implementation is required to pass all 6 basic 
tests.  The 6 resulting Log must be submitted to the certification body.    
The certification body will then examine the log files.  This examination 
may result in certification.

The TDF files, detailing the tests and their arguments,  can be 
found in the etc directory.

The 5 combined tests are briefly described below.  

NumberTranslation.tdf
Party A calls B. On ADDRESS_ANALYSE the call is redirected
to C.

ThirdPartyCallSetup.tdf:
A conference call is set up between parties A_0...A_n, where
n can be any number of parties.

ThreeStageRedirect.tdf:
A calls B. After alerting for 5 seconds, the call is redirected to C. 
After alerting for 5 seconds, the call is redirected to D.

FirstPartyCallSetup.tdf:
A calls B.

FirstPartyCallAnswer.tdf:
A calls B. B answers the connection.

The 6 (individual) basic tests are:

com.telcordia.jain.jcc.tck.ThreeStageRedirectTest
com.telcordia.jain.jcc.tck.FirstPartyCallSetupTest
com.telcordia.jain.jcc.tck.NumberTranslationTest
com.telcordia.jain.jcc.tck.NumberTranslationClientTest
com.telcordia.jain.jcc.tck.CallAnswerTest
com.telcordia.jain.jcc.tck.ThirdPartyCallSetupTest

Running
-------

For a list of options per test (assuming the appropriate JAR 
files are available in the virtual machine), do:

	java com.telcordia.jain.jcc.tck.SomeTest

All tests can be run with default options (Telcordia JCC RI + 
sample addresses) by doing the following:

	java com.telcordia.jain.jcc.tck.TestInvoker <path to etc>SomeTest.tdf

Checking
--------

The test will print on stdout whether the test succeeded or
failed. A log file will be generated in either case, 
detailing the results of the test.

Run the test without arguments to learn about the test's arguments.
See also the section "Running".

Programmatic Checking
---------------------

All tests can be invoked programmatically by calling the
'run' method on the appropriate testing class:

    public boolean run( String sPeer, String sProvider, String[] asAddresses, String sReportFile, long lTimeoutMilliSeconds )

Where:
	sPeer			- JCC Peer
	sProvider 		- JCC Provider
	asAddresses		- List of addresses to use for test
	sReportFile		- Log file to contain report
	lTimeoutMilliSeconds 	- Time (in seconds) before timeout of the test

Result:
    Boolean indicating if the test passed of failed.
    
Address Lists
-------------

The asAddresses parameter has the following format for each test:

com.telcordia.jain.jcc.tck.NumberTranslationTest:

	{ <caller>, <redirect number>, <redirect destination> }

com.telcordia.jain.jcc.tck.NumberTranslationClientTest:

	{ <caller>, <redirect number>, <redirect destination> }

com.telcordia.jain.jcc.tck.ThirdPartyCallSetupTest:

	{ <party1>, <party2>, ..., <partyN> }

com.telcordia.jain.jcc.tck.ThreeStageRedirectTest:

	{ <caller>, <callee1>, <calle2>, <callee3> }

com.telcordia.jain.jcc.tck.FirstPartyCallSetupTest:

	{ <caller>, <callee> }

com.telcordia.jain.jcc.tck.FirstPartyCallAnswerTest:

	{ <caller>, <callee> }