Step 2: Name the map

Defining a Screen Display Using MAPC › Instructions › Step 2: Name the map

Step 2: Name the map

The first screen in an MAPC session is the Main Menu screen. A sample Main Menu is shown below:

Sample Main Menu Screen

Add Modify Compile Delete Display Switch _____________________________________________________________________________. CA IDMS/DC Online Map Compiler CA, Inc. Map name . . . . . . . . ________ Map version . . . . . . ____ Dictionary name . . . . ________ Dictionary node . . . . ________ Screen . . . . . . . . . _ 1. General options 2. Map-Level help text definition 3. Associated records 4. Layout 5. Field definition Copyright (C) 1999 CA, Inc. Command ===> Enter F1=Help F3=Exit F10=Action

Screen Prompts

When you begin a map definition, you typically enter information after one or more of the following Main Menu screen prompts:

Map name—You must supply a map name. The name you specify must be unique among all programs. (For example, it cannot be the same name as a dialog.)
Map version—You type the version number of the map after the Map version prompt. If not specified, the map version defaults to the version number specified as a dictionary option.
Dictionary name—You must specify the same dictionary (if any) as you specified for your application definition in Step 2: Name the Application. The correct dictionary name may already be displayed in this field.
Dictionary node—You must specify the same dictionary node (if any) as you specified for your application definition in Chapter 7. The correct dictionary node may already be displayed in this field.

You specify basic information about map XXXMAP on the Main Menu screen.

Defining the XXXMAP Map

You can use the tab key to move the cursor quickly and easily between prompts. Begin defining your application on the Application Definition screen as shown below:

Add Modify Compile Delete Display Switch _____________________________________________________________________________. CA IDMS/DC Online Map Compiler CA, Inc. Map name . . . . . . . . xxxmap Map version . . . . . . 1 Dictionary name . . . . demo Dictionary node . . . . ________ Screen . . . . . . . . . _ 1. General options 2. Map-Level help text definition 3. Associated records 4. Layout 5. Field definition Copyright (C) 1999 CA, Inc. Command ===> Enter F1=Help F3=Exit F10=Action

Adding the Map

To add the map, position the cursor on the Add item on the action bar and press [Enter]. You can position the cursor on Add by:

Tabbing to Add and pressing [Enter]
Pressing [PF10] to move to the action bar and then tabbing to Add and pressing [Enter]
Typing add on the command line and pressing [Enter]

Add Modify Compile Delete Display Switch ._____________________________________________________________________________. │ Copy from Map │ │ Name ________ │ CA IDMS/DC Online Map Compiler │ Version _____ │ │__________________ │CA, Inc. │ 1. All │ │ 2. Format │ │___________________│ │ F3=Exit │ │___________________│ XXXMAP__ Map version . . . . . . . 1 Dictionary name . . . . . DEMO____ Dictionary node . . . . . ________ Screen . . . . . . . . . _ 1. General options 2. Map-Level help text definition 3. Associated records 4. Layout 5. Field definition Copyright (C) 1999 CA, Inc. Command ===> Enter F1=Help F3=Exit F10=Action

Once you have displayed the Add action item, press [Enter] to add the map to the dictionary. After you press [Enter], the action is confirmed.

MAPC redisplays the Main Menu screen with a message:

Map XXXMAP version 1 has been added is returned when your definition contains no errors.
An error message is returned if MAPC detects any errors. Read the message to see what problem has occurred. You can type over any errors and then press [Enter] again.

After you provide basic information about the map, you can specify the records you want to use on the map.