beautypg.com

5 exception examples – Echelon i.LON SmartServer 2.0 User Manual

Page 161

background image

i.LON SmartServer 2.0 Programmer’s Reference

10-11

Identifier Description

active.

MN_EVERY_11_MONTH

Every eleventh month during the interval the Calendar is
active.

MN_NUL

Value not available. If this is chosen, the Calendar will use
every month.

10.3.2.5 Exception Examples

The following section presents a series of examples that demonstrate how to create exceptions that use
wild cards and recursions.

Consider a case where you need to create an exception to apply to a specific range of dates, year after
year. You could set the property in both the and elements
to DW_WILDCARD. This applies the exception to all years, not just the ones specified by the
element. The other properties are set to DW_NUL, so the exception applies to the days
and months specified by the start and stop dates. As a result, the exception shown below applies to
April 5th through 7th, every year.

2008-04-05

DW_WILDCARD
DW_NUL
DW_NUL

2008-04-07
DW_WILDCARD
DW_NUL
DW_NUL

DM_NUL
MN_NUL

Consider a case where you need to create an exception to apply to the first ten days of every month,
year after year. You could do so by setting the and properties
to DW_WILDCARD, so the years and months specified in the start and stop dates are ignored. The
property is set to DW_NUL, so the days specified (1 through 10) are used. As a
result, the exception shown below applies to April 1

st

through April 10

th

, every year.


2008-04-01
DW_WILDCARD
DW_WILDCARD
DW_NUL

2008-04-10
DW_WILDCARD
DW_WILDCARD
DW_NUL

DM_NUL
MN_NUL

Now consider a case where you need to create an exception to apply to every weekday of every month,
year after year. You could do so by setting the , , and
to DW_WILDCARD, the property to
DM_EVERY_WEEKDAY, and the property to MN_NUL.


2008-04-01