IBM Problem Determination Tools Studio README

Copyright statement

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

Contents

Overview

IBM Problem Determination Tools Studio is a standalone Eclipse-based environment that provides workstation users with easy access to the power of the IBM Problem Determination Tools for z/OS family of products:

Hardware Requirements

The following minimum hardware levels are required:

Supported Platforms

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

Software Requirements

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

Installing IBM Problem Determination Tools Studio

To install Problem Determination Tools Studio:

  1. Download the installation zip file (PD_Tools_Studio_vxxxxxx.32bit.zip) from the IBM Problem Determination Tools Studio file repository
  2. Extract the contents of the zip file into a folder of your choice. Ensure that the directory you choose does not contain any other files

Getting Started With IBM Problem Determination Tools Studio

The following are some steps to get you started once you have installed the Problem Determination Tools Studio.

  1. Double-click the PD_Tools.exe file from where you extracted the install zip file
  2. Specify a workspace location for the Problem Determination Tools Studio. We recommend a new folder on your system
  3. The Problem Determination Tools Studio product will appear displaying its Welcome page. The Welcome page includes links to a basic overview and first steps to creating and managing your connections to host systems
    1. Click Overview
    2. Click any of the links on the left column to open any of the IBM Problem Determination Tools for z/OS plug-ins overview help content
    3. Click any of the links on the right column to open any of the IBM Problem Determination Tools for z/OS plug-ins
    4. The Problem Determination Tools Studio help documentation is integrated with the product. To display the help documentation, from the main menu bar, click Help > Help Contents. The help contents provide detailed help for all components of the offering, along with help for using Problem Determination Tools Studio with each of the individual Problem Determination Tools products. There is also basic help for:
      1. Eclipse (Workbench User Guide) - this is useful if you are new to using an Eclipse environment offering
      2. Problem Determination Tools for z/OS Common Component - contains help details on setting up your host connections
      3. z/OS Explorer User Guide - Contains details on the included z/OS perspectives and views as well as further information on managing your configuration and working with host data sets, JCL files, and submitting batch jobs to the host and viewing output
    5. Each of the IBM Problem Determination Tools for z/OS plug-in perspectives can be opened from Window > Open Perspective > Other...; their views can be opened from Window > Show View > Other....
  4. If you are using Application Performance Analyzer with Problem Determination Tools Studio, there is some connections/credentials setup that is unique to Application Performance Analyzer that must be performed because Application Performance Analyzer uses its own listener.
    1. Start the Problem Determination Tools Studio
    2. Click Window > Manage Connections
    3. Under Connections select Application Performance Analyzer, then click Add...
    4. In Add APA Connection enter the Host name and Port number of the APA listener, then click Save and Connect
    5. Once a connection is established, you will be asked to select the APA started task (STC) that you desire to connect to. Enter that started task.
    6. Create a credentials entry for yourself, with your user name and password (or it can be a passphrase if used on the machine).
  5. If you are using the Debug Tool DTCN function, you will need to establish a connection between the DTCN Profiles view for CICS and your z/OS system by following the steps described in DTCN tips.

Updating IBM Problem Determination Tools Studio

You can choose to update from the website or download the zip file (PD_Tools_Studio_update_xxxxxx.zip) for a local update. The Problem Determination Tools Studio is configured with a link to its repository. If the link to the repository is missing or incorrect, or you would like to use the update zip file, follow the steps below to add them to the Available Software Sites.

  1. Click Window > Preferences
  2. In Preferences expand Install/Update
  3. Click Available Software Sites
  4. Click Add...
  5. In Add Site enter the repository link ftp://public.dhe.ibm.com/software/htp/pdtools/studio/12.1/ in Location to update from the website, or click Archive... and specify the zip file (PD_Tools_Studio_update_xxxxxx.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 Studio:

  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 agreements, and then click Finish
  6. If the Security Warning dialog appears click OK
  7. Click Restart Now to successfully complete the update

Technical support

IBM Problem Determination Tools Studio is 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 V12.1, or later
  2. IBM Debug Tool for z/OS V12.1, or later
  3. IBM Fault Analyzer for z/OS, V12, or later
  4. IBM File Manager for z/OS V12.1, or later
  5. IBM Workload Simulator for z/OS & OS/390 V1.1, or later

IBM Problem Determination Tools Studio is 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 IBM Problem Determination Tools Studio for as long as the IBM Problem Determination Tools for z/OS product which IBM Problem Determination Tools Studio is to be used with is generally supported by IBM. In addition, IBM reserves the right to discontinue service on IBM Problem Determination Tools Studio when it is 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.