Previous Topic: Using MAPCNext Topic: Layout Of the DEPARTMENT Record

Development Tools in the CA ADS Environment › Using the IDD Menu Facility

Using the IDD Menu Facility

As an application developer, you can use the IDD menu facility to define data (records and elements) and process modules in the data dictionary.

Alternatively, you can use online IDD to define data and process modules.

For information on how to use online IDD, see the CA IDMS IDD Quick Reference Guide.

The first screen in an IDD menu facility session is the Master Selection screen. A sample Master Selection screen is shown below:

                        CA                  CAGJF0
        IDD REL 15.0              *** MASTER SELECTION ***                   TOP
   ─►
┌─
│
│               DICTIONARY NAME...: DEMO         NODE NAME..:
│
│               USER NAME.........:
│               PASSWORD..........:
│
│               USAGE MODE........: X UPDATE    _ RETRIEVAL
│
│               PFKEY SIMULATION..: X OFF       _ ON
└─
┌─
│   _ ATTR  =  ATTRIBUTE     <PF2>              _ PROC  =  PROCESS        <PF3>
│   _ CLAS  =  CLASS         <PF4>              _ PROG  =  PROGRAM        <PF5>
│   _ ELEM  =  ELEMENT       <PF6>              _ RECD  =  RECORD         <PF7>
│   _ FILE  =  FILE          <PF8>              _ TABL  =  TABLE          <PF9>
│   _ MODU  =  MODULE        <PF10>             _ USER  =  USER           <PF11>
│   _ ENTL  =  USER DEFINED ENTITY LIST         _ SYST  =  SYSTEM
│   _ MSGS  =  MESSAGE
│   _ QFIL  =  QFILE                            _ OPTI  =  OPTIONS
│   _ DISP  =  DISPLAY ALL                      _ HELP  =  HELP           <PF1>
└─

To get from one IDD screen to another, you can enter the identifier for the next screen in the current screen's command area, select the screen identifier from the Activity Selection area, or press the control key associated with the screen. Identifiers and control keys for available screens are listed in the Activity Selection area of IDD menu facility screens.

The following table describes how to use the IDD menu facility to perform the following procedures:

For more information on using the IDD menu facility, refer to CA IDMS Common Facilities Guide.

For information on other operations you can perform by using IDD, refer to CA IDMS IDD Quick Reference Guide.

Instructions in table assume that you have already invoked IDD, as discussed earlier in this appendix.

Operation

Procedure

Adding an element

Procedure to add a new element to the data dictionary

To add an existing element to a work record, see "Adding a work record" later in this table.

Display the Element Entity screen by entering the identifier(elem) for the screen in the command area, as shown below1:

 

-─► elem

Define the element on the Element Entity screen:

  • Type an element name.
  • Select the ADD action and deselect (space over) DISPLAY.
  • Optionally type a description of the element.
  • Specify a picture; for example, PIC X(20).
  • Select a usage mode; for example, COMP-3 (default is DISPLAY).

For an example of using the IDD menu facility to define an element, see "Step 1: Define an element" in Chapter 14.

Modifying an element

Procedure to modify an element definition in the data dictionary.

To update the modified element in any records that contain the element, see "Modifying a work record" later in this table.

This procedure cannot be used to modify an element name2.

Display the element to be modified on the Element Entity screen by typing the identifier (ELEM) for the screen in the command area, followed by the name of the element, as shown below for an element named ELEMENT1:

 

─► elem element1

Modify the element:

  • Select the MODIFY action and deselect DISPLAY.
  • Modify any of the following specifications:
  • Description
  • Picture
  • Usage mode

For an example of using the Element Entity screen, see "Step 1: Define an element" in Chapter 14.

Deleting an element

Procedure to delete an element definition from the data dictionary.

This procedure cannot be used to delete an element that already belongs to a work record3.

Display the element to be deleted on the Element Entity screen bytyping the identifier (ELEM) for the screen in the command area, followed by the name of the element, as shown below for an element named ELEMENT1:

 

─► elem element1

Delete the element:

  • Select the DELETE action.
  • Deselect the DISPLAY action.

For an example of using the Element Entity screen, see "Step 1: Define an element" in Chapter 14.

Adding a work record

Procedure to add a work record to the data dictionary.

To add elements to the data dictionary, see "Adding an element" earlier in this table.

Display the Record Entity screen by entering the identifier(recd) for the screen in the command area:

 

─► recd

