DO

System Testing Supervisor Script Language.

Purpose

The DO instruction executes a program on a remote machine and waits for the end of its execution.

Syntax

DO [ <process> IS ] <hostname> : <program> [ <parameters> ]

where:

<process> optionally assigns a process name to the program

<hostname> is the name of the remote machine as defined by a HOST instruction

<program> is the name of the program to execute

<parameters> is a set of optional parameters that can be sent to <program>

Description

DO is a blocking instruction that waits for the program to end.

The field <hostname> is mandatory and must specify a remote machine.

You can give a logical name to a program by including the clause <process> IS. You can then form expressions with the ENDOF and STATUS operators.

A process name may only appear once in a supervision script, otherwise you will receive an error when the scenario does not execute. If <process> IS is not present, the ENDOF and STATUS operators cannot be used.

While the program runs, all logs sent to the standard and error outputs are redirected to the supervisor, except if you have set TRACE OFF.

If the program does not start or does not have execution permission, an error message is produced. (See ERROR.)

Note If a logical process name is used in a DO instruction within a WHILE loop, the name refers not to a single process, but a group of processes. (See the ENDOF and STATUS operators.)

Example

HOST remote IS 192.3.2.1

DO process_1 IS remote: ls /tmp -l

i = 1

WHILE i < 10

DO group IS remote:program

i = i + 1

END WHILE

-- the variable group refers to a group of 9

-- executions of the process called program