Echelon OpenLNS User Manual

Page 87

OpenLNS Programmer's Reference

Enter this value if do not want to use any

options.

1 lcaReplaceFlagCopy

Copies the values of all configuration

properties (CPs) from the old device to the

new device. If the old device has no CPs,

configuration network variables will be

copied, if present. Dynamic configuration

network variables will not be copied. This

flag may be ORed with

lcaReplaceFlagExcludeMfgOnly (2) and

lcaReplaceFlagUpload (4).
2 lcaReplaceFlagExcludeMfgOnly
Enables the new device to not inherit any

manufacturer configuration properties from

the old device. This flag must be ORed

with lcaReplaceFlagCopy (1).
4 lcaReplaceFlagUpload
Uploads all configuration properties in the

old device into the OpenLNS database

before the device is removed, and

subsequently downloads the CPs into the

new device. You can only use this option if

your application is still in communication

with the old device. This flag must be ORed

with lcaReplaceFlagCopy (1).
8 lcaReplaceFlagPropagateUpdates
Propagates the network image contained in

the database to the new device, and

deconfigures the old device, even if the

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

lcaMgmtModePropagateConfigUpdate

s (0).
If the network management mode is set to

lcaMgmtModePropagateConfigUpdate

s (0) when you call the ReplaceEx method,

the network image contained in the

database will be propagated to the new

device and the old device will be