Background documentationdb_unreg Locate this document in the navigation structure

 

You delete the registration of the current database instance. The database files of this database instance 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, and in Unix the file databases.ini in the directory <independent_data_path>/config is updated.

This command can only be executed successfully if all DBM server connections to the specified database instance are closed, apart from the ones you use to execute this DBM command.

The system default value is that the command for deleting the registry is only successful if the commands that are still being executed are ended within 2 minutes. New commands are still accepted at this time, but are no longer executed. If this DBM command takes longer to execute, the system does not close the DBM server connections to the database instance, and the command for deleting the registration fails.

You can enter an option in the command to force the system to close the DBM server connection/s. Instead of waiting until current DBM commands have finished, the system stops the DBM server/s immediately.

Prerequisites

  • The database instance is in the OFFLINE operational state.

  • You have the server authorization InstallMgm.

  • The scheduler is switched off (see scheduler_stop).

Structure

db_unreg [-f]

Options

Option

Description

-f

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

The command line windows in question then no longer function. As soon as you enter another DBM command, an error message is displayed.

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

Result

OK

In the event of errors, see Reply Format.