setUserFileVersions

The setUserFileVersions command sets the version number to the 32-bit unsigned integer value specified in the version argument of all user database map files or selected files specified in the optional [file-list] argument. This can be applied only to user data map files; that is, user schema files (for example, _userdev.dat, _userscm.dat, and so on) represented by the DbFile class Kind_User_Schema constant and user data files (for example, _rootdef.dat, locktest.dat, and _sindexdefs.dat) represented by the DbFile class Kind_User_Data constant.

This enables system administrators to optionally assign a version number to user data map files. The JADE database preserves these values (for example, for reorganization, database compaction, application deployment, and so on) but ignores them.

As the setUserFileVersions action is not audited, the version number is not propagated to SDS secondaries.

The current value of the version number is available programmatically by calling the DbFile class getUserPatchVersion method or from the jverinfo JADE Version Information utility. (For details, see Volume 1 of the JADE Encyclopaedia of Classes or "Obtaining the Version Number of User Database Files" under "Using the JADE Version Information Utility", in Chapter 2 of the JADE Installation and Configuration Guide.)

The syntax of the setUserFileVersions command in the jdbutilb command line is as follows.

jdbutilb path=database-path
         ini=initialization-file-name
         setUserFileVersions
         version=version-number
         [file-list]