Echelon OpenLNS - Manual (Page 735)

OpenLNS Programmer's Reference 698
OnDbConversionEvent
Summary Provides a client application the progress of an OpenLNS
database conversion .
When an OpenLNS database is opened using an application
written with a newer version of OpenLNS, the database will
be automatically upgraded to the new version of OpenLNS.
For example, if an application running on OpenLNS calls the
Open method to open a network using an LNS 3.20 database,
the database would be upgraded automatically.
If an application running on OpenLNS calls the
Add method
to create a network and specifies an existing LNS 4.0
database as the new network’s database, the LNS 3.20
database would also be upgraded automatically.
The OpenLNS database conversion is a three-step process
that upgrades the system database, the network database,
and the global database. This event is triggered once for each
stage of the conversion, and once when the conversion is
complete. After a database has been upgraded, it cannot be
opened with an older version of LNS (an application running
on LNS 3.20 cannot open an OpenLNS database).
Syntax OnDbConversionEvent(dbName As String, stage as
Integer)
Element Description
dbName The name of the OpenLNS database
being upgraded.
stage The stage of the database conversion.
The possible values for this element,
which are contained in the
ConstDbConversionStage constant,
are as follows:
0 lcaConversionDone
The conversion is complete.
1 lcaGlobalDb
The global network database is being
converted.
2 lcaNetworkDb
The network database is being
converted.
3 lcaSystemDb
The system database is being
converted.
Added to API LNS Release 3.0.