You write the Message API configuration using a simple XML schema, some settings of which can be changed via software function calls. The initial configuration compiled into the Message API software defines a minimal set of configuration parameters. Message API users can also supply their own custom XML file (e.g., EmaConfig.xml) to specify configuration parameters. For details on deploying a custom XML file, refer to Section 4.3.1. Additionally, programmatic interfaces can change parameter settings.
Message API configuration data is divided into the following groups:
• Consumer: Consumer configuration data are the highest-level description of the application. Such settings typically select entries from the channel, logger, and dictionary groups.
• Provider: Where Provider is either an IProvider or NiProvider. Provider configuration data is the highest-level description of the application. Such settings typically select entries from the channel (NiProvider only), logger, and directory groups.
• Channel: Channel configuration data describe various connection alternatives and provide configuration alternatives for those connections.
• Logger: Logger configuration data specify logging alternatives and associated parameters.
• Dictionary: Dictionary configuration data set the location information for dictionary alternatives.
• Directory: Directory configuration data configure source directory refresh information.
• WarmStandby: Warm standby channel configuration describes a warm standby group definition which is used to enable the warm standby feature for consumer applications.
• WarmStandbyServerInfo: Warm standby server configuration describes a channel configuration data to a starting or standby server and a set of preferred service names for the service based warm standby.
The Consumer and Provider groups are top-level configuration groups. Specific consumer and provider applications select their configurations according to the name specified in the consumerName() or providerName() method (for details on these methods, refer to Section 4.4.1).
This manual discusses the above configuration groups and the configuration parameters available to each group.