# Run Program Task

The *Run Program* task is used to run an executable command or batch file as part of your workflow. The execution of certain tasks, such as a series of commands in other programming languages (e.g., Python/R), in the form of a .bat extension file, is performed through the *Run Program* task object.

![](/files/8dK9C3XbByICwc4Gm6A9)

To use a *Run Program* task:

1. Drag and drop the *Run Program* task object onto the workflow designer. Configure the object by right-clicking on the object’s header and selecting *Properties* from the context menu.

![](/files/j9Lsq8wHI64mENAUbRP6)

2. A *Run Program Properties* window will open, as shown below. This screen lets users define properties for an executable batch file.

![](/files/KpPmTM7JzkStScLxkeqq)

* *Program Path*: Specify the file path to the executable batch file that you want to run as part of the workflow.
* *Run In*: Specify the default folder where Astera will run the batch file. (**optional**)
* *Arguments*: Specify any required or optional arguments for running the batch file, such as providing an external input or indicating an input parameter change.
* *Run As*: Enter a user account (if different from the administrator) that should be used for running the batch file.
* *Password*: Enter the password specific to the user account entered in the *Run As* option.
* *Success Value*: A value returned by the executable batch file upon its successful completion. The default value is 0. The *Run Program* task will expect this value to signal the successful completion of the task.
* *Timeout*: Define a time after which, if the program task fails to execute, Astera will terminate the process.
* *Fail Action if Unsuccessful*: Check this option to return an error when the executable batch file ends with an error in the code.
* *Wait for Task to Complete*: Check this option to stop Astera from proceeding to the next task in the workflow until the batch file has finished running.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.astera.com/astera-data-stack-v9/workflows/run-program-task.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.