Echelon OpenLNS - Manual (Page 86)

OpenLNS Programmer's Reference 49
replacements automatically in most cases. For information on
when you might need to manually replace a Network Service
Device and how to accomplish this, see the PreReplace
method.
Note: Do not read or write the State property of the device in
the same explicit transaction as the invocation of this
method.
Availability Local, full, and lightweight clients.
Syntax object.Replace
Element Description
object The application device to be replaced.
Added to API Prior to LNS Release 3.0.
ReplaceEx
Summary Replaces one application device with another. This method is
typically used to effect repair operations.
This method is similar to the Replace method except that it
provides additional options you can use to determine (1) how
the configuration property information on the old device will
be managed during the replacement, and (2) whether to
propagate network configuration changes caused by the
replacement if the network management mode ( MgmtMode
property) is set to lcaMgmtModeDeferConfigUpdates.
See the description of the options element for more
information.
See the
Replace method for more general information on
replacing application devices.
Availability Local, full, and lightweight clients.
Syntax object.ReplaceEx flags
Element Description
object The AppDevice object to be replaced.
flags The options which apply to this Replace
operation. This determines which
configuration property values will be
passed from the old device to the new
device, and whether changes caused by the
replacement should be propagated if the
network management mode ( MgmtMode
property) is set to
lcaMgmtModeDeferConfigUpdates.
The possible values for this element, which
are contained in the ConstReplaceFlags
constant, are as follows:
0 No options