Copying Parts of Databases

Administrator Command Reference Manual

Reconfiguration : Advanced Reconfiguration : Copying Parts of Databases

The RCFCOPY ALL command copies all the elements in the source DB World into the destination DB World. If the World of the destination DB already contains members, then the elements from the source DB are added to these.

The RCFCOPY command can be used to define the root elements to be copied. A root element is any element owned by the World, that is:


BLTA	CASW	CATA	CCTA	CMPW	CONW	DEPT
GPWL	LIBY	MATW	RUNW	SITE	SPWL	UNIT	UWRL

When a root element is copied, all elements owned by it are also copied. A maximum of 300 root elements may be specified in a single copy list.

The selective commands RCFCOPY CATALOGUE and RCFCOPY SPECIFICATIONS cause the first root elements of type CATA and SPWL, respectively, to be copied from the list part of the World in the source DB.

To copy only part of a DB, one or more root elements must be specified (by name or reference number) in a RCFCOPY command. For example:

RCFCOPY /SITE-A SITE-7

Elements of any other types will be copied into the destination DB as NULL elements, that is they will be created as floating elements, not owned by any higher-level element. This does not mean that they are inaccessible. As long as such an element is named (or you know its new reference number) it can be incorporated as a member of any suitable parent element by using the INCLUDE command.

If you are not at a top level element, there must be an existing element in the destination DB into whose list part you wish to incorporate the element being copied. This is done using the INTO option of the RCFCOPY command. For example:

RCFCOPY /ZONE5A INTO /SITE-3

would copy the Zone /ZONE5A and make it the last member of the Site /SITE-3.

If the intended owning element does not already exist in the destination DB at the beginning of Pass 2, the listed root element will not be copied. For example:

RCFCOPY /SITE-3 /ZONE5A INTO /SITE-3

is not allowed.

INTO cannot be used when the destination is FILES rather then a DB. The word AND and the comma (,) may be used as separators to improve readability, thus:

RCFCOPY /SITE-5, /ZONE5A INTO /SITE-3, /SITE-6 AND /SITE-12

Several RCFCOPY commands can be given in sequence to add elements to the copy list. For example, the sequence

RCFCOPY /SITE-5
RCFCOPY /ZONE5A INTO /SITE-3
RCFCOPY /SITE-6, /SITE-12

is exactly equivalent to the RCFCOPY command in the previous example.

If an element is quoted in the copy list but does not exist in the source DB, an error message is output and the element is not copied. Since RCFCOPY commands are additive, a correcting command may be given on the next line. For example:

RCFCOPY /SITE1 /SITE2 /SITR3 /SITE4

(24,16) SITR3 not found (error message)

Since SITE1, SITE2 and SITE4 are already in the copy list, all that is needed to add SITE3 is:

RCFCOPY /SITE3

Note:

Partial reconfiguration of PADD DBs is only allowed for picture elements (i.e. SHEE, BACK, OVER, SYLB, LALB) and above.

Setting External References

In cases where you have made a partial copy of a database, sometimes it is necessary for you to make sure the external references are correct in the copied elements.

For example, if you moved a piping zone to a different database while maintaining the references to an equipment zone which was to remain it the original database, the copied piping zone could have unset external references and the equipment zone would remain connected to the original piping zone.

In these cases you can use the ALLCONnections option to set the external references for the reconfigured elements:

RCFCOPY /SITE1 INTO /SITE2 ALLCONNECTIONS

This will set all references including those within the original database not in the list of copied elements.

To update the references of the original database to point to the new copied elements use the RCFUPDATE INTERNAL command described in Updating References into a Reconfigured Database.