company logo

DBVersion - Object space version administration

The DBVersion utility provides a number of operations for maintaining database versions. This includes creating and removing versions as well as displaying defined managed versions.

The program may be called with a database path or an ini-file. The database must be accessible on the local machine or as file share. In case of encoded databases, the ini-file is required in order to provide the access key defined in the dictionary. The ini-file must contain a [DATABASE] section defining at least database and dictionary path. When using an external key file, the KEY_FILE option is required in addition.

The utility may be called locally or as client in a client/server application (object or replication server). Running a client/server application, all clients accessing the database will be terminated (killed) after waiting the defined wait time interval. New clients cannot be started until the utility has terminated.

DBVersion db_or_ini [oper] [-M:mode] [-V:version]

                    [-T:time] [-q] [-h] [-p:type]

Definition: 

db_or_ini - symbolic name or file path referring to the database or ini-file.

oper - operation to be performed (l[ist], m[ode], c[reate], r[eset], u[pdate]) default: list

  l: list defined major versions

  m: set/change versioning mode

  c: create new major version

  r: reset database entries for version set in -V

  u: update major version intervall

-M:mode -  set mode for new object space or database

  l: instance

  O: owner

  P: object space

  D: database

  S: synchronized

  M: managed

  Combinationd of M, S and MS with any of the 4 scope options are possible as well

-V:version - version number to be accessed (major version number for managed versioning modes)

-T:time - time stamp for version begin

-q -  do not write messages to system output

-h -  show help information

-p:type - define progress display type (automatic, dots, time, percent), e.g. -p:percent (reset, only)