IBM WebSphere eXtended Transaction Runtime V1.0 Fix Pack 1 README

Copyright International Business Machines Corporation 2011. All rights reserved
US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

About this document

The IBM® WebSphere® eXtended Transaction Runtime (WXTR) V1.0 Fix Pack 1 is a collection of recent software fixes. This README file provides information on prerequisites and installation procedures for WXTR V1.0 Fix Pack 1.

Contents

Important notes
Installing IBM WXTR Fix Pack
Disk space and Operating system requirements for installing WXTR Fix Pack
Installing WXTR Fix Pack through the GUI mode
Installing WXTR Fix Pack through the Silent mode
Mandatory steps after installing WXTR Fix Pack
Uninstalling WXTR Fix Pack
Uninstalling WXTR Fix Pack through the GUI mode
Uninstalling WXTR Fix Pack through the Silent mode

Important notes

WebSphere eXtended Transaction Runtime V1.0 is a prerequisite for this Fix Pack.

This Fix Pack is a prerequisite for IBM WebSphere eXtended Transaction Runtime Feature Pack for Modernizing Oracle Tuxedo Applications.

For new WXTR users:

  1. WXTR V1.0 can be accessed through either of the following methods:
    Download the installable image of WXTR V1.0 from the Passport Advantage available in WXTR Support download Web page.
    OR
    Order and obtain the IBM WXTR V1.0 software CD-ROM.
  2. Install IBM WXTR V1.0.
  3. Install the Fix Pack using installation instructions provided in this document.

For existing WXTR users:

The following known issues have been resolved in this Fix Pack:

  1. CICS COBOL programs are not purged during a client timeout or client termination.
    Note: The Response timeout parameter can be set using the WebSphere Application Server (WAS) administration console.
    Any value changes made to the Response timeout parameter in WAS-WXTR configuration panel will come into effect only after the WAS is restarted.
    The Response timeout parameter can be used to set timeout value for CICS applications. You can access it through either of the following methods:
  2. Restarting the WXTR container might disable a COBOL application program.
  3. Repeated starting and stopping of the DB2 server may suspend running WXTR applications.
  4. Abends such as A16Y, and A146 fail to propogate abend codes back to the WXTR client program.

Installing WXTR Fix Pack

This section describes how to install the WXTR Fix Pack.

Note: For information on supported IBM and vendor-acquired software for use with WXTR, see View detailed requirements section on the WXTR system requirements page.

Disk space and operating system requirements for installing WXTR Fix Pack

The required disk space for the installation of WXTR Fix Pack must be available in the installation directory, where WXTR is installed. Table 1 lists the minimum space required and the minimum version of operating system supported.

Table 1. Minimum Disk space and minimum version of Operating System requirements for installing WXTR Fix Pack.
Operating System Operating System Version Disk space required
AIX AIX 6.1 TL2 50 MB

You can install WXTR Fix Pack using either of the following methods:

Installing WXTR Fix Pack through the GUI mode

Ensure the following:

You can update WXTR interactively using the Installation Manager. Launch the Installation Manager.

To update WXTR, complete the following steps:

  1. Add the WXTR repository to the repository preferences in Installation Manager.
  2. In the Installation Manager Start page, click Update.
  3. In the Update Package Group page, select the package group where you have installed WXTR. Click Next to continue.
  4. In the Update Packages page, select the version of WXTR that you want to update to. Click Next to continue.
  5. On the Licenses page, read the license agreement. If you agree to the terms of the license agreement, click I accept the terms of the license agreement and click Next to continue.
  6. In the Features Page, click Next.
  7. On the Summary page, review the options that you have selected before installing the WXTR package. If you need to modify the options on previous pages, click Back to make changes.
  8. Click Update to update the package. A progress indicator shows the percentage of the installation completed. A message confirms the successful completion of the installation process. Click View log file to open the installation log file for the current session in a new window. You must close the Installation Log window to continue.
  9. Click Finish to close the Installation Manager.

The logs for the Installation Manager session will be available in /var/ibm/InstallationManager/logs/.

Installing WXTR Fix Pack through the Silent mode

Ensure the following:

To install WXTR Fix Pack through the Silent mode, follow the instructions in the topic, Updating WebSphere eXtended Transaction Runtime silently in the WXTR Information Center at http://publib.boulder.ibm.com/infocenter/wxtformp/v1r0/index.jsp

Mandatory steps after installing WXTR Fix Pack

After the WXTR Fix Pack is installed, you need to complete the following steps:

Rebind the db2 bind files with DB2:

The db2 bind files are shipped along with the product and are located in the ${CICSPATH}/etc directory.
Run the following to rebind the db2 bind files with DB2:
db2 bind @cics101.bndlst
db2 bind @cics102.bndlst
db2 bind @cics37.bndlst
db2 bind @cics82.bndlst

Deploying the WXTR artifacts on WAS:

Log in as root user to deploy the WXTR artifacts.
To deploy the WXTR artifacts on WebSphere Application Server, run the following command:

#$CICSPATH/bin/deployCC.sh createRA

If the WAS administrative security is set, you need to provide the username and password. For example:

#$CICSPATH/bin/deployCC.sh createRA -u WAS_admin_user -p WAS_admin_password

where:
WAS_admin_user is the WebSphere Application Server administrative user
WAS_admin_password is the WebSphere Application Server administrative user's password

Uninstalling WXTR Fix Pack

This section describes how you can uninstall WXTR Fix Pack software from your workstation.

You can uninstall the WXTR Fix Pack using either of the following methods:

Uninstalling WXTR Fix Pack through the GUI mode

The rollback option in Installation Manager enables you to roll back packages to a previous version of the installation.

Ensure the following:

To roll back the package, complete the following steps:

  1. On the Start page, click Rollback.
  2. In the Rollback Package Group page, select the WAS package group and click Next.
  3. In the Rollback Package page, select the version of the WXTR that you want to roll back to. Click Next.
  4. Review the Summary Information and click Rollback.
  5. You will get a message indicating completion once the roll back is successful. Click Finish to exit the wizard.

The logs for the Installation Manager session will be available in /var/ibm/InstallationManager/logs/.

Uninstalling WXTR Fix Pack through the Silent mode

Ensure the following:

To uninstall WXTR Fix Pack through the Silent mode, follow the instructions in the topic, Roll back WebSphere eXtended Transaction Runtime silently in the WXTR Information Center at http://publib.boulder.ibm.com/infocenter/wxtformp/v1r0/index.jsp.