2 creating a date based schedule – Echelon i.LON SmartServer 2.0 User Manual

Page 139

Advertising
background image

i.LON SmartServer 2.0 Programmer’s Reference

9-8

<Event>
<UCPTindex>2</UCPTindex>
<UCPTtime>10:00:00</UCPTtime>
<UCPTvalue

LonFormat="">0.0

0</UCPTvalue>

<UCPTvalue

LonFormat="UCPTvalueDef">0.0

0</UCPTvalue>

<UCPTtimeDirection

LonFormat="UCPTtimeDirection">TD_POSITIVE</UCPTtimeDirection>

<UCPTeventType

LonFormat="UCPTeventType">ET_NUL</UCPTeventType>

</Event>
<Weekdays>
<UCPTsunday>0</UCPTsunday>
<UCPTmonday>1</UCPTmonday>
<UCPTtuesday>1</UCPTtuesday>
<UCPTwednesday>1</UCPTwednesday>
<UCPTthursday>1</UCPTthursday>
<UCPTfriday>1</UCPTfriday>
<UCPTsaturday>0</UCPTsaturday>
</Weekdays>
</DayBased>

Property Description

<UCPTindex>

The index number of the day-based schedule.

<UCPTdescription> A user-defined description of the day-based schedule. This

description can be up to 227 characters long.

<UCPTpriority>

The priority assigned to the schedule, from 0 (highest priority) to
255 (lowest priority). The priority chosen here must be greater
than or equal to the current priority level assigned to a data point
when the Scheduler attempts to update that data point. If it is not,
the data point will not be updated successfully.

<Event>

The update events for each day-based schedule are signified by a
list of <Event> elements. Each update event will be used on the
days that this day-based schedule is active. See Creating Events
for more information. Note that each <Day Based> element has an
<Event> item that specifies a LOCK event to occur at midnight
(00:00).

<Weekdays>

The <Weekdays> element contains seven properties, one for each
day of the week. If you set the property for a day to 1, this
day-based schedule will be active on that day. Otherwise, it will
be inactive. For example, to create a day-based schedule that is
active on Monday and Tuesday, use the following <Weekdays>
element:

<Weekdays>
<UCPTsunday>0</UCPTsunday>
<UCPTmonday>1</UCPTmonday>
<UCPTtuesday>1</UCPTtuesday>
<UCPTwednesday>0</UCPTwednesday>
<UCPTthursday>0</UCPTthursday>
<UCPTfriday>0</UCPTfriday>
<UCPTsaturday>0</UCPTsaturday>
</Weekdays>

9.3.2.2 Creating a Date-Based Schedule

The following code demonstrates the structure of the <DateBased> element. This example includes
two <DateBased> elements that have different <Exception> properties. The first <DateBased>
element is a one-time exception that occurs on a specific date. The second <DateBased> element is an

Advertising