# Active List

> Symcon documentation · English · generated on 2026-09-26  
> Index: https://www.symcon.de/en/llms.txt

Source: https://www.symcon.de/en/service/documentation/module-reference/logic/active-list/

_Requires Symcon >= 5.0_

The 'Active List' shows all active variables in the Visualization and offers the possibility to switch them off simultaneously.
To do this, they must have been added to the list on the configuration page beforehand.

### function scope

- Displays all active variables in the Visualization and allows switching them off.

### Software Installation

- Use the [Module Store](https://www.symcon.de/en/service/documentation/components/management-console/module-store/) to install the Active List module.

### Setting up instances in IP-Symcon

- Under "Add Instance" the 'Active List' module can be found using the quick filter.
  - More information in the [Instances documentation](https://www.symcon.de/en/service/documentation/basics/instances/).

#### configuration page

| Name            | Description                                               |
| --------------- | --------------------------------------------------------- |
| Turn Off Action | Creates an action to turn off the variable simultaneously |
| Variables       | A list of variables whose status is checked.              |

Variables are considered active when ...
- the value of an integer or float variable is greater than the minimum value. If the variable has a .reversed profile it is considered active if the value is less than the maximum value.
- the value of a boolean variable is true. If the variable has a .reversed profile, false is the active state.
- the value of a string variable is not empty.

###

Accordingly, variables are considered inactive if ...
- the value of an integer or float variable is the minimum value. If the variable has a .Reversed profile, it is considered inactive if the value is the maximum value.
- the value of a boolean is false. If the variable has a .reversed profile, true is the inactive state.
- the value of a string variable is empty.

### statusvariables

The status variables/categories are created automatically. Deleting individual ones can lead to malfunctions.

#### Statusvariables

| Name    | Type   | Description                                   |
| ------- | ------ | --------------------------------------------- |
| Disable | Script | Disables all variables that are still active. |

### Visualization

All active variables will be displayed on the Visualization. With a click on "Switch off" all displayed variables are switched to inactive.

## AL_SwitchOff

Source: https://www.symcon.de/en/service/documentation/module-reference/logic/active-list/al-switchoff/

`bool AL_SwitchOff(int $InstanzID)`

_Requires Symcon >= 5.0_

**Parameters**

- `$InstanzID` (int): ID des zu schaltenden Geräts

**Returns** (bool): If the command could be executed successfully, it returns __TRUE__ as result, otherwise __FALSE__.

ID des zu schaltenden Geräts

**Example**

```text
AL_SwitchOff(12345);
```