Preparetorecoverfromnetwork – Echelon OpenLNS User Manual

Page 901

Advertising
background image

OpenLNS Programmer's Reference

864

of the network interface is created.
The value of the DomainId

property cannot be changed if any

devices have been commissioned.

InstallOptions

lcaPrivateMedia

If this method is being invoked by a remote client, the

application program needs to manage several additional

properties. If the remote connection uses network

management authentication, you must set the

AuthenticationKey property before invoking this method. In

addition, this method will set the Ping class for this client to

Permanent. Anytime after the Open method is completed,

the application may change the Ping class if desired.
The presence of repeater and permanent bridge routers in

the network path between a remote Full client application

host and the Object Server make it impossible for the Object

Server to automatically determine the channel on which the

remote host resides. In this case, the Full client application

must explicitly set a channel by selecting the appropriate

channel from the Channels property of the Network object,

and then setting the RemoteChannel property to this channel

prior to opening the system.
This method cannot be invoked as part of an explicit

transaction.

Availability

Local, full, and lightweight clients.

Syntax

systemObject.

Open

Element

Description

systemObject

The System

object to be acted on.

Added to API

Prior to LNS Release 3.0.

PrepareToRecoverFromNetwork

Summary

Prepares the system for recovery of the OpenLNS database

from the physical network.

The

System

object uses two methods to support network

recovery: the

PrepareToRecoverFromNetwork

method sets up

for recovery and the

RecoverFromNetwork

method performs

the actual recovery. The

RecoveryStatus

property allows

users to view the state of recovery by returning a

RecoveryStatus

object with recovery information.

To recover from the network, follow these steps. Consult the

OpenLNS Programmer’s Guide for more detailed information:

1. Invoke the Add method of the Network object to create a

new Network.

2. Set the NetworkInterface object contained in the System

Advertising