Configuration Methods

Owned by Stonebranch
Feb 06, 2023
2 min read

Configuration Methods

All components provide a consistent and flexible method of configuration. An operating system's native configuration methods, such as configuration files, are utilized in order to integrate with existing system management policies and procedures for the platform.

Depending on the specific Universal Agent component, and the operating system on which it is being run, component configuration is performed by one or more methods.

These configuration methods, in their order of precedence, are:

  1. Command Line
  2. Command File
  3. Environment Variables
  4. Configuration File

The command line, command file, and environment variables methods let you set configuration options and preferences for a single execution of a component.

The configuration file method lets you set default configuration options and preferences for all executions of a component.

This order of precedence means that an option specified on the command line overrides the same option specified in a command file, which overrides the same option specified with an environment variable, which overrides the same option specified in a configuration file.

Note

For security reasons, not all options can be overridden.

Universal Broker / Servers Configuration Method

Universal Broker, and all Universal Agent servers, are configurable only by modifying their configuration files (see Configuration File). They are not configurable via command line, command file, or environmental variables.

z/OS Platform

On the z/OS platform, configuration can utilize z/OS system symbols as part of the configuration value. Each system symbol is resolved when the value is first read by a component.

z/OS System symbols may be used in some of the configuration methods as follows:

  • Command line or command file options prefixed with a plus (+) character instead of a dash (-) result in system symbols in the option value being resolved.
  • System symbols are not supported in environment variables.
  • System symbols are always resolved in configuration file values.

System symbols start with the ampersand character (&) and end with a period (.). For example, the &SYSNAME. symbol specified in the Universal Broker UNIX_DB_DATA_SET option is "UNV.&SYSNAME..UNVDB". The variable "&SYSNAME." will be replaced with the symbol value.

The z/OS system symbols that are defined on z/OS can be displayed with the MVS system command DISPLAY SYMBOLS.