Defining Work Records Using IDD › Instructions › Adding Elements

Adding Elements

You defined element XXX-WK-FIRST-TIME in the data dictionary in Step 1: Define an Element earlier in this chapter. In this step, you will add element XXX-WK-FIRST-TIME to record XXX-WK-RECORD. Elements used in records are referred to as record elements.

You use the IDD Record Element screen to add elements to work records:

-> relm
                                                                [Enter]

RELM identifies the Record Element screen.

The Record Element screen is displayed.

      IDD REL 15.0                *** RECORD ELEMENT ***                   RELM
 ->                                             NO DATA LINES CURRENTLY EXIST
                        RECORD 'XXX-WK-RECORD' VERSION 1

 _ REMOVE       RECORD ELEMENT NAME.....:
 _ REPLACE      VERSION NUMBER..........:        _ HIGHEST   _ LOWEST
                LINE NUMBER.............:          LEVEL NUMBER..:

   REDEFINES...........:
   OCCURS..............:        TO          TIMES
   DEPENDING ON........:

   PICTURE.............:                                  _ NO SYNC   _ SYNC
   USAGE...............: _ DISPLAY   _ CONDITION NAME   _ BIT      _ POINTER
                         _ COMP      _ COMP-1           _ COMP-2   _ COMP-3
 VALUE(S):
                                      THRU
                                      THRU
                                      THRU
 _ EXCLUDE VALUES

   ELEMENT SYNONYM NAME.................:
   FOR RECORD SYNONYM...................:
       VERSION NUMBER...................:        _ HIGHEST   _ LOWEST

Screen Prompts

When you add an element to a record, you typically specify the following information:

• Element name— You must name an existing element after the RECORD ELEMENT NAME prompt.
• Additional specifications— You optionally can redefine how the element is used in the current record by using prompts on the Record Element screen. For example, you could override the PICTURE or USAGE specifications you gave to element XXX-WK-FIRST-TIME in Step 1: Define an Element earlier in this chapter.

  You most often override specifications for an element when the element is used in different ways by several work records. Specifications made on the Record Element screen do not alter the actual element definition in the data dictionary. For more information on Record Element screen specifications, see the CA IDMS IDD Quick Reference Guide.

  You will not change any values when you add element XXX-WK-FIRST-TIME to record XXX-WK-RECORD in this chapter.

You use the Record Element screen to type in the name of the element that you defined earlier in this chapter.

      IDD REL 15.0                *** RECORD ELEMENT ***                   RELM
 ->                                             NO DATA LINES CURRENTLY EXIST
                        RECORD 'XXX-WK-RECORD' VERSION 1

 _ REMOVE       RECORD ELEMENT NAME.....: xxx-wk-first-time

 _ REPLACE      VERSION NUMBER..........:        _ HIGHEST   _ LOWEST
                LINE NUMBER.............:          LEVEL NUMBER..:

   REDEFINES...........:
   OCCURS..............:        TO          TIMES
   DEPENDING ON........:

   PICTURE.............:                                  _ NO SYNC   _ SYNC
   USAGE...............: _ DISPLAY   _ CONDITION NAME   _ BIT      _ POINTER
                         _ COMP      _ COMP-1           _ COMP-2   _ COMP-3
 VALUE(S):
                                      THRU
                                      THRU
                                      THRU
 _ EXCLUDE VALUES

   ELEMENT SYNONYM NAME.................:
   FOR RECORD SYNONYM...................:

After you press [Enter], the Record Element screen displays a message to indicate whether the element has been added to the work record in the data dictionary:

• If the element is successfully added to the record, IDD displays a message like:

  RECORD 'XXX-WK-RECORD' VERSION 1 MODIFIED
  

• If the element cannot be added to the record, IDD displays a different message than the one shown above.

  In this case, read the message to determine the problem. You can type over any errors and press [Enter] again.

After you finish defining work elements and records, you can exit from IDD. In this sample session, exiting from IDD is optional because you will use the IDD menu facility again in the next chapter.

If you want to exit from IDD, enter the SWITCH SUSPEND command in the command area of any IDD menu facility screen:

-> switch suspend
                                                                [Enter]