Step 20D: Set up the JCL Procedure and the Environment File

The sample procedure ING.SINGSAMP(INGEKPRC) starts the Java application of System Automation Info Broker. The //STDENV statement points to an environment file that resides in your custom directory. This environment file is needed to set up the USS environment for the System Automation Info Broker Publisher - the Java process that is started by the NetView DST and forwards the messages to your Kafka server.

Procedure

  1. Copy the sample procedure ING.SINGSAMP(INGEKPRC) to your PROCLIB and change it to the defaults used in your environment. In case you rename this example procedure to your needs, make sure to change the PROCNAME attribute in the DSIPARM initialization parameter (see Step 20C: Create a New Initialization Member in DSIPARM).
  2. Modify the CONFIG parameter in the sample procedure to the custom directory of your choice.
  3. Copy the sample environment file from the directory /usr/lpp/ing/infobroker/config/ing.infobroker.environmentto your custom directory, for example, /etc/ing/infobroker/config/ing.infobroker.environment
  4. Customize the variables in the environment file as instructed by the descriptions within that sample file.

System Symbol Support for System Automation Info Broker (OA62518)

This feature resolves system symbols in the configuration variables at startup. This enables the user to have a generic configuration file that acts as a "single source of truth" and can be shared across systems and sysplexes. The specific configuration for each system can then be controlled via system symbols.

By default, this feature is disabled. To enable this feature, navigate to the file 'ing.infobroker.environment' and set the following property to true.
# Enable system symbol support [true/false].
ENABLE_SYSTEM_SYMBOL_SUPPORT=true

After the feature is enabled, you can use system symbols in 'ing.infobroker.environment', 'ing.infobroker.properties', and 'ing.infobroker.security.properties' files.

Example 1, ing.infobroker.environment:
IBRKR_CONFIG_HOME=/etc/&SYSNAME./ing/infobroker

On SYS1, this setting resolves to IBRKR_CONFIG_HOME=/etc/SYS1/ing/infobroker.

On SYS2, this setting resolves to IBRKR_CONFIG_HOME=/etc/SYS2/ing/infobroker.

Example 2, ing.infobroker.properties:
ing.infobroker.default-topic=IBM-SYSAUTO-SDF-&SYSPLEX.

On PLEX1, this setting resolves to ing.infobroker.default-topic=IBM-SYSAUTO-SDF-PLEX1.

On PLEX2, this setting resolves to ing.infobroker.default-topic=IBM-SYSAUTO-SDF-PLEX2.

Next step

Step 20E: Customize Properties of the System Automation Info Broker