Echelon OpenLNS - Manual (Page 808)

OpenLNS Programmer's Reference 771
move, this information is lost, and
the router will be put online.
Added to API Prior to LNS Release 3.0.
PostMove
Summary Completes the move of a router from one channel to another .
As part of the move, the router’s network address may
change; however, the router’s Handle property cannot
change.
To move a router from one channel to another, follow these
steps:
1. Invoke the BeginSession method to begin a session. This
will allow your application to avoid some failure
scenarios that may occur when routers are moved.
2. Invoke the PreMove method. The target channel is
validated and the router is deconfigured. However, the
router still appears in the database as residing on the
original channel.
3. Physically move the router from one channel to another.
4. If the router being moved uses authentication, the
PostMove method should be called in a different session
than the PreMove method. This means you should call
the EndSession method to end the session begun in step
1, and then call BeginSession to begin a new session.
5. Invoke the PostMove method. This method changes the
router’s channel assignment, does any necessary
rebinding, and updates the router’s configuration.
If you use explicit transactions during this procedure, make
sure that there are separate ones for the PreMove and
PostMove steps.
Availability Local, full, and lightweight clients.
Syntax object. PostMove
Element Description
object The Router object to be moved from one
channel to another.
Added to API Prior to LNS Release 3.0.
PreMove
Summary Prepares a router for movement from one channel (or subnet)
to another. When you call this method, you must specify the
new channels (newNearChannel and newFarChannel
elements).
If this method is called while not attached to the network,
this message will throw an exception. Ignore it and call the