Echelon OpenLNS User Manual

Page 81

Advertising
background image

OpenLNS Programmer's Reference

44

You first need to invoke it with the lcaMovePrePhysical

flag (analogous to the PreMove call), and then once the device

has been moved, you need to invoke it again with the

lcaMovePostPhysical flag.
You should invoke the BeginSession method to begin a

session before using the MoveEx method. This will allow your

application to avoid some failure scenarios that may occur

when devices or routers are moved.

Availability

Local, full, and lightweight clients.

Syntax

appDeviceObject.MoveEx newChannelObject,

newSubnetObject, flags

Element

Description

appDeviceObject

AppDevice

to be moved to a different

channel.

newChannelObject New destination channel for the device.
newSubnetObject

New destination subnet for the device.

flags

A Long value specifying the movement

flags.

Multiple options may be

specified by logically OR'ing individual

flag values. The flag values, which are

provided in the ConstMoveExFlags

constants, are as follows:
1 lcaMovePrePhysical

Specified when invoking MoveEx prior

to the physical move
2 lcaMovePostPhysical

Specified when invoking MoveEx

following the physical move.
8 lcaMoveOnline
Indicates that moved devices are to be

left online (default for routers).
16 lcaMoveOffline
Indicates that moved devices are to be

left offline (default for application

devices).
32 lcaMoveRestore
Indicates that moved devices will be

restored to their original online/offline

state. If a device is power cycled or

reset as part of the move, this

information is lost, and the device will

be put online.

Added to API

Prior to LNS Release 3.0.

Advertising