Integrating WebSphereMQ with SAP Web Application Server
Prerequisites
The native libraries of WebSphereMQ must be added to the environment variables of the host or hosts where the SAP Web AS is running. Typically, if MQ is installed on the same host, the required entries are added to the environment at installation. However, we recommend that you check the MQ documentation for details about the directory where the libraries are located, and make sure it is added to the environment on all hosts with SAP Web AS.
For example, for Windows OS the following libraries are required:
- amqmtmgr.dll
- amqvwaa2.dll
- amqxcs2.dll
- amqxcsn.dll
- amqzc.dll
- amqzsai.dll
- amqzst.dll
- amqztm.dll
- mqjbdf02.dll
- mqjbnd05.dll
- mqm.dll
- mqmvxd.dll
- mqmxa.dll
- MQXAi02.dll
Procedure
1) If the version of the SAP Web AS is SP 7 or lower, you must apply a patch for the JMS Connector Service. The required SDA is attached to this e-mail (jmsconnector.sda). To apply it:
a. Run the SDM Remote GUI tool. It is located in <SAP_install_dir>\SAPSID\<Instance_ID>\SDM\program.
b. In the Deployment tab, add the jmsconnector.sda to the deployment list. Choose Show Deployment Configuration. Select Update deployed SDAs/SCAs that have any version (this ensures that you will have the SDA deployed even if for some reason its timestamp is older than the one of the SP7 SDA that you already have deployed.)
c. Deploy the SDA following the standard deployment procedure. If prompted to choose if you want to delegate the control to the SDM server, choose Yes. The SDM shuts down the cluster, deploys the SDA, and then restarts the cluster.
2) Create the IBM MQ library. You can do it using either Visual Administrator or SAP NetWeaver Developer Studio.
a. Visual Administrator:
i. Go to Services -> JMS Connector.
ii. Select JMS Libraries, and choose New.
iii. Enter a name for the library, such as MQJMSLIB.
iv. Browse to select the following JAR files:
- com.ibm.mq.jar
- com.ibm.mqbind.jar
- com.ibm.mqjms.jar
- fscontext.jar
- ldap.jar
- postcard.jar
- provider.xml
- providerutil.jar
v. Deploy the library.
vi. Go to Services -> Configuration Adapter. In the configuration tree on the right-hand side of the screen browse to cluster_data -> server -> cfg -> ext -> MQJMSLIB-provider.xml. Switch to edit mode using . Open the XML for editing using . Add the following entry (after the reference entry for jms):
<reference type="library" strength="weak">j2eeca</reference>
Choose OK and restart the cluster to apply the changes.
b. SAP NetWeaver Developer Studio:
i. Create a J2EE Library project.
ii. Select the project and choose File -> Import -> File System. Browse to the MQ folder, which contains the JAR files listed above, and select to import them.
iii. Extend the tree of your library project and open server/provider.xml. Go to the Jars tab.
iv. Select Jars, and choose Add. Choose to add the JAR files that you have imported in the previous step.
v. Go to the References tab. Select References, and choose Add. Choose Select library/interface/service. In the list select jms and j2eeca.
vi. Save and close provider.xml. From the context menu of the library project choose Build Library Archive.
vii. Select the SDA in the project tree, open its context menu, and choose Deploy to J2EE Engine.
3) Create a JMS Connector Factory in Visual Administrator.
You can either enter the required values directly in the Visual Administrator (Services -> JMS Connector), or you can edit the following sample deployment descriptors and import them in Visual Administrator using .
a. Using JNDI:
This is example of factories.xml using JNDI based JMS provider.
<?xml version="1.0" encoding="UTF-8" ?>
<jms-factories>
<application-name>
IBM_Test_App
</application-name>
<connection-factory>
<library-name>
MQJMSLIB
</library-name>
<factory-name>
IBM_Queue_Factory
</factory-name>
<context-factory-type>
<!—This factory should already exist on WebSphereMQ.-->
<link-factory-name>
QCF_1
</link-factory-name>
<initial-context-factory>
com.sun.jndi.fscontext.RefFSContextFactory
</initial-context-factory>
<provider-url>
file:/C:/JNDI-Directory
</provider-url>
<security-principal>
</security-principal>
<security-credentials>
</security-credentials>
</context-factory-type>
</connection-factory>
</jms-factories>
b. Using object factory JMS provider
<?xml version="1.0" encoding="UTF-8" ?>
<jms-factories>
<application-name>
IBM_Test_App
</application-name>
<connection-factory>
<library-name>
MQJMSLIB
</library-name>
<factory-name>
IBM_Queue_Factory
</factory-name>
<object-factory-type>
<object-factory-name>
com.ibm.mq.jms.MQXAQueueConnectionFactoryFactory
</object-factory-name>
<class-name>
com.ibm.mq.jms.MQXAQueueConnectionFactory
</class-name>
<properties>
<property>
<property-name>
HOST
</property-name>
<!-- JMS Provider host name -->
<property-value>
localhost
</property-value>
</property>
<property>
<property-name>
QMGR
</property-name>
<!-- Queue Manager -->
<property-value>
MQ_default
</property-value>
</property>
<property>
<property-name>
PORT
</property-name>
<!-- JMS Provider port number -->
<property-value>
1414
</property-value>
</property>
<property>
<property-name>
TRAN
</property-name>
<!-- Transport type -->
<property-value>
1
</property-value>
</property>
</properties>
</object-factory-type>
</connection-factory>
</jms-factories>
4) Use the connection factory in an application:
Code:
Context ctx = new InitialContext();
Object ref = ctx.lookup("java:comp/env/IBM_Queue_Factory");
QueueConnectionFactory f = (QueueConnectionFactory)ref;
QueueConnection connection = f.createQueueConnection();
Resource references:
<resource-ref>
<res-ref-name>
IBM_Queue_Factory
</res-ref-name>
<res-type>
javax.jms.QueueConnectionFactory
</res-type>
<res-auth>
Container
</res-auth>
</resource-ref>
If you are using 6.40 SP7 or below let me know to send you a patch.
Regards Nikola
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.