Using Software AG Designer to configure adapters that use Universal Messaging
Note:
The Apama > Add UM Configuration to IAF menu item is only for configuring the IAF adapter to communicate over Universal Messaging to the correlator. If you only have the correlator communicating over Universal Messaging, then you use the Universal Messaging connectivity plug-in. Use of Universal Messaging from the IAF is deprecated and will be removed in a future release.
To configure an IAF adapter to use Universal Messaging
1. Add support for Universal Messaging to your project. Right-click the project and select Apama > Add UM Configuration to IAF.
2. Add one of the following adapters to your project:
File Adapter
JDBC Adapter
ODBC Adapter
Sim File Adapter
3. Open the instance of the adapter you just added. In the Settings tab, you can see the following substitution variables:
APAMA_MSG_ENABLED UM_MSG_ENABLED Use Software AG Designer's launch configuration editor to manage these substitution variables.
4. Select Run As > Run Configurations....
5. In the Run Configurations dialog, select the Apama project that contains the adapter you want to configure and then click the Components tab.
6. In the Components tab, double-click the adapter you want to configure.
In the Adapter Configuration dialog, if you added Universal Messaging support to your project, the default for a new adapter in your project is that the UM Messaging radio button is selected. Adding Universal Messaging support to a project does not change an existing adapter configuration.
7. Ensure that UM Messaging is selected. This sets the related substitution variables as follows:
APAMA_MSG_ENABLED is
false.
UM_MSG_ENABLED is
true.
8. Click OK, Apply, and then Close to save the adapter configuration in that launch configuration.
Software AG Designer manages the APAMA_MSG_ENABLED and UM_MSG_ENABLED substitution variables by means of the launch configuration.
If you click the XML Source tab you can see that the <apama> element and the <universal-messaging> element each contain the enabled attribute. In the <apama> element, Software AG Designer sets the enabled attribute to the @APAMA_MSG_ENABLED@ substitution value. In the <universal-messaging> element, Software AG Designer sets the enabled attribute to the @UM_MSG_ENABLED@ substitution value. When you launch the project, Software AG Designer uses the settings of the APAMA_MSG_ENABLED and UM_MSG_ENABLED substitution variables to set the value of the enabled attribute in each element.
The default is that the enabled attribute is set to true. Consequently, if you delete the enabled attribute, it is as if it is set to true.