Define the work record on the Record Entity screen:

  • Type a record name.
  • Select the ADD action and deselect DISPLAY.
  • Optionally make additional specifications for the work record.

For more information on available record options and screens, refer to CA IDMS IDD Quick Reference Guide.

Associate existing elements with the work record by using the Record Element screen:

  • Display the Record Element screen from the Record Entity screen by entering the identifier (relm) for the screen in the command area:

 

─► relm
  • Associate an element with the work record:
  • Type the name of an existing element.
  • Optionally override any existing element specifications for:
  • Picture
  • Usage mode
  • Optionally make other specifications for the element.

For more information on available record options and screens, refer to CA IDMS IDD Quick Reference Guide.

  • Optionally associate another element with the work record as described in Step 3.2 above, after first pressing the page-forward key (default is [PF8]) to display a blank Record Element screen.

For an example of using the Element Entity screen, see "Step 2: Define a work record" in Chapter 14.

Modifying a work record -- continued on next two pages

Procedure to modify a work record in order to replace elements in the record or to modify specifications for record elements.

This procedure cannot be used to modify a work record name4.

Display the work record to be modified by typingthe identifier (RECD) for the Record Entity screen in the command area, followed by the name of the record, as shown below for a record named WK-RECORD1:

 

─► recd wk-record1

Optionally add, modify, or delete work record specifications.

For more information on record specifications and screens, refer to CA IDMS IDD Quick Reference Guide.

Optionally modify element specifications for the record:

  • To associate an element with the work record:
  • Display the Record Element screen by entering the identifier (relm) for the screen in the command area:

 

─► relm
  • Associate an element with the record:
  • type the name of an existing element5.
  • Optionally override any existing element specifications for:
  • Picture
  • Usage mode

Optionally make other specifications for the element.

For more information on record element specifications, refer to CA IDMS IDD Quick Reference Guide.

  • Optionally associate another element with the record as described in Step b above, after first pressing the page-forward key (default is [PF8]) to display a blank Record Element screen.
  • To replace an element in the record:
  • Display the record element specification in either of the following ways:

When the record contains a few record elements:

  • Display the Record Element screen by entering the identifier (relm) for the screen in the command area: 
─► relm
  • Page through record elements in the record (if necessary) to display the required record element. To do this, press the page-forward key (default is [PF8]).

Modifying a work record -- continued

When the record contains several record elements:

  • Display the Record Element List screen by entering the identifier(rell) for the screen in the command area: 
─► rell
  • From the displayed list of elements, select the record element to be replaced by entering a nonblank character in the SELECT column for the element.
  • Modify the record element specification:

Select the REPLACE action.

Note: The REPLACE action:

  • Deletes the element from the work record
  • Adds a new copy of the element to the record.

REPLACE does not modify the original element in the data dictionary.

Optionally type a new element name to replace the existing element with another.

Optionally override any existing element specifications for:

  • Picture
  • Usage mode

Optionally modify other specifications

For more information on available record element specifications, refer to CA IDMS IDD Quick Reference Guide.

  • Optionally select and modify another record element specification:

Return to the Record Element List screen by pressing CLEAR (after pressing [Enter] to make sure that all record element specifications are entered).

  • Select the record element to be modified by entering a nonblank character in the SELECT column for the element.
  • Modify the record element as described in Step b above.

Modifying a work record -- continued
  • To remove an element from the record:
    • Display the record element specification:

Display the Record Element List screen by entering the identifier (rell) for the screen in the command area:

─► rell

From the displayed list of elements, select the record element specification to be removed by entering a nonblank character in the SELECT column for the element.

  • Remove the element by selecting the REMOVE action.

Note: The REMOVE action deletes the record element specification from the record but not from the data dictionary.

For an example of using the IDD menu facility for records, see Chapter 15, "Defining Work Records Using IDD".

Deleting a work record

Procedure to delete a record from the data dictionary.

This procedure cannot be used to delete a work record used by a map or a dialog6.

This procedure does not delete record elements from the data dictionary7.

Display the work record to be deleted on the Record Entity screen by typing the identifier (RECD) for the screen in the command area, followed by the name of the record to be deleted, as shown below for a record named WK-RECORD1:

 

─► recd wk-record1

Delete the work record:

  • Select the DELETE action.
  • Deselect the DISPLAY action.

For an example of using the IDD menu facility for work records, see num=14.Defining Work Records Using IDD.

Adding a process module

Procedure to add a process module definition and source statements to the data dictionary.

To make an existing process module the premap or response process for a dialog, see "Using ADSG" earlier in this appendix.

