Special considerations – Echelon LNS User Manual

Page 268

Advertising
background image

LNS Programmer's Guide

254

Table 10.1 lists the properties of the DatabaseValidationReport object. See the LNS
Object Server Reference
help file for more details on the DatabaseValidationReport

object and its properties.

Table 10.1 DatabaseValidationReport Object

Property Description

PassedValidation

This property will be set to True if the network passed

the database validation. This will occur if no errors

were discovered during the validation, or if all the
errors discovered during the validation were repaired.

This property will be set to False if the network

database has any problems that were not repaired

during the validation. In this case, you can use the
ErrorSummaries property to examine the problems

that were not repaired.

ErrorSummaries

This property contains the
DatabaseValidationErrorSummaries collection

returned by the database validation. This collection

contains a group of
DatabaseValidationErrorSummary objects, each of

which contains properties identifying and describing an

error that was encountered, and not repaired, during
the database validation. You can use this collection to

troubleshoot any problems that still exist in the

database after performing a validation.

RepairedErrors

This property contains the number of errors that were

successfully repaired by LNS during the database

validation.

UnrepairedErrors

This property contains the number of errors that were

not repaired by LNS during the database validation.

TotalObjectsValidated

This property contains the number of database objects

that LNS validated during the database validation

procedure.

Special Considerations

When validating a network database, there are several things you should consider.
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

event, or the ProgressUpdate() method of the ILcaProgressListener interface, 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 valid
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, Echelon

Advertising