testdev/ite/src/com.nokia.testfw.stf.scripteditor/scripter.xml
changeset 1 96906a986c3b
equal deleted inserted replaced
0:f1112f777ce9 1:96906a986c3b
       
     1 <?xml version="1.0"?>
       
     2 
       
     3 <sections>
       
     4 
       
     5 <section name="Test" endname="Endtest" proposal="[Test]\    title testcasename\[Endtest]">
       
     6 
       
     7 <command id="title">
       
     8 	<mandatory>
       
     9 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
    10 			string 
       
    11 		</argument>
       
    12 	</mandatory>
       
    13 	<optional>
       
    14 		<argument type="normal" value="words" binding="none" nextvalue="none">
       
    15 			value 
       
    16 		</argument>
       
    17 	</optional>
       
    18 	<errornote>
       
    19 	Title commmand requires test title as an argument	
       
    20 	</errornote>
       
    21 	<commandinfo>
       
    22 Specifies a verbal description for a test case.
       
    23 
       
    24 title testcasedescription
       
    25 
       
    26 Arguments:
       
    27 test case description:	A verbal description for a test case.
       
    28 	</commandinfo>
       
    29 </command>
       
    30 
       
    31 <command id="timeout">
       
    32 	<mandatory>
       
    33 		<argument type="normal" value="digit" binding="none" nextvalue="none">
       
    34 			value 
       
    35 		</argument>
       
    36 	</mandatory>
       
    37 	<errornote>
       
    38 	Timeout keyword should have a timeout value as an argument
       
    39 	</errornote> 
       
    40 	<commandinfo>
       
    41 Specifies a timeout value for a test case.
       
    42 Timeout value is passed in milliseconds.
       
    43 
       
    44 timeout value
       
    45 
       
    46 Arguments:
       
    47 value:Timeout value,passed in milliseconds.
       
    48 	</commandinfo>
       
    49 	
       
    50 </command>
       
    51 
       
    52 <command id="priority">
       
    53 	<mandatory>
       
    54 		<argument type="selective" value="none" binding="none" nextvalue="none">
       
    55 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
    56 				normal
       
    57 			</argument>
       
    58 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
    59 				high
       
    60 			</argument>
       
    61 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
    62 				low
       
    63 			</argument>
       
    64 			<argument type="normal" value="digit" binding="none" nextvalue="none">
       
    65 				Priority value
       
    66 			</argument>
       
    67  		</argument>
       
    68 	</mandatory>
       
    69 	<errornote>
       
    70 	Priority keyword should have a priority value as an argument
       
    71 	</errornote> 
       
    72 	<commandinfo>
       
    73 Specifies the priority value of the test case. The value can be either an integer
       
    74 or the string "high", "normal" or "low". Negative values are low and positive
       
    75 values are high.
       
    76 	</commandinfo>
       
    77 </command>
       
    78 
       
    79 <command id="setresultdescription">
       
    80 	<mandatory>
       
    81 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
    82 			setresultdescriptionValue 
       
    83 		</argument>
       
    84 	</mandatory>
       
    85 	<errornote>
       
    86 	Setresultdescription has invalid argument
       
    87 	</errornote> 
       
    88 	<commandinfo>
       
    89 Sets the description of the current executed test case. 
       
    90 In case of error situation, it will be shown to user in test report.
       
    91 
       
    92 setresultdescription setresultdescriptionValue
       
    93 	</commandinfo>
       
    94 </command>
       
    95 
       
    96 <command id="create">
       
    97 	<mandatory>
       
    98 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
    99 			TestClassName
       
   100 		</argument>
       
   101 		<argument type="creative" value="literal" binding="none" nextvalue="none">
       
   102 			TestObjectName 
       
   103 		</argument>
       
   104 	</mandatory>
       
   105 	<errornote>
       
   106 	Create has invalid argument
       
   107 	</errornote> 
       
   108 	<commandinfo>
       
   109 Creates keyword is used to create a new instance of a test class.
       
   110 
       
   111 create TestClassName TestObjectName
       
   112 
       
   113 Arguments:
       
   114 Test class name:	The test class name for the new object.
       
   115 Test object name:	The name of the created new instance of the test class.
       
   116 	</commandinfo>
       
   117 </command>
       
   118 
       
   119 <command id="createkernel">
       
   120 	<mandatory>
       
   121 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   122 			KernelTestClassName
       
   123 		</argument>
       
   124 		<argument type="creative" value="literal" binding="none" nextvalue="none">
       
   125 			TestObjectName 
       
   126 		</argument>
       
   127 	</mandatory>
       
   128 	<errornote>
       
   129 	Createkernel has invalid argument
       
   130 	</errornote> 
       
   131 	<commandinfo>
       
   132 Creates a new instance of a kernel test class.
       
   133 
       
   134 createkernel KernelTestClassName TestObjectName
       
   135 
       
   136 Arguments:
       
   137 Test class name:	The test class name for the new object. It's the first argument.
       
   138 Test object name:	The name of the created new instance of the test class.
       
   139 	</commandinfo>
       
   140 </command>
       
   141 
       
   142 <command id="delete">
       
   143 	<mandatory>
       
   144 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   145 			TestObjectName
       
   146 		</argument>
       
   147 	</mandatory>
       
   148 	<errornote>
       
   149 	Delete has invalid argument
       
   150 	</errornote> 
       
   151 	<commandinfo>
       
   152 Deletes an instance of a test class
       
   153 
       
   154 delete TestObjectName
       
   155 
       
   156 Arguments:
       
   157 Test object name:	The name of the instance of the test class that is deleted.
       
   158 	</commandinfo>
       
   159 </command>
       
   160 
       
   161 <command id="allownextresult">
       
   162 	<mandatory>
       
   163 		<argument type="normal" value="digit" binding="none" nextvalue="none">
       
   164 			errorCode 
       
   165 		</argument>
       
   166 	</mandatory>
       
   167 	<optional>
       
   168 		<argument type="normal" value="words" binding="none" nextvalue="digit">
       
   169 			optionalErrorCode 
       
   170 		</argument>
       
   171 	</optional>
       
   172 	<errornote>
       
   173 	"allownextresult" keyword must be followed by an error code
       
   174 	</errornote>
       
   175 	<commandinfo>
       
   176 Adds valid result values for a method and for asynchronous commands.
       
   177 The default value for the expected result is 0
       
   178 
       
   179 allownextresult errorCode
       
   180 
       
   181 Arguments:
       
   182 A Symbian OS error codes:	A Symbian OS error codes, which is allowed from the next method or waittestclass completion. 
       
   183 Optional Error Code:	Optional.Multiple error codes, separated by space, can be passed.
       
   184 	</commandinfo> 
       
   185 </command>
       
   186 
       
   187 <command id="allowerrorcodes">
       
   188 	<mandatory>
       
   189 		<argument type="normal" value="digit" binding="none" nextvalue="none">
       
   190 			errorCode 
       
   191 		</argument>
       
   192 	</mandatory>
       
   193 	<optional>
       
   194 		<argument type="normal" value="words" binding="none" nextvalue="digit">
       
   195 			optionalErrorCode 
       
   196 		</argument>
       
   197 	</optional>
       
   198 	<errornote>
       
   199 	"allowerrorcodes" keyword must be followed by an error code
       
   200 	</errornote>
       
   201 	<commandinfo>
       
   202 Adds valid result values for a method and for asynchronous commands.
       
   203 The default value for the expected result is 0
       
   204 
       
   205 allowerrorcodes errorCode
       
   206 
       
   207 Arguments:
       
   208 A Symbian OS error codes:	A Symbian OS error codes, which is allowed from the next method or waittestclass completion. 
       
   209 Optional Error Code:	Optional.Multiple error codes, separated by space, can be passed.
       
   210 	</commandinfo>
       
   211 </command>
       
   212 
       
   213 
       
   214 <command id="waittestclass">
       
   215 	<mandatory>
       
   216 		<argument type="normal" value="object" binding="none" nextvalue="none">
       
   217 			TestObjectName
       
   218 		</argument>
       
   219 	</mandatory>
       
   220 	<errornote>
       
   221 	Delete has invalid argument
       
   222 	</errornote> 
       
   223 	<commandinfo>
       
   224 Pauses test case running until the specified test class object calls the 
       
   225 Signal function to proceed with the test case execution again. 
       
   226 
       
   227 waittestclass TestObjectName
       
   228 
       
   229 Arguments:
       
   230 Test object name:	The name of the instance of the test class, 
       
   231 which must call Signal() to proceed with the test case execution.
       
   232 	</commandinfo>	
       
   233 </command>
       
   234 
       
   235 <command id="pause">
       
   236 	<mandatory>
       
   237 		<argument type="normal" value="digit" binding="none" nextvalue="none">
       
   238 			pauseValue 
       
   239 		</argument>
       
   240 	</mandatory>
       
   241 	<errornote>
       
   242 	"pause" keyword takes number of miliseconds as an argument"
       
   243 	</errornote> 
       
   244 		<commandinfo>
       
   245 Pauses test case running.
       
   246 
       
   247 pause pauseValue
       
   248 
       
   249 Arguments:
       
   250 pauseValue:	The timeout for the pause, specified in milliseconds.
       
   251 	</commandinfo>
       
   252 </command>
       
   253 
       
   254 <command id="loop">
       
   255 	<mandatory>
       
   256 			<argument type="normal" value="digit" binding="none" nextvalue="none">
       
   257 				loopTimes
       
   258 			</argument>
       
   259 	</mandatory>
       
   260 		<optional>
       
   261 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   262 				msec
       
   263 			</argument>
       
   264 	</optional>
       
   265 	<errornote>
       
   266 	"loop" keyword must be followed by the loop count
       
   267 	</errornote> 
       
   268 	<commandinfo>
       
   269 Repeats a section of the test case file for the specified number of iterations. 
       
   270 The section to be repeated is enclosed with the loop and endloop keywords. 
       
   271 
       
   272 loop loopTimes msec
       
   273 
       
   274 Arguments:
       
   275 Loop times:	The loop count, that is, the number of times that the loop is executed.
       
   276 Msec: Optional.This keyword says that ‘Loop times’ argument stands for the time in milliseconds during which loop will be looped
       
   277 	</commandinfo>
       
   278 </command>
       
   279 
       
   280 <command id="print">
       
   281 	<mandatory>
       
   282 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   283 			String
       
   284 		</argument>
       
   285 	</mandatory>
       
   286 	<optional>
       
   287 			<argument type="normal" value="words" binding="none" nextvalue="none">
       
   288 				yes
       
   289 			</argument>
       
   290 	</optional>
       
   291 	<errornote>
       
   292 	incorrect "print" value
       
   293 	</errornote>
       
   294 	<commandinfo>
       
   295 Specifies a description to print, for example, to print progress information to the UI.
       
   296 
       
   297 print string
       
   298 
       
   299 Arguments:
       
   300 Print string:	The string that want to be printed.
       
   301 	</commandinfo> 
       
   302 </command>
       
   303 
       
   304 <command id="endloop">
       
   305 	<errornote>
       
   306 	"endloop" keyword takes no arguments	
       
   307 	</errornote> 
       
   308 		<commandinfo>
       
   309 The endloop keyword is used to specify the end of a looped section.
       
   310 
       
   311 endloop
       
   312 	</commandinfo> 
       
   313 </command>
       
   314 
       
   315 
       
   316 <command id="oomignorefailure">
       
   317 	<mandatory>
       
   318 		<argument type="selective" value="none" binding="none" nextvalue="none">
       
   319 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   320 				on
       
   321 			</argument>
       
   322 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   323 				off
       
   324 			</argument>			
       
   325 		</argument>
       
   326 	</mandatory>
       
   327 	<errornote>
       
   328 	"oomignorefailure" keyword must be followed by an on/off value
       
   329 	</errornote> 
       
   330 	<commandinfo>
       
   331 Used for OOM testing. 
       
   332 Defines if a test class’s building block execution result is checked or ignored.
       
   333 
       
   334 Arguments:
       
   335 Indication for the result check: The possible values are on and off:
       
   336 on indicates that the building block execution result will be ignored.
       
   337 off (default) indicates that the building block execution result will be checked and errors will be handled.
       
   338 	</commandinfo>
       
   339 </command>
       
   340 
       
   341 <command id="oomheapfailnext">
       
   342 	<mandatory>
       
   343 		<argument type="normal" value="digit" binding="none" nextvalue="none">
       
   344 			CountValue
       
   345 		</argument>
       
   346 	</mandatory>
       
   347 	<errornote>
       
   348 	"oomheapfailnext" keyword must be followed by a failure rate
       
   349 	</errornote> 
       
   350 	<commandinfo>
       
   351 Used for OOM testing. 
       
   352 Defines that heap allocation failure occurs in the test thread.
       
   353 
       
   354 oomheapfailnext CountValue
       
   355 
       
   356 Arguments:
       
   357 Count value (rate): The failure rate. Heap allocation fails every time that is given as an argument. 
       
   358 The given argument will be increased by one because the Test Scripter LOOP_COUNTER range starts from 0. 
       
   359 The oomheapfailnext range starts from 1.
       
   360 	</commandinfo>
       
   361 </command>
       
   362 
       
   363 
       
   364 <command id="oomheapsetfail">
       
   365 	<mandatory>
       
   366 		<argument type="selective" value="none" binding="none" nextvalue="none">	
       
   367 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   368 				random
       
   369 			</argument>
       
   370 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   371 				truerandom
       
   372 			</argument>	
       
   373 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   374 				deterministic
       
   375 			</argument>	
       
   376 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   377 				none
       
   378 			</argument>	
       
   379 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   380 				failnext
       
   381 			</argument>			
       
   382 		</argument>
       
   383 		<argument type="normal" value="digit" binding="none" nextvalue="none">
       
   384 			CountValue
       
   385 		</argument >
       
   386 	</mandatory>
       
   387 	<errornote>
       
   388 	"oomheapsetfail" keyword must be followed by the type of failure and a count value
       
   389 	</errornote>
       
   390 		<commandinfo>
       
   391 Used for OOM testing. 
       
   392 Defines that heap allocation failure occurs in the test thread. 
       
   393 The user can define the failure type and count (rate).
       
   394 
       
   395 Arguments:
       
   396 The type of failure to be simulated:  The supported value are: random, truerandom, deterministic, none, failnext
       
   397 Count value (rate): The given argument will be increased by one because the Test Scripter LOOP_COUNTER range starts from 0. 
       
   398 	The oomheapsetfail range starts from 1
       
   399 	</commandinfo>
       
   400 	
       
   401 </command>
       
   402 
       
   403 <command id="oomheaptonormal">
       
   404 	<errornote>
       
   405 	"oomheaptonormal" takes no parameter	
       
   406 	</errornote> 
       
   407 	<commandinfo>
       
   408 Used for OOM testing. 
       
   409 Ends OOM testing and normal testing continues. 
       
   410 
       
   411 oomheaptonormal
       
   412 	</commandinfo>
       
   413 </command>
       
   414 
       
   415 <command id="testinterference">
       
   416 	<mandatory>
       
   417 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   418 			objectName 
       
   419 		</argument>
       
   420 		<argument type="selective" value="none" binding="none" nextvalue="none">	
       
   421 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   422 				start
       
   423 			</argument>
       
   424 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   425 				stop
       
   426 			</argument>			
       
   427 		</argument>
       
   428 	</mandatory>
       
   429 	<optional>
       
   430 		<argument type="selective" value="none" binding="none" nextvalue="none">
       
   431 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   432 				activeobject
       
   433 			</argument>
       
   434 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   435 				thread
       
   436 			</argument>
       
   437 		</argument>
       
   438 		<argument type="selective" value="none" binding="none" nextvalue="none">
       
   439 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   440 				cpuload
       
   441 			</argument>
       
   442 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   443 				filesystemreadc
       
   444 			</argument>
       
   445 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   446 				filesystemreadd
       
   447 			</argument>
       
   448 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   449 				filesystemreade
       
   450 			</argument>
       
   451 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   452 				filesystemreadz
       
   453 			</argument>
       
   454 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   455 				filesystemwritec
       
   456 			</argument>
       
   457 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   458 				filesystemwrited
       
   459 			</argument>
       
   460 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   461 				filesystemwritee
       
   462 			</argument>
       
   463 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   464 				filesystemfillandemptyc
       
   465 			</argument>
       
   466 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   467 				filesystemfillandemptyd
       
   468 			</argument>
       
   469 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   470 				filesystemfillandemptye
       
   471 			</argument>			
       
   472 		</argument>
       
   473 		<argument type="normal" value="digit" binding="none" nextvalue="none">
       
   474 			idleTime
       
   475 		</argument>
       
   476 		<argument type="normal" value="digit" binding="none" nextvalue="none">
       
   477 			activeTime
       
   478 		</argument>
       
   479 	</optional>
       
   480 	<errornote>
       
   481 	syntax error error
       
   482 	</errornote> 
       
   483 	<commandinfo>
       
   484 Interferes the testing.
       
   485 
       
   486 Arguments:
       
   487 object name: Object name that is used for starting and stopping interference operations.
       
   488 command: Command for STIF Test Interference control.
       
   489 The supported values are: 
       
   490 -start
       
   491 -stop.
       
   492 
       
   493 category: Interference category. The supported values are:
       
   494 -activeobject
       
   495 -thread.
       
   496 
       
   497 type: Interference type. 
       
   498 The supported values are:
       
   499 -cpuload
       
   500 -filesystemreadc
       
   501 -filesystemreadd
       
   502 -filesystemreade
       
   503 -filesystemreadz
       
   504 -filesystemwritec
       
   505 -filesystemwrited
       
   506 -filesystemwritee
       
   507 -filesystemfillandemptyc
       
   508 -filesystemfillandemptyd
       
   509 -filesystemfillandemptye
       
   510 
       
   511 idle time: Idle time in milliseconds. 
       
   512 active time: Active time in milliseconds.
       
   513 set priority: Optional. Set priority for thread or active object.
       
   514 	</commandinfo>
       
   515 </command>
       
   516 
       
   517 <command id="measurement">
       
   518 	<mandatory>
       
   519 		<argument type="selective" value="none" binding="none" nextvalue="none">
       
   520 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   521 				start
       
   522 			</argument>
       
   523 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   524 				stop
       
   525 			</argument>			
       
   526 		</argument>
       
   527 		<argument type="selective" value="none" binding="none" nextvalue="none">
       
   528 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   529 				measurementplugin01
       
   530 			</argument>
       
   531 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   532 				measurementplugin02
       
   533 			</argument>
       
   534 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   535 				measurementplugin03
       
   536 			</argument>
       
   537 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   538 				measurementplugin04
       
   539 			</argument>
       
   540 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   541 				measurementplugin05
       
   542 			</argument>
       
   543 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
   544 				stifbappeaprofiler
       
   545 			</argument>
       
   546 		</argument>
       
   547 	</mandatory>
       
   548 	<optional>
       
   549 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   550 			STIFTestMeasurementParameters
       
   551 		</argument>
       
   552 
       
   553 	</optional>
       
   554 	<errornote>
       
   555 	"measurement" keyword must be follwed by a command, type and optionaly parameters
       
   556 	</errornote>
       
   557 	<commandinfo>
       
   558 easures the testing. 
       
   559 
       
   560 Arguments:
       
   561 STIF Test measurement command: Commad for STIF Test Measurement control. The supported values are: start for starting test measurement, stop for stopping test measurement. It also releases all allocated resources.
       
   562 STIF Test measurement type: Test measurement type.
       
   563 The supported values are: measurementplugin01, measurementplugin02, measurementplugin03, measurementplugin04, measurementplugin05, bappeaprofiler
       
   564 STIF Test measurement parameters: Test measurement module configuring etc. user and test measurement module specific. 
       
   565 	</commandinfo> 
       
   566 </command>
       
   567 
       
   568 <command id="var">
       
   569 	<mandatory>
       
   570 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   571 			varName
       
   572 		</argument>
       
   573 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   574 			varValue 
       
   575 		</argument>		
       
   576 	</mandatory>
       
   577 	<errornote>
       
   578 	"var" keyword requires variable name and value
       
   579 	</errornote>
       
   580 	<commandinfo>
       
   581 Assigns a text value to a specified variable. It can be then used in other part of the script. 
       
   582 
       
   583 var varName varValue
       
   584 	</commandinfo>  
       
   585 </command>
       
   586 
       
   587 
       
   588 <command id="callsub">
       
   589 	<mandatory>
       
   590 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   591 			callsubValue
       
   592 		</argument>
       
   593 	</mandatory>
       
   594 	<errornote>
       
   595 	"callsub" keyword requires subroutine name as the only agrument
       
   596 	</errornote>
       
   597 	<commandinfo>
       
   598 Makes TestScripter executing pointed section of script.
       
   599 
       
   600 Section which will be called must start with [Sub name] and end with [EndSub] tags, where name is the identifier of the sub. 
       
   601 The execution of the sub will continue until its end is reached. There is possibility to call a sub from another sub.
       
   602 
       
   603 callsub callsubValue
       
   604 	</commandinfo>  
       
   605 </command>
       
   606 
       
   607 <command id="request">
       
   608 	<mandatory>
       
   609 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   610 			requestValue
       
   611 		</argument>
       
   612 	</mandatory>
       
   613 	<errornote>
       
   614 	"request" keyword must be follwed by an event name
       
   615 	</errornote>
       
   616 	<commandinfo>
       
   617 Requests an event. If someone wants to use an event, it must first be requested, and after that it can be waited.
       
   618 After the event is not used anymore, it must be released.
       
   619 
       
   620 request requestValue
       
   621 
       
   622 Arguments:
       
   623 Event: The event name.
       
   624 	</commandinfo> 
       
   625 </command>
       
   626 
       
   627 <command id="wait">
       
   628 	<mandatory>
       
   629 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   630 			waitValue
       
   631 		</argument>
       
   632 	</mandatory>
       
   633 	<errornote>
       
   634 	"wait" keyword must be follwed by an event name
       
   635 	</errornote> 
       
   636 	<commandinfo>
       
   637 Waits for an event.
       
   638 A request must be called before wait, and wait blocks until the requested event is set. 
       
   639 Wait may proceed immediately if the requested event is a state event and already pending (for example, a phone call is already active). 
       
   640 
       
   641 wait waitValue
       
   642 
       
   643 Arguments:
       
   644 Event: The event name.
       
   645 	</commandinfo> 
       
   646 	
       
   647 </command>
       
   648 
       
   649 <command id="release">
       
   650 	<mandatory>
       
   651 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   652 			releaseValue
       
   653 		</argument>
       
   654 	</mandatory>
       
   655 	<errornote>
       
   656 	"release" keyword must be follwed by an event name
       
   657 	</errornote> 
       
   658 	<commandinfo>
       
   659 Releases an event. 
       
   660 Every requested event must be released explicitly when it is not used anymore.
       
   661 
       
   662 release releaseValue
       
   663  
       
   664 Arguments:
       
   665 Event: The event name.
       
   666 	</commandinfo> 
       
   667 </command>
       
   668 
       
   669 
       
   670 <command id="set">
       
   671 	<mandatory>
       
   672 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   673 			setValue
       
   674 		</argument>
       
   675 	</mandatory>
       
   676 	<optional>
       
   677 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   678 			state
       
   679 		</argument>
       
   680 	</optional>
       
   681 	<errornote>
       
   682 	"set" keyword must be follwed by an event name
       
   683 	</errornote>
       
   684 	<commandinfo>
       
   685 Sets an event. Every set state event must be explicitly unset.
       
   686 
       
   687 set setValue state
       
   688 
       
   689 Arguments:
       
   690 Event: The event name.
       
   691 State: Optional. If a state is given, sets the state event, otherwise sets an indication event. 
       
   692 	</commandinfo>  
       
   693 </command>
       
   694 
       
   695 <command id="unset">
       
   696 	<mandatory>
       
   697 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   698 			unsetValue
       
   699 		</argument>
       
   700 	</mandatory>
       
   701 	<errornote>
       
   702 	"unset" keyword must be follwed by an event name
       
   703 	</errornote> 
       
   704 	<commandinfo>
       
   705 The unset keyword is used to unset a state event. 
       
   706 Every set state event must be unset. 
       
   707 Indication events cannot be unset. unset blocks until everyone who has requested the specified event has released the event.
       
   708 
       
   709 unset unsetValue
       
   710 
       
   711 Arguments:
       
   712 Event: The event name. 
       
   713 	</commandinfo> 
       
   714 </command>
       
   715 
       
   716 
       
   717 <command id="bringtoforeground">
       
   718 	<errornote>
       
   719 	"bringtoforeground" keyword takes no arguments	
       
   720 	</errornote>
       
   721 	<commandinfo>
       
   722 Brings UI component container to foreground described in below. 
       
   723 
       
   724 bringtoforeground
       
   725 	</commandinfo> 
       
   726 </command>
       
   727 
       
   728 <command id="sendtobackground">
       
   729 	<errornote>
       
   730 	"sendtobackground" keyword takes no arguments	
       
   731 	</errornote>
       
   732 	<commandinfo>
       
   733 Sends UI component container to background.
       
   734 
       
   735 sendtobackground
       
   736 	</commandinfo> 
       
   737 </command>
       
   738 
       
   739 <command id="presskey">
       
   740 	<mandatory>
       
   741 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   742 			presskeyValue 
       
   743 		</argument>
       
   744 	</mandatory>
       
   745 	<optional>
       
   746 		<argument type="normal" value="words" binding="none" nextvalue="none">
       
   747 			presskeyValue 
       
   748 		</argument>
       
   749 	</optional>
       
   750 	<errornote>
       
   751 	"presskey" keyword takes Key code as an argument.	
       
   752 	</errornote> 
       
   753 	<commandinfo>	
       
   754 Sends key event to tested UI component. 
       
   755 
       
   756 presskey presskeyValue
       
   757 
       
   758 Arguments:
       
   759 Key code	Single character or constant defined in TKeyCode enumeration. Must be defined if keycode and keyscancode is not defined
       
   760 
       
   761 keycode:	Numeric value or constant defined in TKeyCode enumeration.  If it is defined, then mandatory argument may be omitted
       
   762 keyscancode:	Numeric key value or constant defined in TStdScanCode enumeration. If it is defined, then mandatory argument or keycode argument may be omitted
       
   763 modifier:	One of the constant values defined in TEventModifier enumeration
       
   764 repeats:	Count of auto repeats generated. 0 means an event without repeats. 1 or more means "this many auto repeat events". In most cases this value is ignored  and treated as a single event.
       
   765 local:	Sends key event to focused UI control, constructed under CCoeEnv delivered by STIF.
       
   766 global:	Sends key event to focused UI control ( constructed under any CCoeEnv, not necessarily CCoeEnv delivered by STIF ) e.g press left softkey of global message box
       
   767 
       
   768 	</commandinfo> 
       
   769 </command>
       
   770 
       
   771 
       
   772 <command id="typetext">
       
   773 	<mandatory>
       
   774 		<argument type="normal" value="quoted" binding="none" nextvalue="none">
       
   775 			typetextValue 
       
   776 		</argument>
       
   777 	</mandatory>
       
   778 	<errornote>
       
   779 	"typetext" keyword takes text as an argument.
       
   780 	</errornote>
       
   781 	<commandinfo>	
       
   782 Sends text to tested UI component. 
       
   783 
       
   784 typetext typetextValue
       
   785 
       
   786 Arguments:
       
   787 text: Text in quotation marks which should be send to UI component
       
   788 
       
   789 	</commandinfo>  
       
   790 </command>
       
   791 
       
   792 
       
   793 <command id="sendpointerevent">
       
   794 	<mandatory>
       
   795 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   796 			sendpointereventValue 
       
   797 		</argument>
       
   798 	</mandatory>
       
   799 	<optional>
       
   800 		<argument type="normal" value="words" binding="none" nextvalue="none">
       
   801 			SendpointereventValue 
       
   802 		</argument>
       
   803 	</optional>
       
   804 	<errornote>
       
   805 	"sendpointerevent" keyword takes Event type and positon as an arguments.
       
   806 	</errornote> 
       
   807 	<commandinfo>	
       
   808 Sends pointer event to tested UI component. 
       
   809 
       
   810 sendpointerevent sendpointereventValue
       
   811 
       
   812 Arguments:
       
   813 Event type:	Pointer event type. 
       
   814 Fallowing pointer even types are sypported: EButton1, EButton2, EButton3, EPointerMove, EPointerSwitchOn, EButton1Down, EButton1Up, EButton2Down, EButton2Up, EButton3Down, EButton3Up
       
   815 x:	Pointer x co-ordinate
       
   816 y:	Pointer y co-ordinate
       
   817 
       
   818 	</commandinfo>  
       
   819 </command>
       
   820 
       
   821 
       
   822 <command id="using">
       
   823 	<mandatory>
       
   824 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   825 			TestLibDLLName
       
   826 		</argument>
       
   827 		<argument type="creative" value="literal" binding="none" nextvalue="none">
       
   828 			DllObjectName 
       
   829 		</argument>
       
   830 	</mandatory>
       
   831 	<errornote>
       
   832 	Create has invalid argument
       
   833 	</errornote> 
       
   834 	<commandinfo>
       
   835 Loads STF specific test harness library.
       
   836 
       
   837 using TestLibDLLName DllObjectName
       
   838 
       
   839 Arguments:
       
   840 DLL name:	The test harness library name.
       
   841 DLL object name:    The alias of the created new instance of the test harness library.
       
   842 	</commandinfo>
       
   843 </command>
       
   844 
       
   845 <command id="expectedpanic">
       
   846     <mandatory>
       
   847 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   848 			PanicNumber
       
   849 		</argument>
       
   850 	</mandatory>
       
   851 	<errornote>
       
   852 	"expectedpanic" keyword takes one panic number argument
       
   853 	</errornote> 
       
   854 	<commandinfo>
       
   855 Declares valid panic result value for a test case. It indicates that the test case MUST panic with this specified panic code in execution, and only can be used once with a single parameter. 
       
   856 NOTE: expectedpanic does not support UI Testing.
       
   857 
       
   858 expectedpanic PanicNumber
       
   859 
       
   860 Arguments:
       
   861 Panic Number, An single integer, which represents the expected panic number.
       
   862 	
       
   863 	</commandinfo>
       
   864 </command>
       
   865 
       
   866 <!-- commands below are for test combiner -->
       
   867 
       
   868 <command id="canceliferror">
       
   869 	<errornote>
       
   870 	"canceliferror" keyword takes no arguments
       
   871 	</errornote> 
       
   872 	<commandinfo>
       
   873 Cancels the execution of the remaining test cases if one of the executed test cases has failed. 
       
   874 This keyword is normally used to stop the test case execution when some of the test cases are long running.
       
   875 
       
   876 canceliferror
       
   877 	</commandinfo>
       
   878 </command>
       
   879 
       
   880 <command id="run">
       
   881 	<mandatory>
       
   882 			<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   883 				testmodule
       
   884 			</argument>
       
   885 			<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   886 				configfile
       
   887 			</argument>
       
   888 			<argument type="normal" value="digit" binding="none" nextvalue="none">
       
   889 				TestCaseNumber
       
   890 			</argument>
       
   891 	</mandatory>
       
   892 	<optional>
       
   893 		<argument type="normal" value="name" binding="=" nextvalue="digit">
       
   894 			expect
       
   895 		</argument>
       
   896 		<argument type="normal" value="name" binding="=" nextvalue="literal">
       
   897 			testid
       
   898 		</argument>
       
   899 		<argument type="normal" value="name" binding="=" nextvalue="literal">
       
   900 			ini
       
   901 		</argument>
       
   902 		<argument type="normal" value="name" binding="=" nextvalue="literal">
       
   903 			category
       
   904 		</argument>
       
   905 		<argument type="normal" value="name" binding="=" nextvalue="digit">
       
   906 			timeout
       
   907 		</argument>
       
   908 		<argument type="normal" value="quoted" binding="none" nextvalue="none">
       
   909 			title
       
   910 		</argument>		
       
   911 	</optional>
       
   912 	<errornote>
       
   913 	"run" keyword takes test module name, configuration file and test case number as argumets
       
   914 	</errornote> 
       
   915 	<commandinfo>
       
   916 Starts a specified test case. It has several mandatory and optional arguments. 
       
   917 
       
   918 run testmodule configfile TestCaseNumber expect testid ini category timeout title
       
   919 
       
   920 Arguments:
       
   921 testmodule:	The test module name.
       
   922 configfile:	The test case configuration file.
       
   923 Test case number:	The test case number to be executed from configfile.
       
   924 
       
   925 Optional arguments:
       
   926 expect:	The expected result (0 = KErrNone).
       
   927 testid:	Test case identification, which is used by other keywords to identify the test case ().
       
   928 ini:	The initialization file for test module ().
       
   929 category:	The result category; either normal, leave, panic, exception or timeout.
       
   930 timeout:	Test case timeout (not supported yet).
       
   931 title:	Test case title.  
       
   932 	</commandinfo>
       
   933 </command>
       
   934 
       
   935 
       
   936 <command id="cancel">
       
   937 	<mandatory>
       
   938 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   939 			testid
       
   940 		</argument >
       
   941 	</mandatory>
       
   942 	<errornote>
       
   943 	"cancel" keyword takes test an identification of a test case as an argument
       
   944 	</errornote>
       
   945 	<commandinfo>
       
   946 Cancels a started test case. 
       
   947 The test case is cancelled by immediately killing the thread that executes the test case.
       
   948 
       
   949 cancel testid
       
   950  
       
   951 Arguments:
       
   952 testid:	The test ID from the run command. 
       
   953 	</commandinfo> 
       
   954 </command>
       
   955 
       
   956 <command id="pausetest">
       
   957 	<mandatory>
       
   958 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   959 			testid
       
   960 		</argument >
       
   961 	</mandatory>
       
   962 	<optional>
       
   963 		<argument type="normal" value="name" binding="=" nextvalue="digit">
       
   964 			time
       
   965 		</argument>
       
   966 	</optional>
       
   967 	<errornote>
       
   968 	"pausetest" keyword takes testid as mandatory argument.
       
   969 	</errornote>
       
   970 	<commandinfo>
       
   971 Pauses a test case. The test case is paused by pausing the thread that executes
       
   972 the test case. The pausetest keyword has one mandatory argument
       
   973 
       
   974 pausetest testid time
       
   975  
       
   976 Arguments:
       
   977 testid: the test ID from the run command.
       
   978 time: (optional) Pause time in milliseconds. After this time, resume is called automatically (if not given, resume needs to be called explicitly). 
       
   979 	</commandinfo> 
       
   980 </command>
       
   981 
       
   982 <command id="resume">
       
   983 	<mandatory>
       
   984 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
   985 			testid
       
   986 		</argument >
       
   987 	</mandatory>
       
   988 	<errornote>
       
   989 	"resume" keyword takes an identification of a test case as an argument
       
   990 	</errornote> 
       
   991 	<commandinfo>
       
   992 Resumes a paused test case. 
       
   993 
       
   994 resume testid
       
   995  
       
   996 Arguments:
       
   997 testid:	The test ID from the run command.
       
   998 	</commandinfo> 
       
   999 </command>
       
  1000 
       
  1001 <command id="complete">
       
  1002 	<mandatory>
       
  1003 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
  1004 			testid
       
  1005 		</argument >
       
  1006 	</mandatory>
       
  1007 	<errornote>
       
  1008 	"complete" keyword takes an identification of a test case as an argument
       
  1009 	</errornote> 
       
  1010 	<commandinfo>
       
  1011 Waits and blocks a running test case. This keyword is used to have a started test case wait to complete. 
       
  1012 It blocks until the test case has finished.  
       
  1013 
       
  1014 complete testid
       
  1015  
       
  1016 Arguments:
       
  1017 testid:	The test ID from the run command.
       
  1018 	</commandinfo> 
       
  1019 </command>
       
  1020 
       
  1021 <command id="allocate">
       
  1022 	<mandatory>
       
  1023 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
  1024 			SlaveType
       
  1025 		</argument>
       
  1026 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
  1027 			SlaveName
       
  1028 		</argument>
       
  1029 	</mandatory>
       
  1030 	<errornote>
       
  1031 	"allocate" keyword must be follwed by slave type ans slave name
       
  1032 	</errornote> 
       
  1033  	<commandinfo>
       
  1034 Allocates a slave, for example for running a test case on a remote phone. 
       
  1035 It uses Remote Control Protocol (RPC). 
       
  1036 The slave must always be allocated first before it can be used.
       
  1037  
       
  1038 Arguments:
       
  1039 Slave type:	The type of the slave.
       
  1040 STIF only supports slave phone. phone indicates that slave phone is also running STIF. 
       
  1041 Other types must be handled by the slave implementation, i.e. when implementing separate support for external network simulator.
       
  1042 
       
  1043 Slave name:	A unique name for the slave.
       
  1044 
       
  1045 	</commandinfo>	
       
  1046 </command>
       
  1047 
       
  1048 
       
  1049 <command id="free">
       
  1050 	<mandatory>
       
  1051 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
  1052 			SlaveName
       
  1053 		</argument>
       
  1054 	</mandatory>
       
  1055 	<errornote>
       
  1056 	"free" keyword must be follwed by slave name
       
  1057 	</errornote>
       
  1058 	<commandinfo>
       
  1059 Frees a slave. Every allocated slave must be freed with free when it becomes unused.
       
  1060  
       
  1061 Arguments:
       
  1062 Slave type:	The type of the slave.
       
  1063 STIF only supports slave phone. phone indicates that slave phone is also running STIF. 
       
  1064 Other types must be handled by the slave implementation, i.e. when implementing separate support for external network simulator.
       
  1065 
       
  1066 	</commandinfo>	 
       
  1067 </command>
       
  1068 
       
  1069 <command id="remote">
       
  1070 	<mandatory>
       
  1071 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
  1072 			objectName 
       
  1073 		</argument>
       
  1074 		<argument type="selective" value="none" binding="none" nextvalue="none">
       
  1075 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
  1076 				run
       
  1077 			</argument>
       
  1078 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
  1079 				request
       
  1080 			</argument>		
       
  1081 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
  1082 				wait
       
  1083 			</argument>	
       
  1084 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
  1085 				set
       
  1086 			</argument>		
       
  1087 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
  1088 				unset
       
  1089 			</argument>
       
  1090 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
  1091 				set
       
  1092 			</argument>	
       
  1093 			<argument type="normal" value="name" binding="none" nextvalue="none">
       
  1094 				release	
       
  1095 			</argument>				
       
  1096 		</argument>
       
  1097 			<argument type="normal" value="literal" binding="none" nextvalue="none">
       
  1098 				module
       
  1099 			</argument>
       
  1100 	</mandatory>
       
  1101 	<optional>
       
  1102 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
  1103 				testmodule
       
  1104 		</argument>
       
  1105 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
  1106 				configfile
       
  1107 		</argument>
       
  1108 		<argument type="normal" value="digit" binding="none" nextvalue="none">
       
  1109 				testCaseNumber
       
  1110 		</argument>
       
  1111 		<argument type="normal" value="name" binding="=" nextvalue="digit">
       
  1112 			expect
       
  1113 		</argument>
       
  1114 		<argument type="normal" value="name" binding="=" nextvalue="literal">
       
  1115 			testid
       
  1116 		</argument>
       
  1117 		<argument type="normal" value="name" binding="=" nextvalue="literal">
       
  1118 			ini
       
  1119 		</argument>
       
  1120 		<argument type="normal" value="name" binding="=" nextvalue="literal">
       
  1121 			category
       
  1122 		</argument>
       
  1123 		<argument type="normal" value="name" binding="=" nextvalue="digit">
       
  1124 			timeout
       
  1125 		</argument>
       
  1126 		<argument type="normal" value="quoted" binding="none" nextvalue="none">
       
  1127 			title
       
  1128 		</argument>		
       
  1129 	</optional>
       
  1130 	<errornote>
       
  1131 	syntax error error
       
  1132 	</errornote> 
       
  1133 	<commandinfo>
       
  1134 Starts the execution of a test case in a slave and also to request and release events from the slave.
       
  1135 Other test case controlling for remote test cases is done with the same keywords as for the local test cases.
       
  1136  
       
  1137 Arguments:
       
  1138 Slave name: 	The slave name, the same that was given for allocate.
       
  1139 Command name:	The remote command name 
       
  1140 supported commands:
       
  1141 -run
       
  1142 -request
       
  1143 -wait
       
  1144 -set
       
  1145 -unset
       
  1146 -release
       
  1147 
       
  1148 
       
  1149 	</commandinfo>	
       
  1150 </command>
       
  1151 
       
  1152 
       
  1153 <command id="INCLUDE">
       
  1154 	<mandatory>
       
  1155 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
  1156 			filename
       
  1157 		</argument>
       
  1158 	</mandatory>
       
  1159 	<errornote>
       
  1160 	missing mandatory argument: filename.
       
  1161 	</errornote>
       
  1162 	<commandinfo>
       
  1163 Includes a file.
       
  1164 
       
  1165 Must be written in capital letters and must start from the first column of the line.
       
  1166 File name (with path and extension) must follow INCLUDE command. Rest of line would be ignored.
       
  1167 All files included from Unicode file should also be in Unicode format (and vice versa).
       
  1168 Loops in includes are not allowed (for example incorrect situation is when file A includes file B and file B includes file A). In that case, the second include will be ignored, but STF parser will continue working).
       
  1169 	</commandinfo>
       
  1170 </command>
       
  1171 
       
  1172 <!-- end test combiner commands -->
       
  1173 
       
  1174 <!-- commands for shareobject -->
       
  1175 <command id="createshareobj">
       
  1176 	<mandatory>
       
  1177 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
  1178 			TestClassName
       
  1179 		</argument>
       
  1180 		<argument type="creative" value="literal" binding="none" nextvalue="none">
       
  1181 			TestObjectName
       
  1182 		</argument>
       
  1183 	</mandatory>
       
  1184 	<errornote>
       
  1185 	syntax error
       
  1186 	</errornote>
       
  1187 	<commandinfo>
       
  1188 Creates an object, wihch can be shared to other test cases in the same test script file.
       
  1189  
       
  1190 createshareobj TestClassName  TestObjectName
       
  1191  
       
  1192 Arguments:
       
  1193 Test Class Name:	The test class name for the new object.
       
  1194 Test Object Name:   the name of the created new instance of the test class
       
  1195 	</commandinfo>	 
       
  1196 </command>
       
  1197 
       
  1198 <command id="restoreshareobj">
       
  1199 	<mandatory>
       
  1200 		<argument type="creative" value="literal" binding="none" nextvalue="none">
       
  1201 			TestObjectName
       
  1202 		</argument>
       
  1203 	</mandatory>
       
  1204 	<errornote>
       
  1205 	syntax error
       
  1206 	</errornote>
       
  1207 	<commandinfo>
       
  1208 Restores an object, which has been created by the createshareobj keyword.
       
  1209 
       
  1210 restoreshareobj TestObjectName
       
  1211  
       
  1212 Arguments:
       
  1213 Test Object Name:   the name of the instance of the test class
       
  1214 	</commandinfo>	 
       
  1215 </command>
       
  1216 
       
  1217 <command id="deleteshareobj">
       
  1218 	<mandatory>
       
  1219 		<argument type="creative" value="literal" binding="none" nextvalue="none">
       
  1220 			TestObjectName
       
  1221 		</argument>
       
  1222 	</mandatory>
       
  1223 	<errornote>
       
  1224 	syntax error
       
  1225 	</errornote>
       
  1226 	<commandinfo>
       
  1227 Deletes an instance of a test class created with createshareobj.
       
  1228 
       
  1229 deleteshareobj TestObjectName
       
  1230  
       
  1231 Arguments:
       
  1232 Test Object Name:   the name of the instance of the test class
       
  1233 	</commandinfo>	 
       
  1234 </command>
       
  1235 
       
  1236 <!-- end commands for shareobject -->
       
  1237 
       
  1238 </section>
       
  1239 
       
  1240 <section name="StifSettings" endname="EndStifSettings" proposal="[StifSettings]\[EndStifSettings]">
       
  1241 
       
  1242 </section>
       
  1243 
       
  1244 
       
  1245 <section name="Define" endname="Enddefine" proposal="[Define]\[Enddefine]">
       
  1246 </section>
       
  1247 
       
  1248 
       
  1249 <section name="New_Include_Module" endname="End_Include_Module" proposal="[New_Include_Module]\[End_Include_Module]">
       
  1250 </section>
       
  1251 
       
  1252 <section name="Data" endname="Enddata" proposal="[Data]\    file sectionfile.ini sectiondescriptor
       
  1253 \    section SectionName SectionObjectName\[Enddata]">
       
  1254 
       
  1255 <command id="file">
       
  1256 	<mandatory>
       
  1257 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
  1258 			sectionfile.ini
       
  1259 		</argument>
       
  1260 	</mandatory>
       
  1261 	<optional>
       
  1262 	    <argument type="creative" value="literal" binding="none" nextvalue="none">
       
  1263 			da 
       
  1264 		</argument>
       
  1265 	</optional>
       
  1266 	<errornote>
       
  1267 	Create has invalid argument
       
  1268 	</errornote> 
       
  1269 	<commandinfo>
       
  1270 Specifies data file name.
       
  1271 
       
  1272 file sectionfile.ini da
       
  1273 
       
  1274 Arguments:
       
  1275 sectionfile.ini:	the data file name
       
  1276 da:	Optional.A short name used in the script to reference the data file
       
  1277 	</commandinfo>
       
  1278 </command>
       
  1279 
       
  1280 
       
  1281 <command id="section">
       
  1282 	<mandatory>
       
  1283 		<argument type="normal" value="literal" binding="none" nextvalue="none">
       
  1284 			SectionName
       
  1285 		</argument>
       
  1286 	</mandatory>
       
  1287 	<optional>
       
  1288 	    <argument type="normal" value="literal" binding="none" nextvalue="none">
       
  1289 			SectionShortName 
       
  1290 	    </argument>
       
  1291 	</optional>
       
  1292 	<errornote>
       
  1293 	Create has invalid argument
       
  1294 	</errornote> 
       
  1295 	<commandinfo>
       
  1296 Specify which section in the data file will be referred
       
  1297 
       
  1298 section SectionName SectionShortName
       
  1299 
       
  1300 Arguments:
       
  1301 SectionName:	The section name defined in the data file.
       
  1302 SectionShortName:	Optional.The short name.
       
  1303 	</commandinfo>
       
  1304 </command>
       
  1305 
       
  1306 
       
  1307 </section>
       
  1308 
       
  1309 <section name="Sub" endname="Endsub" proposal="[Sub subname]\[Endsub]">
       
  1310 </section>
       
  1311 
       
  1312 </sections>