Defining a Screen Display Using MAPC › Instructions › Step 5: Modify the map layout

Step 5: Modify the map layout

You use the Layout screen to modify the layout of fields on a map. There are two types of fields on the screen:

• Map literal fields display predefined literal strings at runtime.
• Map variable fields display stored values and allow users to store new values at runtime.

When you modify map XXXMAP in this chapter, you will:

• Add new literal fields
• Modify literal fields
• Change the placement of variable and literal fields

Accessing the Layout Screen

Once you have pressed [PF5] from the Automatic Screen Painter screen, the Layout screen is displayed to you with the automatically-created map presented. Fields at the bottom of the screen show key functions and a scale.

To reveal the hidden portion of the screen, press [PF8].

Sample Layout Screen with Additional Fields Displayed

    ;DEPT-ID-0410              ;____*

    ;DEPT-NAME-0410            ;_____________________________________________*

    ;DEPT-HEAD-ID-0410         ;_____________________________________________*

    ;AGR-CURRENT-FUNCTION      ;_____________________________________________*







;NEXT RESPONSE;________*
________________________________________________________________________________
 ...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8

 Enter  F1=Help  F2=Select  F3=Exit  F4=Prev  F5=Next  F6=Preview  F7=Top
 F9=SetCursor  F10=Deselect  F11=AltKeys

Note: Although you did not specify a response or message field, ADSA provided both. Since you associated the global record with this map, ADSA provided AGR-MAP-RESPONSE and AGR-MESSAGE as the response and message variable fields. If you had not associated the ADSO-APPLICATION- GLOBAL-RECORD with this map, ADSA would have provided $RESPONSE and $MESSAGE as the response and message variable fields.

Notice that the field mark for the message field is in column 80 so that the message will begin in column 1 of the following line.

Press [PF11] to reveal the alternate PF key set used for tailoring the screen.

Sample Layout Screen with Alternate Set of PF Keys Displayed

    ;DEPT-ID-0410          ;____*

    ;DEPT-NAME-0410        ;_____________________________________________*

    ;DEPT-HEAD-ID-0410     ;____*

    ;AGR-CURRENT-FUNCTION  ;________*






 ...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8

 F1=Help  F2=Mark  F3=Copy  F4=Move  F5=Delete  F6=Preview  F8=Bottom
 F9=SetCursor  F10=ClrMark  F11=MainKeys

When you first display the Layout screen for an existing map, each field on the map is preceded by a start-field character, as shown above. While using the Layout screen, you can select a field for editing by:

• Pressing [PF2] while on the field you want to select (with the main set of function keys displayed at the bottom of the screen)

  or

• Typing a select-field character (%) in place of the start-field character for the field.

You use the start-field and select-field characters based on the following guidelines:

