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

Add RECORD Substructures

The ADD function allows you to define the base occurrence of a substructure. CA Datacom Datadictionary automatically relates the occurrence to the existing subject occurrence that you specify. You can define a RECORD occurrence by using one of the following procedures:

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

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

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

 TO  FILE     ________________________________ in STATUS ____
 TO  FIL      (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.

RECORD (name)

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

Valid Entries:

1- to 32-character name

Default Value:

(No default)

FILE (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 RECORD occurrence in the same status to use as the model for the occurrence you are adding. When you model a RECORD, you also model its FIELD, KEY, and ELEMENT occurrences.

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 RECORD definition panel appears.

 =>
 =>
 =>

 -------------------------------------------------------------------------------
 FILE Structure Maintenance                                                 ADD
                                                                           TURU
 ........................... RECORD ATTRIBUTES .................................
 Name:  PER-REC-HISTORY                   Status: T001    Type: ____


 .......................... KEY/ELEMENT ATTRIBUTES .............................
       Type
       K/E Name                             Pswd Lock
 ====== =  ====================== 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

Type

(Optional) Specify a user-defined code indicating the type of RECORD for multirecord files. For example, HDR, DETL, and TRL for Header, Detail, and Trailer.

Valid Entries:

1 to 4 characters

Default Value:

(No default)