Echelon LNS User Manual

Page 78

LNS Programmer's Guide

management mode is set to lcaMgmtModePropagateConfigUpdates,

all device configuration changes are immediately propagated to the
network.

Note that the system management mode is global, and affects all clients

currently attached to the system. For more information on the system

management mode, see System Management Mode Considerations on
page 97.

MySystem.MgmtMode = lcaMgmtModePropagateConfigUpdates

2. DiscoveryInterval Property. If the shared media option was not

selected when the system was opened, set the discovery interval. The

discovery interval specifies the rate, in seconds, at which the LNS Object
Server will scan the network for unconfigured devices that have been

attached to the network. The default setting for this property is 180 if the
InstallOptions property is set to lcaPrivateMedia, and 0 if the
InstallOptions property is set to lcaSharedMedia. The setting may

have been changed by another LNS application if you are opening an
existing network.

Setting the interval to 0 disables discovery. You should set this property

to 0 unless the control network is expected to be highly dynamic, and

your LNS application is programmed to respond to the automatic

registration of new devices.

Because this property affects all current and future clients accessing this

network, Echelon recommends that you specify an appropriate discovery
interval only when you create the network and open the System for the

first time.

ActiveSystem.DiscoveryInterval = 600

3. UpdateInterval Property. This property determines how often the LNS

Object Server will try to complete operations such as device
commissioning that occurred as a result of a device update failure. A

device update failure occurs when a transaction has been completed and
committed to the LNS database, but LNS is unable to load the

information into the physical device due to some error. The default value

for this property is 120 seconds. Note that you can force the LNS Object
Server to complete such operations at any time by calling the
RetryUpdates() method on the System object. Setting this property to

0 disables automatic retries, and requires explicit calls to the
RetryUpdates() method.

MySystem.UpdateInterval = 240

Because this property affects all current and future clients accessing this

network, Echelon recommends that you specify an appropriate update
interval only when you create the network and open the System the first

time. It is recommended to set this property to 0 only when you require

explicit control of bandwidth usage in low-bandwidth networks.

Steps 1 through 3 list several key properties of the System object that you need to set

when initializing your application, but there are many others you should consider as you
program your application. You should also note that many properties of the System