PMDF System Manager's Guide
PMDF-REF-6.0


Previous | Contents

renamedb

Rename a PMDF database.

Syntax

pmdf renamedb old-database-spec new-database-spec

Command Qualifiers Defaults
None. None.

restrictions

On UNIX, must have superuser privileges in order to use this utility.

PARAMETERS

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.

DESCRIPTION

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. The pmdf 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 the pmdf renamedb utility. The pmdf 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.


EXAMPLES

# 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 (usually C:\pmdf\table\aliasdb).


Previous | Next | Contents