ENTMAINT Mode - Entity Maintenance › Update Occurrences › Update Name › Impact of Changing Names

Impact of Changing Names

When you change an occurrence name, the change applies only to the status/version of the occurrence you specify. If a program or facility outside CA Datacom Datadictionary references the original occurrence name, you must also change the name in that program or facility.

The name you specify with the UPDATE NAME option takes effect immediately. Therefore, when you use subsequent options or execute batch transactions, you must use the new name of the occurrence. For example, you must use the new name of a table or record when specifying fields, keys and elements in that TABLE or RECORD substructure.

Note: When you change the name of an occurrence in a CA Datacom/DB Model structure, you must CATALOG the database to update the CA Datacom/DB Directory (CXX).

The renamed occurrence retains aliases, descriptors, relationships, and text as follows:

• All descriptors and relationships for an occurrence are changed to reflect the new name.
• If an alias is a timestamp starting with $19, or if the alias is unique for only this occurrence regardless of version number, then it will also be changed to reflect the new name. If this occurrence has an alias that is shared by other versions of the same occurrence, then the alias will be deleted for this version. The reason is that an alias must be unique for an entity-type. If the alias for a version were to be updated for one version of an occurrence where the same alias is used for multiple versions of the same occurrence, then that alias would reference more than one occurrence name in the same entity-type.
• Text is treated differently because text can be shared from one version to another.
  • If there is text for an occurrence that is being renamed and the text is shared by other versions of that occurrence, that text is copied to the first occurrence that shares that text, all other versions that share that text will be modified to point at the new owned text. The original owned text is updated to the new name.
  • If the occurrence has text that is shared with another version that owns that text, the text is copied to the occurrence with the new name so that it owns a copy of the text.
  • If a field has no text except the text that comes from a UNIVERSAL field with the same original name, the UNIVERSAL text will be copied so that the field with the new name owns a copy of the text.