company logo

DataSource :: systemVersion - SYSTEM_VERSION option

When the ODABA system version has been changed, i.e. when the internal ODABA schema has been expanded, one may run older ODABA versions of a dictionary by defining the old system version number. The version value must be set before opening the data source.

Usually, only the previous system version can be accessed this way in order to upgrade from the previous version to the next version.

Usually, this value is set in the configuration or ini-file in the SYSTEM_VERSION option for the data source definition.

Default: current system version

SYSTEM_VERSION=21

Return value:  Major version number ( int32  )

Major versions are defined on database level. database versions are numbered consecutively beginning with 0, when consistent versioning has been enabled.

Implementation overview

Implementation details

  1. Get system version set for data source
    int32 DataSource  :: systemVersion (  )

    The function returns the system version set for the data source, but not for the dictionary currently opened.

  2. to list
  3. Set system version
    int32 DataSource  :: systemVersion ( int32 iVersion )

    The function changes the value of the system version currently set in the data source, but not the system version for the database and dictionary handle currently opened.

    The value must be set before opening the data source. Setting the value afterwards, it will not have any effect until reopening the data source.

    • iVersion - Major version number

      Major versions are defined on database level. database versions are numbered consecutively beginning with 0, when consistent versioning has been enabled.

  4. to list