oracle.apps.fnd.appltest.diagfwk.engine
Class DiagCmdRunTests

java.lang.Object
  oracle.apps.fnd.appltest.diagfwk.engine.DiagCmd<TestRun>
      oracle.apps.fnd.appltest.diagfwk.engine.DiagCmdRunTests

All Implemented Interfaces:

DiagConstants, DiagCmdConstants

public class DiagCmdRunTests
extends DiagCmd<TestRun>

Command for running one or more tests. The following parameters are supported:

• test - a single test name or a "," separated list of test names. When specifying a single test name you can also specify one or more input parameter names and values using the "input:" parameter.
• app - One or more "," comma separated list of product codes e.g. FND,GL as specified in the Applications taxonomy.
• modid - One or more "," comma separated list of module IDs specified in the Applications taxonomy.
• modkey - One or more "," comma separated list of module keys specified in the Applications taxonomy.
• tag:[tag name]=[tag value] - Name of a tag specified in the diagnostics test repository and a Value for the tag specified in the diagnostics test repository.
• runName - A name for the current run. If not specified, a default run name is generated.
• recurse - Y/N. If Y, runs all tests associated with the specified taxonomy modules and/or diagnostic tags. If N, runs only the tests immediately associated with the specified taxonomy modules and/or diagnostic tags. The default value is Y.
• prereq - Y/N. If Y, performs a prerequisite analysis to identify any prerequisite tests and runs those prior to running the specified tests. If N, runs only the specified tests. The default value is N.
• moninterval - Monitoring interval (in seconds). Specifies the interval in seconds in which the monitoring threads will update test execution status to the test repository. Default value is 30 seconds.
• nthreads - Number of parallel threads to use in order to execute tests. Default value is 5.
• input:[param name]=[param value] - The "input:" option is only applicable when running a single test using the "test" option. One or more parameter names and values for those paramters can be specified using this option.
• execmode - This is a hidden argument used only by the engine in order to indicate the client that invoked the run. possible values are 'C' - for command line. 'U' - for local UI. 'B' - for batch program etc.

This command will return a TestRun object representing the test executed test run. If the "waitForCompletion" parameter was set to "Y", the returned TestRun object is fully populated with all the executed test executions. However if the "waitForCompletion" parameter was set to "N" (this is the default behaviour), the TestRun object is returned as soon as the execution is kicked off and may not contain completion information. In such cases, the TestRun object will contain a run ID (GUID) that can be used by the client to track the status of the run.

Nested Class Summary

static class	DiagCmdRunTests.AppArg Internal class representing a single "app" argument
static class	DiagCmdRunTests.ChainedTestListSet Models a set of ExecTestListSet objects that have been chained to run in serial.
class	DiagCmdRunTests.CmdExecutor Internal runner class for executing the argument.
static class	DiagCmdRunTests.ExecArg Internal class to model an argument name value pair that represents an executable entity.
static class	DiagCmdRunTests.ModKeyArg Internal class representing a single "modkey" argument
static class	DiagCmdRunTests.TagNameValueArg Internal class representing a single "tag:name" and value argument
static class	DiagCmdRunTests.TestArg Internal class representing a single test name argument
class	DiagCmdRunTests.TestDefCacheHandler This handler caches the TestDefs used in the current Test Run.
static class	DiagCmdRunTests.TestListSet Models a set of Lists of test IDs that can be kicked off in parallel with each other.
static class	DiagCmdRunTests.TVIArg Internal class representing a single tag value Id argument

Nested classes/interfaces inherited from interface oracle.apps.fnd.appltest.diagfwk.common.DiagConstants

DiagConstants.ExecutionMode, DiagConstants.Format, DiagConstants.LinkType, DiagConstants.Status

Field Summary

static int

DEFVAL_NTHREADS

Fields inherited from class oracle.apps.fnd.appltest.diagfwk.engine.DiagCmd

mParams

Fields inherited from interface oracle.apps.fnd.appltest.diagfwk.engine.DiagCmdConstants

DELIM_VALUE, PARAM_APP, PARAM_CHILD_REPORTS, PARAM_CONNECT_STR, PARAM_DB_PWD, PARAM_DB_UN, PARAM_DESTDIR, PARAM_DIR, PARAM_EXEC_MODE, PARAM_EXECID, PARAM_FORMAT, PARAM_HELP, PARAM_LANG, PARAM_MAKESUBDIR, PARAM_MODID, PARAM_MODKEY, PARAM_NTHREADS, PARAM_PREREQ, PARAM_PRINTTOCONSOLE, PARAM_PRINTTREE, PARAM_PWD, PARAM_QUERY, PARAM_RECURSE, PARAM_REGISTER, PARAM_REPORT, PARAM_RUN_LOCALLY, PARAM_RUN_NAME, PARAM_RUNID, PARAM_RUNTEST, PARAM_STATUS, PARAM_TEST, PARAM_TESTFILE, PARAM_TOKEN_INPUT, PARAM_TOKEN_TAG, PARAM_TRANSLATE, PARAM_USERNAME, PARAM_VALIDATE_ONLY, PARAM_WAITFORCOMPLETION, PARAM_WRITETOFILE, PRE_POPULATED_EXECID