• The start-field character (default is ; or {) defines the start of a field on the Layout screen.
• The select-field character (default is %) defines the start of a field and simultaneously selects the field for editing.

You use the Layout screen to modify the layout of map XXXMAP and to select fields on the map for further editing:

Selecting Multiple Fields to Edit

You can mark two fields with [PF2] to select either all literal fields or all data fields in the area bounded by the two fields you mark.

If the first field you marked with [PF2] was a literal field, all literal fields between the two marked fields are selected. If the first field you marked with [PF2] was a data field, all data fields between the two marked fields are selected.

Adding Literal Fields

You place each field on the Layout screen in the following manner:

1. Position the cursor by using any of the cursor movement keys.
2. Type a start-field character for each literal and variable field.

Note: In this document, the start-field character is shown as a ";". Do not confuse this with a semi-colon.

On the Layout screen, the start-field character signals the start of a field. For example:

Sample start-field
character.
│
▼
;sample literal field 
 ▲
 │
 The field itself starts in the column that
 immediately follows the start-field character.

At runtime, the start-field character is not shown to users with 3270-type terminals. Instead, each field is preceded by a nondisplayable attribute byte. The attribute byte specifies the runtime characteristics of the field, such as input restrictions and display intensity.

The default start-field character for the Layout screen is:

• For IBM-type terminals, the field mark character (;)

  Note: The field mark is not the same as the semicolon character. To type a field mark, you press the FIELD MARK key.

• For Siemens-type terminals, the left brace character ({)

  Note: The start-field character for the Layout screen is defined at system-generation time, and can vary from site to site.

• Type the literal string (for literal fields only) after the start-field character.

  Note: To add a variable field, you need only type the start-field character. (See num=11.Modifying a Map Using MAPC.)

Changing the Content of a Literal Field

To change the content of an existing literal field, type characters or spaces over the fields that you want to change.

Note: Use the ERASE EOF key only if you want to erase everything that can be seen on the Layout screen starting at the current cursor position.

Moving Fields, Lines, and Blocks

You can move fields or groups of fields:

• Moving one field—Move the cursor to the field you want to move and press [PF2] with the alternate set of function keys displayed at the bottom of the screen. This marks the field.
• Moving a line—Move the cursor to the starting position of the block you want to move and press [PF2] twice. This marks the line.
• Moving a block—Move the cursor to the starting position of the block you want to move and press [PF2]. Move the cursor to the ending point of the block and press [PF2] again. This marks a block.

Move the cursor to the desired target location for the field, line, or block, and press [PF4].

Deleting Fields, Lines, and Blocks

Mark the field, line, or block. Then press [PF5].

Copying Fields, Lines, and Blocks

Mark the field, line, or block. Then press [PF3].

When you copy literal or variable fields, the complete definition of the literal or variable field (including attributes, etc.) is copied. Copying a data field that occurs increments the subscript to the next available value.

Modifying the Map Layout for XXXMAP

For map XXXMAP, you selected four variable fields that are now shown on the Layout screen. These are associated with four literal fields. Each literal and variable field is shown with the field mark (;) used as the start-field character.

    ;DEPT-ID-0410          ;____*

    ;DEPT-NAME-0410        ;_____________________________________________*

    ;DEPT-HEAD-ID-0410     ;____*

    ;AGR-CURRENT-FUNCTION  ;________*






 ...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8

 F1=Help  F2=Mark  F3=Copy  F4=Move  F5=Delete  F6=Preview  F8=Bottom
 F9=SetCursor  F10=ClrMark  F11=MainKeys

You are going to modify this map so that it looks like the following layout:

     FUNCTION:   ________


                        DEPARTMENT INFORMATION




   ┌─  DEPARTMENT ID......:    ____*
   │
   │             NAME.....:    _____________________________________________*
   │
   └─            HEAD ID..:    ____*







  NEXT RESPONSE: _

Your modifications involve:

• Changing the AGR-CURRENT-FUNCTION literal field to FUNCTION
• Moving the FUNCTION literal and variable fields
• Adding a title
• Modifying the remaining literal fields

Modifying the FUNCTION Fields for XXXMAP

The AGR-CURRENT-FUNCTION fields (literal and variable) should be placed in the upper left corner of the screen and the literal changed to FUNCTION according to the sample screen.

To change the FUNCTION field:

1. Overtype the literal field (leaving the field mark) with the word FUNCTION
2. Mark the variable field
3. Move the variable field closer to the FUNCTION literal field
4. Mark the line containing the literal and variable fields
5. Move the line to the upper left corner

Add the Title

1. Place the cursor where you want the title to begin.
2. Type a field mark
3. Type the title, DEPARTMENT INFORMATION

Modify the Remaining Literal Fields

There are three literal fields relating to the DEPARTMENT record. Modify these fields so that they match the XXXMAP screen shown above.

1. Overtype the literal fields with the appropriate words
2. Mark each field that needs to be moved
3. Move the field

Remember that there is more room for screen layout hidden at the bottom of the screen. To see this hidden area, press [PF8].

The completed screen should look like the one below.

 ;FUNCTION:;

                         ;DEPARTMENT INFORMATION

 ;DEPARTMENT ID .......:;
            ;NAME .....:;
            ;HEAD ID ..:;







 ;NEXT RESPONSE: ;
                                                                                ;                                                                          

After you press [Enter], MAPC redisplays the Layout screen so that you can inspect the screen for errors. At this point, it is a good idea to verify that:

• You have preceded each literal field with a start-field character.
• You have defined each variable field with a start-field character, including the field that starts on the bottom right-hand margin of the screen and wraps around to the last line on the screen.

Correcting Errors

If you find any mistakes in the map layout, you can correct the Layout screen in either of the following ways:

• To change a few fields, type over the characters that you want to change and press [Enter] again.
• To erase all fields that you just placed on the screen, press the CLEAR key. If you press CLEAR, you must then place fields on the Layout screen again, as described earlier.

When you are satisfied with the Layout screen, press [PF11] to return to the main keys. You can now go on to Step 6, where you will select fields for further definition.