Process Operations

The automation tools modules for process operations opens an application or an executable file.

TBox Start Program

Open an application or an executable file stored on a Microsoft Windows file system. You can also use it to shut down an application from the command line.

Value	Description
Path	Path to the application that you want to open or an environment variable. To shut down an application, enter the name of the command line task. This entry is mandatory.
Directory	Specify a working directory for the program. By default, Tosca Cloud uses the home directory of the registered user: C:\Documents and Settings\<user name>.
Arguments	If you want to start or stop the application via arguments, specify arguments.
Arguments->Argument	Define an argument and use action mode Input. To shut down an application, one of the arguments must be its name according to the Details tab of Windows Task Manager. You can specify multiple arguments.
WaitforExit	You can instruct Tosca Cloud to wait until the application is closed. To do this, set the value to True and use action mode Select. Optionally, specify StandardOutputFile, TimeoutForExit, and ExitCode.
WaitforExit->StandardOutputFile	If you want Tosca Cloud to create a log, specify the path and name of the log file. The log includes standard output (stdout) and standard error (stderr).
WaitforExit->TimeoutForExit	Specify the maximum time in seconds that Tosca Cloud should wait before exiting the application.
WaitforExit->ExitCode	Verify your application's exit code. To do this, enter the code in the Value column and use action mode Verify.
Run as	Define which domain or local user credentials Tosca Cloud should use to open the application. The default action mode is Select.
Run as->Username	User Principal Name (UPN) format of the user name that should open the application. For example: jdoe@company.com.
Run as->Password	If needed, specify the user's password.

TBox Close Program

Lets you do the following things:

Close an application or process.
Wait until an application has closed.
Verify whether an application or process is currently running.

This is helpful whenever you need to end an application before you can proceed with the next test step.

Value	Description
Id*	Process identification number (PID) of the application. Example: 7588.
Name*	Process name of the application. Example: msedge.
Main Window Title*	Title of the main application window. Example: Slack.
Command Line	Optionally, you can refine the identification by entering the command line parameters that you use to run your application. If you're only interested in certain parts of the parameter set, use wildcards.
Operation	Select the operation you want to perform: Close if Exist: Closes the specified application or process. If the application or process doesn't exist, or if Tosca Cloud can't find it, the test case passes with nothing to close. Close: Closes the specified application. If the specified application isn't running, the test case fails. Wait on Close: Waits until the specified application is closed by another process or user. Verify Program Exists: Verifies if the specified application or process is currently running.
*You need to specify at least one of these values in your test case for Tosca Cloud to find the correct application or process. If you have multiple applications or processes with the same or similar identifiers, use more than one of those identifiers in your test case.