IBM Support

WebSphere MQ Suite Open Session service failing with "Service Error" in Sterling B2B Integrator

Troubleshooting


Problem

WebSphere MQ Suite Open Session service reports "Service Error" under Advanced Status of workflow. And Status Report of the service shows following error. Throwable in ae.invokeservice:com.ibm.mq.MQEnvironment (initialization failure)

Symptom

SBI is integrated with WebSpehere MQ server 8.0.0.0 by installing jars from MQ server's java/lib directory.

Cause

SBI comes with few jar libraries from 7.0.1.6 version of WebSphere MQ server by default. These jars can be found through properties/dynamicclasspath.cfg entries.

VENDOR_JAR=/install/jar/mqseries/7_0_1_6/com.ibm.mq.commonservices.jar
VENDOR_JAR=/install/jar/mqseries/7_0_1_6/com.ibm.mq.headers.jar
VENDOR_JAR=/install/jar/mqseries/7_0_1_6/com.ibm.mq.jar
VENDOR_JAR=/install/jar/mqseries/7_0_1_6/com.ibm.mq.jmqi.jar
VENDOR_JAR=/install/jar/mqseries/7_0_1_6/com.ibm.mq.pcf.jar
VENDOR_JAR=/install/jar/mqseries/7_0_1_6/com.ibm.mqjms.jar

Websphere MQ server 8.0.0.0 has these 17 libraries under java/lib directory. By installing these libraries onto SBI leading to conflicts with default libraries above.

com.ibm.mq.allclient.jar
com.ibm.mq.axis2.jar
com.ibm.mq.commonservices.jar
com.ibm.mq.defaultconfig.jar
com.ibm.mq.headers.jar
com.ibm.mq.jar
com.ibm.mq.jmqi.jar
com.ibm.mq.jms.Nojndi.jar
com.ibm.mq.pcf.jar
com.ibm.mq.postcard.jar
com.ibm.mq.soap.jar
com.ibm.mq.tools.ras.jar
com.ibm.mq.traceControl.jar
com.ibm.mqjms.jar
fscontext.jar
jms.jar
providerutil.jar

Environment

This issue is noticed in 5.2.4.1 fixpack environment integrated with MQ server 8.0.0.0

But it could occur whenever there are conflicting versions of MQ jars/libraries loaded in classpath.

Diagnosing The Problem

Match the status report and advanced status from failed workflow with the ones from abstract here.

Resolving The Problem

Ensure SBI's classpath is referring to only one set of MQ jars (not multiple versions').

Resolve this issue by uninstalling older libraries. Uninstallation of vendor jars can be done by running install3rdParty script from install/bin folder. Restart SBI later to take changes effective.

E.g.,

./install3rdParty.sh mqseries 7_0_1_6 -j /install/jar/mqseries/7_0_1_6/com.ibm.mq.commonservices.jar -uninstall

[{"Product":{"code":"SS3JSW","label":"Sterling B2B Integrator"},"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Component":"Adapters","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All","Edition":"","Line of Business":{"code":"LOB02","label":"AI Applications"}},{"Product":{"code":"SS3JSW","label":"Sterling B2B Integrator"},"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB02","label":"AI Applications"}}]

Document Information

Modified date:
09 January 2020

UID

swg21691696