Previous Topic: Update OccurrencesNext Topic: Add Alias


Update Aliases

You can define aliases for an occurrence to serve as alternate names for the occurrence. Some products, such as CA Dataquery, can use aliases instead of occurrence names when accessing information. You can also use aliases to give different departments in your company the option of referring to an occurrence in CA Datacom Datadictionary by a name other than the occurrence name. This gives these departments an alternate search path to follow to find the occurrence using a name with which they are familiar.

Using the online facility, you can specify up to 1300 aliases for each occurrence. (There is no limit using the batch facility.) An occurrence must be in TEST or PROD status when you add or delete the alias. Alias names must be unique within the entity-type.

Note: If an occurrence exists in multiple status/versions and an alias is added to one status/version, the alias does not apply to other existing status/versions of the occurrence until you explicitly add the alias. The alias is copied to a new status/version of an occurrence when you copy the occurrence.

The alias name can be 32 characters or less in length. The same rules for naming an occurrence apply to naming an alias. For more information about these rules, see the CA Datacom Datadictionary User Guide. The one exception is that the maximum length of the alias name is not affected when you assign a different attribute-value to the ENTY-NAME-LEN attribute of the TABLE entity-occurrence for the entity-type in the DATA-DICT database.

When you select the UPDATE ALIASES option, CA Datacom Datadictionary displays the following Selection Criteria Fill-in panel:

=> => => 1-DDOL000196A - CMPP - PLEASE COMPLETE REQUIRED INFORMATION FOR COMMAND ----------------------------------------------------------------------------- DDOL Entity Maintenance Selection Criteria Fill-in T01F ...................optional........................... UPDATE ALIAS : using _ _______________________________ : UPD ALI : using (A-alias) (alias name) : : (D-descr) (descriptor name) : : (P-path) (STANDARD) (S-Sqlname) : :....................................................: / ________________________________ , ________________________________ . (entity-type) (parent occurrence-name) ________________________________ ( ____ , , ) / (occurrence-name) (stat, pswd, ovrd) (vers, pswd, ovrd) PF1=HELP PF2=END PF3=CLARIFY PF4=PROCESS PF5=MENU PF6=STATUS PF7=SCB PF8=SCF PF9=APPLY PF10=PATH PF11=NEXT PF12=INPUT

Fill in your specifications on the Selection Criteria Fill-in panel according to the following descriptions. Use the optional criteria box with the DISPLAY function only.

(entity-type)

Specify the entity of the occurrence you are updating. You cannot use abbreviations in this field.

Valid Entries:

An existing entity-type

Default Value:

(No default)

(parent occurrence-name)

When the entity you are selecting is FIELD, KEY, or ELEMENT, you can enter the name of a TABLE or RECORD occurrence in this field to limit your selection to the occurrences contained in a single table or record.

You can enter ALL to select all occurrences or use a generic selection of one or more of the initial characters of the name with an asterisk (*) to select several occurrences. For example, PAY* processes all occurrences of this entity-type with PAY as the first three characters in the name.

When you leave this field blank, CA Datacom Datadictionary uses the occurrence that meets the other selection criteria you enter on this panel. For more information about how CA Datacom Datadictionary returns occurrences, see the CA Datacom Datadictionary User Guide.

Valid Entries:

1- to 32-character RECORD or TABLE occurrence name

Generic selection

ALL

Default Value:

The name of the first RECORD or TABLE occurrence that meets the other selection criteria

(occurrence-name)

Limit the selection to a specific occurrence by entering the name of the occurrence.

You can enter ALL to select all occurrences or use a generic selection of one or more of the initial characters of the name with an asterisk (*) to select several occurrences. For example, PAY* processes all occurrences of this entity-type with PAY as the first three characters in the name.

When you leave this field blank, CA Datacom Datadictionary returns the occurrence or occurrences that meet the other selection criteria you enter on this panel. For more information about how CA Datacom Datadictionary returns occurrences, see the CA Datacom Datadictionary User Guide.

Valid Entries:

1- to 32-character occurrence name

Generic selection

ALL

Default Value:

The name of the first occurrence that meets the other selection criteria

(stat, or vers,)

Specify the status or version of the occurrence you are updating. When you leave this field blank, CA Datacom Datadictionary uses the status/version from the list below of the occurrence that meets the other selection criteria you enter on this panel. For more information about how CA Datacom Datadictionary returns occurrences, see the CA Datacom Datadictionary User Guide.

Valid Entries:

TEST
T001—T999
PROD
001—999
ALL

Default Value:

The status/version of the first occurrence that meets the other selection criteria

pswd,

Supply the password for this occurrence if this occurrence has password protection against unauthorized maintenance.

Valid Entries:

1- to 4-character password

Default Value:

(No default)

(ovrd)

Supply the override code if this occurrence is restricted from unauthorized maintenance or retrieval with a lock level assignment.

Valid Entries:

1- to 4-character override code

Default Value:

(No default)

Alias Maintenance Panel

After completing your entries, press Enter. If there are no errors, CA Datacom Datadictionary displays the Alias Maintenance panel. The panel displays any aliases previously defined for this occurrence. If no aliases exist for this occurrence, you receive a panel similar to the following.

=> => => 1-DDOL000361I - 06IP - OCCURRENCE HAS NO ASSOCIATED ALIASES ----------------------------------------------------------------------------- DDOL: ANCHORED OCCURRENCE FOR ALIAS MAINTENANCE TYPE OCCURRENCE STA VER JOB SAMPLE-JOB T 001 -------------------------------------------------------------------------T06U ====== ============ T O P ============= 000001 ________________________________ ====== ========= B O T T O M ========== PF1=HELP PF2=END PF3=CLARIFY PF4=PROCESS PF5=MENU PF6=STATUS PF7=SCB PF8=SCF PF9=APPLY PF10=PATH PF11=NEXT PF12=INPUT