Introduction to the Mapping Facility › The Online Compiler › A Sample Session

A Sample Session

The following figures illustrate an abbreviated online mapping compiler session. The primary screens used during an online session are shown in this sample session. The names and major functions of each screen are listed:

• The Main Menu, which is used to specify basic information about the map, is the first screen in a session. The developer supplies the name and version number of the map and the name and node of the dictionary to be used.

  From this screen, the developer can:

  • Either move to other screens to define more specific information about the map such as general options, help text, the layout of the map, field descriptions, or associated records
  • Or, select an action to perform on the specified map from the action bar at the top of the screen

  For the purposes of this sample session, we will move through the screens to create and define a map.

• The General Options screens are used to define general characteristics of the map such as its title, the screen size, display and print options, attributes for redisplayed fields, as well as to indicate whether automatic editing takes place.
• The Map-Level Help Text Definition screen is used to associate help text with a map. The help text itself resides in an IDD module.
• The Associated Records screen is used to specify the records that contain the elements that will populate the map.

  At this point, the developer can choose to create the map automatically using the Autopaint option or go to the Layout screen.

• The Layout screen is used to layout the map. If the Autopaint option was chosen, the screen initially displays the layout created by the automatic map painter. Otherwise, the developer can begin to layout the map as desired.
• The Field Definition screens are used to define the specific information about the field.

  The seven screens used to expand on the field definition are:

  • Field Definition
  • Map Read/Write Options
  • Additional Edit Criteria
  • Field-Level Help Text definition
  • Device-Dependent Options
  • User-Defined Edit Modules
  • Pageable Options

For the Sample Session

• Default values for specifications are used in the sample session unless otherwise indicated. For more information on the screens, see "Online Mapping Compiler Reference".
• To move from option to option, <F5> is pushed; to move from screen to screen within a given option, <F8> is pushed.

Specifying Basic Information

    Add  Modify  Compile  Delete  Display  Switch
  _____________________________________________________________________________.

                           CA IDMS Online Map Compiler

                               CA, Inc.


    Map name . . . . . . . .    EYHTST9
    Map version  . . . . . .    1
    Dictionary name  . . . .    DOCANWK
    Dictionary node  . . . .    ____

    Screen . . . . . . . . . 1    1. General options
                                  2. Map-Level help text definition
                                  3. Associated records
                                  4. Layout
                                  5. Field definition

                           Copyright (C) 2007 CA, Inc.

 Command ===>
 Enter  F1=Help  F3=Exit  F10=Action

What is Entered?

The developer enters the name and version number of the map as well as the dictionary name and node. The developer also enters a 1 to indicate that options are specified.

Specifying General Options

                            General Options                   Page 1 of 2
 Map name:  EYHTST9   Version:     1

   Description. . .  ________________________________________

   Type . . . . . .  1  1. Standard   2. Pageable   3. Videotex

   Screen sizes (/)  / 24 by 80   / 32 by 80   / 43 by 80   / 27 by 132

   Automatic editing (/)  . . . . /
   Decimal point is comma (/) . . _
   Message prefix . . . . . . . . DC

   Display options   Unlock keyboard (/). . . . . . . . . . /
                     Turn off MDT (/) . . . . . . . . . . . /
   Alarm options     Sound alarm on mapout. . . . . . . . . _
                     Sound alarm on edit error (/)  . . . . _
   Print options     Print screen when displayed (/). . . . _
   (3280-type)       Line control  1 1. No formatting      3. 64 chars per line
                                     2. 40 chars per line  4. 80 chars per line



 F1=Help  F3=Exit  F4=Prev  F5=Next  F6=Preview  F8=Fwd

What is Entered?

The general options associated with the map are entered using the General Options screen. The General Options screen has two pages.

The first page is shown previously and the second page is shown. To move between the two, use <F7> and <F8>.

General Options Screen - Page 2

                            General Options                  Page 2 of 2
 Map name:  EYHTST9   Version:     1

                    Attributes for redisplayed fields    In error   Not in error

 Display intensity  1. Normal  2. Bright  3. Hidden . . . .  2  . . . .  _

 Highlighting       1. Blink   3. Underline . . . . . . . .  _  . . . .  _
                    2. Reverse video

 Color              1. White   4. Blue    7. Turquoise  . .  2  . . . .  _
                    2. Red     5. Yellow  8. Default
                    3. Green   6. Pink

 Entry options      1. Protect  2. Unprotect  . . . . . . .  _  . . . .  _
                    1. Numeric  2. Alphanumeric . . . . . .  _  . . . .  _
                    1. Set MDT  2. Reset MDT  . . . . . . .  _  . . . .  _
                    Detect with light pen (/) . . . . . . .  /  . . . .  _
                    Tab key selection (/) . . . . . . . . .  _  . . . .  _

 DC366804 Select map options

 F1=Help  F3=Exit  F4=Prev  F5=Next  F6=Preview  F7=Bkwd

