1 creating an exception point – Echelon i.LON 100 e2 Internet Server User Manual

Page 174

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 element.
Table 57 describes the properties that must be defined within each element.

Table 57 Exception Point Properties

Property Description

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.

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.

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

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

property follows these tables.

Table 58 lists and describes the identifiers you can use to fill in the DAY_T field of the

property. The exception point will active on the days specified by
this property.
NOTE: If you use the

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.