Block Execution

Prev Next

Overview

Block Execution pauses parts of Pathfinder Core PRO while it keeps running. You can stop everything, stop one subsystem such as all scenes, or stop a single scene, router, panel or logic flow folder, while leaving the rest working.

Use it during maintenance windows, when testing a new configuration, while troubleshooting, or when making many changes at once without them triggering each other.

How It Works

The Three States

Every component that can be blocked has one of three states:

State

What it does

Inherit

Follows its parent. If the parent is blocked, this is blocked; otherwise it runs.

Block

Stops execution here and in everything below that inherits.

Override

Runs even when a parent is blocked. Use it for exceptions such as maintenance tools.

Everything starts as Inherit, which at the top level means "not blocked".

What Can Be Blocked

Blocking works down Pathfinder's object tree. Block a manager and everything under it is blocked, except components set to Override.

Manager

Object path

Children that can be blocked

Logic Flows

LogicFlows#0

Logic flow folders

Property Groups

PropertyGroups#0

Property groups

Routers

Routers#0

Individual routers

Scenes

Scenes#0

Individual scenes

Timers

TimeEvents#0

Timers, date/time and day-of-week events

User Panels

UserPanels#0

Panels and their pages

The flows that a user panel creates for its bindings are in the _panels View of Logic Flows, but they follow the block state of their panel or page, not of Logic Flows. Blocking LogicFlows#0 leaves them running. Blocking User Panels, a panel or a page blocks the flows that belong to it. Pathfinder Core PRO adds the matching entries for the _panels folders to the block list for you, so they appear in ExecutionBlockList (see From the API or a Logic Flow).

What Stops and What Keeps Working

Component

When blocked

Still works

Scenes

Triggers are ignored, whether manual, scheduled or automated.

Viewing and editing scenes.

Routers

Route change requests are rejected.

Querying routes, editing router configuration, source and destination metadata.

Property Groups

Property synchronization stops.

Property values are still monitored; the group can be edited.

User Panels

Button presses do not trigger logic flows, hardware mappings send nothing, and panel changes do not reach the objects they control.

The panel still renders and shows state; it can be edited.

Timers

Timers, date/time and day-of-week events do not fire. Skipped events are logged.

Countdowns keep running; timers can be viewed and edited.

Logic Flows

Translators do not process input changes and combiners do not evaluate.

Inputs are still monitored; flows and folders can be viewed and edited.

Blocking and Unblocking

Open System > Configuration and click View next to Block Execution.

The Block Execution dialog lists each manager with its current state highlighted. Click Inherit, Block or Override to change it. The change takes effect immediately.

Click + next to a manager to show the components under it and set them individually. Here the OnAir logic flow folder is blocked while the rest of Logic Flows runs:

A blocked logic flow folder's name is shown in red in the Logic Flows Views tree.

To unblock, set the component back to Inherit.

From the API or a Logic Flow

BlockExecution is an ordinary property, so it can also be set over the SapV2 API (port 9600), from a scene, or as a logic flow End Point:

set Scenes#0 BlockExecution=Block
set Scenes#0.Scene#system_restore BlockExecution=OverrideBlock
set Scenes#0 BlockExecution=Inherit
get Scenes#0 BlockExecution

Over the API, the Override state is written OverrideBlock.

A logic flow cannot use the BlockExecution property of LogicFlows#0 or of a logic flow folder as its End Point. Logic Flows treats any End Point inside LogicFlows#0 as a link to another flow element. To block or unblock logic flows from a flow, put the change in a scene and have the flow trigger the scene.

To clear every block at once, set ClearExecutionBlockList on Clustering#0.ClusterSystem#0 to True. Every component that is set to Block or Override goes back to Inherit. This is the recommended way to end a maintenance window. The property is momentary and always reads False. If Logic Flows is blocked, a flow that sets it must be in a folder that is set to Override.

To see the current blocks, read ExecutionBlockList on the same object. It returns one line for each component that is set to Block or Override, in the form set <object path> BlockExecution=<state>. Do not set this property. Change blocks through each component's BlockExecution property.

set Clustering#0.ClusterSystem#0 ClearExecutionBlockList=True
get Clustering#0.ClusterSystem#0 ExecutionBlockList

Example: Maintenance Window with Exceptions

You need to freeze all automation for maintenance, but a maintenance panel and two maintenance scenes must keep working.

  1. Set the exceptions first. Set the maintenance panel and the two maintenance scenes to Override. Doing this before blocking their parents avoids a moment when they are blocked too.

  2. Block the managers. Set Scenes, Routers, Property Groups and User Panels to Block. Everything except the three exceptions stops.

  3. Do the maintenance. Blocked scenes, route changes and property syncs are skipped and logged. The maintenance tools work normally.

  4. Unblock in a controlled order. Set each manager back to Inherit one at a time, checking each before moving on: Property Groups first so synchronization is healthy, then Routers, then User Panels, then Scenes.

  5. Remove the overrides if you no longer need them, by setting them back to Inherit.

Other common uses:

  • Test a new scene without side effects: block Scenes#0 and set the new scene to Override. It runs, but any scenes it would trigger are blocked.

  • Edit many scenes at once: block Scenes#0 so no half-edited scene fires, then unblock when you are done.

  • Replace router hardware: block just that router so no route changes are sent to it during the swap. Other routers keep working.

Things to Know

Block Execution is not saved. After Pathfinder Core PRO restarts, everything returns to Inherit (unblocked). This is deliberate: a forgotten block that survived a restart could leave automation stopped. Re-apply any blocks you still need after a restart.

  • Nothing is queued. Operations that are blocked are skipped, not delayed. When you unblock, skipped scene triggers, route changes and timer events are not replayed.

  • Logic flows catch up when they are unblocked. When a blocked folder, panel or manager goes back to Inherit, each flow under it that had an End Point change held back is evaluated again from the current value of its input. The End Point is set to match the present state. Changes that came and went while the flow was blocked are not replayed.

  • A virtual router needs its underlying routers unblocked. A virtual router makes its routes through the routers its points come from. If one of those routers is blocked, that part of the route is refused, even when the virtual router itself is not blocked.

  • Configuration is not affected. You can still add, edit and delete scenes, flows and other components while they are blocked. When unblocked, they run with the new configuration.

  • Each cluster node has its own block state.

  • Block at the highest level that does the job. One block on Scenes#0 is easier to track, and to undo, than a hundred blocks on individual scenes.

  • Keep track of what you have blocked. Note it in your maintenance ticket or runbook, and plan when it will be unblocked.