Rename a PMDF database.
pmdf renamedb old-database-spec new-database-spec
Command Qualifiers Defaults None. None.
On UNIX, must have superuser privileges in order to use this utility.
old-database-spec
The old name of the database.new-database-spec
The new name of the database; this may either be an actual pathname, or one of the special names such as PMDF_ALIAS_DATABASE, PMDF_REVERSE_DATABASE, PMDF_FORWARD_DATABASE, PMDF_GENERAL_DATABASE, PMDF_DOMAIN_DATABASE, PMDF_PIPE_DATABASE, or PMDF_X400_MTAID_DATABASE, listed in the PMDF tailor file (UNIX) or as a PMDF Tailor Registry entry (NT) and pointing to actual pathnames.
Since PMDF may optionally reference several "live" databases, that is, databases whose mere presence triggers their use by PMDF, it is important firstly to ensure that PMDF does not see such a database while it is in a mixed state, and secondly to minimize any period of time during which the database is inaccessible. Thepmdf crdb
utility locks the database it is creating to avoid having it accessed in a mixed state, and therefore it is usually recommended that PMDF databases be created or updated in a two-step process: first creating or updating a temporary database, and next renaming the temporary database with the "live" name using thepmdf renamedb
utility. Thepmdf renamedb
utility, which must delete any old database files and rename the new database files, locks the database during the renaming process to avoid presenting the database in a mixed state. In this way the database is never accessible while it is in a mixed state, and yet any window of time during which the database is inaccessible is minimized, as renaming will generally be quicker than database generation.
# pmdf renamedb tmpdb PMDF_ALIAS_DATABASE
This UNIX command will rename the database
tmpdb
to be the actual PMDF alias database (usually/pmdf/table/aliasdb
).
C:\> pmdf renamedb tmpdb PMDF_ALIAS_DATABASE
This NT command will rename the database
tmpdb
to be the actual PMDF alias database (usuallyC:\pmdf\table\aliasdb
).