Installing IMS TM resource adapter service and updates

Service and updates are available as newer versions of the IMS™ TM resource adapter. Use the Update RAR function in the WebSphere® Application Server administrative console to install the new version of the IMS TM resource adapter.

Before you begin

Prerequisite:
  1. Check the IMS TM resource adapter V12 release notes. You can find a list of available updates and fixes and links to the release notes for other supported versions of the resource adapter.
  2. Download the new version (for all supported platforms). For z/OS®, you can also obtain the updates as APARs or PTFs.

About this task

To update the IMS TM resource adapter version without deleting and reconfiguring all existing connection factories, use the Update RAR function in the WebSphere Application Serveradministrative console and update the class path accordingly.

To install the new version:

Procedure

  1. In the WebSphere Application Server administrative console, click to expand ResourcesResource Adapters.
  2. Click Resource adapters.
  3. Click the check box to select the IMS TM resource adapter that you want to update and click Update RAR.
    Figure 1. Updating the RAR for new versions of the resource adapter
    This graphic shows the administrative console screen where the configured TM resource adapter to be updated is selected, with an Update RAR button on top. End figure description.
  4. In Step 1, Select either Local file system or Remote file system, and click Browse to navigate to where the new IMS TM resource adapter RAR file is. For example, on a local file system, the RAR file is located in install_path/IBM/IMS/ICOxx/Vxxxx/JCA15/imsxxxx.rar
  5. Click Next.
  6. In Step 2, verify the version numbers of the existing and the new resource adapters and click Next.
  7. In Step 3, configure any new properties introduced by the new version of resource adapter as prompted. Click Next.
  8. Confirm the changes in the summary step, and click Finish. You are returned to the Resource adapter page.
  9. Click the name of the resource adapter you updated.
  10. In the class path field under General Properties, update the RAR file name. For example, if you are upgrading to Version 12.1 of the IMS TM resource adapter, change the class path to: ${CONNECTOR_INSTALL_ROOT}/imsico1210.RAR
  11. Click OK. You are returned to the Resource adapter page.
  12. Click Save at the top of the page.
  13. Update the IMS TM resource adapter IVP EAR file by using the same approach if the EAR file is already deployed.
  14. Optionally, remove the old IMS TM resource adapter RAR files.
    • For distributed platforms, remove the installation directory at install_path/IBM/IMS/ICOxxx/Vxxxx.
    • For z/OS, remove the directory at install_path/Vxxxx.
    install_path is the target installation path and Vxxxx is the IMS TM resource adapter version that you want to remove.

Results

The IMS TM resource adapter RAR file is updated. All existing connection factories now use the new version of the RAR.