Replace – Echelon OpenLNS User Manual
Page 85
OpenLNS Programmer's Reference
48
If you accept an xDriver session with the doPostponeUpdates
field set to True, you should open the network involved in the
session, and enable all the monitor sets you want to use.
Then, call the ReleasePendingUpdates method on the
contained by the network’s MyVni
property. This will release the updates that were withheld.
For an example of this, see the example uplink application in
the OpenLDV Programmer’s Guide, xDriver Supplement.
Echelon recommends that you only use this method when
operating as an Independent client, as using this method in
server-dependent mode may disrupt network management
operations. If you are operating in server-dependent mode
and you invoke this method, an exception will be thrown.
However, the monitor point update events will be released.
These methods only apply to clients that are using the
OpenLDV xDriver to connect to remote network interface
(RNI) devices. For an overview of the xDriver, see Chapter
11, OpenLNS Network Interface Drivers, of the OpenLNS
Programmer’s Guide.
Availability
Local, full, lightweight, and independent clients. Note that
some collections are not available to Independent clients.
Syntax
appDevice.ReleasePendingUpdates
Element
Description
appDevice
Added to API
LNS Release 3.06.
Replace
Summary
Replaces one application device with another. This method is
typically used to effect repair operations.
This method lets you replace one application device with
another. The new device receives the same network address
and connections as the old device. To automatically load the
old device’s configuration properties into the new device, use
the ReplaceEx method. The ReplaceEx method performs the
same function as the Replace method; however, it provides
options you can use to determine how the configuration
property information on the old device will be managed
during the replacement.
The new device is specified by setting the NeuronId property
of the object to the NeuronId of the new device.
When the replace method is complete, a new application
device is placed in the soft offline state (lcaStateSoftOffline)
and a new router device is placed in the online state
(lcaCnfgOnline).
You should not use this method on the AppDevice property of
a NetworkServiceDevice because OpenLNS will perform NSD