# Read Jobs

## Read Jobs

A *job* in the Modbus context is a recurring task that is set 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 what intervals the query should take place.

## Steps to Create a New Job

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FAT4WDXx5alOzTYi09lDY%2Fimage.png?alt=media&#x26;token=38bd9258-ee41-4769-82cf-fe5e1ccc10a3" alt=""><figcaption></figcaption></figure>

1. In the -> Modbus Connection, click on <img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FmonEQGTvfoU6ZiJs6S4P%2Fimage.png?alt=media&#x26;token=2abf90aa-a8c7-40e6-b89c-3d821adff853" alt="" data-size="line"> to create a new job.&#x20;

   ▷ 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 that should 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 that should be read.
   * **Interval**: Enter the interval (in seconds) at which the job should query 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.
* **Record performance data** A job that queries performance data of a generator every hour via holding registers.

***

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