Echelon LNS - Manual (Page 114)

LNS Programmer's Guide 100
Tracking System Management Mode Changes
The system management mode is global and affects all clients that are accessing the
network. Because of this, you should consider registering your application for the
OnSystemMgmtModeChangeEvent. You can do so by invoking the
BeginSystemMgmtModeChangeEvent() method on the System object. Once your
application registers for this event, it will be fired each time the system management
mode changes. You should not change the system management mode after receiving this
event, as the client that changed the system management mode probably had a reason to
do so, but you can use the event to stay informed of system management mode changes.
Affects on Network Management Methods and Properties
The following methods and properties are also affected by the system management mode.
These tasks are described in more detail in Chapter 6, Network Management: Defining,
Commissioning and Connecting Devices.
• If you use the Commission() or Replace() methods to commission or replace
an AppDevice or Router object while the system management mode is set to
lcaMgmtModeDeferConfigUpdates, LNS will not validate the device’s
program interface or channel. However, if you use the ReplaceEx() method
with the lcaReplaceFlagPropagateUpdates option set, or the
CommissionEx() method with the lcaCommissionFlagPropagateUpdates
option set, LNS will perform these validation tasks, regardless of the system
management mode.
• Background pinging is disabled while the system management mode is set to
lcaMgmtModeDeferConfigUpdates. This is so LNS will not generate
misleading ping reports while the LNS database and the physical network are
not synchronized.
• Background update retries for operations that failed while the system
management mode was set to lcaMgmtModePropgageConfigUpdates are
disabled while the system management mode is set to
lcaMgmtModeDeferConfigUpdates. Normally, you can enable background
update retries by setting the System object's UpdateInterval property to a
positive value.
In addition, if you invoke the RetryUpdates() method while the system
management mode is set to lcaMgmtModeDeferConfigUpdates, only failed
updates that occurred while the system management mode was set to
lcaMgmtModeDeferConfigUpdates will be retried. Failed updates that
occurred while the system management mode was set to
lcaMgmtModePropagateConfigUpdates will not be retried, unless the system
management mode is still set to (or has been restored to) the
lcaMgmtModePropagateConfigUpdates value when you call
RetryUpdates().
• If you create a Router with the AddEx() method while the system management
mode is set to lcaMgmtModeDeferConfigUpdates, you cannot specify the
lcaRouterFlagSplit value as the flags element.
• You cannot call the Load() or LoadEx() methods on an AppDevice while the
system management mode is set to lcaMgmtModeDeferConfigUpdates.