Upgrading a Project

The XREF and RESETXREFS commands described in this section are intended for use during the upgrading of a Project from one version of the AVEVA base product to the next. They operate on the data during its transfer from the source Database (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 an MDB reconfiguration. They are particularly useful in the case where two DBs 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.

These commands are normally handled automatically by the upgrade macros supplied with a new version of the AVEVA base product. They may be used independently of the upgrade macros by the experienced user, preferably after consultation with AVEVA Solutions Limited, and it is for this reason that they are described here.

The XREF command 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.

For example:

RESETXREFS WITH /REFFILE RESOLVE DB MASTER/DESNEW

RESET /REF2 RESOL /NEWDB

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 AVEVA Administration makes sure that the RESET file names are correctly matched to the corresponding RESOLVE dbnames.

Note:
The XREF file only indicates those elements which need to be updated. The DUMP files are still required in order to match the old and new reference numbers correctly.

When reconfiguring a whole Project, it is impossible to order DBs 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.

Note:
The UPGRADE command is used when a Project is being upgraded from an earlier version of the AVEVA base product.

The following is an example of a sequence of commands:

A more general command sequence for a Project upgrade is shown in the following input and output macros.

Input macro:

Write  ’Upgrading Project CJB ’

Write ’From PDMS10 to PDMS11 ’

Write ’Input phase ’

$R6

Checkddl is 11

To db STANA/SAPROP

From files /REC1A /REC1B

Xref /REC1X

Reconfigure

To db DEREKF/DFPROP

From files /REC2A /REC2B

Xref /REC2X

Reconfigure

To db ALANC/ACPROP

From files /REC3A /REC3B

Xref /REC3X

Reconfigure

To db TAMH/THPROP

From files /REC4A /REC4B

Xref /REC4X

Reconfigure

To db TAMH/PROP_ATEST

From files /REC5A /REC5B

Xref /REC5X

Reconfigure

Reset with /REC1X

Resolve db STANA/SAPROP

Reset with /REC2X

Resolve db DEREKF/DFPROP

Reset with /REC3X

Resolve db ALANC/ACPROP

Reset with /REC4X

Resolve db TAMH/THPROP

Reset with /REC5X

Resolve db TAMH/PROP_ATEST

Finish

Output macro:

Write  ’Upgrading Project CJB ’

Write ’From PDMS10 to PDMS11 ’

Write ’Output phase ’

$R6

UPGRADE ON

From db STANA/SAPROP

To files  /REC1A /REC1B

rcfcopy all

Reconfigure

From db DEREKF/DFPROP

To files  /REC2A /REC2B

rcfcopy all

Reconfigure

From db ALANC/ACPROP

To files  /REC3A /REC3B

rcfcopy all

Reconfigure

From db TAMH/THPROP

To files  /REC4A /REC4B

rcfcopy all

Reconfigure

From db TAMH/PROP_ATEST

To files  /REC5A /REC5B

rcfcopy all

Reconfigure