Enhanced configuration property management, Online database validation and backup – Echelon LNS User Manual
Page 30
LNS Programmer's Guide
16
LNS Turbo Edition also includes a new option (lcaReplaceFlagPropagateUpdates)
for the ReplaceEx() method, which you can use to replace an AppDevice or Router. If
you call the Replace() method, or if you call the ReplaceEx() method without
specifying the lcaReplaceFlagPropagateUpdates option, on a device while the
system management mode is set to lcaMgmtModeDeferConfigUpdates, the physical
devices will not be updated with configuration changes caused by the replace process
until the system management mode is set back to
lcaMgmtModePropagateConfigUpdates. You can now use the ReplaceEx() method
with the lcaReplaceFlagPropagateUpdates option to replace devices while the
system management mode is still set to lcaMgmtModeDeferConfigUpdates. This may
be useful if there are configuration changes pending for a large number of devices, and
you want to replace a device without waiting for all of those changes to be applied. A
similar option is also provided for use with the new CommissionEx() method, which you
can use to re-commission a device while the system management mode is set to
lcaMgmtModeDeferConfigUpdates.
Finally the OnSystemMgmtModeChangeEvent event has been added to the
ObjectServer object. Once an application registers for this event, it will be fired each
time the system management mode changes.
For more information on the features described in this section, see Chapter 6, Defining,
Commissioning and Connecting Devices.
Enhanced Configuration Property Management
Several properties have been added to the ConfigProperty object that will allow your
application to better identify the source and configuration of a ConfigProperty object.
For example, in some cases the value stored in the LNS database for a configuration
property may not match the actual value of the configuration property in the physical
device on the network. To help you make this determination, the ValueStatus has been
added to the ConfigProperty object. The ValueStatus property indicates whether or
not the value currently stored in the LNS database for a configuration property matches
the value stored in the physical device on the network.
Two additional properties, the DeviceSpecificAttribute and ConstantAttribute
properties, have been added to the ConfigProperty object. These properties allow you
to read and write the device-specific and constant attributes of the configuration property
with your LNS application.
For more information on these configuration property attributes, see the Configuration
Property Flags section of version 3.3 of the LonMark Application-Layer Interoperability
Guidelines. For more information on configuration properties in this document, and for
information on how you might want to use configuration properties within an LNS
application, see Using Configuration Properties In a Monitor and Control Application on
page 233.
Online Database Validation and Backup
LNS Turbo Edition features two new ways to help you maintain your LNS network
databases: online backup and database validation. You can perform database validations
using the LNS Database Validation Tool, or by calling the Validate() method on a
Network object. When you perform a database validation, LNS will process the contents