# File Resource tab

**File resources** describe the characteristics of files and how data is converted when a file enters a VFS, is read from a VFS, or is used within the VFS.

In the **File Resource** tab of the **Actors** section, you can specify:

1. **Settings related to the content of the file**, e.g., text or binary, end of line for text files, charset for text files, compression and security configuration.
2. **File positioning:** internal, external, or link.
3. **Disposition rules**: creation of the file if it does not exist, override existing file, replace the file, etc.

The settings specified for **File Resources** are divided into **Local** and **Remote**: 

* **Local settings** are the attributes the file will have when inserted in the Virtual File System. 
* **Remote settings** are related to the file being received from a remote origin or being sent to a remote destination. Remote settings describe the file content received or the file content to be sent.

{% hint style="danger" %}
When defining a File Resource, **it is mandatory to specify both the local and remote settings, even if only the remote settings are used**. 
{% endhint %}

{% hint style="danger" %}
**Local settings are not used when the file is already present in the Virtual File System**. For example, when the file is sent to a remote destination, the content of the file is described by the Virtual File System attributes, and **local settings of the File Resource are ignored**.
{% endhint %}

## Create a new File Resource associated with an actor

To create a File Resource associated with an actor, on the **Actors** page, edit the actor, select the **File Resource** tab and click the **NEW** button. 

The actor to which the File Resource will be applied is shown and cannot be modified. These are the fields that must be filled in:

* **Name**: assign a unique name to the File Resource. These characters are accepted / ! \* + ? = " |\
  Blanks are not accepted.
* **Description**: enter a description for the File Resource. 
* **Reject File**: YES or NO (default). Select if a file matching the [File Processing Rule](/data-mover-1.21/contracts/create-your-first-contract/create-a-connection-contract.md#file-processing-rules) associated with this **File Resource** will be accepted (NO, default) or not (YES). 
* **Local Settings** have two different configurable platforms where they can operate, with different properties: WINDOWS / UNIX LIKE and zOS. Refer to the [Windows / Unix Like](/data-mover-1.21/contracts/file-resources/creating-file-resources.md#windows-unix-like) and [zOS](/data-mover-1.21/contracts/file-resources/creating-file-resources.md#zos) sections in the **File Resources** documentation. 
* The **Remote Settings** configuration has the same properties and definitions as the **Local Settings**.

## File Resources list

Already configured File Resources are listed on the page with the following details:

* **Modified**: the date and time when the File Resource was last updated. The date is displayed on the first line, and the time on the second line.
* **Name**: the name of the File Resource.
* **Reject File**: indicates whether a reject file is generated (YES or NO).

Results can be sorted in ascending or descending alphabetical order by selecting the **Name** column header, or in chronological and reverse chronological order by selecting the **Modified** column header.

## File Resource menu options

The 3‑dot icon next to each file resource provides the following options:

* **Edit**: opens the file resource details so you can modify fields.
* **Delete**: permanently deletes the file resource.

## Filters panel

File resources can be filtered using the **Filters** panel. 

In the **Search File Resources** field, enter the full file resource name or part of it, then press **Enter** on your keyboard or click **Apply**.

* The search field is **case‑insensitive**.
* You can run a search even by typing a **single character** (letter or number).
* **Wildcard characters are not supported**.

In the **Reject File** field, select whether a reject file is expected for the File Resource. Available options are **YES** or **NO**.

To reset the filter, click **Clear all**.


---

# 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://docs.primeur.com/data-mover-1.21/actors/configure-an-actor/file-resource-tab.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.