Echelon OpenLNS - Manual (Page 83)

OpenLNS Programmer's Reference 46
element, and the new subnet as the newSubnetObject
element.
If this method is called while not attached to the network,
this message will throw an exception. Ignore it and call the
PostMove method to move a device while in engineered mode.
See the PostMove method for more information on the steps
required to move an application device.
Availability Local, full, and lightweight clients.
Syntax appDeviceObject.PreMove newChannelObject,
newSubnetObject
Element Description
appDeviceObject AppDevice to be moved from one
channel to another.
newChannelObject Destination channel for the device.
newSubnetObject
Destination subnet for the device.
Added to API Prior to LNS Release 3.0.
PropagateDeviceConfigUpdates
Summary Propagates any pending configuration changes to the
physical device associated with this AppDevice object.
The network management mode can be set to one of two
values: lcaMgmtModePropagateConfigUpdates (0), or
lcaMgmtModeDeferConfigUpdates (1). When it is set to
lcaMgmtModeDeferConfigUpdates (1), all network
configuration changes caused by your application will only be
applied to the OpenLNS database, and not to the physical
devices on the network.
Prior to LNS 3.20, these changes would be queued and then
applied to all the physical devices as soon as the network
management was set back to
lcaMgmtModePropagateConfigUpdates (0).
However, in LNS 3.20 and beyond, you can use this method
to apply device-only configuration changes to a physical
device without changing the network management mode
back to lcaMgmtModePropagateConfigUpdates (0). This
may be useful if you have configuration changes pending for
a large number of devices, and only want to apply them to a
subset of those devices. The device-only configuration
information propagated by this method includes
configuration property values and the device location string.
It does not include information such as network variable
configurations, address table entries and connection
information.
If you invoke this method and OpenLNS determines that it
cannot safely propagate the changes to the physical device,
the operation will fail, and the NS, #4039