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

11.2.1.3 EventCalendarSet
i. LON 100 Internet Server Programmer’s Reference
EventCalendarGet
0
0000-04-11,0000-04-12,MN_NUL,DY_NUL
You can use the EventCalendarSet function to create new Event Calendars, or to overwrite
the configuration of existing Event Calendars. The Event Calendars to be created or written
to are signified by a list of elements in the parameter. The properties
you must define within each element are the same, whether you are creating a
new Event Calendar or modifying an existing Event Calendar. The previous section,
, describes these properties.
NOTE: When modifying an existing Event Calendar, any optional properties left out of the
input string will be erased. Old values will not be carried over, so you must fill in every
property when writing to an Event Calendar, even if you are not changing all of the values.
You can create multiple Event Calendars per i. LON 100. However, the i. LON 100 can only
support one active Event Calendar at a time. The Event Calendar that is assigned index
number 0 will be the active Event Calendar.
When creating or modifying an Event Calendar with EventCalendarSet, it may be useful to
use output from the EventCalendarGet function as the basis for your parameter. You
would then only need to modify the values of each property to match the new configuration
you want, as opposed to re-creating an entire string like the one shown below, to generate
your input.
The EventCalendarSet function will generate the EventCalendar.XML file in the
/root/config/software directory of your i. LON 100, if the file does not already exist.
The following example call to the EventCalendarSet function creates an Event Calendar with
two recurring exception dates: 4/11 and 4/12.
Parameter
0
Floor
Calendar 1
Easter
Parameter
0
11-12