ObjectSpace :: setMajorVersion - Set current major version

The function may be called i n order to set the access version for the object space. Although major versions are defined on database level, different object spaces opened for a database may access the database for different major versions simultaneously. When opening an object space (or database), the major version valid for the current time point is activated. In order to access data for older major versions, required major version may be activated via version number or time stamp or implicitly via scope version number. Major versions with starting time in future (newer than "now") cannot be activated.

In contrast to setAccessVersion() for combined versioning modes the function sets the minor version to the maximum minor version number, i.e. to 0xFFFF for older major versions and to the last scope version for the current major version.

The function may be called for any kind of managed versioning mode. When being called for not managed versioning modes ( versioningMode() ) , the function throws an exception . In this case, one may call setAccessVersion() . Setting access version for managed... or managedSyncronized... versioning modes, the current scope access version is set to the highest version number for the selected major version, which is the last version number for the current major version and minor version 0xFFFF for any older version.

Activating another major version is possible while property handles are opened. Since the function may influence data selected in property handles, all property handles are stored and unselected before changing version ( Property ::top() ).