RADE

Source Code Manager

adl_ren_db

Renaming a database of current SCM site

Quick Reference

Abstract

The adl_ren_db command changes the name registered for a database of the current SCM site.

Synopsis
Usage
Options
Examples
References

Synopsis

adl_ren_db database_name new_database_name [-no_check_connect] [-h | -help | -?]

Usage

The adl_ren_db command is used to change the name of an existing database. To change other characteristics, see the adl_set_db [2] command. To learn how to register a new database, see the adl_mk_db [1] command.

The first parameter is the current name of the database (use the adl_ls_db command [3] to list existing databases).

The second parameter is the new name of this database.

If the current name is already obsolete, you can deactivate the default connection to it by using the -no_check_connect option. Note that the new name must correspond to a valid database because the command will check it.

[Top]

Options

adl_ren_db accepts the following options:

`-h\|-help\|-?`	Help of the command
`database_name`	Name of the database to rename
`new_database_name`	New name of the database
-no_check_connect	To prevent the command for connecting to the database using its old name

[Top]

Examples

Rename of a database named "SCMDB1" to "SCM_DB1":

adl_ren_db SCMDB1 SCM_DB1 -no_check_connect
Renaming the database "SCMDB1" to "SCM_DB1".
Command successful.

Trying to rename a database SCM3 to SCM4 but SCM4 does not reference the same database: this is forbidden by the command.

adl_ren_db adl3 adl4
#ERR# ADLCMD - B112: The new database named "adl4" and the database "ADL3" you want to rename are not the same.
Analyze your databases.

##### THE COMMAND ENTIRELY OR PARTIALLY FAILED #####

[Top]

References

[1] [2]	adl_mk_db: registering a new SCM database adl_set_db: changing the characteristics of a SCM database
[3]	adl_ls_db: list existing databases

[Top]

History

Version: 1 [Jan 2003]

Document created

[Top]