> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/english-v14/connectivity-as-a-service/gerate-mit-abb-buildingpro-verbinden/gerate-per-modbus-verbinden/jobs-lesen.md).

# Read jobs

## Read Jobs

A *job* in the Modbus context is a recurring task that is defined to read data from a Modbus device. This data can then be used for further processing, visualization, or control. A *job* defines which data (registers) are read from a Modbus slave device and at which intervals polling should take place.

## Steps to create a new job

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/ICgtMRA7FxMWMFuYQPkm/image.png" alt=""><figcaption></figcaption></figure>

1. Click in the [-> Modbus connection](https://docs.buildings.ability.abb/collection/english-v14/connectivity-as-a-service/gerate-mit-abb-buildingpro-verbinden/gerate-per-modbus-verbinden/neue-modbus-verbindung-erstellen.md) on <img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/gACUHLw4AgMd2KBEJG6p/image.png" alt="" data-size="line">, to create a new job.

   ▷ A configuration window for the new job opens.
2. **Job configuration**

   Fill in the following fields in the configuration window:

   * **Name**: Enter a name for the job that describes the task (e.g. "Read temperature").
   * **Function**: Select the Modbus function to be used for this job (e.g. "Read holding registers").
     * Typical functions include reading coil registers, input registers, or holding registers.
   * **Address**: Enter the start address of the registers you want to read. This is the memory address in the Modbus device.
   * **Length**: Enter the number of registers to be read.
   * **Interval**: Enter the interval (in seconds) at which the job should poll the registers (e.g. every 10 seconds).
3. **Save job**
   * Click on **Save**, to create the job.
   * ▷ The new job appears in the list of defined jobs under *Read jobs*.

***

### Examples of typical Modbus jobs

* **Temperature monitoring**\
  A job that reads the temperature from a specific sensor every 30 seconds.
* **Capture performance data**\
  A job that polls performance data from a generator hourly via holding registers.

***

{% hint style="danger" %}
Make sure that the address and length of the registers are specified correctly to ensure that the correct data is read. Incorrect information can lead to malfunctions or incorrect values.
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.buildings.ability.abb/collection/english-v14/connectivity-as-a-service/gerate-mit-abb-buildingpro-verbinden/gerate-per-modbus-verbinden/jobs-lesen.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
