ADD

In the DBMAINT and FILEMAINT Modes, use the ADD command to define an occurrence that is the base of a substructure. You can add substructures to an existing structure in TEST status. The ADD function applies only to the base occurrence of a substructure. When you add a base occurrence, you are also relating the occurrence to the indicated parent occurrence.

Use the LIKE option to model an existing substructure in the parent structure. Also, see the section about adding UNIVERSAL fields in the CA Datacom Datadictionary User Guide.

Use the following format for this command:

Note: If your completed command exceeds the 76 spaces available in one command line, use the prompter panel to issue the command.

ADD (in DBMAINT and FILEMAINT modes)

►►─ ADD ─ entity1 ─ occ-name1 ─ TO ─ entity2 ─ occ-name2 ─────────────────────►

 ►─┬─ STATUS xxxx ─┬─┬─────────────────┬─┬──────────┬─────────────────────────►
   └─ STA xxxx ────┘ ├─ PASSWORD xxxx ─┤ ├─ LOCK n ─┤
                     └─ PSWD xxxx ─────┘ └─ LOC n ──┘

 ►─┬────────────────────┬─────────────────────────────────────────────────────►◄
   └─ LIKE ─ occ-name3 ─┘

entity1: (Required) Specify the entity of the occurrence you are adding.
entity2: (Required) Specify the entity of the existing occurrence.

Valid Entries in DBMAINT Mode:

AREA|ARA: DATABASE|BAS
TABLE|TBL: AREA|ARA
KEY: TABLE|TBL
ELEMENT|ELM: TABLE|TBL

Valid Entries in FILEMAINT Mode:

RECORD|REC

FILE|FIL

KEY

RECORD|REC

ELEMENT|ELM

RECORD|REC

Default Value:

(No default)

occ-name1

(Required) Supply the name for the occurrence you are adding.

Valid Entries:: 1- to 32-character name
Default Value:: (No default)

occ-name2

(Required) Supply the name of the existing occurrence.

Valid Entries:: 1- to 32-character name
Default Value:: (No default)

STA xxxx

(Required) Supply the status of the existing occurrence.

Valid Entries:: T001—T999
Default Value:: (No default)

PSWD xxxx

(Optional) Specify a password to protect this occurrence from unauthorized updates. See the section about protecting definitions in the CA Datacom Datadictionary User Guide.

Valid Entries:: 1 to 4 alphanumeric characters
Default Value:: (No default)

LOC n

(Optional) Specify the lock level to restrict access to this occurrence. See the section about protecting definitions in the CA Datacom Datadictionary User Guide.

Valid Entries:: 0, 1, or 2
Default Value:: 0

LIKE occ-name3

(Optional) Supply the name of an existing occurrence in the same status to use as the model for this occurrence.

If the occurrence is related to a structure outside the CA Datacom/DB Model or the CA FILE Model, the relationship cannot be carried forward when you see this keyword. See the CA Datacom Datadictionary User Guide for information about adding and maintaining relationship definitions.

Valid Entries:: 1- to 32-character name
Default Value:: (No default)

When you press Enter, the Structure Maintenance Panel for the entity of the occurrence you are adding appears. See the samples of these panels and their attributes in the following chapters on the specific processing modes.