Gen Host Encyclopedia Screen Generation Standard and Enhanced Map options

Products

• Gen
• Gen - Host Encyclopedia

Issue/Introduction

The Enhanced and Standard map screens generated on the Gen Host Encyclopedia can be set by user or globally. This document will describe how and where the settings are located and include code examples to determine if a screen was generated with Enhanced or Standard map.

Environment

Release: 8.x
z/OS Host Encyclopedia

Cause

There are two map options for screen generation in Gen:

• In Standard map the screen is read in one line at a time.

• In Enhanced map the entire screen is read at one time which makes this option more efficient.

Screen and/or program code do not always work together with Enhanced map if screens were built with Standard map in earlier releases of Gen. Standard map was retained for this reason.

Generally when screen problems occur, changing from Enhanced to Standard or vice versa will resolve the problem.

Resolution

USER SETTINGS

There is a global setting. This setting can be overwritten by the user on the Application System Construction Menu option 8. Screen generator options. Here there are three options:

E.  Enhanced     Use enhanced screen generator 
S.  Standard     Use standard screen generator 
D.  Default      Use installation default 

Set as desired to Enhanced or Standard. If Default is selected, it will take the global setting. The global setting is described below. This setting will be saved in the users ISPF profile for future use. Note that if the setting by a user differs from the default setting, the user setting prevails. This setting is for all models and business systems. Again, it will be saved in the user ISPF profile when the user logs off and retrieved for use when the user logs on again to the Host Encyclopedia.
Related doc. page: Other Considerations and Construction Options see section at bottom of page "Screen Generator Options"

GLOBAL SETTING

In Gen 8.x and after, the global default for map generation selection is located in the Gen PARMLIB(TIRHE) for the Host Encyclopedia.
The setting default is ENHANCED MAP. This is for all models and business systems unless overwritten by the user.

PARMLIB ---- See member TIRHE

/* MAP GENERATOR SELECTION                              
/*    TIMAPSEL=1 SELECTS THE STANDARD MAP GENERATOR     
/*    TIMAPSEL=2 SELECTS THE ENHANCED MAP GENERATOR     
/* *****************************************************
   SET TIMAPSEL = 2                                     
   ISPEXEC VPUT (TIMAPSEL) SHARED

Additional Information

ENHANCED / STANDARD Generated Source Code

The header portion of the generated code can be viewed to determine if Enhanced or Standard map was used. Below are examples of code generation for Enhanced and Standard map screens. Note the difference in the presentation of the flower box for Enhanced map code generation. See the screen source in your generated source code library. This library can be found in the Specify Construction Libraries and then Specify Internal Libraries.

ENHANCED MAP Generated Source Code

      * ************************************************************
      *  
      *                   Source code generated by 
      *                             CA Gen 8.6
      *   Copyright (c) 2024 CA Technologies. All rights reserved.
      * Model name .............. GEN SAMPLE MODEL 8 6             
      * Business system name .... CORPORATE_MANAGEMENT             
      * Screen name ............. EMPLOYEE_DETAIL                  
      * Panel/Member name ....... DETSCRN  
      * Screen object id ........ 0222298113 
      * Generator version ....... 02.11600218 
      * Generator Build ......... 02004
      * Extended attributes ..... YES 
      * Date of generation ...... Wednesday, July 31, 2024       
      * Time of generation ...... 01:51:13 PM                    
      * Dynamic link (z/OS) used bus sys default of "No"
      *  
      * ************************************************************


STANDARD MAP Generated Source Code

      ****************************************************************
      *
      *                    Source Code Generated by
      *                          CA Gen 8.6
      *
      *   Copyright (c) 2024 CA Technologies. All rights reserved.
      *
      *    NAME: EMPLOYEE_DETAIL                  DATE: 2024/07/31
      *    TARGET OS:   MVS                       TIME: 13:49:40
      *    TARGET DBMS: DB2 z/OS                 
      *
      *     
      *     
      *
      *    Generation Options:
      *    TP Monitor: CICS
      *    Screen Format Type: BYPASS
      *    Extended Attributes: ALL
      *    Dynamic link (z/OS) used bus sys default of "No"
      *
      *    Runtime Functions Referenced:
      *    TIRIBUF = identify input message
      *    TIROBUF = open an output buffer
      *    TIRCBUF = close an output buffer
      *    TIREDI  = extract data from an edited field
      *    TIREDO  = edit data into a displayable field
      *    TIRGFLD = find a field in the input stream
      *    TIRPFLD = add a field to the output stream
      *              including attribute processing  
      *    TIRPBUF = write a buffer to the screen or printer
      *    TIRMFPA = Map Field Prompt Attribute processor
      *
      ****************************************************************

Related article: Screen Map option in Gen Toolset or CSE generation for z/OS IT build