# Request limit (throttling)

{% hint style="info" %}
Availability of the functionality depends on the license and may not be available in all deployments.
{% endhint %}

## Active request instance limit

Active request instance limit (so-called *throttle*) allows limiting the number of simultaneously running requests of a given type on a **specific server**. After the limit is exceeded, the user cannot start another instance — instead, an information page is displayed.

This solution is especially useful in situations of increased system load or during maintenance work.

## Configuration

The limit configuration is done in the file:

```
/etc/eximee/webforms.xml
```

{% hint style="info" %}
Changes in the file are applied without the need to restart the Tomcat server.
{% endhint %}

Example configuration in the .xml file:

```js
<webforms>
    <server> 
        <limits>
            <forms>
                <_uwmappertest>3</_uwmappertest>
                <_demo_porownywarka_ofert>3</_demo_porownywarka_ofert>
            </forms>
        </limits>
    </server>
</webforms>
```

In the tag `<forms>` we define the requests covered by the limit:

```
<_FORMNAME>LIMIT</_FORMNAME>
```

Where:

* `FORMNAME` – request name,
* `LIMIT` – maximum number of active instances.

**Important rules:**

* each request name `FORMNAME` must have the \_ prefix
* no entry means **no limit**,
* setting the value to 0 means complete **blocking of the request**.

### Configuration examples

**Complete blocking of the request**

```
<_przykladowy_wniosek>0</_przykladowy_wniosek>
```

After entering the request, the user will see a page informing them that it is unavailable.

**Limiting the number of instances**

```
<_przykladowy_wniosek>2</_przykladowy_wniosek>
```

The third attempt to start the request will result in an error page being displayed.

## Information page

The text on the information page can be set from the **Eximee Designer**tab, **Library → Content** section by searching for the formatted content **error\_page\_formLimitExceeded**.

You should also complete the file **webforms-error-pages.xml** by adding the following fragment:

```xml
<code_formLimitExceeded>
    <content>error_page_formLimitExceeded-*</content>
</code_formLimitExceeded>
```


---

# 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.eximee.com/documentation/documentation-en/eksploatacja-aplikacji/webforms/konfiguracja/limit-wnioskow-dlawik.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.