com.ibm.rational.test.lt.kernel.services
Interface ITestExecutionServices


public interface ITestExecutionServices

The ITestExecutionServices interface provides information for adding custom test execution features to tests. This interface replaces the IKLog interface. All the methods that were available in IKLog are contained in ITestExecutionServices, along with several newly exposed objects and interfaces. ITestExecutionServices is the primary interface for test execution services.

ITestExecutionServices provides a number of methods for use in ICustomCode2. Each of these methods returns an object that provides further services in that area.


Method Summary
 IDataArea findDataArea(java.lang.String name)
          Returns an IDataArea object for the named DataArea or null if no such DataArea exists.
 IARM getARM()
          Retuns an IARM object that exposes ARM (Application Response Measurement)-related methods.
 ILoopControl getLoopControl()
          Returns an ILoopControl object that provides methods for limited control of the nearest enclosing loop in a performance test or schedule.
 IPDLogManager getPDLogManager()
          Returns an IPDLogManager object that provides methods for writing messages into the problem determination log from custom code actions.
 IStatisticsManager getStatisticsManager()
          Returns an IStatisticsManager object that provides methods for creating and reporting statistical model counters.
 ITestLogManager getTestLogManager()
          Returns an ITestLogManager object that provides methods for writing events, such as messages and verification points, to the TestLog (execution history).
 ITime getTime()
          Returns an ITime object that provides basic time methods used to synchronize all the computers in a performance test run, and to record the test start and elapsed time.
 ITransaction getTransaction(java.lang.String label)
          Asserts that an ITransaction object with the given label exists in the virtual tester's transaction collection and returns a reference to that transaction object.
 

Method Detail

getARM

public IARM getARM()
Retuns an IARM object that exposes ARM (Application Response Measurement)-related methods. These methods apply to virtual users that are being sampled for ARM processing.

Returns:
An IARM object that exposes ARM-related methods.

findDataArea

public IDataArea findDataArea(java.lang.String name)
Returns an IDataArea object for the named DataArea or null if no such DataArea exists. Three publicly accessible data areas are provided:

EnginData

Owned by the engine and contains objects that apply to the entire engine and persist for the duration of the test run.

VirtualUserData

Owned by the virtual user container and contains objects that persist for the life of the virtual user.

TestData

Owned by the KScript container (which all tests extend) and contains objects that persist for the duration of the individual test script.

Other DataAreas might be provided for specific protocols.

Parameters:
name -
Returns:
An IDataArea object for the named DataArea or null if no such DataArea exists.

getLoopControl

public ILoopControl getLoopControl()
Returns an ILoopControl object that provides methods for limited control of the nearest enclosing loop in a performance test or schedule.

Returns:
An ILoopControl object that provides methods for limited control of the nearest enclosing loop.

getPDLogManager

public IPDLogManager getPDLogManager()
Returns an IPDLogManager object that provides methods for writing messages into the problem determination log from custom code actions.

Returns:
An IPDLogManager object that provides methods for writing messages into the problem determination log.

getStatisticsManager

public IStatisticsManager getStatisticsManager()
Returns an IStatisticsManager object that provides methods for creating and reporting statistical model counters. These counters can then be accessed through the performance test reports.

Returns:
An IStatisticsManager object that provides methods for creating and reporting statistical model counters.

getTestLogManager

public ITestLogManager getTestLogManager()
Returns an ITestLogManager object that provides methods for writing events, such as messages and verification points, to the TestLog (execution history).

Returns:
An ITestLogManager object that provides methods for writing events to the TestLog (execution history).

getTime

public ITime getTime()
Returns an ITime object that provides basic time methods used to synchronize all the computers in a performance test run, and to record the test start and elapsed time.

Returns:
An ITime object that provides basic time methods.

getTransaction

public ITransaction getTransaction(java.lang.String label)
Asserts that an ITransaction object with the given label exists in the virtual tester's transaction collection and returns a reference to that transaction object.

Parameters:
label -
Returns:
A reference to the ITransaction object with the given label in the virtual tester's transaction collection.


Copyright (c) IBM Corp. and others 2005. All rights reserved