System Testing supervisor script reference (.spv)

When using the System Testing tool, the machine running Rational® Test RealTime runs a supervisor process.

This section describes each supervisor script instruction, including:

  • Syntax

  • Functionality and rules governing its usage

  • Examples of use

Notation Conventions

Throughout this guide, command notation and argument parameters use the following standard convention:

NotationExampleMeaning
BOLDADD_IDLanguage keyword
<italic><filename>Symbolic variables
[ ][<option>]Optional items
{ }{<filenames>}Series of values
[{ }][{<filenames>}]Optional series of variables
|on|offOR operator

System test script keywords are case sensitive. All keywords must be entered in upper case.

For conventional purposes however, this document uses upper-case notation for the supervisor script keywords in order to differentiate from native source code.

Split statements

Statements may be split over several lines in a .spv supervisor script. Continued lines must start with the ampersand ('&') symbol to be recognized as a continuation of the previous line. No tabs or spaces should precede the ampersand.

Statements must be shorter than 2048 characters, although this limit may be lower on some platforms.

Identifiers

A supervisor script identifier is a text string used as a label, such as the name of a message type.

Identifiers are made of an unlimited sequence of the following characters:

  • a-z

  • A-Z

  • 0-9

  • _ (underscore)

Spaces are not valid identifier characters.

System Testing keywords and identifiers are case sensitive. This means that LABEL, label, and Label are three different identifiers.

Related Topics

Supervisor script structure | Supervisor script keywords | System Testing supervisor