Replace – Echelon OpenLNS User Manual

Page 85

Advertising
background image

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

AppDevice

object

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

The

AppDevice

object being acted upon.

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

Advertising