Customization examples

Attention: This topic contains Product-sensitive Programming Interface and Associated Guidance Information.

The following sample 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=*,                                        *
               PF1='Help',PF3='Exit',PF4='Save',PF9='Messages'
         DFHMDX MAPSET=DFHWB0,MAP=*,                                   *
               TITLE='CICS Web Interface',                             *
               PF3='Messages'
         DFHMDX MAPSET=DFHWB0,MAP=DFHWB02,                             *
               TITLE='CICS Web Interface Enable',                      *
               PF3='Save'
         MEND

Start of changeWhen CICS® creates the templates for each of your BMS map definitions, it invokes 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. End of changeEach 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 PF3='Exit'. This value of PF3 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 PF3='Messages'. This value of PF3 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 PF3='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 Start of changeand CLEAREnd of change keys
  • PA1, PA2, and PA3 keys
  • Program function keys PF1 to PF24
  • HTML reset
However, if you use the DFHMDX macro to specify the buttons you want in your template, only the buttons you specify will be included in the template. For example, if you specify
DFHMDX MAPSET=*,MAP=*,PF3='Exit',ENTER='Continue'
the template will contain buttons for the PF3 and ENTER keys only.

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