Echelon LNS - Manual (Page 112)

LNS Programmer's Guide 98
addition, any changes that affect the configuration of devices that have not yet been
commissioned are deferred until those devices are commissioned.
Note that the system management mode cannot be set to
lcaMgmtModePropagateConfigUpdates while in engineered mode.
lcaMgmtModeDeferConfigUpdates
When the system management mode is set to lcaMgmtModeDeferConfigUpdates,
changes made to the database that affect the configuration of devices on the network are
not propagated to the devices until the system management mode is set back to
lcaMgmtModePropagateConfigUpdates. If you commission or replace a device with
the Commission() or Replace() methods while the system management mode is set to
lcaMgmtModeDeferConfigUpdates, LNS will not propagate updates to the device until
the management mode is set to lcaMgmtModePropagateConfigUpdates.
However, 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. For more
information on replacing devices, see Replacing Devices on page 132.
A similar option is also provided for use with the new CommissionEx() method, which
you can use to recommission a device while the system management mode is set to
lcaMgmtModeDeferConfigUpdates. For more information on commissioning devices,
see Commissioning Devices on page 121.
When you open a network in engineered mode, it automatically sets the system
management mode to lcaMgmtModeDeferConfigUpdates. When you re-open that
network later, and are attached to the network, the System object’s MgmtMode property
will not be automatically reset. The application must explicitly set the system
management mode back to lcaMgmtModePropogateConfigUpdates.
It is possible to communicate with devices while the system management mode is set to
lcaMgmtModeDeferConfigUpdates, as long as the network was not opened in
engineered mode. However, some operations may not behave correctly in this case,
because a device’s configuration may not be synchronized with the LNS database. When
set to lcaMgmtModeDeferConfigUpdates, the system management mode also effects
certain operations explicitly. For more information on this, see Affects on Network
Management Methods and Properties on page 100.
Devices that have pending updates will have a commission status of pending (or failed, if
the last update attempt failed) when the system management mode is set to
lcaMgmtModeDeferConfigUpdates. A network service warning in the range 4030-
4089 (lcaErrNsWarningFirst- lcaErrNsWarningLast) will be returned to indicate
this, but the warning will not indicate which devices have not been updated. You can
check a device’s commission status by reading its CommissionStatus property.
Intended Usage of the System Management Mode
The system management mode should generally be set to
lcaMgmtModePropagateConfigUpdates, except when defining a network in