<?xml version="1.0"?>

<sections>

<section name="Test" endname="Endtest" proposal="[Test]\    title testcasename\[Endtest]">

<command id="title">

	<mandatory>

		<argument type="normal" value="literal" binding="none" nextvalue="none">

			string 

		</argument>

	</mandatory>

	<optional>

		<argument type="normal" value="words" binding="none" nextvalue="none">

			value 

		</argument>

	</optional>

	<errornote>

	Title commmand requires test title as an argument	

	</errornote>

	<commandinfo>

Specifies a verbal description for a test case.

title testcasedescription

Arguments:

test case description:	A verbal description for a test case.

	</commandinfo>

</command>

<command id="timeout">

	<mandatory>

		<argument type="normal" value="digit" binding="none" nextvalue="none">

			value 

		</argument>

	</mandatory>

	<errornote>

	Timeout keyword should have a timeout value as an argument

	</errornote> 

	<commandinfo>

Specifies a timeout value for a test case.

Timeout value is passed in milliseconds.

timeout value

Arguments:

value:Timeout value,passed in milliseconds.

	</commandinfo>

</command>

<command id="priority">

	<mandatory>

		<argument type="selective" value="none" binding="none" nextvalue="none">

			<argument type="normal" value="name" binding="none" nextvalue="none">

				normal

			</argument>

			<argument type="normal" value="name" binding="none" nextvalue="none">

				high

			</argument>

			<argument type="normal" value="name" binding="none" nextvalue="none">

				low

			</argument>

			<argument type="normal" value="digit" binding="none" nextvalue="none">

				Priority value

			</argument>

 		</argument>

	</mandatory>

	<errornote>

	Priority keyword should have a priority value as an argument

	</errornote> 

	<commandinfo>

Specifies the priority value of the test case. The value can be either an integer

or the string "high", "normal" or "low". Negative values are low and positive

values are high.

	</commandinfo>

</command>

<command id="setresultdescription">

	<mandatory>

		<argument type="normal" value="literal" binding="none" nextvalue="none">

			setresultdescriptionValue 

		</argument>

	</mandatory>

	<errornote>

	Setresultdescription has invalid argument

	</errornote> 

	<commandinfo>

Sets the description of the current executed test case. 

In case of error situation, it will be shown to user in test report.

setresultdescription setresultdescriptionValue

	</commandinfo>

</command>

<command id="create">

	<mandatory>

		<argument type="normal" value="literal" binding="none" nextvalue="none">

			TestClassName

		</argument>

		<argument type="creative" value="literal" binding="none" nextvalue="none">

			TestObjectName 

		</argument>

	</mandatory>

	<errornote>

	Create has invalid argument

	</errornote> 

	<commandinfo>

Creates keyword is used to create a new instance of a test class.

create TestClassName TestObjectName

Arguments:

Test class name:	The test class name for the new object.

Test object name:	The name of the created new instance of the test class.

	</commandinfo>

</command>

<command id="createkernel">

	<mandatory>

		<argument type="normal" value="literal" binding="none" nextvalue="none">

			KernelTestClassName

		</argument>

		<argument type="creative" value="literal" binding="none" nextvalue="none">

			TestObjectName 

		</argument>

	</mandatory>

	<errornote>

	Createkernel has invalid argument

	</errornote> 

	<commandinfo>

Creates a new instance of a kernel test class.

createkernel KernelTestClassName TestObjectName

Arguments:

Test class name:	The test class name for the new object. It's the first argument.

Test object name:	The name of the created new instance of the test class.

	</commandinfo>

</command>

<command id="delete">

	<mandatory>

		<argument type="normal" value="literal" binding="none" nextvalue="none">

			TestObjectName

		</argument>

	</mandatory>

	<errornote>

	Delete has invalid argument

	</errornote> 

	<commandinfo>

Deletes an instance of a test class

delete TestObjectName

Arguments:

Test object name:	The name of the instance of the test class that is deleted.

	</commandinfo>

</command>

<command id="allownextresult">

	<mandatory>

		<argument type="normal" value="digit" binding="none" nextvalue="none">

			errorCode 

		</argument>

	</mandatory>

	<optional>

		<argument type="normal" value="words" binding="none" nextvalue="digit">

			optionalErrorCode 

		</argument>

	</optional>

	<errornote>

	"allownextresult" keyword must be followed by an error code

	</errornote>

	<commandinfo>

Adds valid result values for a method and for asynchronous commands.

The default value for the expected result is 0

allownextresult errorCode

Arguments:

A Symbian OS error codes:	A Symbian OS error codes, which is allowed from the next method or waittestclass completion. 

Optional Error Code:	Optional.Multiple error codes, separated by space, can be passed.

	</commandinfo> 

</command>

