Customization examples

Follow this example to help you customize templates for your BMS map definitions.
Attention: This topic contains Product-sensitive Programming Interface and Associated Guidance Information.

The following example shows a customizing macro definition. The first invocation of DFHMDX sets defaults for the values to be applied to subsequent invocations of DFHMDX by specifying * for the map set name and map name. Later invocations override or add to the parameters for specific maps in the map set. The continuation characters are in column 72, and the continued text is resumed in column 16.

         MACRO
         DFHMSX
         DFHMDX MAPSET=*,MAP=*,                                        *
               F1='Help',F3='Exit',F4='Save',F9='Messages'
         DFHMDX MAPSET=DFHWB0,MAP=*,                                   *
               TITLE='CICS Web Interface',                             *
               F3='Messages'
         DFHMDX MAPSET=DFHWB0,MAP=DFHWB02,                             *
               TITLE='CICS Web Interface Enable',                      *
               F3='Save'
         MEND

When CICS® creates the templates for each of your BMS map definitions, it calls the customizing macro specified on the SYSPARM parameter in the DFHMAPT procedure. If the SYSPARM parameter does not specify a customizing macro name, DFHMSX is used. Each macro is processed in sequence, and, if applicable, the parameter values are stored. Where a duplicate parameter is specified for a particular map or map set, the new value replaces the previous value for that map or map set only.

  • The first DFHMDX macro in this example specifies MAPSET=*,MAP=* and F3='Exit'. This value of F3 applies to every map set and map for which a different value is not specified in a subsequent DFHMDX macro.
  • The second DFHMDX macro specifies MAPSET=DFHWB0,MAP=* and F3='Messages'. This value of F3 applies to every map in map set DFHWB0 for which a different value is not specified in a subsequent DFHMDX macro.
  • The third DFHMDX macro specifies MAPSET=DFHWB0,MAP=DFHWB02 and F3='Save'. This value applies only to map DFHWB02 in map set DFHWB0.
The default template generated from the BMS map contains buttons to represent all the following keys:
  • ENTER and CLEAR keys
  • PA1, PA2, and PA3 keys
  • Function keys F1 to F24
  • HTML reset
However, if you use the DFHMDX macro to specify the buttons that you want in your template, only the buttons you specify are included in the template. For example, if you specify:
DFHMDX MAPSET=*,MAP=*,F3='Exit',ENTER='Continue'
the template will contain buttons for the F3 and ENTER keys only.

Here are further examples showing how you can customize the HTML template generated from a BMS map.



dfhtlb3.html | Timestamp icon Last updated: Sunday, 4 June 2017