Appendix A       MOM Listener and JMS Tags


The message oriented middleware (MOM) listener and the Java message service (JMS) tags are in the sample BasicSchema.xml and TransportSchema.xml schema files that come with the iPlanet Market Maker software.

MOM Listeners Tag

---

The MOM_LISTENERS tag specifies the list of registered JMS listeners in the Exchange module. The Exchange module uses the publish/subscribe JMS paradigm. Each registered listener subscribes to the topic of interest. By default, these listeners are internal exchange services, but you can configure additional listeners and integrate them to external systems as part of customizing the process for a new exchange.

Each listener entity has the following XML structure:

<MOM_LISTENER_PROPERTIES>

<MOM_LISTENER_PROPERTY name="debug" value="[debug level to set for the listener]"/>

<MOM_LISTENER_PROPERTY name="message.topic" value="[name of the topic to which the listener subscribes to]" />

</MOM_LISTENER_PROPERTIES>

</MOM_LISTENER>

The MOM listener implementation class should extend the com.iplanet.ecommerce.vortex.exchange.mom.ExchangeMOMListener class provided by the Exchange module API and implement the processMessage method.

JMS Tag

---

The JMS tag specifies all the configuration information needed to enable the Exchange module for the JMS implementation being used, such as the iPlanet Message Queue. The ENCRYPT tag specifies the XML subtree that needs token replacement of values for elements such as user name, password, and so on.

<JMS>       <JMS_PROPERTIES>          <JMS_PROPERTY name="jndi.context.factory" value="com.sun.jndi.ldap.LdapCtxFactory"/>          <JMS_PROPERTY name="jndi.url" value="ldap://localhost:389/o=imm"/>       <ENCRYPT>          <JMS_PROPERTY name="jmq.admin.user" value="admin"/>          <JMS_PROPERTY name="jmq.admin.password" value="admin"/>          <JMS_PROPERTY name="jndi.authentication" value="simple"/>          <JMS_PROPERTY name="jndi.principal" value="cn=Directory Manager"/>          <JMS_PROPERTY name="jndi.credentials" value="dirmanager"/>          <JMS_PROPERTY name="jms.exchange.user" value="crs"/>          <JMS_PROPERTY name="jms.exchange.password" value="crs"/>       </ENCRYPT>          <JMS_PROPERTY name="jms.host" value="localhost"/>          <JMS_PROPERTY name="jms.port" value="7676"/>          <JMS_PROPERTY name="routers.jvm.id" value="router"/>          <!-- this should go into MOM_PROPERTIES -->          <JMS_PROPERTY name="max.concurrent.listeners" value="5" />          <!-- unack messages threshold for the router listeners -->          <JMS_PROPERTY name="unack.messages.stop.limit" value="1000"/>          <JMS_PROPERTY name="unack.messages.resume.limit" value="100"/>       </JMS_PROPERTIES>    </JMS>