<command id="allowerrorcodes">

	<mandatory>

		<argument type="normal" value="digit" binding="none" nextvalue="none">

			errorCode 

		</argument>

	</mandatory>

	<optional>

		<argument type="normal" value="words" binding="none" nextvalue="digit">

			optionalErrorCode 

		</argument>

	</optional>

	<errornote>

	"allowerrorcodes" keyword must be followed by an error code

	</errornote>

	<commandinfo>

Adds valid result values for a method and for asynchronous commands.

The default value for the expected result is 0

allowerrorcodes errorCode

Arguments:

A Symbian OS error codes:	A Symbian OS error codes, which is allowed from the next method or waittestclass completion. 

Optional Error Code:	Optional.Multiple error codes, separated by space, can be passed.

	</commandinfo>

</command>

<command id="waittestclass">

	<mandatory>

		<argument type="normal" value="object" binding="none" nextvalue="none">

			TestObjectName

		</argument>

	</mandatory>

	<errornote>

	Delete has invalid argument

	</errornote> 

	<commandinfo>

Pauses test case running until the specified test class object calls the 

Signal function to proceed with the test case execution again. 

waittestclass TestObjectName

Arguments:

Test object name:	The name of the instance of the test class, 

which must call Signal() to proceed with the test case execution.

	</commandinfo>	

</command>

<command id="pause">

	<mandatory>

		<argument type="normal" value="digit" binding="none" nextvalue="none">

			pauseValue 

		</argument>

	</mandatory>

	<errornote>

	"pause" keyword takes number of miliseconds as an argument"

	</errornote> 

		<commandinfo>

Pauses test case running.

pause pauseValue

Arguments:

pauseValue:	The timeout for the pause, specified in milliseconds.

	</commandinfo>

</command>

<command id="loop">

	<mandatory>

			<argument type="normal" value="digit" binding="none" nextvalue="none">

				loopTimes

			</argument>

	</mandatory>

		<optional>

			<argument type="normal" value="name" binding="none" nextvalue="none">

				msec

			</argument>

	</optional>

	<errornote>

	"loop" keyword must be followed by the loop count

	</errornote> 

	<commandinfo>

Repeats a section of the test case file for the specified number of iterations. 

The section to be repeated is enclosed with the loop and endloop keywords. 

loop loopTimes msec

Arguments:

Loop times:	The loop count, that is, the number of times that the loop is executed.

Msec: Optional.This keyword says that ‘Loop times’ argument stands for the time in milliseconds during which loop will be looped

	</commandinfo>

</command>

<command id="print">

	<mandatory>

		<argument type="normal" value="literal" binding="none" nextvalue="none">

			String

		</argument>

	</mandatory>

	<optional>

			<argument type="normal" value="words" binding="none" nextvalue="none">

				yes

			</argument>

	</optional>

	<errornote>

	incorrect "print" value

	</errornote>

	<commandinfo>

Specifies a description to print, for example, to print progress information to the UI.

print string

Arguments:

Print string:	The string that want to be printed.

	</commandinfo> 

</command>

<command id="endloop">

	<errornote>

	"endloop" keyword takes no arguments	

	</errornote> 

		<commandinfo>

The endloop keyword is used to specify the end of a looped section.

endloop

	</commandinfo> 

</command>

<command id="oomignorefailure">

	<mandatory>

		<argument type="selective" value="none" binding="none" nextvalue="none">

			<argument type="normal" value="name" binding="none" nextvalue="none">

				on

			</argument>

			<argument type="normal" value="name" binding="none" nextvalue="none">

				off

			</argument>			

		</argument>

	</mandatory>

	<errornote>

	"oomignorefailure" keyword must be followed by an on/off value

	</errornote> 

	<commandinfo>

Used for OOM testing. 

Defines if a test class’s building block execution result is checked or ignored.

Arguments:

Indication for the result check: The possible values are on and off:

on indicates that the building block execution result will be ignored.

off (default) indicates that the building block execution result will be checked and errors will be handled.

	</commandinfo>

</command>

<command id="oomheapfailnext">

	<mandatory>

		<argument type="normal" value="digit" binding="none" nextvalue="none">

			CountValue

		</argument>

	</mandatory>

	<errornote>

	"oomheapfailnext" keyword must be followed by a failure rate

	</errornote> 

	<commandinfo>

Used for OOM testing. 

Defines that heap allocation failure occurs in the test thread.

oomheapfailnext CountValue

Arguments:

Count value (rate): The failure rate. Heap allocation fails every time that is given as an argument. 

The given argument will be increased by one because the Test Scripter LOOP_COUNTER range starts from 0. 

The oomheapfailnext range starts from 1.

	</commandinfo>

</command>

