Introduction to tsscmd |
tsscmd statements have one of the following two basic formats:
tsscmdcommand
options
arguments
value
= `tsscmdcommand
options
arguments
'
command
is a keyword indicating the Test Script Service you are requesting.
options
indicates zero or more options supported by command
. Option names are preceded by a "-" (hyphen) and might be followed by arguments. If present, options must precede arguments
.
arguments
indicates zero or more values that might be required by command
. If present, arguments are positional (must be specified in order) and must follow any options
. Argument strings that contain spaces (or any characters with special meaning to the scripting language, such as ".") must be quoted.
In the second format, value
is a variable defined in whatever scripting language you are using: the tsscmd expression will return a value to this variable, which can then be used in the test script in whatever manner the scripting language allows.
Note that `' indicate delimiters. Some delimiter is required, but a different delimiter might be used, or required, with different scripting languages. For example, in Perl, here are the correct command formats:
`tsscmdcommand
options
arguments`;
$value
=`tsscmd
command
options
arguments
`;
With the first format (no value returned), you can use the Perl system
function.
Both command
and options
are case-insensitive and can be abbreviated by the shortest unique string. Thus, two statement options named -access and -ascend can be specified as -ACCESS, -ASCEND, -ac, and -as. Similarly, the command DatapoolOpen
can be entered as datapoolopen
, DATAPOOLOPEN
, datapoolO
, DATAPOOLo
, and so on.
The Command Line Interface to Rational Test Script Services | Rational Software Corporation |
Copyright (c) 2003, Rational Software Corporation | http://www.rational.com support@rational.com info@rational.com |