Echelon OpenLNS - Manual (Page 810)

OpenLNS Programmer's Reference 773
the same explicit transaction as the invocation of this
method.
Availability Local, full, and lightweight clients.
Syntax object.Replace
Element Description
object The Router to be replaced.
Added to API Prior to LNS Release 3.0.
ReplaceEx
Summary Replaces one router with another. This method is typically
used to effect repair operations. The new router receives the
same network address and routing configuration as the old
router.
This method is similar to the Replace method except that it
provides additional options you can use. See the description
of the options element for more information.
See the
Replace method for more general information on
replacing routers.
Availability Local, full, and lightweight clients.
Syntax object.ReplaceEx flags
Element Description
object The Router object to be replaced.
flags The options which apply to this Replace
operation. The possible values for this
element, which are contained in the
ConstReplaceFlags constant, are as follows:
0 No options
Enter this value if do not want to use any
options.
8 lcaReplaceFlagPropagateUpdates
Propagates the network image contained in
the database to the new router, and
deconfigures the old router, even if the
network management mode is set to
lcaMgmtModeDeferConfigUpdates (1)
when you call the ReplaceEx method.
If any of these changes will cause network
inconsistencies, OpenLNS will defer the
updates, and the NS, #4039
lcaErrNsUpdatesDeferred exception will be
thrown. Those updates will not be
propagated until the network management
mode is set back to