<command id="oomheapsetfail">

	<mandatory>

		<argument type="selective" value="none" binding="none" nextvalue="none">	

			<argument type="normal" value="name" binding="none" nextvalue="none">

				random

			</argument>

			<argument type="normal" value="name" binding="none" nextvalue="none">

				truerandom

			</argument>	

			<argument type="normal" value="name" binding="none" nextvalue="none">

				deterministic

			</argument>	

			<argument type="normal" value="name" binding="none" nextvalue="none">

				none

			</argument>	

			<argument type="normal" value="name" binding="none" nextvalue="none">

				failnext

			</argument>			

		</argument>

		<argument type="normal" value="digit" binding="none" nextvalue="none">

			CountValue

		</argument >

	</mandatory>

	<errornote>

	"oomheapsetfail" keyword must be followed by the type of failure and a count value

	</errornote>

		<commandinfo>

Used for OOM testing. 

Defines that heap allocation failure occurs in the test thread. 

The user can define the failure type and count (rate).

Arguments:

The type of failure to be simulated:  The supported value are: random, truerandom, deterministic, none, failnext

Count value (rate): The given argument will be increased by one because the Test Scripter LOOP_COUNTER range starts from 0. 

	The oomheapsetfail range starts from 1

	</commandinfo>

</command>

<command id="oomheaptonormal">

	<errornote>

	"oomheaptonormal" takes no parameter	

	</errornote> 

	<commandinfo>

Used for OOM testing. 

Ends OOM testing and normal testing continues. 

oomheaptonormal

	</commandinfo>

</command>

<command id="testinterference">

	<mandatory>

		<argument type="normal" value="literal" binding="none" nextvalue="none">

			objectName 

		</argument>

		<argument type="selective" value="none" binding="none" nextvalue="none">	

			<argument type="normal" value="name" binding="none" nextvalue="none">

				start

			</argument>

			<argument type="normal" value="name" binding="none" nextvalue="none">

				stop

			</argument>			

		</argument>

	</mandatory>

	<optional>

		<argument type="selective" value="none" binding="none" nextvalue="none">

			<argument type="normal" value="name" binding="none" nextvalue="none">

				activeobject

			</argument>

			<argument type="normal" value="name" binding="none" nextvalue="none">

				thread

			</argument>

		</argument>

		<argument type="selective" value="none" binding="none" nextvalue="none">

			<argument type="normal" value="name" binding="none" nextvalue="none">

				cpuload

			</argument>

			<argument type="normal" value="name" binding="none" nextvalue="none">

				filesystemreadc

			</argument>

			<argument type="normal" value="name" binding="none" nextvalue="none">

				filesystemreadd

			</argument>

			<argument type="normal" value="name" binding="none" nextvalue="none">

				filesystemreade

			</argument>

			<argument type="normal" value="name" binding="none" nextvalue="none">

				filesystemreadz

			</argument>

			<argument type="normal" value="name" binding="none" nextvalue="none">

				filesystemwritec

			</argument>

			<argument type="normal" value="name" binding="none" nextvalue="none">

				filesystemwrited

			</argument>

			<argument type="normal" value="name" binding="none" nextvalue="none">

				filesystemwritee

			</argument>

			<argument type="normal" value="name" binding="none" nextvalue="none">

				filesystemfillandemptyc

			</argument>

			<argument type="normal" value="name" binding="none" nextvalue="none">

				filesystemfillandemptyd

			</argument>

			<argument type="normal" value="name" binding="none" nextvalue="none">

				filesystemfillandemptye

			</argument>			

		</argument>

		<argument type="normal" value="digit" binding="none" nextvalue="none">

			idleTime

		</argument>

		<argument type="normal" value="digit" binding="none" nextvalue="none">

			activeTime

		</argument>

	</optional>

	<errornote>

	syntax error error

	</errornote> 

	<commandinfo>

Interferes the testing.

Arguments:

object name: Object name that is used for starting and stopping interference operations.

command: Command for STIF Test Interference control.

The supported values are: 

-start

-stop.

category: Interference category. The supported values are:

-activeobject

-thread.

type: Interference type. 

The supported values are:

-cpuload

-filesystemreadc

-filesystemreadd

-filesystemreade

-filesystemreadz

-filesystemwritec

-filesystemwrited

-filesystemwritee

-filesystemfillandemptyc

-filesystemfillandemptyd

-filesystemfillandemptye

idle time: Idle time in milliseconds. 

active time: Active time in milliseconds.

set priority: Optional. Set priority for thread or active object.

	</commandinfo>

</command>

<command id="measurement">

	<mandatory>

		<argument type="selective" value="none" binding="none" nextvalue="none">

			<argument type="normal" value="name" binding="none" nextvalue="none">

				start

			</argument>

			<argument type="normal" value="name" binding="none" nextvalue="none">

				stop

			</argument>			

		</argument>

		<argument type="selective" value="none" binding="none" nextvalue="none">

			<argument type="normal" value="name" binding="none" nextvalue="none">

				measurementplugin01