Background documentationdb_unreg Locate this document in the navigation structure


Use this command to delete the registration of the current database. The database files of this database are however retained on the database computer. This way, it is possible to revoke the deletion of the registration if necessary (see db_reg).

In Microsoft Windows, the relevant entry in the registry is deleted. In Unix, the file databases.ini in the directory <independent_data_path>/config is updated.

The db_unreg command can only be executed successfully if all DBM server connections to the specified database are closed, apart from that one you use to execute this DBM command.

As per the system default, the command for deleting the registry is only successful if all other commands, which are still being executed, are ended within 2 minutes. New commands are still accepted during that time, but are no longer executed. If one or more of those commands take longer than 2 minutes to be terminated, the system does not close the DBM server connections to the database, and the db_unreg command fails.

You can enter an option in the command to force the system to close the DBM server connection/s. Instead of waiting for running DBM commands to terminate, the system stops the DBM server/s immediately.


  • The database is in the OFFLINE operational state.

  • You have the server permission InstallMgm.

  • The scheduler is OFF (see scheduler_stop).


db_unreg [-f]





If you specify this option, all connections between the DBM server and the database are closed immediately, and the registration of the database is deleted.

The respective command line windows no longer function. As soon as you enter another DBM command in such a window, an error message is displayed.

If you do not specify the option -f and DBM commands are still being executed in the database, the command db_unreg fails.



In the event of errors, see Reply Format.