company logo

Synchronized owner scope versioning

In order to activate synchronized versioning, the DBVersion utility or Database::versioningMode() might be called.

In order to create a new version, a new version number can be assigned to the database by calling Database::createVersion(). Each version request will create a new consecutive version number on database level -the database version. Thus, version numbers represent a temporal order, since lower versions are older than higher versions.

In order to upgrade an owner scope to a version number between the current owner scope version and the last database version, the owner scope version can be upgraded by calling Property::updateVersion(). The function has to be called for a property handle with a selected instance (scope owner). The function must not be called for local property handles.

New versions for subordinated database entries are created automatically before updating database entries with version number older than the owner scope version.

// DBVersion Utility: set version mode

  DBVersion.exe c:\Sample\sample.dat mode -M:SI

// set version mode from within a program: Database dbh;

... fragment ( Database &dbh ) {

  dbh.versioningMode(synchronizedInstance);

}