Echelon OpenLNS - Manual (Page 560)

OpenLNS Programmer's Reference 523
it is not open, the LCA, #67 lcaErrSystemNotOpen
exception will be thrown.
You should consider using the
Validate method to repair your
network database a last resort. You should backup the
database with the Backup method before performing a
validation with repairs. For more information on this
procedure, see the Backup method. It is safer for the client
application to remove invalid objects from the database
(delete and recreate a device) than for the database
validation method to attempt to do so.
Depending on the size of the network database, it may take a
considerable amount of time to complete the database
validation. You can use the OnDbValidationEvent or the
ProgressUpdate method to check the status of an ongoing
database validation.
You can cancel a validation by invoking the
CancelValidation
method on the Network object. In this case, the method will
not return a DatabaseValidationReport object.
The database validation must be initiated locally. While the
database validation is in progress, clients will be unable to
modify or write to the database. As a result, you should
perform the database validation while a minimal number of
client applications are connected to the database. One
suggested approach is to backup the database and restore it
with a different name and location, and perform the
validation on this restored database. This approach will
minimize the disruption caused by the validation, and has
the benefit of producing in a backup whose validity is known.
Availability Local clients.
Syntax networkObject.Replace
Element Description
validationReport The DatabaseValidationReport
object returned by the method. This
object contains information
describing the results of the
database validation.
network The Network object to be acted
upon.
validationFlags Specifies whether inconsistencies
discovered during the database
validation will be repaired.
The valid options for this element,
which are contained in the
ConstDbValidationFlags constant,
are as follows:
0 lcaDbValidateOnly
OpenLNS performs the database