To use MATLAB analysis and modeling capability in an Apama application or in an application built using the Apama Capital Markets Foundation, you need to add the MATLAB bundle to your project and ensure that MATLAB executables and libraries are available to the correlator. The MATLAB bundle provides access to the MATLAB analysis and modeling toolkit from Apama EPL code and includes a correlator plug-in.

For information about supported versions, see the Supported Platforms document for the current Apama version. This is available from the following web page: http://documentation.softwareag.com/apama/index.htm.

This MATLAB plug-in lets you connect to and use the MATLAB engine. However, there are some functions/toolkits for which MATLAB does not support integration with C or Fortran on some operating platforms. Check the MATLAB documentation before using the MATLAB correlator plug-in.

The recommended way to use the MATLAB plug-in is to use the MatlabManager event, and call the relevant action and supply a callback. The call goes directly to the MATLAB plug-in so you do not need to route a request event. *Response events are routed from the MATLAB plug-in to the calling context. Each request action automatically sets up a listener for the *Response event that will call the supplied callback. You can supply the relevant doesNothing*Callback() action from the MatlabManager event if you are not interested in the results of the callback. If you use the MatlabManager actions you do not need to call the #initialize() action.

The legacy way to use the MATLAB plug-in is to route *Request events and set up listeners for the *Response events. If you are using the MATLAB plug-in in only the main context, injecting MatlabService.mon sets up all required listeners for the *Request events that call into the MATLAB plug-in. To use the MATLAB plug-in from another context, instantiate a MatlabManager variable, spawn to the other context, and call #initialize() on the variable. This sets up the required listeners in the current (non-main) context, and the *Response events are routed to this context.

The MATLAB plug-in is multi-context aware. The *Response events are routed to the calling context.

To include MATLAB capabilities in your application, follow these steps: