Echelon i.LON SmartServer Technical Information Page 161

  • Download
  • Add to my manuals
  • Print
  • Page
    / 443
  • Table of contents
  • BOOKMARKS
  • Rated. / 5. Based on customer reviews
Page view 160
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 <UCPTyearMask> property in both the <StartDate> and <EndDate> elements
to DW_WILDCARD. This applies the exception to all years, not just the ones specified by the
<UCPTDate> 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.
<StartDate>
<UCPTdate>2008-04-05</UCPTdate>
<UCPTyearMask>DW_WILDCARD</UCPTyearMask>
<UCPTmonthMask>DW_NUL</UCPTmonthMask>
<UCPTdayMask>DW_NUL</UCPTdayMask>
</StartDate>
<EndDate>
<UCPTdate>2008-04-07</UCPTdate>
<UCPTyearMask>DW_WILDCARD</UCPTyearMask>
<UCPTmonthMask>DW_NUL</UCPTmonthMask>
<UCPTdayMask>DW_NUL</UCPTdayMask>
</EndDate>
<UCPTschedDay LonFormat="UCPTschedDay">DM_NUL</UCPTschedDay>
<UCPTschedMonth LonFormat="UCPTschedMonth">MN_NUL</UCPTschedMonth>
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 <UCPTyearMask> and <UCPTmonthMask> properties
to DW_WILDCARD, so the years and months specified in the start and stop dates are ignored. The
<UCPTdayMask> 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.
<StartDate>
<UCPTdate>2008-04-01</UCPTdate>
<UCPTyearMask>DW_WILDCARD</UCPTyearMask>
<UCPTmonthMask>DW_WILDCARD</UCPTmonthMask>
<UCPTdayMask>DW_NUL</UCPTdayMask>
</StartDate>
<EndDate>
<UCPTdate>2008-04-10</UCPTdate>
<UCPTyearMask>DW_WILDCARD</UCPTyearMask>
<UCPTmonthMask>DW_WILDCARD</UCPTmonthMask>
<UCPTdayMask>DW_NUL</UCPTdayMask>
</EndDate>
<UCPTschedDay LonFormat="UCPTschedDay">DM_NUL</UCPTschedDay>
<UCPTschedMonth LonFormat="UCPTschedMonth">MN_NUL</UCPTschedMonth>
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 <UCPTyearMask>, <UCPTmonthMask>, and
<UCPTschedDay> to DW_WILDCARD, the <UCPTschedDay> property to
DM_EVERY_WEEKDAY, and the <UCPTschedMonth> property to MN_NUL.
<StartDate>
<UCPTdate>2008-04-01</UCPTdate>
Page view 160
1 2 ... 156 157 158 159 160 161 162 163 164 165 166 ... 442 443

Comments to this Manuals

No comments