# Configure Rules

To create a new Rule, click the **New Rule** button at the top right-hand corner. The **New Rule** dialog window will appear.

Depending on your needs, in this window you can:

* Use one of the 4 templates already configured
* Create a new rule from scratch

On the left of the window, 4 configured Rule Templates are listed:

<figure><img src="/files/3FNbPAla0HJb54xljiGV" alt=""><figcaption></figcaption></figure>

As you can see in the figure above, 2 templates define rules to limit the Jobs executed in parallel and 2 templates assign priorities to the Jobs to be executed. In other words, there are 2 templates of “limit” type and 2 templates of “priority” type.

To see the attributes defined for each Template, simply click the template name on the list. Its values will be loaded on the right. As you can see in the figure above, the second template is of limit type, it has 100 maximum parallel transfers in output, for protocol PR4 and the rule is applied to a specific Actor.

Once you have identified the template that best suits your needs, click the **Use** button at the top right-hand corner to proceed with its configuration. The **New Rule** dialog window will appear, loading the attributes defined for the template and allowing you to add the attributes you need to further customize your Rule.

To customize your Rule, assign it a name in the **New rule** field.

Then, you can set the limit of concurrent transfers in the TO edit box – in the figure above, the limit is set to 100. If you are creating a priority-type Rule, in this field you will assign the priority to the Jobs to be executed.

Now you can select the **conditions** in the drop-down lists on the left and the **attribute** on the right.

<figure><img src="https://files.readme.io/c98b2f0-attributes.png" alt="" width="563"><figcaption></figcaption></figure>

**Note**: The Direction, Data One Role, and Cluster Name attributes are mandatory and cannot be deleted.

This is the list of the existing attributes and their relevant description:

| Attribute                                                                                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>LIMIT (*)</strong><br><strong>or</strong><br><strong>PRIORITY (*)</strong></p> | <p>The Rule sets the maximum number of parallel transfers allowed<br>or<br>The Rule assigns a priority to the Job executed</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **TO**                                                                                    | <p>Limit-type Rule: enter the maximum number of parallel transfers<br>Priority-type Rule: enter the priority of the Job. The higher the number, the higher the priority</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **DIRECTION (\*)**                                                                        | Direction of the transfer: Input or Output                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **DATA ONE ROLE (\*)**                                                                    | PRIMEUR Data One can be a Client or a Server                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **CLUSTER NAME (\*)**                                                                     | Select one of the configured Clusters                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **SOURCE**                                                                                | <p>To fill in this field, keep the values entered in the Client Connection Tab close at hand. Refer to Configuring an Actor > <a href="/pages/Av3LOwepqIHKlzeKAehp">Client Connection Tab</a> for details.<br>The content of the Source field depends on the Protocol and other attributes.<br>For PR4, PR5 and PR5S Protocols:<br>- when DIRECTION is set to Input, the SOURCE is the value entered in the QMANAGER NAME field when creating the client connection.<br>- when DIRECTION is set to Output, the SOURCE is the value entered in the LOCAL QM field when creating the client connection.<br>For all protocols different from PR4, PR5 and PR5S:<br>- when ROLE is set to SERVER, the SOURCE is the name of the Actor.<br>- when ROLE is set to CLIENT, the SOURCE is not needed.</p>                                  |
| **DESTINATION**                                                                           | <p>To fill in this field, keep the values entered in the Client Connection Tab close at hand. Refer to Configuring an Actor → <a href="/pages/Av3LOwepqIHKlzeKAehp">Client Connections</a> for details.<br>The content of the Destination field depends on the Protocol and other attributes.<br>For PR4, PR5 and PR5S Protocols:<br>- when DIRECTION is set to Input, the DESTINATION is the value entered in the LOCAL QM field when creating the client connection.<br>- when DIRECTION is set to Output, the DESTINATION is the value entered in the QMANAGER NAME field when creating the client connection.<br>For all protocols different from PR4, PR5 and PR5S:<br>- when ROLE is set to CLIENT, the DESTINATION is the name of the Client Connection<br>- when ROLE is set to SERVER, the DESTINATION is not needed.</p> |
| **PROTOCOL**                                                                              | Select the Transfer Protocol to which the Rule will be applied                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **SERVER**                                                                                | Choose the Server configured on the selected peer                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **PARTNER**                                                                               | Select the Partner to which the Rule will be applied                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **DESCRIPTION**                                                                           | Define a Description for the Rule                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **PEER NAME**                                                                             | Select the endpoint Peer Name for the Rule                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

On the right of the value, the <img src="https://files.readme.io/20970cd-bin_icon.png" alt="" data-size="line"><img src="https://files.readme.io/54dfce1-_icon.png" alt="" data-size="line"> buttons allow you to add a new Attribute and remove it from the list.\
On the right of the window, use the WHEN section to define the time interval when the Rule will be applied. As you can see, you can define multiple time slots by simply clicking the <img src="https://files.readme.io/2f461d5-add_time_slot.png" alt="" data-size="line">option. Leave this field empty to have the Rule enabled all day long. To remove a Time slot, click the <img src="https://files.readme.io/20970cd-bin_icon.png" alt="" data-size="line"> icon.

If you prefer to create a new rule without using a template, click the **CREATE YOUR RULE** button in the **New Rule** window.

<figure><img src="/files/PmqKtJhuCCIVuVrhpF3g" alt="" width="563"><figcaption></figcaption></figure>

The same window shown for the template-created Rule will appear without loading any value in the attributes fields. The same options and attributes as for the pre-configured Rules apply, so refer to the section above for details.

Once you have defined the attributes for your Rule – either based on a Template or not – click the **Save** button. Your Rule will be added to the Home Page where the standard search, visualization, sorting, editing, and deleting options are available.

<figure><img src="/files/ZtmxmjDQn4Vrbao1bSwq" alt=""><figcaption></figcaption></figure>


---

# 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/monitoring/file-transfers-rules/configure-rules.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.
