Preparing the deployment plan for WebSphere Application Server Community Edition

To deploy a resource adapter or an application on WebSphere® CE, you need to prepare a deployment plan. The deployment plan contains the definition of the IMS™ TM resource adapter and the dependency on the icu4j file.

About this task

The deployment plan is an XML file that contains the name of the associated artifact (IMSTMRA), which group it belongs to, and any dependency on other artifact it has.

The following is a sample resource adapter deployment plan.

Important: If you are using WebSphere CE Version 3.0 or later, ensure that you uncomment the three export-package lines as indicated in the sample deployment plan. If these lines remain commented, you would encounter multiple errors regarding invalid ConnectionSpec when trying to invoke the resource adapter.
<connector xmlns="http://geronimo.apache.org/xml/ns/j2ee/connector-1.2" 
  xmlns:dep="http://geronimo.apache.org/xml/ns/deployment-1.2" 
  xmlns:naming="http://geronimo.apache.org/xml/ns/naming-1.2">
  <dep:environment> 
    <dep:moduleId> 
      <dep:groupId>com.ibm.imsico</dep:groupId> 
      <dep:artifactId>IMSTMRA</dep:artifactId> 
      <!-- Specify the version of resource adapter that you use-->
      <dep:version>12.1.0</dep:version> 
      <dep:type>rar</dep:type> 
    </dep:moduleId> 
    <dep:dependencies> 
      <dep:dependency> 
        <dep:groupId>com.ibm.imsico</dep:groupId> 
        <dep:artifactId>icu4j</dep:artifactId> 
      </dep:dependency> 
    </dep:dependencies> 
    <!-- Uncomment these export-package lines when using WAS CE 3.0 or higher  -->
    <!-- <dep:export-package>com.ibm.connector2.ims.ico</dep:export-package>  -->
    <!-- <dep:export-package>com.ibm.ims.ico</dep:export-package> --> 
    <!-- <dep:export-package>commonj.connector.runtime</dep:export-package>  -->
  </dep:environment> 
  <resourceadapter>
    <resourceadapter-instance>
      <!-- Specify a name for the resource adapter  -->
      <resourceadapter-name>IMSTMRA</resourceadapter-name>
      <naming:workmanager>
        <naming:gbean-link>DefaultWorkManager</naming:gbean-link>
      </naming:workmanager>
    </resourceadapter-instance>

    <outbound-resourceadapter>
      <connection-definition>
        <connectionfactory-interface>javax.resource.cci.ConnectionFactory</connectionfactory-interface>
        <connectiondefinition-instance>
          <!-- Provide a JNDI name for your connection factory instance.  -->
          <!-- You would provide this name to the resource-link field in the -->
          <!-- resource-ref element of your Java EE module .  -->             
          <name>jca/myIMSTMRA</name>
          <!-- Modify host name, port number, and data store name for your environment.  -->            
          <config-property-setting name="HostName">your.ims.host.com</config-property-setting> 
          <config-property-setting name="PortNumber">9999</config-property-setting> 
          <config-property-setting name="DataStoreName">IMS1</config-property-setting> 
          <connectionmanager> 
            <!-- No Transaction is specified because IMS TM resource adapter does not support 2PC in WAS CE -->
            <!-- or other non-IBM server.  -->            
            <no-transaction/> 
            <!-- Connection pooling options-->
            <!-- Single pool is specified for connection pooling and reuse of connections. -->
            <!-- Modify connection pooling properties for your environment. -->
            <single-pool>
              <max-size>10</max-size> 
              <min-size>0</min-size> 
              <blocking-timeout-milliseconds>5000</blocking-timeout-milliseconds> 
              <idle-timeout-minutes>5</idle-timeout-minutes> 
              <select-one-assume-match /> 
            </single-pool>
          </connectionmanager> 
        </connectiondefinition-instance> 
      </connection-definition>
    </outbound-resourceadapter>
  </resourceadapter>

</connector>
You can download this sample deployment plan XML file by right-clicking here and select Save Link As (Mozilla Firefox) or Save Target As (Microsoft Internet Explorer).

Feedback