Fields inherited from interface oracle.apps.fnd.appltest.diagfwk.common.DiagConstants

APPS_MSG_ID_TAG_NAME, CFG_ADR_PROVIDER_CLASS, CFG_CACHE_PROVIDER_CLASS, CFG_CRED_PROVIDER_CLASS, CFG_DAO_FACTORY_CLASS, CFG_DB_CONN_INFO_PROVIDER_CLASS, CFG_DB_CONN_PROVIDER_CLASS, CFG_NLS_PROVIDER_CLASS, CFG_PLSQL_PROVIDER_CLASS, CFG_PROFILE_PROVIDER_CLASS, CFG_SECURITY_PROVIDER_CLASS, CFG_SESSION_INFO_PROVIDER_CLASS, CFG_URL_PROVIDER_FACTORY_CLASS, CFG_WLS_MBEANSRV_CONNINFO_PROVIDER_CLASS, DATA_SECURITY_PERMISSION_ALLOWED, DATA_SECURITY_PERMISSION_NOT_ALLOWED, DELIM_URL, EXEC_MODE_CLI, EXEC_MODE_ESS, EXEC_MODE_INCIDENT, EXEC_MODE_JAVA, EXEC_MODE_UI, EXECUTABLE_TYPE_JAVA, EXECUTABLE_TYPE_PLSQL, EXECUTABLE_TYPE_TESTREF, FORMAT_HTML, FORMAT_XML, GUID_ORACLE_MINUS1, GUID_ORACLE_ZERO, INPUTS_STATUS_ALL_OPT_INPUTS, INPUTS_STATUS_NO_INPUTS, INPUTS_STATUS_REQ_INPUTS_NO_DEFAULTS, INPUTS_STATUS_REQ_INPUTS_W_DEFAULTS, IO_FLAG_I, IO_FLAG_O, JMX_API_BASE_OBJECT_NAME, LINK_EXTERNAL, LINK_INTERNAL, LINK_METALINK, N, NLS_BUNDLE_JAVA_RES, NLS_BUNDLE_MSG_SVC, NLS_BUNDLE_RES_REF, NLS_BUNDLE_XLIFF, NO, NULL, ODF_MBEAN_DOMAIN_NAME, PARAM_MON_INTERVAL, PLSQL_DEBUG_ENABLED_SYSTEM_PROP, PREREQ_TYPE_TAG_VALUE, PREREQ_TYPE_TEST, SECONDS_IN_ONE_DAY, SECONDS_IN_ONE_HOUR, STATUS_CANCELED, STATUS_EXECERROR, STATUS_FAILURE, STATUS_RUNNING, STATUS_SUCCESS, STATUS_WARNING, SYS_PROP_MAX_MONITOR_INTERNVAL, SYS_PROP_MAX_NUM_THREADS, SYSPROP_APPCONNFILE, SYSPROP_DIAG_CONFIG_FILE, TAG_TYPE_DIAG, TAG_TYPE_TAXONOMY, TEST_TYPE_DECL, TEST_TYPE_JAVA, USER_NAME, WEB_APP_NAME_TAG_NAME, Y, YES

Constructor Summary

DiagCmdRunTests()

Method Summary

TestRun	execute() Executes one or more tests based on the given parameters.
java.lang.Thread	getExecutorThread() Returns the handle on the executor thread if the runner command was called with waitForCompletion=N option.
void	putTestInputs(java.lang.String pTestName, NameValueList pTestInputs) Puts the given list of input parameter name values for the given test name
void	setTestInputs(java.util.Map<java.lang.String,NameValueList> pInputs) Sets the given set of inputs for this command

Methods inherited from class oracle.apps.fnd.appltest.diagfwk.engine.DiagCmd

addUpdateParam, getIntParam, getParam, getParam, getParam, getParams, getPosIntParam, getYNFlagParam, isParamName, logParams, setParams, tokenize, validateExactlyOneReqParam

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFVAL_NTHREADS

public static final int DEFVAL_NTHREADS

See Also:

Constant Field Values

Constructor Detail

DiagCmdRunTests

public DiagCmdRunTests()

Method Detail

putTestInputs

public void putTestInputs(java.lang.String pTestName,
                          NameValueList pTestInputs)

Puts the given list of input parameter name values for the given test name

setTestInputs

public void setTestInputs(java.util.Map<java.lang.String,NameValueList> pInputs)

Sets the given set of inputs for this command

execute

public TestRun execute()

Executes one or more tests based on the given parameters. Returns a run ID for the tests.

Specified by:

execute in class DiagCmd<TestRun>

Returns:

a test run object corresponding to the current run.

getExecutorThread

public java.lang.Thread getExecutorThread()

Returns the handle on the executor thread if the runner command was called with waitForCompletion=N option. Otherwise returns null.

Returns:

the executor thread.