Adding a map

Procedure to add a map definition to the data dictionary

To add an existing map to a dialog, see "Using ADSC" earlier in this appendix.

Specific basic information about the map on the MAPC Main Menu:

• The map name
• The dictionary name/node (when applicable)

Names the associated database and work records on the Associated Records screen.

Autopaint the map by naming the map fields on the Automatic Screen Painter screen.

Optionally make additional specifications on other MAPC screens.

For more information on available MAPC screens and definition options, refer to CA IDMS Mapping Facility Guide.

Optionally modify the map layout using the Layout screen.

Create a map load module using the Compile4 activity from the action bar on the Main Menu.

For an example of using MAPC to add a map definition, see Chapter 9, "Defining a Screen Display Using MAPC".

Modifying a map

Procedure to modify an existing map.

This procedure cannot be used to modify a map name1.

To update a modified map definition in a dialog, recompile the dialog as described in "Using ADSC" earlier in this appendix.

Display the map definition by entering on a Main Menu screen:

• The map name
• the dictionary name/node (when applicable)

Optionally add and modify basic information about the map, including names of associated database and work records.

Optionally add, modify, and/or delete fields. You can add, modify, and delete fields at the same time:

• To add new fields, see "Adding new fields to a map" later in this table.
• To modify fields, see "Modifying existing fields on a map" later in this table.
• To delete fields, see "Deleting fields from a map" later in this table.

Optionally add, modify, and/or delete specifications on other MAPC screens.

For more information on available MAPC specifications, see CA IDMS Mapping Facility Guide.

Recompile the map load module: by specifying the Compile4 activity from the action bar on the Main Menu.

Note: If new copies of maps are not automatically loaded in the program pool at your site, return to CA IDMS/DC or DC/UCF and issue the following command before executing the modified map:

DCMT VARY PROGRAM modified-map-name

NEW COPY.

This command causes a new copy of the map to be loaded in the program pool.

For an example of using MAPC to modify a map, see Chapter 12, "Modifying a Map Using MAPC".

Deleting a map

Procedure to delete a map from the data dictionary.

To delete a map from a dialog, modify the dialog as described in "Using ADSC" earlier in this appendix.

Identify the map to be deleted on the Main Menu screen by entering:

• The map name
• the dictionary name/node (when applicable)

Choose the Delete action4 from the action bar

Confirm or rescind the action

The next time you modify a dialog associated with a deleted map, ADSC displays a message warning you that the map has been deleted. Users can continue to execute a deleted map until a new copy of the map is loaded in the program pool, provided that automatic load is not specified in the system generation OLM statement.

For an example of using MAPC, see Chapter 9, "Defining a Screen Display Using MAPC".

Adding new fields to a map

Procedure to add new fields to a map.

To move or modify fields, see "Modifying existing fields on a map" later in this table. To delete fields, see "Deleting fields from a map" later in this table.

Display the Layout screen from the Main Menu by entering 2 opposite the Screen prompt and pressing [Enter].

Define each new field on the Layout screen as described below:

• Move the cursor to the screen position that immediately precedes the starting position of the field.
• Type a start-field character2 to signal the start of the field. The field starts in the column immediately after the start-field character.
• For a literal field only, specify the value to be displayed at runtime by typing a literal string after the start-field character, as shown below for a field that displays the value DEPARTMENT INFORMATION:

     ;DEPARTMENT INFORMATION
  

Note: For a variable field, you will specify the value to be displayed at runtime in Step 3 later in this procedure.

• Optionally add additional new fields as described in Steps 1, 2, and 3 above.
• Press [Enter] to save the current map layout for further definition.

Select fields for further editing by positioning the cursor on the field and pressing [PF2] or by overtyping the start-field character with the field-select character (the default is a percent sign).3

Editing fields

Procedure to edit variable fields on a map.

Press [PF5] from the Layout screen to access the Literal or Field Definition screen.

Edit variable fields on the Field Definition screen as described below:

• Specify the value to be displayed by the field by naming a record element or system-supplied field ($RESPONSE, $MESSAGE, or $PAGE) after the Element prompt.
• Optionally override default specifications for the variable field:

For an example of adding fields to a map, see Chapter 9, "Defining a Screen Display Using MAPC".

Modifying existing fields on a map

Procedure to modify or move existing fields on a map.

Adding new fields to a map is presented in "Adding new fields to a map" earlier in this table.

To associate the modified map with any dialogs that use the map, you recompile the dialog load module. See "Using ADSC" earlier in this appendix.

Display the Layout screen from the Main Menu screen by entering 4 at the Screen prompt.

Use the alternate set of function keys to mark and move the fields

Select one or more fields to be modified by positioning the cursor on the field and pressing [PF2] or by overtyping the start-field character with a percent sign.

Modify each field definition selected as described below:

• Display the Field Definition or Literal Definition screen.
• Modify any specifications for the field.

Recompile the map load module if there are no more updates to be made to the map by selecting the Compile4 activity from the action bar on the Main Menu.

For an example of modifying fields on a map, see Chapter 12, "Modifying a Map Using MAPC".

Deleting fields from a map

Procedure to delete existing fields from a map

To associate the modified map with any dialogs that use the map, recompile the dialog load module. See "Using ADSC" earlier in this appendix.

Display the Layout screen by entering 4 at the Screen prompt on the Main Menu.

Make sure that insert-character mode is disabled by pressing the RESET key.

Select the fields to be deleted by positioning the cursor on the field or fields and pressing [PF2] or by overtyping the start-field character with the field-select character.

Press [PF5] to move to the Literal Definition or Field Definition screen.

Enter a nonblank character next to the Drop field prompt to delete the field.

Recompile the map load module (if there are no more updates to be made to the map) by selecting the Compile activity from the action bar on the Main Menu.