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
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:
- 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.
- Install IBM WXTR V1.0.
- Install the Fix Pack using installation instructions provided in this document.
For existing WXTR users:
- Install the WXTR Fix Pack using the installation instructions provided
in this document.
The following known issues have been resolved in this Fix Pack:
- 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:
- The Administration Console by completing the following steps:
In the Navigation panel, select Servers > Server Types > WebSphere Application Servers and then choose the server name for which you want to view the WXTR container
settings.
- The wsadmin.sh utility
- Restarting the WXTR container might disable a COBOL application program.
- Repeated starting and stopping of the DB2 server may suspend running WXTR
applications.
- 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:
- Log in to the system as a root user
- Stop all WXTR and WAS processes running on the workstation and ensure that
the LANG environment variable is set to en_US in the /etc/environment file.
You can update WXTR interactively using the Installation Manager. Launch
the Installation Manager.
To update WXTR, complete the following steps:
- Add the WXTR repository to the repository preferences in Installation Manager.
- In the Installation Manager Start page, click Update.
- In the Update Package Group page, select the package group where you have
installed WXTR. Click Next to continue.
- In the Update Packages page, select the version of WXTR that you want to
update to. Click Next to continue.
- 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.
- In the Features Page, click Next.
- 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.
- 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.
- 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:
- Log in to the system as a root user.
- Stop all WXTR and WAS processes running on the workstation and ensure that
the LANG environment variable is set to en_US in the /etc/environment file.
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
- Deploying the WXTR artifacts on WAS
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:
- Log in to the system as a root user.
- Stop all WXTR and WAS processes running on the workstation and ensure that
the LANG environment variable is set to en_US in the /etc/environment file.
To roll back the package, complete the following steps:
- On the Start page, click Rollback.
- In the Rollback Package Group page, select the WAS package group and click
Next.
- In the Rollback Package page, select the version of the WXTR that you want
to roll back to. Click Next.
- Review the Summary Information and click Rollback.
- 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:
- Log in to the system as a root user.
- Stop all WXTR and WAS processes running on the workstation and ensure that
the LANG environment variable is set to en_US in the /etc/environment file.
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.