Start of change

Setting up group-level configuration files

A group-level file can be used to set up feature toggles for a collection of regions. This file can also be used to prevent region-level files from setting feature toggles and configuration options.

Procedure

  1. Create a feature toggle configuration file in a directory that is shared by the CICS® regions that will use this file.
    Note: Ensure that all the CICS regions that will use this configuration file have read access to the file.
  2. In the file, for each feature that you want to enable, specify the feature's toggle setting and, if necessary, configuration options, as described in Specifying feature toggles.
    Note: To prevent region-level files from setting certain feature toggles and configuration options, you can specify the parameter finalize in the toggle setting and configuration options, as in the following example:
    [finalise] com.ibm.cics.bms.ids=true
    [finalise] com.ibm.cics.bms.ids.vtamignore=false
  3. In the USSCONFIG directory of each CICS region that will use the configuration file created in Step 1, create a file with the name groupfeaturetoggle.properties, which is a symbolic link to the configuration file. By default, the path is /var/cicsts/dfhconfig.
    Note: The CICS installation process creates an empty groupfeaturetoggle.properties file in /pathprefix/usr/lpp/cicsts/ussdira/dfhconfig, which you can copy to the required USSCONFIG directory.
    Tip: If you are not sure which path the CICS region is using, you can see the path in message DFHPA1951I in the system message log.
    In the following example, CICS regions AOR1, AOR2, and AOR3 are using the following configuration file:

    /etc/cicsts/aorgroup/featuretoggle.properties

    To do so, you must specify a group-level configuration file, groupfeaturetoggle.properties, in the USSCONFIG directory of each region. groupfeaturetoggle.properties is a symbolic link to featuretoggle.properties, as shown in Figure 1.

    Figure 1. Symbolic links
    AOR1     /var/cicsts/dfhconfig/AOR1/groupfeaturetoggle.properties
    AOR2     /var/cicsts/dfhconfig/AOR2/groupfeaturetoggle.properties
    AOR3     /var/cicsts/dfhconfig/AOR3/groupfeaturetoggle.properties
    To specify a symbolic link for AOR1 as shown in the preceding figure, enter the following command:
    ln -s /etc/cicsts/aorgroup/featuretoggle.properties
          /var/cicsts/dfhconfig/AOR1/groupfeaturetoggle.properties


configfeaturetogglefile-regiongroup.html | Timestamp icon Last updated: Sunday, 4 June 2017
End of change