Catalog Copy

Use the Catalog Copy window to copy catalog items from read only databases to local write databases. The read only databases may be foreign databases or locally copied primary (MASTER) databases that you have no write access to.

The following restrictions should be observed:

• The system only allows items to be copied at the same level in the hierarchy within a copy sequence.

• The owning hierarchy must exist (or be created) in the database where the items are going to be copied to.

• Only members of top level items (for example: SPWL, CATA and so on) can be copied, as it is not possible to specify into which database an item is to be copied without actually having an existing item in the target database.

The Catalog Copy window is divided into the following frames:

The Copy From frame can be populated by right clicking in the Catalog Explorer frame to display a sub-menu, Add Elements to Copy From and Add Members to Copy From or by clicking either of the two top options to the right of the Catalog Explorer frame.

Or by clicking either of the two top options to the right of the Catalog Explorer frame.

Either option adds the current element or its members to the Copy From pane.

Once the Copy From pane has been populated, the right click functionality on the Catalog Explorer is only active if the Catalog Explorer item's owner is the same as the one in the pane. The options are also only active based on the current catalog explorer item and the Copy From pane owner type.

Items can be removed from the Copy From pane by using the right click functionality:

Or by clicking the two lower options to the left of the Copy From pane:

The Copy From pane can also be populated by using the Include References toggle and Update option. These are only active if any items in the grid are of type SCOM, SPRF or SFIT and will look for any references for example: GMRE, PTRE, NGMRE, DTRE, PSTR, GSTR and BLFARRAY.

Any items not already in the Copy From pane are added.

If the Include References toggle is not checked then the references are removed from the pane. The Update option allows any new items that have been added to the pane after the Include References toggle has been ticked to be added to the pane.

When the Copy From pane is populated the Copy To pane is also populated.

The Copy To pane is populated with the name the item is to be given when the Apply Copy option is applied. The green tick indicates that the name does not already exist in the target databases. Any items where the specified name does exist in the target databases will be highlighted with a red dot sphere and will not be copied. The target databases are defined by any database in the current MDB that can be written to.

The Copy To column now needs to be populated with the new location in the target databases.

Select an owning element in the Catalog Explorer frame to copy to, making it the currently selected item.

If the selected item in the Catalog Explorer frame is of the correct owner type and the database can be written to then a Set copy location from Explorer right click option is available in Copy To pane.

For example, if the element members that are to be copied are of type CATA then an owning element of type CATA in the destination database from the Catalog Explorer frame must be selected then select Set copy location from Explorer.

Note:
If the destination database does not have an owning element of the correct type then it must be created in the database hierarchy. For example in the case of a CATA refer to Create Catalog.

If an owning element of the correct type is already present when the Copy From grid is populated then the Copy To Location pane is also populated with any items in the target databases where the items in the Copy From pane can be created.

For example, in the following figure a number of SPRF items are copied which need to be created at an Structural Category (STCA) level. Therefore the pane is populated with all STCA elements in all databases that can be written to in the Multiple Database (MDB).

When an item is selected in the Copy to Location pane, the location of the selected items in the Copy To pane can be set by either right clicking on the Copy To Location pane.

Or by clicking the options located to the right of the pane.

Note:
Different elements can be created in different locations in the target databases.

Once the Copy To grid is populated and contains any items that have a name and copy location that both contain a green tick, Apply becomes active.

When Apply is clicked, all the items that can be copied (items with green ticks in both columns of the Copy To grid) are copied from the Copy From pane to the location in the Copy To pane with the applied name. All references that are included in the copy are reset to the newly created references in the target databases. The Catalog Copy window is then cleared ready for the next copy sequence.