Echelon LNS - Manual (Page 178)

LNS Programmer's Guide 164
Managing Network Service Devices
This section describes special tasks you may need to perform when managing the
Network Service Devices on your network. This includes the following:
• Upgrading a Network Service Device
• Moving a Network Service Device
Upgrading a Network Service Device
In some cases, it may necessary to upgrade a Network Service Device when you change
its network interface. Generally, LNS will perform this upgrade automatically, as soon as
the system is opened.
However, you can prevent LNS from automatically upgrading the Network Service
Device your client application is using by setting the Flags property to
lcaFlagsManualNsdUpgrade. By default, this flag is not set. When the flag is set, you
will need to manually perform the upgrade by calling the Upgrade() method on the
AppDevice object that represents your client’s Network Service Device. There are
several factors you will need to consider when doing so. For more information, see
Network Interfaces and Network Service Devices on page 273.
Moving a Network Service Device
Whenever a device is moved from one channel to another, it affects the configuration of
that device, and possibly the configuration of the devices that are connected to it. If a
Network Service Device that is being used by a Local client application is physically
moved from one channel to another, the LNS application must tell the LNS Object Server
that the Network Service Device is being moved. This is done using the PreMove() and
PostMove() methods. Moving the Network Service Device will typically assign the
Network Service Device a new address corresponding to a subnet on the new channel,
recalculate transaction timers and update connections accordingly.
The procedure to follow when moving a Network Service Device is the same as if you
were moving any other application device. However, unlike moving a normal application
device, LNS will not be able to verify that the Network Service Device is on the proper
channel after the move. To move a Network Service Device, perform the following steps.
This procedure can be performed by a Local client application, a Lightweight client
application, or a Full client application. However, you cannot perform this procedure
with a Full client application if it is using the Network Service Device being moved.
1. Invoke the StartTransaction() and BeginSession() methods to
start a session.
MySystem.StartTransaction()
MySystem.BeginSession()
2. Obtain the AppDevice object that represents the Network Service Device
to be moved. Use the MyVni property to do so.
Set NSDAppDevice = MyNetwork.MyVNI