Test Script Execution Adapter API

prevnext

Communication Overview


Communication between the TSEE and the TSEA occurs in three phases:

  1. Initialization phase. The TSEE:

    1. Dynamically links in the DLL for your TSEA (located under the installation folder in Rational Test\tsea).

    2. Calls SessionOpen() to start a session; the TSEA returns a session handle.

    3. Optionally, calls SessionSetOption() to set one or more session options. Session options apply to all tasks (scripts) in a session. An option may be anything (such as a working directory or timer) needed during execution.

  2. Execution phase. The TSEE:

    1. Calls TaskCreate(), which creates a test script of a type that the TSEA knows how to execute; the TSEA returns a task handle.

    2. Optionally, calls TaskSetOption() to set one or more task options.

    3. Calls TaskExecute(); the TSEA executes the task and upon completion returns the status.

    4. Closes the task handle.

    5. Repeats a-d until all tasks for this TSEA have been completed.

  3. Cleanup phase. The TSEE calls SessionClose() to close the session.

At any time during task execution, the TSEE might call TaskAbort(). For example, if the TestManager user choses to stop an executing test script or suite run, the TSEE calls TaskAbort(). If this happens, TaskExecute() should return as soon as possible with a termination status. The TSEE then terminates the session as cleanly as possible.

The following diagram (generated using Rose) is a static diagram illustrating the interactions among the components of the Java TSEA provided with TestManager.

prevnext


Rational TestManager Extensibility Reference Rational Software Corporation
Copyright (c) 2003, Rational Software Corporation http://www.rational.com
support@rational.com
info@rational.com