Title
MQSeries Adapter disappears from AS Control after configuring it

Date
2008-09-02

Summary
The Oracle document section titled Configuring the MQSeries Adapter describes how to configure the MQSeries Adapter. Namely, the steps involve the following:

1. Copy the com.ibm.mq.jar to %ORACLE_HOME%/bpel/lib (or any directory actually).

2. Add the following configuration to %ORACLE_HOME%\j2ee\oc4j_soa\config\server.xml: 
    <shared-library name="oracle.mqseries" version="10.1.3">
    <code-source path="e:\oracle\product\10.1.3\soa_1\bpel\lib\com.ibm.mq.jar"/>
</shared-library>

3. Update %ORACLE_HOME%\j2ee\oc4j_soa\application-deployments\default\MQSeriesAdapter\oc4j-ra.xml and add the oracle.mqseries shared library as follows: 
    <imported-shared-libraries>
    <import-shared-library name="oracle.bpel.common"/>
    <import-shared-library name="oracle.xml"/>
    <import-shared-library name="oracle.mqseries"/>
</imported-shared-libraries>

Unfortunately, this results in the adapter disappearing from AS Control (by navigating to oc4j_soa --> Applications --> default).

The correct configuration is described below.

Prerequisites
Must have a copy of com.ibm.mq.jar.

Details
1. Copy the com.ibm.mq.jar file to the shared library location (assumming your container name is oc4j_soa): 
%ORACLE_HOME%\j2ee\oc4j_soa\shared-lib\com.ibm.mq\6.0.2.4\com.ibm.mq.jar

2. Update %ORACLE_HOME%\j2ee\oc4j_soa\config\server.xml and add the following: 
<shared-library name="com.ibm.mq" version="6.0.2.4">
    <code-source path="com.ibm.mq.jar"/>
</shared-library>

3. Update %ORACLE_HOME%\j2ee\oc4j_soa\application-deployments\default\MQSeriesAdapter\oc4j-ra.xml accordingly: 
<imported-shared-libraries>
    <import-shared-library name="oracle.bpel.common"/>
    <import-shared-library name="oracle.xml"/>
    <import-shared-library name="com.ibm.mq"/>
</imported-shared-libraries>

4. Restart the oc4j_soa container.

Applicable Versions
Oracle SOA Suite 10g (10.1.3)

References
http://otndnld.oracle.co.jp/document/products/as10g/101310/doc_cd/integrate.1013/b28994/adptr_mq.htm#BGEJIDEF
Ahmed Aboulnaga
.com .com