Script Language Definition

Lexical Analyser

The following table describes the script tokens in Fast Lexical Analyzer (FLEX) notation. Visit the FLEX web site for details at http://www.gnu.org/software/flex/.

Definitions

Rules

Backus Naur Form

An action can be called in two ways, the first with a full stop will log all passes and failure whereas using a colon will log only failures. This allows the script writer to reduce the size of the results file for actions that are not critical to the overall result.

The Sprintf statement allows you to format a string and assign it to a variable. The sprint statement has the format string sprintf(string format, ...). It can therefore be used via the assignment statement e.g.

Str = Sprintf(“Hello %s”,”World”)

In this example Str would equal “Hello World”

The Sscanf statements allow you to extract values from a string and has the format var = sscanf(string format,string text). Please note that although this is called sscanf the format for the function is not the same as in the C library due to the fact that the results are returned as an array rather than entered into supplied parameters. Also the input string comes after the format string. It is therefore used via the assignment statement e.g.

Var = Sscanf(“%s %s”,”Hello World”)

In this example Var would be an array where Var[0] = “Hello” and Var[1] = “World”

The Sleep statement allows you pause for a number of seconds or fraction of seconds if a double is used. Please note that the sleep statement only guarantees a minimum wait and that the actual wait can be longer.

The arraylength command returns the number of values in an array e.g.

Given Var from the sscanf statement arraylength(Var) would return 2.

If you add the keyword default before a variable assignment the assignment will only take place if the variable does not already exist either from the script or as a system variable. This allows you to have default values for variables that can be overridden if required e.g.

default loopcount = 10

If you wish to define a different loopcount then add a system variable called loopcount with the new value.

The built in variables provide date and time values for three points in time plus random numbers. Values preceded with Current or nothing are for current date/time, values preceded with load are the date/time at which the script was loaded and values preceded with run are the date/time when the script was started.

The ScriptDirectory command provides the full path to the directory from which the script was loaded. This can be used to ensure your script is directory independent when requiring test files. To obtain the full path to a test file located in the same directory as the script use the sprintf statement e. g. :-

filename = sprintf("%smyfile.txt",scriptdir)

Move and Copy Log file allows you to add bespoke log files to the results directory. These can be defined at any point in the script but the actual move/copy takes place once the script is complete and the log file name is given the same name as the script results file followed by the actual filename. e.g.

movelogfile("C:\MyLogFile.txt")

This will move the file C:\MyLogFile.txt to the results directory at script completion if it exists. Should a failure occur the log file will indicate the problem. Please note you can include wild card chars in the file name as well as using a string variable. Use the copylogfile command to copy instead of move the file(s).

The local keyword can be added to a variable assignment/declaration in order to limit its scope to the current script nesting level.