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

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.4:
  • 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.4:
  • 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.4:
  • 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.4 is available in the following national languages:

  • English
  • Japanese
  • Korean

The following levels of software required to install the DTCN and DSTP plug-ins:
  • 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
    • Rational Developer for System z V8.0.3.1, or later
  • Debug Tool for z/OS Version 9.1 or later

Back to Contents

Downloading Debug Tool Plug-in for Eclipse V11.1.0.4

The IBM Debug Tool Plug-in for Eclipse V11.1.0.4 can be downloaded from the Problem Determination Tools Plug-in website. Then follow the IBM Debug Tool Plug-in for Eclipse link to the download page. The download file is called DT_plugin_v11104.zip.

Back to Contents

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

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

  1. Extract all the contents of DT_plugin_v11104.zip to any writable directory of your choice, for example, C:\DebugTool.
  2. Delete any com.ibm.pdt.debugtool.profile_*.jar file(s) inside of CICS_Explorer_install_directory\dropins folder.
  3. Start CICS Explorer.
  4. In the action bar click "Help" -> "Install New Software".
  5. 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 3.6" and any DTCN or DTSP plugins (if previously installed), click "Uninstall" then "Finish". Allow CICS Explorer to restart. Once CICS Explorer has restarted, select "Help" -> "Install New Software" again.
  6. Click "Add".
  7. An "Add Repository" window should open.
  8. Click "Local".
  9. Navigate to the directory storing the extracted files.
  10. Click "OK".
  11. Click "OK".
  12. 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" (if the Debug Perspective has not previously been installed) and (optionally) one of the DTCN and DTSP Plug-ins for Debug Tool (depending on the installed version of Debug Tool).
  13. Click "Next".
  14. Click "Next".
  15. Accept the feature license agreement and click "Finish". There may be a security warning for unsigned content. Click "OK" if this message appears.
  16. CICS Explorer installs the Debug Tool Plug-in for Eclipse V11.1.0.4. 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.4" 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.4 into IMS Explorer

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

  1. Extract all the contents of DT_plugin_v11104.zip to any writable directory of your choice, for example, C:\DebugTool.
  2. Start IMS 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. Once IMS Explorer has restarted, select "Help" -> "Install New Software" again.
  5. Click "Add".
  6. An "Add Repository" window should open.
  7. Click "Local".
  8. Navigate to the directory storing the extracted files.
  9. Click "OK".
  10. Click "OK".
  11. IMS 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 Explorer installs the Debug Tool Plug-in for Eclipse V11.1.0.4. 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.4" 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 DTCN and DTSP Plug-in for Eclipse V11.1.0.4 into Rational Developer for System z

The following steps are required in order to install the DTCN and DTSP Plug-in for Eclipse V11.1.0.4 into Rational Developer for System z.

  1. Extract all the contents of DT_plugin_v11104.zip to any writable directory of your choice, for example, C:\DebugTool.
  2. Delete any com.ibm.pdt.debugtool.profile_*.jar file(s) inside of C:\Program Files\IBM\SDP\plugins and C:\Program Files\IBM\SDP\dropins folder.
  3. Start Rational Developer for System z.
  4. In the action bar click "Help" -> "Install New Software".
  5. If a previous version of the DTCN and DTSP Plug-in is installed, click on "already installed" to display the list of current plugins. Select the existing DTCN and DTSP plugin (if previously installed), click "Uninstall" then "Finish". Allow Rational Developer for System z to restart. Once Rational Developer for System z has restarted, select "Help" -> "Install New Software" again.
  6. Click "Add".
  7. An "Add Repository" window should open.
  8. Click "Local".
  9. Navigate to the directory storing the extracted files.
  10. Click "OK".
  11. Click "OK".
  12. Rational Developer for System z displays a list of features you can install. Select only one of the DTCN and DTSP Plug-ins for Debug Tool (depending on the installed version of Debug Tool). Do not select IBM Debug Tool Plugin for Eclipse.
  13. Click "Next".
  14. Click "Next".
  15. Accept the feature license agreement and click "Finish". There may be a security warning for unsigned content. Click "OK" if this message appears.
  16. Rational Developer for System z installs the DTCN and DTSP Plug-in for Eclipse V11.1.0.4. You will be asked if you want to restart Rational Developer for System z. Click "Restart Now"

Back to Contents

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

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.4. 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.4 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.