ExecIsRunning
- Last UpdatedOct 29, 2026
- 1 minute read
ExecIsRunning is a built-in function that determines whether a command that was executed asynchronously by the Exec function is still being executed.
|
Function |
Group |
Execution |
String Exp. |
Windows |
Windows Embedded |
IoT View |
Thin Clients |
Mobile Access |
|---|---|---|---|---|---|---|---|---|
|
ExecIsRunning |
Module Activity |
Synchronous |
Yes |
Supported |
Supported |
Supported |
Supported |
Not supported |
Syntax
ExecIsRunning(numHandle,"optTagReturn")
ExecIsRunning ( numHandle { | ,"optTagReturn" } )
numHandle
The handle that was previously stored in the project tag specified by the optStrReturnOrHandle parameter of the Exec function.
optTagReturn
The name of a project tag that will receive the exit code returned by the command or program when the execution is completed.
Note: If this parameter is enclosed in quotes, the string literal will be used. Otherwise, the value of the tag/expression will be used.
Return value
This function returns one of the following possible values:
|
Value |
Description |
|---|---|
|
1 |
Program is still running. |
|
0 |
Execution has completed successfully (that is, the program has closed). |
|
-1 |
Invalid number of parameters. |
|
-2 |
Invalid handle number. Check the value for numHandle. |
|
-3 |
Execution has completed, but the return tag is invalid. Check the value for optTagReturn. |
Examples
Get the handle stored in the tag execHandle, and then determine whether that command is still being executed:
ExecIsRunning(execHandle)
Get the handle stored in the tag execHandle, determine whether that command is still being executed, and then store the exit code in the tag execReturn:
ExecIsRunning(execHandle,"execReturn")