Defining Map-level Help

                        Map-Level   Help Text Definition       Page  1 of  1
 Map name:  EYHTST9   Version:     1

 Help name: ________  Help key:   PF01                     Drop Help (/) _






      Window format . . . . .  1  1. Half   2. Full

      Origin of help text . .  1  1. No text
                                  2. Module   ________________________________
                                     Version     1





 DC366306 Select help text options

 Enter  F1=Help  F3=Exit  F4=Prev  F5=Next  F6=Preview

What is Entered?

To associate help with a map, the developer specifies:

• The name of the load module that contains the help information in the Help name field
• The function key that invokes map-level help in the Help key field
• Whether the help is displayed in a half or full window in the window format field
• The name of the IDD module that contains the help text for this map in the Origin of help text field

Specifying the Associated Records

                           Associated Records                  Page  1 of  1
 Map name:  EYHTST9   Version:    1

              Record name           Version            Role name            Drop
                                                                             (/)
  1 EMPLOYEE                           100  ________________________________  _

  2 DEPARTMENT                         100  ________________________________  _

  3 ________________________________        ________________________________  _

  4 ________________________________        ________________________________  _

  5 ________________________________        ________________________________  _

  6 ________________________________        ________________________________  _

  7 ________________________________        ________________________________  _


 DC366601 Map options processed successfully

 F1=Help  F3=Exit  F4=Prev  F5=Next  F6=Preview  F7=Bkwd  F8=Fwd  F9=Autopaint

What is Entered?

The developer enters the names and version numbers of the records associated with the map.

Creating a Map Automatically

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

       01 EMPLOYEE    VERSION 0100
   /    02 EMP-ID-0415
   _    02 EMP-NAME-0415
   /     03 EMP-FIRST-NAME-0415
   /     03 EMP-LAST-NAME-0415
   _    02 EMP-ADDRESS-0415
   /     03 EMP-STREET-0415
   /     03 EMP-CITY-0415
   /     03 EMP-STATE-0415
   /     03 EMP-ZIP-0415
   _      04 EMP-ZIP-FIRST-FIVE-0415
   _      04 EMP-ZIP-LAST-FOUR-0415
   _    02 EMP-PHONE-0415
   _    02 STATUS-0415
   /    02 SS-NUMBER-0415

 DC365503 Select the fields that are to appear on the screen

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

What is Entered?

The developer selects the fields (/) that will be displayed on the map. Often, the list of elements is displayed on more than one screen as illustrated here.

Previewing the Map

       EMP-ID-0415              ____

       EMP-FIRST-NAME-0415      _________________________

       EMP-LAST-NAME-0415       _________________________

       EMP-STREET-0415          ______________________________________

       EMP-CITY-0415            _________________________

       EMP-STATE-0415           __________________________

       EMP-ZIP-0415             _________

       SS-NUMBER-0415           _________

       DEPT-ID-0410       ____




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

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

What is Entered?

The online compiler uses the fields the developer selected to create a map which can be previewed.

Modifying the Map

The developer can then add, modify, or delete the fields as appropriate.

Compiling the Map

    Add  Modify  Compile  Delete  Display  Switch
  _____________________________________________________________________________.
              |  1  1. Compile       |
              |     2. View Messages |line Map Compiler
              |______________________|
              | F3=Exit              | CA, Inc.
              |______________________|
    Map name . . . . . . . .    EYHTST9
    Map version  . . . . . .       1
    Dictionary name  . . . .    ________
    Dictionary node  . . . .    ________

    Screen . . . . . . . . . _    1. General options
                                  2. Map-Level help text definition
                                  3. Associated records
                                  4. Layout
                                  5. Field definition



 Command ===>
 Enter  F1=Help  F3=Exit  F10=Action

What is Entered?

To compile the map, the developer returns to the main menu and selects the Compile option from the action bar.

More information:

Online Mapping Compiler Reference