The XREF and RESETXREFS commands described in this section are intended for use during the upgrading of a project from one version of AVEVA E3D™ to the next. They operate on the data during its transfer from the source DB to the destination DB such that the data can be modified to conform to the requirements of a new DDL.

The commands are used to make sure that all cross-references are correctly set after a multi-DB reconfiguration. They are particularly useful in the case where two databases of the same type are referencing each other. They are also useful when copying between projects, as an alternative to the UPDATE command. When copying between DBs with the same DB number, it is best to use XREF and RESETXREFS.

XREF may be used to generate a list of the reference numbers of all elements which need updating for each DB. The list is created during the restructuring of the new DBs in Phase 2 of Pass 2.

This list is then used to monitor a partial updating operation, which makes sure that all references are reset into every element which has been affected by a DB reconfiguration. The partial update is controlled by the RESETXREFS command, which is related to the RCFUPDATE DB command. The RESETXREFS function applies only to elements whose reference numbers appear in the corresponding XREF file.

Here /REFFILE is the name of the file generated by the XREF command and MASTER/DESNEW is the corresponding DB to be updated.

In effect the RESETXREFS command opens the specified XREF file and the RESOLVE command part initiates the appropriate update. The macro files generated by the UPGRADE command in ADMIN makes sure that the RESET filenames are correctly matched to the corresponding RESOLVE dbnames.

When reconfiguring a whole project, it is impossible to order databases of the same type so that all references are resolved as the reconfiguration proceeds. The XREF and RESETXREFS commands are needed to tidy up the references.