Echelon i.LON 100 e2 Internet Server - Manual (Page 174)

i. LON 100 Internet Server Programmer’s Reference 11-7
11.2.1.2.1 Creating an Exception Point
The exception points for an Event Calendar are defined by a series of <Exceptions> element.
Table 57 describes the properties that must be defined within each <Exceptions> element.
Table 57 Exception Point Properties
Property Description
<UCPTexceptionName> The name of the exception point. This can be a maximum of 27
characters long. You will use this to reference the exception point
from the Event Scheduler application.
<UCPTtemporary> Either 0 or 1. If 0, this exception will be repeated anually. If 1, this
will be a temporary exception. In this case, it will be removed from
the Event Calendar, and any Event Schedulers referencing the
exception, after the first time it is referenced.
<UCPTexceptionSchedule> This property defines the dates that the Event Calendar is active. It
uses the following format:
YYYY-MM-DD, YYYY-MM-DD, DAY_T, MONTH_T
The first date entered represents the date that the exception period
begins. The second date entered represents the date that the
exception period ends. You can set up a recurring event by setting
the year, month or date for these periods to 0.
The dates entered here must be within the effective period of the
Event Scheduler (as defined by the UCPTexceptionSchedule
property).
NOTE: If you use the i. LON 100 Configuration Software to modify
the configuration of an Event Calendar after creating it with the
SOAP/XML interface, any date entered that is before 1/1/1970 will be
reset to 1/1/1970. Any date entered that is after 12/31/2037 will be
reset to 12/31/2037.
DAY_T represents an identifier you can fill in to specify which days
of the month the exception will be valid during the interval. For
example, every third day, every fourth day, etc. Table 58 lists and
defines the identifers you can use for the DAY_T field.
MONTH_T represents an identifer you can fill in to specify which
months the exception will be valid during the interval. Table 59 lists
and defines the identifiers you can use for the MONTH_T field. A list
of example strings you could use to fill in the
<UCPTexceptionSchedule> property follows these tables.
Table 58 lists and describes the identifiers you can use to fill in the DAY_T field of the
<UCPTexceptionSchedule> property. The exception point will active on the days specified by
this property.
NOTE: If you use the
i. LON 100 Configuration Software to modify the configuration of an
Event Calendar after creating it with the SOAP/XML interface, the Configuration Software
will automatically reset the Event Calendar to use the DAY_LAST_SECOND_DAY
identifier.