Sun Microsystems 1.2 manual Appendix C Test Description Fields and Keywords

TABLE C-1Framework Test Description Fields (Continued)

Field	Description
executeArgs	An array of strings that are passed to the test classes being executed. The
	arguments might be fixed but often involve symbolic values that are
	substituted from the test environment (variables defined elsewhere in the
	test environment). The result of substituting values can be seen in the
	resulting .jtr files.
	These arguments form the basis for the set of arguments that are passed
	into the tests defined in the executeClass field.
	The default value of any variable not defined in the test environment is an
	empty string.
timeout	A value specified in seconds used to override the default ten-minute
	timeout used with all test suite tests.
context	Specifies configuration values required by the test. When a test requires
	information about the technology under test (context) to determine the
	expected results, this information is identified in the context field of the
	test description table. The harness checks to be sure that all values
	specified in the context field are defined in the test environment before it
	attempts to execute the test. If any of the values are not set, the test is not
	executed and the test is considered to be in error. See the Java Technology
	Test Suite Development Guide for detailed information about setting context
	sensitive properties for a test.
grant	Space-separated list of MIDP permission names. Specifies MIDP
	permissions that must be granted for this test application. If tests are run
	as trusted MIDlets, these permissions are included in the MIDlet-
	Permissions attribute for the test MIDlet. If tests are run as untrusted
	MIDlets, the tests are filtered out if the security policy does not have all of
	these permissions granted in the untrusted domain.
deny	Space-separated list of MIDP permission names. Specifies MIDP
	permissions that must be denied for this test application. If tests are run as
	trusted MIDlets, these permissions are not included in the MIDlet-
	Permissions attribute for the test MIDlet. If tests are run as untrusted
	MIDlets, the test can be filtered out if the security policy has all of these
	permissions granted in the untrusted domain.
selectIf	Specifies a condition that must be satisfied for the test to be executed. This
	field is constructed using environment values, Java programming
	language literals, and the full set of Boolean operators:
	(+, -, *, /, <, >, <=, >=, &, , !, !=, ==).
	Example:
	integerValue>=4 & display==”my_computer:0”
	If the Boolean expression evaluates to false, the test is not run. If the
	expression evaluates to true, the test is run. If any of the values are not
	defined in the test environment, the harness considers the test to be in
	error.

Appendix C Test Description Fields and Keywords 93