5.7.7 run keyword

The run keyword is used to start a specified test case. It has several mandatory and optional arguments, described below.

Mandatory arguments

testmodule

The test module name.

configfile

The test case configuration file. If does not contain path but only filename then $HOME/.min path is used.

Test case number

The test case number to be executed from configfile.

Optional arguments

expect

The expected result default 0 = ENOERR

testid

Test case identification, which is used by other keywords to identify the test case

Note: Avoid using the same testid for many test case runs

Ini

The initialization file for test module (not supported yet)

category

The result category; either normal, leave, panic, exception or timeout

timeout

Test case timeout.

title

Test case title. If given, following rules must be held:

• if title is given, test case number is ignored (however still must be provided);
• if title contains space chars, then the whole title has to be given between quotation marks (e.g. title="My example with space");
• test case title must not contain quotation mark (");
• all normal modules must be 1-base indexed;
• if module has more than one test case which match the title, first one will be run;
• in master slave environment, if module does not have configuration file, dummy.cfg must be given for configfile argument.

The run keyword can be used for example in the following way:

     run netmodule net.cfg 5 testid=test1 expect=3 ini=ini.txt
     run netmodule net.cfg -1 testid=test2 title="My test case example"