Apama 10.3 | Apama Documentation | Deploying and Managing Apama Applications | Correlator Utilities Reference | Configuring the correlator | Using properties files
Using properties files
Properties files (with the file extension .properties) can be used to specify values for substitution variables in YAML files (see also Using YAML configuration files). A properties file must be either in ISO-8859-1 encoding or in UTF-8 encoding if it begins with an UTF-8 byte order mark (BOM).
You can specify one or more properties files using the --config option when you start the correlator. See Starting the correlator. The properties files are processed in the order in which they appear on the command line. Each properties file can refer to properties that have already been defined by a previously processed properties file, using ${varname} syntax.
Note: If the same property is defined more than once, the first definition that is loaded by the correlator takes precedence over all definitions that are loaded later. Messages are then logged for all later definitions that are being ignored.
The properties file format is the same as the standard Java .properties file format, with # for comments and \\ used to escape any occurrences of \. For example:
# my comment line
myplugin.mykey=c:\\my directory
You can use the following predefined properties:
The absolute normalized path of the directory containing the properties file or YAML file currently being processed.
The path to the Apama installation.
The path to the Apama work directory.
The literal $ sign.
All properties are applied to all YAML files, although conventionally, there is often a .properties file named the same as each .yaml file. Properties files, however, are not actually tied in to YAML files in any way. It is therefore recommended that you prefix each property key with a unique string, such as the identifier of the chain to which it applies.
Note: Instead of using a properties file or in addition to using a properties file, you can also use the -D option of the correlator tool. See Starting the correlator.
Correlator-integrated messaging for JMS and the distributed MemoryStore have their own properties files, which are Spring files. Keep in mind that any properties that are specified with the --config file or -Dkey=value option of the correlator tool take precedence and override the properties defined in a Spring properties file. See also Configuration files for JMS and Configuration files for distributed stores.

Copyright © 2013-2018 | Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.