Updating References into a Reconfigured Database

Administrator Command Reference Manual

Reconfiguration : Advanced Reconfiguration : Updating References into a Reconfigured Database

While a DB is being reconfigured without the SAMEREF option, RECONFIGURER builds up an index of the reference numbers of all elements in the source DB versus their corresponding new reference numbers in the destination DB. The RCFUPDATE command uses this index to check reference pointers in other DBs and update them to point to the correct elements in the reconfigured DB. Examples of the use of this command are:


Examples:
RCFUPDATE DB MASTER/DESIGN Updates references to the reconfigured DB from DB MASTER/DESIGN.
RCFUPDATE DB MASTER/DESIGN INTERNAL Updates references in DB MASTER/DESIGN for any elements that have been copied with RCFCOPY ALL CONNECTIONS. Use this option with care because it is possible to update a reference that has already been changed by the RECONFIGURE command.
RCFUPDATE MDB /USERA Updates all references to the reconfigured DB from DBs in MDB /USERA.
RCFUPDATE TEAM USER Updates all references to the reconfigured DB from DBs owned by team USER.

Note:

The RCFUPDATE command must be given immediately following a RECONFIGURE operation.

As the RCFUPDATE command may cause a DB to be written to, you must have Read-Write access to all relevant DBs. The DBs must not be in active use by any other user of the project.

Care should be taken when reconfiguring to the same DB number. If you update a DB twice, the resulting reference numbers could be wrong. For example:


	Old reference	New reference
/VESS1	=123/456	=123/457
/VESS2	=123/457	=123/458

Thus, giving the RCFUPDATE command twice results in the reference =123/456 being reset to =123/458.

RECONFIGURER knows which types of DB can be pointed to by reference attributes in other types of DB, and so does not attempt to update DBs which could not possibly point to the latest reconfigured copy. A report is output which lists which DBs were and which were not updated.

The table of references is maintained across multiple reconfigurations, as long as you do not exit from ADMIN.