Configuring Blueprint Execution Schedules

Blueprint execution rates are determined by the individual source blocks contained in a blueprint and their respective configuration options.

You can use the First execute configuration options available on most source blocks to configure the timestamp for the first execution of the blueprint.

By configuring the First execute options on a source block, you can specify exactly how the first execution timestamp for a blueprint is determined. This can be especially useful when deploying large quantities of Real-time Action Objects with similar execution rates. By specifying different first execute timestamps for the deployed blueprints, the load on the CPU can be spread evenly if done correctly.

You can configure the first execute properties for the following blocks:

Input Blocks

Available First Execute Properties

NOTE: These properties are only available if the source block is configured to execute in real-time mode.

Properties Supported Options Description

First execute

You can use this property to define how the first execute timestamp will be determined.

Default

Select this option if you want the first execute of the source block to be configured as the next multiple of the specified sampling period of the source block since 1601/1/1 00:00:00 UTC.

Start on the day

Select this option if you want the first execute of the source blocks to begin at the start of the day (00:00:00). You can set an offset in the hh:nn:ss format from the start of the day if required.

For example, if the offset is set to 13:00:00, the blocks will begin to execute at 1 PM. If the blueprint is started after 1 PM on that day, the first execute of the source blocks will begin at 1 PM the next day. If the offset is set to 0:00:00, then the first execute will begin at the start of the next day after the deployment of the blueprint (local time).
 

Start on the hour

Select this option if you want the first execute of the source blocks to begin at the start of the hour (local time). You can specify an offset in the nn:ss format from the start of the hour.

For example, if the offset is set to 15:00, the blocks will begin to execute on the 15th minute after the hour. If the blueprint was deployed at 1:30:00 PM of that day, the first execute of the source blocks will begin at 2:15:00 PM. If the blueprint was deployed at 1:10:00 PM, the first execute of the source blocks will begin at 1:15:00 PM. If the offset is set to 0:00, the first execute of the source blocks will begin one hour after the blueprint is deployed. (local time).

Start on the minute

Select this option if you want the first execute of the source blocks to begin on the start of the minute (local time). You can specify an offset in the ss format from the start of the minute.

For example, if the offset is set to 30, the blocks will begin to execute on the 30th second after the minute. If the blueprint was deployed at 1:20:45 PM that day, the first execute of the source block will begin at 1:21:30 PM. If the blueprint was deployed at 1:20:15 PM, the first execute of the source blocks will start at 1:20:30 PM. If the offset if set to 0,  then the first execute of the source blocks will start on the first minute after the deployment (local time).

Offset

If you chose Start on the day, Start on the hour, or Start on the minute, you can use this property to specify an offset from the timestamp.

NOTE: This property will be ignored if the First execute is set to Default. The format of the offset is determined by what the First execute was set to.

Supported formats

hh:nn:ss: When you select Start on the day, you can set the offset in the hour, minute, and second (hh:nn:ss) format.

nn:ss: When you select Start on the hour, you can set the offset in the minute, and second (nn:ss) format.

ss: When you select Start on the minute, you can set the offset in the second (ss) format.

NOTE:
The hour ('hh') can be in the range of 0 to 23.
The minute ('nn') can be in the range of 0 to 59.
The second ('ss') can be in the range of 0 to 59.

 


Related topics:

  

CSense 2023- Last updated: June 24,2025