Version 4.2.6 for Mainframes
 —  Editors  —

Creating and Testing a Help Map

In this session, you will create and test a help routine/help map for a map field.

Start of instruction setTo create a help map

  1. In the Edit Map menu, enter an H in the Code field and HELP001 in the Name field.

  2. Press ENTER.

    The Define Map Settings for HELPMAP screen appears.

  3. In the Page Size field, enter 15, and, in the Line Size field, enter 25 as shown below:

    11:36:53               Define Map Settings for HELPMAP               2007-12-14
                                                                                   
     Delimiters           Format                         Context                   
     -----------------    ---------------------------    --------------------------
     Cls Att CD  Del      Page Size ...... 15            Device Check .... ________
      T   D      BLANK    Line Size ...... 25            WRITE Statement   _       
      T   I      ?        Column Shift ... 0 (0/1)       INPUT Statement   X       
      A   D      _        Layout ......... ________                                
      A   I      )         dynamic ....... N (Y/N)                                 
      A   N      ¬        Zero Print ..... N (Y/N)       Position Line    Col      
      M   D      &        Case Default ... UC (UC/LC)                              
      M   I      :        Manual Skip .... N (Y/N)       Automatic Rule Rank  1    
      O   D      +        Decimal Char ... .             Profile Name .... SYSPROF 
      O   I      (        Standard Keys .. N (Y/N)                                 
                          Justification .. L (L/R)       Filler Characters         
                          Print Mode ..... __            ------------------------  
                                                         Optional, Partial ....    
                          Control Var .... ________      Required, Partial ....    
                                                         Optional, Complete ...    
                                                         Required, Complete ...    
                                                                            
                                                                                   
                                                                                   
                                                         
    
    
    
    
                              
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit                                                  Let
    
  4. Press ENTER twice.

    The map editing screen appears.

  5. Press PF9.

    The screen appears in full-screen mode:

                               ....................................................
                               ....................................................
                               ....................................................
                               ....................................................
                               ....................................................
                               ....................................................
                               ....................................................
                               ....................................................
                               ....................................................
                               ....................................................
                               ....................................................
                               ....................................................
                               ....................................................
                               ....................................................
                               ....................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Mset  Exit  Test  Edit  --    -     +     Split <     >     Let    
    001   --010---+----+----+---030---+----+----+---050---+----+----+---070---+----

    The portion of the screen not to be used is filled with periods.

  6. Enter text as shown below:

                               ....................................................
    Type in the name of an     ....................................................
    employee in the first      ....................................................
    field and press ENTER.     ....................................................
    You will then receive      ....................................................
    a list of all employees    ....................................................
    of that name.              ....................................................
                               ....................................................
    For a list of employees    ....................................................
    of a certain name who      ....................................................
    live in a certain city,    ....................................................
    type in a name in the      ....................................................
    first field and a city     ....................................................
    in the second field        ....................................................
    and press ENTER.           ....................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    ...............................................................................
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Mset  Exit  Test  Edit  --    -     +     Split <     >     Let    
    001   --010---+----+----+---030---+----+----+---050---+----+----+---070---+----
    
  7. Press PF3.

    The Edit Map menu appears with the Name field set to HELP001.

  8. STOW help map HELP001 by using the appropriate menu function.

  9. In the Code field, enter a T, and, in the Name field, enter MAP001.

  10. Press ENTER.

    The test screen for MAP001 appears.

  11. In the first position of the input field next to PLEASE ENTER NAME:, enter a question mark (?) and press ENTER.

    Help map HELP001 appears:

    *******************************************************************************
     07-12-14                    PERSONNEL INFORMATION                             
     16:58:37                                                                      
                                                                                   
    PLEASE ENTER NAME: ?___________________                                        
    PLEASE ENTER CITY: +---------------------------+                               
                       |                           |                               
    TYPE IN . TO STOP  | Type in the name of an    |                               
                       | employee in the first     |                               
                       | field and press ENTER.    |                               
                       | You will then receive     |                               
                       | a list of all employees   |                               
                       | of that name.             |                               
                       |                           |                               
                       | For a list of employees   |                               
                       | of a certain name who     |                               
                       | live in a certain city,   |                               
                       | type in a name in the     |                               
                       | first field and a city    |                               
                       | in the second field       |                               
                       | and press ENTER.          |                               
                       |                           |                               
                       +---------------------------+                               
    *******************************************************************************
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
    
  12. Press ENTER twice.

    The processing rule for the first field (#NAME) is tested and the following message is displayed: PLEASE TYPE IN A NAME.

  13. In the first position of the first field, enter any character and press ENTER.

    The test is terminated and the Edit Map menu appears.

You can now proceed with Invoking a Map with INPUT USING MAP.

Top of page