Programming i!-Schedule
16
i!-Schedule
i!-ScheduleEngineMod Module Parameters (Cont.)
strTmTzDstRules
A string containing 1 or more daylight saving rule strings. Multiple daylight saving rules are
separated with the "$FF" character. Two standard rule strings, 'None' and 'US' will disable
daylight savings time (default) and enable US daylight savings rules respectively. For other
locations, daylight saving rule strings should be in the following format:
Custom string: "Month" "Day Description" "Time" "Offset From Std" "Description"
"Month": Month name ex: "Apr"
"Time" Time to activate (hh:mm:ss, 24 hour). ex: "02:00:00"
"Offset From Std" Time to offset from GMT (hh:mm:ss, 24 hour). ex: "01:00:00"
"Description" String to replace "%s" with in Time zone description. ex: 'D'
"Day Description" Day Description. Fixed Date, Last Day Of Week or
First Day of Week Before/After Date
Fixed ex: "15"
Last Day of Week ex: "LastSunday"
First Day of Week Before DATE-ex: "Sun<=24"
First Day of Week After DATE-ex: "Sun>=1"
Time zone examples:
Here is an example configuration for Santiago, Chile which observes Daylight savings
starting on the first Sunday on or after October 9th at midnight (jump ahead 1 hour) and the
First Sunday on or after the 9th of March at midnight (jump back 1 hour):
strTmTzDstRules = "'Oct Sun>=9 00:00:00 01:00:00 D',$FF,'Mar Sun>=9 00:00:00 00:00:00 S'"
Here is an example configuration for Sydney, Australia which observes Daylight savings
starting on the Last Sunday in October 2:00 AM (jump ahead 1 hour) and the Last Sunday
in March at 3:00 AM (jump back 1 hour):
strTmTzDstRules = "'Oct LastSun 02:00:00 01:00:00 X',$FF,'Mar LastSun 03:00:00 00:00:00 X'"
Here is the example configuration for London, England which uses GMT and observes
Daylight savings starting on the last Sunday in March at 1:00 AM (jump ahead 1 hour) and
the Last Sunday in October at 1:00 AM (jump back 1 hour):
strTmTzDstRules = "'Mar LastSun 01:00:00 01:00:00 BST',$FF,'Oct LastSun 01:00:00 00:00:00 GMT'"
strTmLocName
A string describing the location the system is installed in. This could be any string
describing the region or city.
dTmLocLong
and
dTmLocLat
A double containing the longitude and latitude coordinates of the location where the system
is installed. Longitude is in Degrees (Fraction of Degrees). West longitudes must be
negative. Latitude is in Degrees (Fraction of Degrees). South latitudes must be negative.
These parameters are used for calculating sunrise and sunset times. You can find
longitude / latitude values and descriptions at:
• http://geography.about.com/cs/latitudelongitude/
• http://www.census.gov/cgi-bin/gazetteer
• http://www.njdxa.org/landl-lookup-dx.shtml
nTmTsProtocol
A Timeserver protocol number to allow the NetLinx system to synchronous its clock with an
Internet timeserver. The available values are:
• 0 = Disabled
• 1 = DayTime(13/udp, 13/tcp)
• 2 = Time(37/udp, 37/tcp)
• 3 = SNTP(123/udp)
• 4 = SNTP Broadcast (123/udp).
nTmTsCheck_Time
The time in minutes between time checked to the Internet timeserver. You can put 0 to use
the default value of 120 (or 2 hours).
strTmTsServer
The IP address or Host Name of the preferred Internet timeserver. If left blank (empty
string), a default server is picked from the nist_svr.lst file location in the doc:\time directory
of the NetLinx Master. If this file is not present, an internal list of NIST time servers are used
and an appropriate server is selected from the list.
