To Next Page

To Previous Page

Appendix C: Clock Manager NetLinx Programming API

114

NetLinx Integrated Controllers (Firmware v4)- WebConsole & Programming Guide

NetLinx.axi - Library Calls (Cont.)

CLKMGR_GET_TIMESERVERS

(CLKMGR_TIMESERVER_STRUCT T[])

Populates the currently configured time server entries from the Clock Manager

into the specified TIMESERVER array. The function returns a negative SLONG

value if it encounters an error, otherwise the return value is set to the number

of records populated into the CLK-MGR_-TIMESERVER_STRUCT array.

CLKMGR_ADD_USERDEFINED_TIMESERVER

(CONSTANT CHAR IP[], CONSTANT CHAR URL[],

CONSTANT CHAR LOCATION[])

Adds a user-defined time server entry.

CLKMGR_DELETE_USERDEFINED_TIMESERVER

(CONSTANT CHAR IP[])

Deletes the user-defined entry that has its IP-ADDRESS matching the

parameter.

CLKMGR_GET_START_DAYLIGHTSAVINGS_RULE() Gets a string representation of when Daylight Savings is supposed to START.

The Fixed-Date rules have the form:

"fixed:DAY,MONTH,HH:MM:SS"

with all fields as numeric except for the word "fixed".

The Occurrence-Of-Day rules have the form:

"occurence:OCCURENCE,DAY-OF-WEEK,MONTH,HH:MM:SS"

with all fields as numeric except for the word "occurence".

• OCCURANCE range = 1-5

’5’ indicates the 'LAST' occurrence of a particular day of the month.

• DAY-OF-WEEK translates as:

1=Sunday

2=Monday

3=Tuesday

4=Wednsday

5=Thursday

6=Friday

7=Saturday

Examples:

"fixed:5,10,16:00:00" = October 5, at 4:00PM).

"occurence:5,1,10,02:00:00" = last Sunday in October, at 2:00AM).

CLKMGR_SET_START_DAYLIGHTSAVINGS_RULE

(CONSTANT CHAR RECORD[])

Sets the START Daylight Savings rule to the specified string which must be in

either the Fixed-Date format or the Occurence-Of-Day format. The function

returns a negative SLONG value if it encounters an error.