---
title: "Run Command Line Program On File"
slug: "run-command-line-program-on-file"
updated: 2025-07-11T14:23:15Z
published: 2025-07-11T14:23:15Z
canonical: "documentation.decisions.com/run-command-line-program-on-file"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Run Command Line Program On File

| ## Step Details |
| --- |
| **Introduced in Version** | 3.0.0 |
| **Last Modified in Version** | --- |
| **Location** | File Management |

The **Run Command Line Program on File** step utilizes a file as an input and is used to execute a batch file within a Flow, similar to the **Run Command** step. Though the step requires a file as an input, the step does not require the file to be utilized by any commands within the batch file. The full file path to the batch file will need to be entered into the Command input.

---

## Properties

#### Inputs

| Property | Description | Data Type |
| --- | --- | --- |
| File | The file which can be passed as a parameter to the command file. | FileData |
| Working Directory | The path to the file | List of String |

#### Outputs

| Property | Description | Data Type |
| --- | --- | --- |
| ErrorCode |
|  | Command Error Output | Outputs errors found when executing the command | String |
|  | Command Output | Outputs the command | String |
|  | Return Code | Outputs the return code | String |

#### Setup

| Property | Description | Data Type |
| --- | --- | --- |
| Command | The absolute file path of the command file (C:\Examples\Test.bat) | --- |
| ParameterString | Optional setting used to pass parameters to the command file | --- |
| UseShellExecute | Determines whether to use the system shell to start the process | Boolean |
| LoadFileOnCompletion | Loads the file after completion of the step | Boolean |

#### ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1673464018374.png) ---

## Common Errors

### Could not find command

A common error when utilizing the step would be having an incomplete file path to the command file. Ensure that the full file path to the command file is complete and includes the file extension

```cpp
Exception Stack Trace: DecisionsFramework.Design.Flow.ErrorRunningFlowStep: Error running step Run Command Line Program On File 1[RunCommandOnFile] in flow [Testing Flow]: could not find command: C:\Examples\Test.ext ---> DecisionsFramework.LoggedException: could not find command: C:\Examples\Test.ext
   at DecisionsFramework.Design.Flow.CoreSteps.StandardSteps.AbstractRunFileCommand.Run(StepStartData data)
   at DecisionsFramework.Design.Flow.FlowStep.RunStepInternal(String flowTrackingID, String stepTrackingID, KeyValuePairDataStructure[] stepRunDataValues, AbstractFlowTrackingData trackingData)
   at DecisionsFramework.Design.Flow.FlowStep.Start(String flowTrackingID, String stepTrackingID, FlowStateData data, AbstractFlowTrackingData trackingData, RunningStepData currentStepData) 
   --- End of inner exception stack trace ---
```

---

Related Information

Forum Posts: [Changing Working Directory On Run Command Step](https://community.decisions.com/discussion/2106/changing-working-directory-on-run-command-step)