README for IBM Debug Tool Plug-in for Eclipse V11.1.0.1

Copyright statement

(C) Copyright IBM® Corporation 2011. All rights reserved. For legal information, see http://www.ibm.com/legal/copytrade.shtml

Contents

System requirements and prerequisites

The following minimum hardware levels are required to run the CICS Explorer and are therefore applicable to Debug Tool Plug-in for Eclipse V11.1.0.1:
  • CPU - Intel® Pentium® 4 or equivalent.
  • RAM - 768 MB in addition to the operating system requirements.
  • Hard disk - 500 MB available space.
One of the following levels of Windows operating system software is required to install the CICS Explorer and is therefore applicable to Debug Tool Plug-in for Eclipse V11.1.0.1:
  • Microsoft Windows 7 32-bit
  • Microsoft® Windows® XP 32-bit
  • Microsoft Windows Vista 32-bit
  • Microsoft Windows Server 2003 32-bit
  • Microsoft Windows Server 2008 32-bit
The following levels of software required to install the Debug Tool Plug-in for Eclipse V11.1.0.1:
  • One of the following Eclipse-based platforms:
    • CICS Explorer (for Windows) V1.1.0.0, or later
    • IMS Explorer (for Windows) V2.1.0.0, or later
  • Debug Tool for z/OS Version 9.1 or later

The Debug Tool Plug-in for Eclipse V11.1.0.1 is available in the following national languages:

  • English
  • Japanese
  • Korean

Back to Contents

Downloading Debug Tool Plug-in for Eclipse V11.1.0.1

The Debug Tool Plug-in for Eclipse V11.1.0.1 can be downloaded from the Problem Determination Tools Plug-in website. The download file is called DT_plugin_v11100.zip.

Back to Contents

Installing Debug Tool Plug-in for Eclipse V11.1.0.1 into CICS Explorer

The following steps are required in order to install the Debug Tool Plug-in for Eclipse V11.1.0.1 into CICS explorer.

  1. Extract all the contents of DT_plugin_V11101.zip to any writable directory of your choice, for example, C:/DebugTool.
  2. Start CICS Explorer.
  3. In the action bar click "Help" -> "Install New Software".
  4. If a previous version of the Debug Tool Plug-in is installed, click on "already installed" to display the list of current plugins. Select the existing "IBM Debug Tool Plugin for Eclipse", "Debug Perspective for Eclipse", and any DTCN or DTSP plugins (if previously installed), click "Uninstall" then "Finish". Allow CICS Explorer to restart.
  5. Click "Add".
  6. An "Add Respository" window should open.
  7. Click "Local".
  8. Navigate to the directory storing the extracted files.
  9. Click "OK".
  10. Click "OK".
  11. CICS Explorer displays a list of features you can install. Select the "IBM Debug Tool Plug-in -> IBM Debug Tool Plug-in for Eclipse", the "IBM Debug Tool Plug-in -> Debug Perspective for Eclipse 3.6" and (optionally) one of the DTCN and DTSP Plug-ins for Debug Tool (depending on the installed version of Debug Tool).
  12. Click "Next".
  13. Click "Next".
  14. Accept the feature license agreement and click "Finish". There may be a security warning for unsigned content. Click "OK" if this message appears.
  15. CICS Explorer installs the Debug Tool Plug-in for Eclipse V11.1.0.1. You will be asked if you want to restart CICS Explorer. Click "Restart Now"

After CICS Explorer restarts, read "Getting Started Using Debug Tool Plug-in for Eclipse V11.1.0.1" for instructions on how to display the "Getting Started" help topic, which has instructions on how to start debugging your applications.

Back to Contents

Installing Debug Tool Plug-in for Eclipse V11.1.0.1 into IMS Explorer

The following steps are required in order to install the Debug Tool Plug-in for Eclipse V11.1.0.1 into IMS explorer.

  1. Extract all the contents of DT_plugin_V11101.zip to any writable directory of your choice, for example, C:/DebugTool.
  2. Start IMS Enterprise Suite Explorer.
  3. In the action bar click "Help" -> "Install New Software".
  4. If a previous version of the Debug Tool Plug-in is installed, click on "already installed" to display the list of current plugins. Select the existing "IBM Debug Tool Plugin for Eclipse" and any DTCN or DTSP plugins (if previously installed), click "Uninstall" then "Finish". Allow IMS Explorer to restart.
  5. Click "Add".
  6. An "Add Respository" window should open.
  7. Click "Local".
  8. Navigate to the directory storing the extracted files.
  9. Click "OK".
  10. Click "OK".
  11. IMS Enterprise Suite Explorer displays a list of features you can install. Select the "IBM Debug Tool Plug-in -> IBM Debug Tool Plug-in for Eclipse", and (optionally) one of the DTCN and DTSP Plug-ins for Debug Tool (depending on the installed version of Debug Tool). Do not install "IBM Debug Tool Plug-in -> Debug Perspective for Eclipse 3.6".
  12. Click "Next".
  13. Click "Next".
  14. Accept the feature license agreement and click "Finish". There may be a security warning for unsigned content. Click "OK" if this message appears.
  15. IMS Enterprise Suite Explorer installs the Debug Tool Plug-in for Eclipse V11.1.0.1. You will be asked if you want to restart IMS Enterprise Suite Explorer. Click "Yes".

After IMS Explorer restarts, read "Getting Started Using Debug Tool Plug-in for Eclipse V11.1.0.1" for instructions on how to display the "Getting Started" help topic, which has instructions on how to start debugging your applications.

Back to Contents

Getting Started Using Debug Tool Plug-in for Eclipse V11.1.0.1

The topic "Getting started" describes the steps you must do to start debugging your applications with the Debug Tool Plug-in for Eclipse V11.1.0.1. To open that topic:
  1. In CICS Explorer or IMS Explorer, click "Help" -> "Help Contents".
  2. Expand "Debug Tool Plug-in for Eclipse".
  3. Click "Getting started".

You can find more information on how to use Debug Tool Plug-in for Eclipse V11.1.0.1 in the help of CICS Explorer or IMS Explorer. Click "Help" -> "Help Contents". Expand the topic "Debug Tool for z/OS client for Eclipse".

Back to Contents

Restrictions and limitations

CICS Explorer displays, by default, the Outline View, but you cannot use this view. You can close the view.

Back to Contents

Technical Support

This plug-in is available at no charge to all licensed users of IBM Debug Tool for z/OS V9, or later. It 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 IBM Debug Tool for z/OS V9, or later. Service is available for this plug-in for as long as the IBM Debug Tool for z/OS product with which the plug-in is to be used is generally supported by IBM. In addition, IBM reserves the right to discontinue service on this plug-in when it is withdrawn from marketing by IBM. Please reference "IBM Debug Tool for z/OS" as the entitled product when contacting IBM and requesting support for this plug-in.