How to Work with Processes > Working with the Other Processes Group > Working with Start External Program Process

Process Purpose

The Start External Program process is used to call a specific external program with arguments (if needed). This process handles external programs, so you must consider the operating system of the current project's target device when using it. Depending on the target device's OS, some of the "Start External Program" settings will be filled in differently (ex: the required identifying elements of the external program being called are different for a Windows and an Android environment).

When you add a process, you are required to define its settings. This occurs in the process's properties window which is displayed automatically after having added the Start External Program process.

If any subsequent edition is required, double-click the process to open its properties window and enter the necessary modifications.

Proceed as follows:

Program
Name	Identify and locate the external program you want to call: •If the target device for the current application is a Windows Mobile device, you must specify name, path and extension (ex: \windows\mobilecalculator.exe). •If the target device for the current application is an Android device, enter the complete package name (ex: com.android.calculator2). You can enter the information or click and select a variable with that value. As an option, you can use a relative path to locate the external program. See Working with Aliases.
Arguments	Define the arguments to be provided to the external program or click and select a variable with that value.
Run in Background	Check this option to allow the called external program to run in the background. If left unchecked, the external program will run on top of the MCL application.
Wait for Completion	Check this option to force the MCL program's execution to wait for the external program to finish its tasks. If not checked, the MCL program continues its execution. When checking/unchecking this option, consider the external program you want to call. For instance, some Windows applications are not terminated when closed with the "X" option, they continue running in the background. If this is the type of program you want to call, you should not check the option to wait for the called program's completion. Calling applications that are already running in the background (with the option of "wait for completion" unchecked), will bring them to foreground.
Store Result into Variables
Return Code	Click to select the variable that will receive the return code value. See To Select/Create a Variable.
If Error
Go to	Select a target location from the drop-down or the list, if an error occurs in the execution of the Run Process operation. See Detail of a window below.

Detail of a window:

"S:Menu" is a screen included in the same program as the process.

"R:Routine_1" is a routine included in the same program as the process.

If required, use the icon on the upper right corner of the properties window:

Use the icon to attach any relevant notes to this process. Click it and enter your notes in the resulting text box. These notes will be displayed in the corresponding "Actions" tab or "Process" window (in the "Notes" field) and in the "Developer Report".

After filling in the required options, click to conclude or to abort the operation.

The added process is displayed in the corresponding "Actions" tab or "Process" window.

Start External Program Examples

Use the right click in MCL-Designer's input boxes to access certain features regarding the input box's option as well as general actions such as "Copy"; "Paste"; "Search".

Ex: If you right-click the "Variable" input box (included in a "Conversion's" properties window), you are provided with the "Search..."and "Variable Select" options.

If you right-click another input box, it will provide other possibilities.