IBM Problem Determination Tools for z/OS plug-ins Combined Packages (P2) README

Copyright statement

© Copyright IBM® Corporation 2012. All rights reserved. For legal information, see http://www.ibm.com/legal/copytrade.shtml

Contents

Overview

The IBM Problem Determination Tools plug-ins combined packages contain all of the individual product plug-ins in a single downloadable zip file. These single all-inclusive zip files make the initial installation and follow-on maintenance and functional updates easier than the previous individual product plug-in packages.

Hardware Requirements

The following minimum hardware levels are required:

Supported Platforms

One of the following levels of the Microsoft Windows operating system:

Software Requirements

One of the following Eclipse-based platforms:

NOTE: We recommend and support installation of the Problem Determination Tools plug-ins into either IBM Explorer for z/OS, CICS Explorer, or IMS Explorer. At your own risk, you can install the Problem Determination Tools plug-ins into an Eclipse 4.2.2, or later environment, as long as you also install CICS Explorer SDK V5.1.1.0, or later.

Any combination of one or more of the following IBM Problem Determination Tools for z/OS products:

Restrictions

IBM Application Performance Analyzer for z/OS plug-in does not install successfully into IBM IMS Enterprise Suite Explorer for Development.

Preparing to install IBM Problem Determination Tools plug-ins Combined Packages

It is highly recommended that you uninstall any pre-existing Problem Determination Tools plug-ins from your Eclipse environment. To check what software is installed and to uninstall:

  1. Click Help > About IBM CICS Explorer or Help > About IMS Enterprise Suite Explorer
  2. Click Installation Details
  3. Review the list of Installed Software and click Uninstall...

Installing IBM Problem Determination Tools plug-ins Combined Packages

Download and extract the zip file (PD_Tools_plugins_combined_P2_vxxxxxx.zip) for a local install. To install Problem Determination Tools plug-ins Combined Packages:

  1. Start CICS Explorer
  2. Click Help > Install New Software...
  3. In Install click Add...
  4. Click Local...
  5. Browse to and select the directory with the unzipped PDTools plugins
  6. In Install, you have the choice of selecting one or more individual plug-ins, or, selecting all of them. We recommend that you select all of them by clicking Select All. If, instead, you prefer to select individual plug-ins, the Problem Determination Tools Common Component must also be selected for installation. Note the restriction if installing into IBM IMS Enterprise Suite Explorer for Development.
  7. If you are installing Application Performance Analyzer, please see the installation notes below before proceeding.
  8. In Install Details, Click Next
  9. Review each of the License agreements, "I accept the terms of the license agreements", must be selected to continue, then click Finish
  10. The Installing Software dialog will appear
  11. If a "Security Warning" dialog appears, Click OK
  12. When the "Software Updates" dialog appears, Click Yes, to restart IBM CICS Explorer, to start using the PDtools plugins.
  13. When CICS Explorer has restarted, If IBM Problem Determination Tools Studio Branding was installed, the Welcome page will contain new content related to the PDTools plugins. Clicking one of the entries will display more information about the respective plugin.

Installation Notes for Application Performance Analyzer users:

  1. This package contains both the Application Performance Analyzer Version 12 plug-ins and the Application Performance Analyzer Version 13 plug-ins.
  2. Application Performance Analyzer for z/OS Version 12 requires the Application Performance Analyzer version 12 plug-ins. It is not forward compatible.
  3. Application Performance Analyzer for z/OS Version 13 requires the Application Performance Analyzer version 13 plug-ins. It is not backward compatible.
  4. Only one version of the APA plug-ins can be installed at once, not both.
  5. By default the Available Software window will have the option Show only the latest version of available software checked, and only the Application Performance Analyzer Version 13 plug-ins are displayed when the Application Performance Analyzer plug-in category is expanded.
  6. If you wish to install the Application Performance Analyzer Version 13 plug-ins, continue with the installation instructions at Step 8) above.
  7. If you wish to install the Application Performance Analyzer Version 12 plug-ins, you must:

Getting Started With IBM Problem Determination Tools plug-ins Combined Packages

After installing the plug-ins, follow the steps below for the plug-in(s) you are using:

Updating IBM Problem Determination Tools plug-ins Combined Packages

Download the zip file (PD_Tools_plugins_combined_P2_vxxxxxx.zip) for a local update. To add either source to the Available Software Sites:

  1. Click Window > Preferences
  2. In Preferences expand Install/Update
  3. Click Available Software Sites
  4. Click Add...
  5. Click Archive... and specify the zip file (PD_Tools_plugins_combined_P2_vxxxxxx.zip) for a local update, then click OK
  6. Click OK to go back to Preferences
  7. In Preferences click OK to close Preferences

To update the Problem Determination Tools plug-ins Combined Packages:

  1. Click Help > Check for Updates
  2. If there are any updates found, Available Updates will appear, click Select All
  3. Click Next
  4. In Install Details click Next
  5. Review and accept the terms in the license agreement, and then click Finish
  6. If the Security Warning dialog appears click OK
  7. Click Restart Now to successfully complete the update

Technical support

These IBM Problem Determination Tools plug-ins are available at no charge to all licensed users of any of the following five IBM Problem Determination Tools for z/OS products:

  1. IBM Application Performance Analyzer for z/OS V13.1, or later
  2. IBM Debug Tool for z/OS V13.1, or later
  3. IBM Fault Analyzer for z/OS, V12.1, or later
  4. IBM File Manager for z/OS V13.1, or later
  5. IBM Workload Simulator for z/OS & OS/390 V1.1, or later

These IBM Problem Determination Tools plug-ins are supplied under the standard terms and conditions of the IBM International Program License Agreement (IPLA) and of the associated License Information and other documentation, and provides a defect correction entitlement for those licensed users entitled to service for any of the IBM Problem Determination Tools for z/OS products listed above. Service is available for these plug-ins for as long as the IBM Problem Determination Tools for z/OS product which the plug-ins are to be used with are generally supported by IBM. In addition, IBM reserves the right to discontinue service on these plug-ins when they are withdrawn from marketing by IBM. Please reference the IBM Problem Determination Tool for z/OS product that you are using as the entitled product when contacting IBM and requesting support for IBM Problem Determination Tools Studio.