oracle.apps.fnd.appltest.diagfwk.mbean.internal
Interface DiagTestExecutorMXBean

All Known Implementing Classes:

DiagTestExecutorMXBeanImpl

@MBeanRequiredCustomSecurityGroups(value={"FUSION_APPS_CRM_DIAGNOSTICS_APPID","FUSION_APPS_FSCM_DIAGNOSTICS_APPID","FUSION_APPS_HCM_DIAGNOSTICS_APPID"})
public interface DiagTestExecutorMXBean

MBean interface that allows the Diagnostics Framework to execute tests remotely within the context of an Application.

Currently this interface is private and for the purpose of Diagnostics Framework only. An instance of this MBean will get registered along with each Fusion J2EE Application that impelement Diagnostics Tests.

Execution of tests through this MBean interface will require that a diagnostic test run has already been initiated.

Because an instance of this MBean could be invoked by different user sessions and for executing different sessions, this MBean will currently service test executions on a first come first serve basis (one at a time). Any incoming requests for test executions would be placed on a queue along with an execution and an execution ID would be returned to the invoker. A separate thread would then process the executions from the queue asynchronously.

Since:

release specific (what release of product did this appear in)

Version:

$Header: atgpf/appltest/applications/Diagnostics/Engine/src/oracle/apps/fnd/appltest/diagfwk/mbean/internal/DiagTestExecutorMXBean.java /main/4 2010/04/06 14:14:54 ilawler Exp $

Author:

ppradhan

Method Summary

java.util.Map<java.lang.String,java.lang.String>

executeTests(java.lang.String pRunId, java.util.List<java.lang.String> pTestNames, java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> pParameters, java.util.Map<java.lang.String,java.lang.String> pUserContext, java.util.Map<java.lang.String,java.lang.String> pRunParams) Executes one or more Diagnostic Tests with the given name and under the given run ID and with the given list of parameters.

Method Detail

executeTests

java.util.Map<java.lang.String,java.lang.String> executeTests(java.lang.String pRunId,
                                                              java.util.List<java.lang.String> pTestNames,
                                                              java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> pParameters,
                                                              java.util.Map<java.lang.String,java.lang.String> pUserContext,
                                                              java.util.Map<java.lang.String,java.lang.String> pRunParams)

Executes one or more Diagnostic Tests with the given name and under the given run ID and with the given list of parameters.

The tests are kicked off asynchronously and the API returns an execution ID that tracks the test execution.

The list of parameters also contains any user context related parameters that might be required in order to initialize a user session in the JMX Thread prior to invocation of the test.

Parameters:

pRunId - - ID of the Run under which this test should be executed

pTestNames - - Fully qualified list of test names to be executed.

pParameters - - Input parameters for each test keyed by the test name.

pUserContext - - User context related parameters such as user guid, role guid that would be required to set an Applications context in the JMX thread during execution of the mbean.

pRunParams - - Run parameters to use for invocation in worker mode

Returns:

- A map of execution GUIDs for each specified test name (keyed by the test name)