Apama Documentation : Connecting Apama Applications to External Components : Using Message Services : Using Universal Messaging in Apama Applications : Starting correlators that use UM
Starting correlators that use UM
For a correlator to use UM, you must specify one of the following options when you start the correlator:
*--rnames list
Specifies one or more UM realm names (RNAME) separated by commas or semicolons.
Commas indicate that you want the correlator to try to connect to the UM realms in the order in which you specify them here. For example, if you have a preferred local server you could specify its associated RNAME first and then use commas as separators between specifications of other RNAMEs, which would be connected to if the local server is down.
Semicolons indicate that the correlator can try to connect to the specified UM realms in any order. For example, use semicolons when you have a cluster of equally powered machines in the same location and you want to load balance a large number of clients.
You can specify multiple UM realms only when they are connected in a single UM cluster. That is, all RNAMEs you specify must belong to the same UM cluster. Since channels are shared across a cluster, connecting to more than one UM realm lets you take advantage of UM's failover capability.
You can specify -r in place of --rnames.
For additional information on Communication Protocols and RNAMEs, and on clusters, see the Universal Messaging documentation.
*--umConfigFile path
Specifies the name or path to a properties file that defines the UM configuration settings for the Apama correlator you are starting. See Defining UM properties for Apama applications.
You can specify -UMconfig in place of --umConfigFile.
Copyright © 2013-2016 Software AG, Darmstadt, Germany.

Product LogoContact Support   |   Community   |   Feedback