Defining a Screen Display Using MAPC › Instructions › Step 4: Create the map with the autopaint facility

Step 4: Create the map with the autopaint facility

You can create a map either manually or through the autopaint facility.

To create a map manually, you would name the records on the Associated Records screen and then place each literal and variable field explicitly on the map using the Layout screen. Then you would further define each variable field to associate a record element with that field.

For further information, see CA IDMS Mapping Facility Guide.

The autopaint facility quickly creates a standard map layout based on the records you have named on the Associated Records screen. The autopaint facility is useful for maps which require little or no explicit screen placement.

You will use the autopaint facility to create the XXXMAP for the Department application.

The first step in using the autopaint facility to create a map is to go to the Automatic Screen Painter screen to identify the fields you want to have displayed on the map. Here you determine what record elements will be displayed on the screen.

A record element is a data definition that is contained in a record.

For example, the DEPARTMENT record contains a record element for a department's name, DEPT-NAME-0410.

If the dialog retrieves a department record from the database, the record is temporarily stored in variable storage. The record name in variable storage is automatically displayed when the map is displayed. If the user enters a valid department name in this map field, the data is automatically moved into variable storage. It can then be saved in the database or used to access other data, depending on the dialog code.

To access the Automatic Screen Painter screen, press [PF9] from the Associated Records screen.

Sample Automatic Screen Painter Screen

                          Automatic Screen Painter           Page  1  of  3
 Map name:  XXXMAP    Version:     1
  Select (/)               Element Level and Name                       Occurs

       01 DEPARTMENT    VERSION 0001
   _    02 DEPT-ID-0410
   _    02 DEPT-NAME-0410
   _    02 DEPT-HEAD-ID-0410
       01 ADSO-APPLICATION-GLOBAL-RECORD    VERSION 0001
   _     03 AGR-APPLICATION-NAME
   _     03 AGR-CURRENT-FUNCTION
   _     03 AGR-NEXT-FUNCTION
   _     03 AGR-CURRENT-RESPONSE
   _     03 AGR-DEFAULT-RESPONSE
   _     03 AGR-TASK-CODE
   _     03 AGR-EXIT-DIALOG
   _     03 AGR-PRINT-DESTINATION
   _     03 AGR-DATE
   _     03 AGR-USER-ID

 DC365503 Select the fields that are to appear on the screen

 F1=Help  F3=Exit  F4=Prev  F5=Next  F7=Bkwd  F8=Fwd

Screen Prompts

On the Automatic Screen Painter screen, you can select the fields that will be used on the map. The fields will be listed under the appropriate record name. Use a nonblank character to select the fields you want displayed.

• Element level and name—Each element within a record listed on the Associated Records screen will be displayed. Each element is associated with its level number as defined in the dictionary.
• Occur—If the element is a repeating element, you can define the occurrence number in this column.

There can be multiple pages of elements. Press [PF8] to continue to the next page.

Fields on XXXMAP

The following table lists the records and fields to be displayed on XXXMAP.

Note:

The database does not have to be defined before you create the prototype map layout. If the database were not already defined, you would define all literal fields manually. (See num=C.Layout Of the DEPARTMENT Record)

Selecting Fields for Use with XXXMAP

                          Automatic Screen Painter           Page  1  of  3
 Map name:  XXXMAP    Version:     1
  Select (/)               Element Level and Name                       Occurs

       01 DEPARTMENT    VERSION 0001
   /    02 DEPT-ID-0410
   /    02 DEPT-NAME-0410
   /    02 DEPT-HEAD-ID-0410
       01 ADSO-APPLICATION-GLOBAL-RECORD    VERSION 0001
   _     03 AGR-APPLICATION-NAME
  /     03 AGR-CURRENT-FUNCTION
   _     03 AGR-NEXT-FUNCTION
   _     03 AGR-CURRENT-RESPONSE
   _     03 AGR-DEFAULT-RESPONSE
   _     03 AGR-TASK-CODE
   _     03 AGR-EXIT-DIALOG
   _     03 AGR-PRINT-DESTINATION
   _     03 AGR-DATE
   _     03 AGR-USER-ID

 DC365503 Select the fields that are to appear on the screen

 F1=Help  F3=Exit  F4=Prev  F5=Next  F7=Bkwd  F8=Fwd

After you have selected the names of the fields on the Automatic Screen Painter screen, press [PF5] to paint the map.

Note: You can press [Enter] first if you want the screen to be redisplayed to check your choices.

If there are multiple pages of elements, you would use [PF8] to move to subsequent screens for further selection.

The autopainted screen will be displayed on the Layout screen. Now you can modify the placement of the fields and request that some fields be further defined.