Optimize 10.5 | webMethods Optimize Documentation | Administering webMethods Optimize | For System Administrators | Configuring Optimize | Implementing Guaranteed Event Storage in Optimize | Configuring the MAPI Flag
 
Configuring the MAPI Flag
By default, events in Optimize are published by the Monitor API (MAPI) and handled asynchronously. This method provides optimal performance, but it means that users may not receive immediate notification of event publication errors. Using the flag described herein, you can configure the Optimize MAPI service to publish events synchronously. If an event delivery problem occurs in this configuration, errors are generated immediately.
The -Dsag.opt.mapi.sync.event.flag system property setting in the Integration Server startup file enables synchronous event delivery in all the components that use MAPI client mechanism running in the same Java Virtual Machine (JVM). It is important to remember that this flag is not limited to a single component; it can be set for any client JVM that uses the MAPI jar file.
Note that, depending on your system configuration, there may be multiple MAPI instances present in a system or JVM. In most cases, you can simply set the MAPI flag in the startup script for Integration Server or Infrastructure Data Collector or the custom build client application, etc.
*To configure the MAPI flag on an Optimize system
1. Open the Integration Server startup file located in the Integration Server_directory/bin folder under your installation directory. On a Windows system, the file is named server.bat, while on a Unix system, it is named server.sh.
2. Add the following line to the “run integration server” section of the startup file.
-Dsag.opt.mapi.sync.event.flag=y
Here’s an example of the flag added to a generic startup file:
SET JAVA_OPTS=-Dsun.lang.ClassLoader.allowArraySyntax=true
-Dwatt.server.prepend.classes=%PREPEND_SYSTEM_CLASSPATH%;%APPEND_SYSTEM_CLA
SSPATH%;%PREPENDCLASSES% -Dwatt.server.append.classes=%APPENDCLASSES%
-Dcom.webmethods.sc.auditing.Use80TableFormat=true
-Djavax.xml.xpath.XPathFactory:http://java.sun.com/jaxp/xpath/dom=com.sun.
org.apache.xpath.internal.jaxp.XPathFactoryImpl
-Dtangosol.coherence.shutdownhook=false -Dsag.opt.mapi.sync.event.flag=y
%DEBUG_JAVA_OPTS% %9
3. Save the file and close it.
4. Repeat the preceding steps for any other applicable components in your system.