Display the Process Entity screen by entering the identifier (proc) for the screen in the command area:

 

─► proc

Specify basic information about the process module on the Process Entity screen:

  • Type the process module name.
  • Select the ADD action and deselect DISPLAY.
  • Optionally type a description for the process module.

Display the Process Source screen from the Process Entity screen by entering srce in the command area:

 

─► srce

Enter process source statements for the module8.

  • Type one or more lines of process statements on a page of the Process Source screen.

Note: Do not extend process source statements beyond column 72.

  • Optionally enter additional pages of process source statements. For each new page:

Place the cursor on the line after which new source statements are to be inserted.

Press [PF4] (default) to open new lines after the cursor.

Enter lines of process statements on the new page.

Press [PF5] (default) to apply your changes to the work file maintained by the IDD menu facility.

Press [Enter] to add the process source statements to the process module in the data dictionary.

For an example of using the IDD menu facility to define a process module, see "Defining process modules using IDD" in Chapter 12.

A process module's source statements are compiled when the process module is added to a dialog. For information on adding process modules (as premap and response processes) to a dialog, see "Using ADSC" earlier in this appendix.

Modifying a process module

Procedure to modify a process module in the data dictionary.

This procedure does not update dialogs that use the process module9.

This procedure cannot be used to modify a process module name10.

Display the process module to be modified on the Process Entity screen by typing the identifier (PROC) for the screen in the command area, followed by the name of the process module, as shown below for a process module named PROCESS1:

 

─► proc process1

Modify process statements, as necessary:

  • Display process statements for the module on the Process Source screen by entering the identifier (srce) for the screen in the command area:

 

─► srce
  • Add, modify, and delete process statements. To insert one or more lines of statements:

Place the cursor on the line after which new source statements are to be inserted.

Press [PF4] (default) to open new lines after the cursor.

Enter lines of process statements on the new page.

Press [PF5] (default) to apply the new statements to the work file maintained by the IDD menu facility.

Note: Do not extend statements beyond column 72.

  • Optionally page through the Process Source screen:
  • Press [PF8] (default) to page forward.
  • Press [PF7] (default) to page backward.

Press [Enter] to modify the process module stored in the data dictionary.

For an example of modifying a process module, see Chapter 14, "Modifying Process Logic in a Dialog".

Copying a process module

Procedure to copy source statements from one process module to a new process module11.

Display the Process Entity screen by entering the identifier (proc) for the Process Entity screen in the command area:

 

─► proc

Specify basic information about the new process module on the Process Entity screen:

  • Type the name of the new process module.
  • Select the ADD action and deselect DISPLAY.
  • Optionally type a description for the new process.

Display the Copy screen by entering the identifier (copy) for the screen in the command area:

 

─► copy

Enter process module specifications:

  • Type the name of the original process module after the COPY FROM PROCESS NAME prompt.
  • Select the PROCESS TEXT action to copy the process commands in the original process module to the current process module.

Modify process statements if necessary, by using the Process Source screen as described in "Modifying a process module" earlier in this table.

For an example of using IDD for process modules, see Chapter 13 "Adding Process Logic to a Dialog".

Deleting a process module

Procedure to delete a process module from the data dictionary.

To delete a process module (premap or response process) from a dialog, see "Using ADSC" earlier in this appendix.

Display the process module to be deleted by typing the identifier (PROC) for the Process Entity screen in the command area, followed by the name of the process module, as shown below for a process module named PROCESS1:

 

─► proc process1

Delete the process module:

  • Select the DELETE action.
  • Deselect the DISPLAY action.

For an example of using IDD for process modules, see Chapter 13 "Adding Process Logic to a Dialog".

Notes:

1 You can also display any IDD menu facility screen by using either of the following methods:

2 To modify an element name:

3 To delete an element that belongs to a work record:

4 To modify a work record name:

5 If the element already belongs to the record, specifications on the Record Element screen modify previous specifications for the record element.

6 If the work record participates in maps and/or dialogs:

7 To delete elements from the data dictionary, see "Deleting an element" earlier in the table.

8 For information on specific process statements, refer to CA ADS Reference Guide.

9 To update dialogs that use the module, see "Modifying a premap process specification" or "Modifying a response process specification" as appropriate, in "Using ADSC" earlier in this appendix. At this point, the process module's source statements are compiled.

10 To modify a process module name:

11 You can also use one process module's source statements in another process module by using the INCLUDE command. The INCLUDE command names the process module whose source statements are included in the current process module at compile time.