Previous Topic: With Ordered RelationshipsNext Topic: Delete Occurrences


Copy Occurrences

You can create a new version of an occurrence using the COPY option. This option is valid only for non-Model occurrences. Use DBMAINT Mode or FILEMAINT Mode to create a new version of a CA Datacom/DB Model or a CA FILE Model occurrence.

=> => => 1-DDOL000196A - CMPP - PLEASE COMPLETE REQUIRED INFORMATION FOR COMMAND ------- DDOL Entity Maintenance Selection Criteria Fill-in T01F ...................optional............................ COPY : using _ ________________________________ : CPY : 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 the specification on a 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 copying. You cannot use abbreviations in this field.

Valid Entries:

An existing entity-type

Default Value:

(No default)

(parent occurrence-name)

Leave this field blank.

(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 following list 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)

Copy Occurrence Panel

When you press Enter, CA Datacom Datadictionary displays the Copy Occurrence panel. The Type, Name, Status, and Version fields contain information from on the Selection Criteria panel. Fill in the remaining fields according to the descriptions shown next.

=> => => ------------------------------------------------------------------------------- DDOL Entity-Occurrence Maintenance: T04U Copy Occurrence Panel (Create the next version of an existing entity-occurrence) Existing Occurrence Information: Type: JOB Name: SAMPLE-JOB Status: TEST Version: 002 New Occurrence Information: Text Option: ______ (CLASS, COPIED, NOTEXT or SHARED - default is SHARED) New Password: (default is password of copied occurrence) Issue 'APPLY' command or press PF9 key to make the copy. PF1=HELP PF2=END PF3=CLARIFY PF4=PROCESS PF5=MENU PF6=STATUS PF7=SCB PF8=SCF PF9=APPLY PF10=PATH PF11=NEXT PF12=INPUT

Text Option:

Specify the text option for the new occurrence.

Valid Entries:

CLASS

COPIED

NOTEXT

SHARED

Default Value:

SHARED

New Password:

This field allows you to enter a password for the new occurrence version. If you leave this field blank, CA Datacom Datadictionary assigns the same password (if one exists) to the new version of the occurrence.

Valid Entries:

1- to 4-character password

Default Value:

Password for the existing occurrence, if one exists

Text Copy Fill-in Panel

If you selected CLASS as the Text Option and the occurrence being copied has text, CA Datacom Datadictionary displays the Text Copy Fill-in panel. If you do not want to accept the default, this panel allows you to designate the text-class for the occurrence you are copying.

=> => => 1-DDOL000199I - 04UP - SUCCESSFUL OCCURRENCE COPY ------------------------------------------------------------------------------- Text Copy Criteria Fill-in T25F Source Occurrence job_____________________________ ________________________________ (entity-type) (parent occurrence-name) sample-job______________________ ( 0001, , ) (occurrence-name) (stat, pswd, ovrd) standard________________________ (vers, pswd, ovrd) (text-class) Target Occurrence job_____________________________ ________________________________ (entity-type) (parent occurrence-name) sample-job_____________________ ( 0002, , ) (occurrence-name) (stat, pswd, ovrd) standard________________________ (vers, pswd, ovrd) (text-class) PF1=HELP PF2=END PF3=CLARIFY PF4=PROCESS PF5=MENU PF6=STATUS PF7=SCB PF8=SCF PF9=APPLY PF10=PATH PF11=NEXT PF12=INPUT

(text-class)

Change or accept the text classification name of the occurrence you are copying. Use naming conventions established for CA Datacom Datadictionary. For more information, see the CA Datacom Datadictionary User Guide.

Valid Entries:

1- to 32-character text classification name

Default Value:

STANDARD or the currently defined default

After completing your entries, press PF9 (APPLY). If there are no errors, CA Datacom Datadictionary presents an Attribute Update panel for the occurrence with a message indicating the successful completion of this function. You can add, change or delete values for any of the displayed attributes for the new occurrence. For more information about how to obtain a list of the attributes, see Update Attribute-Values.