IBM TXSeries CICS 6.1.0.2 PTF README


IBM TXSeries CICS for AIX, HP-UX, Solaris and Windows Systems PTF README - Installation Instructions.

Copyright International Business Machines Corporation 2007. 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 TXSeries(R) for Multiplatforms Program Temporary Fix (PTF) is a collection of cumulative product patches and recent software fixes. This README file provides information about the prerequisites and installation procedures for TXSeries CICS(R) PTF for all supported platforms.

Note:
See READPTF_APAR_En_US.htm available in the PTF download page for a cumulative list of APARs that were fixed in this TXSeries CICS PTF and all the previous PTFs (if any) of TXSeries CICS 6.1 release till date. The cumulative list of APARs fixed will also be listed in the APARs.txt file present at installation_directory/etc. (Where installation_directory is the default installation directory described in Table 2.)

Contents

About this document
Important notes
Installing the TXSeries CICS PTF
Disk space and Operating system requirements for installing CICS
GUI mode installation procedure
Console mode installation procedure
Using silent installation for CICS
Uninstalling CICS PTF
GUI mode uninstallation procedure
Console mode uninstallation
Silent mode uninstallation procedure

Important notes

TXSeries CICS 6.1.0.0 is a prerequisite for this PTF.

For new TXSeries V6.1 users:

For existing TXSeries V6.1 users:

Installing the TXSeries CICS PTF

This section describes how to install the TXSeries CICS PTF for all supported platforms.

Before you start, note that the TXSeries for Multiplatforms Product Setup program requires a working directory for its resources. This directory is created in /tmp. The working directory can be as large as 100 MB. Therefore, ensure that enough space is available in /tmp. If the working directory is too small, the necessary resources cannot be set up and the installation process fails.

Note:
For the latest information about supported IBM and vendor acquired software for use with TXSeries, see "Supported IBM and Third-Party software for TXSeries" on the TXSeries requirements webpage at http://www.ibm.com/software/htp/cics/txseries/requirements.html.

Ensure that all CICS services that are on the machine are stopped. On Windows(R), TXSeries LWI Service also needs to be stopped prior to the installation of the PTF.

Disk space and Operating system requirements for installing CICS

The disk space required to install CICS must be available in the installation directory (shown in Table 1), where CICS binaries, libraries, messages, and associated files are installed. The table also lists the minimum level required for the supported operating systems.

Table 1. Disk space and OS version requirements for installing CICS PTF.
Platform Disk space required
AIX(R) 180 MB
Solaris 180 MB
HP-UX PA-RISC 325 MB
HP-UX on HP Integrity Platform 330 MB
Windows 170 MB

You can install CICS in two ways:

  1. GUI mode installation

    The graphical user interface installation process. This is described in GUI mode installation procedure.

  2. Console mode installation

    The console mode installation process. This is described in Console mode installation procedure. (You need to use this method of installation on Open Systems if you do not have X-server running on your machine.)

GUI mode installation procedure

To use the GUI to install CICS:

  1. Ensure that you are logged into your machine with super user (root) privileges.
  2. Access the location that contains the TXSeries CICS PTF installable image. (Image name will be TXSeries6102PTF<ptf number>-<platform>.bin for all unix platforms and TXSeries61PTF<ptf number> -windows.exe for windows.)
  3. Double-click the TXSeries CICS PTF installation file to access the Welcome screen.
  4. Click Next. The information dialog box is displayed; it enables you to back up your existing TXSeries installation.
  5. If you want to back up your existing TXSeries CICS installation before installing the PTF, ensure that the Backup Enabled check box is selected. Your existing TXSeries CICS installation is backed up in the <txseries _installed_location>/BACKUP directory. Ensure that enough space is available.

    It can take several minutes to perform the backup.

    Note:
    You are strongly recommended to back up your existing TXSeries installation. The PTF installation process does not automatically create a backup; if files are not backed up during the installation of the PTF, you cannot uninstall the patch at a later date.
  6. Click Next to continue. When the installation is complete, the Setup Complete window appears.
  7. Click Next to continue. TXSeries CICS PTF Readme Panel appears. Click Next to continue.
    Note:
    You can view the README file later from the <txseries_install_location>/docs directory.
  8. On the Setup Complete window, click Finish to complete the installation.

Console mode installation procedure

To use console mode to install CICS:

  1. Ensure that you are logged into your machine with super user (root) privileges.
  2. Enter this command at the prompt to start the console install: ./TXSeries61PTF<ptf number>-<platform>.bin -console

    Where platform is the name of your platform.

  3. Follow the instructions that are displayed on the screen. (The instructions listed in steps 4 through 8 of the GUI mode installation procedure will guide you in completing these tasks.)

Using silent installation for CICS

You can use the silent installation function to install TXSeries for Multiplatforms by specifying the installation options in a response file (called TXSeriesV61PTF<ptf number>.res, by default). Silent installation enables you to bypass the CICS Product Setup program, where you must manually click the installation options that you want. Silent installation is useful when you want to install the same configuration on multiple machines.

A default TXSeriesV61PTF <ptf number>.res file is supplied with TXSeries for Multiplatforms. It silently installs CICS at the default installation locations.

Uninstalling CICS PTF

This section describes how to remove CICS PTF software from your machine. If you are unfamiliar with the process of stopping regions and file managers, see the TXSeries for Multiplatforms Administration Guide.

To remove CICS PTF software from your machine:

  1. Ensure that you are logged into your machine with root privileges.
  2. Ensure that all CICS services that are on the machine are stopped.
  3. Uninstall CICS PTF by using GUI mode, console mode, or silent mode.

GUI mode uninstallation procedure

  1. Execute the following command from the installation_directory/_uninst_ptf directory: # ./uninstall_ptf.bin

    Where installation_directory is the default installation directory described in Table 2. (The uninstaller name will be uninstall_ptf.exe for windows).

  2. The CICS Product Setup program starts and the Removal Summary window appears on screen.
  3. Click Uninstall to begin uninstalling CICS.
  4. When uninstallation is complete, click Finish to close the window.

Console mode uninstallation

Execute the following command from the installation_directory/_uninst_ptf directory:# ./uninstall_ptf.bin -console

Where installation_directory is the default installation directory described in Table 2.

Silent mode uninstallation procedure

Execute the following command from the installation_directory/_uninst_ptf directory. # ./uninstall_ptf.bin -silent

Where installation_directory is the default installation directory described in Table 2.

Note:
The CICS PTF uninstallation process does not remove the CICS data directories and any user data in CICS install directory (described in Table 2).
Table 2. Location for CICS installation.
Platform Default Installation directory
AIX /usr/lpp/cics
HP-UX PA-RISC /opt/cics
HP-UX on HP Integrity Platform /opt/cics
Solaris /opt/cics
Windows C:\opt\cics