> For the complete documentation index, see [llms.txt](https://docs.pentaho.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pentaho.com/pba/pentaho-user-console/classic-design/about-pentaho-user-console-perspectives/browse-puc-perspective/run-files-in-background-task-article.md).

# Run files in background

You can run reports in the background from the User Console using Run in Background. The types you can run include Report Designer Reports (.prpt), Analyzer Reports (.xanalyzer), and Interactive Reports (.prpti).

You must be connected to a Pentaho Repository and have your reports saved to that repository before running them.

Perform the following steps to run a report in the background:

1. Log in to the User Console, and then click the **Browse Files** button.
2. In the **Folders** pane, browse to the folder containing the file that you want to run.
3. In the **File** pane, click on the file that you want to run.
4. In the **File Actions** pane, click **Run in background**.

   The Run In Background dialog box appears.

   ![Run in Background dialog box](/files/TJoJZdvuHrrIgM9Camk2)
5. Enter your selections for the following fields:

   | Field                                                     | Description                                                                                                                                                                                                                                               |
   | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | **Generated Content Name**                                | Specify a name for the generated content. If no name is entered in the Name field, the default is the report name.                                                                                                                                        |
   | **Append timestamp to generated content**                 | Click this check box to append the value specified in the **Generated Content Name** with a timestamp. When selected, a menu shows a list of timestamp format options. Use the **Preview** panel to view how the name will display on the generated file. |
   | **Generated Content Location**                            | Specify a location for the generated content. Click **Select** to browse to a folder location to choose it.                                                                                                                                               |
   | **Overwrite existing files with same name and timestamp** | Click this check box to overwrite any existing files that have the same name and timestamp as the one you are running and saving to the specified location.                                                                                               |
6. Click **Next**. If the selected report has run parameters, such as Output Type, you will be asked to specify them here.
7. When you have completed your parameter selections, click **Finish**.

The file is now processing. The system will deliver the content generated from the report to your specified location.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.pentaho.com/pba/pentaho-user-console/classic-design/about-pentaho-user-console-perspectives/browse-puc-perspective/run-files-in-background-task-article.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.