Using Apama Studio to configure adapters that use UM
You can use Apama Studio to configure an IAF adapter to use Universal Messaging. To do this:
2. Add one of the following adapters to your project:
File Adapter
JDBC Adapter
ODBC Adapter
Sim File Adapter
WebServices Client 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 Apama Studio's launch configuration editor to manage these substitution variables.
4. Select Run > 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 UM support to your project, the default for a new adapter in your project is that the UM Messaging radio button is selected. Adding UM 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.
Apama Studio 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, Apama Studio sets the enabled attribute to the @APAMA_MSG_ENABLED@ substitution value. In the <universal-messaging> element, Apama Studio sets the enabled attribute to the @UM_MSG_ENABLED@ substitution value. When you launch the project Apama Studio 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.