FILEMAINT Mode - FILE Structure Maintenance › Add Structures › Add KEY Substructures

Add KEY Substructures

You can add substructures to an existing structure in TEST status by defining the base occurrence of the substructure. However, the ADD function applies only to the base occurrence of a substructure. Use the CREATE function to define the root occurrence of a structure. Adding a base occurrence implies that you are defining the occurrence and relating the occurrence to the appropriate subject occurrence.

You can define a KEY by using one of the following procedures:

• Select the ADD option on the KEY Structure Functions Menu, fill in the following prompter panel and complete the KEY definition panel.
• Use the ADD command for a KEY substructure (see ADD) and complete the resulting definition panel.
• Use the MOD margin command in the line number of a RECORD on an indented structure display to place the RECORD in the online work queue. When you retrieve the RECORD with PF4 (PROCESS), complete an entry for a KEY in the KEY section on the RECORD definition panel.

When you select the ADD option on the KEY Structure Functions panel, you receive the following prompter panel:

 =>
 =>
 =>
 1-DDOL000196A - CMPP - PLEASE COMPLETE REQUIRED INFORMATION FOR COMMAND
 -------------------------------------------------------------------------------
 FILE Structure Maintenance
                                                                            TACF
 ADD KEY      ________________________________
 ADD KEY      (name)

 TO  RECORD   ________________________________ in STATUS ____
 TO  REC      (name)                              STA   (status)

 with PASSWORD      using LOCK 0     LIKE ________________________________
      PSWD    (pswd)      LOC (lock) LIKE (name)







 PF1=HELP  PF2=END  PF3=CLARIFY  PF4=PROCESS  PF5=MENU   PF6=STATUS
 PF7=SCB   PF8=SCF  PF9=APPLY    PF10=PATH    PF11=NEXT  PF12=INPUT

The following list describes each field, the valid entries and the default (if one exists). Fields that require an entry are highlighted on your terminal. Fields which are not highlighted indicate that an entry is optional.

KEY (name)

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

Valid Entries:

1- to 32-character name

Default Value:

(No default)

RECORD (name)

(Required) Specify the name of the existing occurrence.

Valid Entries:

1- to 32-character name

Default Value:

(No default)

(status)

(Required) Specify the status of the existing occurrence.

Valid Entries:

T001—T999

Default Value:

(No default)

(pswd)

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

Valid Entries:

1 to 4 alphanumeric characters

Default Value:

(No default)

(lock)

(Optional) Specify a lock level to restrict access to this occurrence. For more information, see the section about protecting definitions in the CA Datacom Datadictionary User Guide.

Valid Entries:

0, 1, 2

Default Value:

0

LIKE (name)

(Optional) Specify the name of an existing KEY occurrence in the same status to use as the model for the occurrence you are adding.

Note: Any aliases or descriptors assigned to the existing occurrence are not duplicated for the new occurrence. Define these separately.

Valid Entries:

1- to 32-character name

Default Value:

(No default)

When you press Enter, the KEY definition panel appears.

 =>
 =>
 =>
 1-DDOL000407I - 09IP - KEY HAS NO RELATED FIELDS
 -------------------------------------------------------------------------------
 FILE Structure Maintenance                                                  ADD
                                                                            TUKU
 .............................. KEY ATTRIBUTES .................................
 Name  : EMP-NO                             Status/Version: T001    Type:
 Record: PER-REC-HISTORY


 ..............................FIELD ATTRIBUTES ................................
        Field Name                                         Order Data-Sen Length
                  Compiler-Name                  Assembler-Name
 ==== = =================== T O P ====== =================== = ===== = ==== ===
 0001   ________________________________                     _       _      ___
                  ______________________________ ________
 ==== = ================ 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