Release notes for IBM Explorer for z/OS V2.1 and IBM CICS Explorer Version 5.1.1

Main contents

Release notes for IBM Explorer for z/OS Version 2.1.0

Overview

The IBM Explorer for z/OS® Version 2.1.0 is an Eclipse-based tool that provides a framework to manage your system connections, and provide access to System z/OS functions.

Back to Top

System requirements and prerequisites

The z/OS Explorer system requirements are listed on the CICS Explorer® system requirements web page.

Back to Top

Downloading the z/OS Explorer

You must use IBM Installation Manager to install z/OS Explorer. For more information about installing z/OS Explorer by using Installation Manager, see Installing the CICS Explorer in the CICS® TS information center.

To install z/OS Explorer by using the Installation Manager launchpad, download the z/OS Explorer Installation Manager compressed file from the download page. Unpack the file into an empty folder, then open the disk1 folder.
  • If you have administrator access, double-click the launchpad executable file that is applicable to your operating system. Follow the prompts to install Installation Manager and z/OS Explorer.
  • If you do not have administrator access, locate the userinst executable file in the InstallationManager folder and subdirectory appropriate for your operating system. This userinst executable file enables a non-administrative user to install Installation Manager and z/OS Explorer.

To install z/OS Explorer by using an existing copy of Installation Manager, you must add the URL for the composite update site to the Installation Manager Preferences - Repositories page. The CICS Explorer download page contains the URL for the composite update site. Click the Install option in the Installation Manager wizard, and follow the prompts to install z/OS Explorer, or the CICS Explorer SDK.

Back to Top

Launching the z/OS Explorer

To launch the z/OS Explorer:
  • Windows: Click the zOS Explorer icon in the Start menu for your operating system.
  • Linux: Start zOS Explorer from your launcher.

Alternatively, on Windows, locate and double-click the file eclipse.exe in the location you specified to install z/OS Explorer.

Back to Top

Getting started

The z/OS Explorer help documentation is integrated with the product and includes instructions to configure a connection and use the z/OS features. To display thez/OS Explorer help, use one of the following methods:
  • From the welcome screen, click the Tutorials icon. The icon names are displayed when you hover over them.
  • From the main menu bar, click:Help > Help Contents > z/OS Explorer User Guide.

Back to Top

Release notes for CICS Explorer Version 5.1.1

What's new in this release?

CICS Explorer® Version 5.1.1 adds further enhancements:
  • Changes to the bundle deployment processing
  • Ability to install CICS Explorer by using Installation Manager.
  • Ability to copy and paste a fully qualified name.
  • Ability to create region types and CICS® region definitions in a platform project.
  • Ability to add CICS regions to a region type in an active platform.
  • Ability to remove CICS regions from a region type in an active platform.
  • Ability to view CICS regions and CICS bundles in a region type in a platform.
  • Ability to edit a CICS Platform project, CICS Application project, or CICS Application Binding project.
  • Ability to edit an application definition.
  • Ability to include OSGi applications in a CICS bundle.
  • Support for additional national languages.
  • In the Console view, job entries are now shown as hyperlinks. You can follow a hyperlink from a job id to the completed or running job.
  • A new option to copy a fully qualified name is added to the Data Sets view, Jobs view, and z/OS® UNIX Files view.

The What's New topics in the CICS Explorer help documentation describes the new and changed items in more detail. To display the topics, click Help > Help Contents.

For more information about installing CICS Explorer by using Installation Manager, see Installing the CICS Explorer in the CICS TS information center.

Before you upgrade to CICS Explorer Version 5.1.1, it is advisable to take a backup of your CICS Explorer workspace so that you can use it to restore the workspace to a previous version. When you upgrade to CICS Explorer Version 5.1.1, the data that is stored in your existing workspaces is automatically migrated to the new data format when those workspaces are used with CICS Explorer Version 5.1.1. The workspaces will no longer work with CICS Explorer Version 5.1.0. Therefore, if you need to work with CICS Explorer Version 5.1.0, you must back up your existing workspace before you upgrade. For more information about taking a backup of the CICS Explorer workspace, see Installing the CICS Explorer in the CICS TS information center.

Back to Top

System requirements and prerequisites

The CICS Explorer system requirements are listed on the CICS Explorer system requirements web page.

Before you upgrade to CICS Explorer Version 5.1.1, it is advisable to take a backup of your CICS Explorer workspace so that you can use it to restore the workspace to a previous version. When you upgrade to CICS Explorer Version 5.1.1, the data that is stored in your existing workspaces is automatically migrated to the new data format when those workspaces are used with CICS Explorer Version 5.1.1. The workspaces will no longer work with CICS Explorer Version 5.1.0. Therefore, if you need to work with CICS Explorer Version 5.1.0, you must back up your existing workspace before you upgrade. For more information about taking a backup of the CICS Explorer workspace, see Installing the CICS Explorer in the CICS TS information center.

Note: There are some changes to the way that Platform and Application bundles are processed in CICS Explorer v5.1.1. As a result, you must ensure that you have APAR PM81540 installed on your CICS system, otherwise the bundle deployment fails.

Similarly, if you are using a Liberty JVM server, then you must ensure that you have APAR PM80214 installed on your CICS system.

Back to Top

Downloading CICS Explorer

Note: You can now use IBM Installation Manager to install CICS Explorer. To install CICS Explorer by using Installation Manager, do not use the following procedure. Instead, see Installing CICS Explorer with IBM Installation Manager in the CICS TS information center.

To develop a third-party application to run as a plug-in in CICS Explorer, you must download the CICS Explorer SDK and install it into an existing Eclipse environment. For details, see Downloading the CICS Explorer SDK.

To download CICS Explorer, select the CICS Explorer files for your operating system:
For the Windows operating system
Download the .zip file.
For the Linux operating system
Download the .tar.gz file.
To download the CICS Explorer compressed file for Windows or Linux:
  1. Click the download link for the relevant operating system.
  2. In the resulting dialog, select Save and save the compressed file to a temporary directory.
  3. When the download is complete, extract the contents of the compressed file to a suitable writable directory. Ensure that the directory you choose does not contain any other files.
    An example directory on Windows is as follows:
    C:\Program Files\Explorer
    An example directory on Linux is as follows:
    ~/Explorer

Back to Top

Downloading the CICS Explorer SDK

Note: You can now use IBM Installation Manager to install CICS Explorer. To install CICS Explorer by using Installation Manager, do not use the following procedure. Instead, see Installing CICS Explorer with IBM Installation Manager in the CICS TS information center.

The CICS Explorer SDK must be installed into an existing Eclipse environment.

To download the CICS Explorer SDK compressed file:
  • Click the CICS Explorer SDK download link.
  • Save the .zip file in a temporary directory on your workspace, for example, C:\temp on Windows, or your home directory on Linux. Do NOT unzip the file.
  • Install the CICS Explorer SDK into your Eclipse environment.

Back to Top

Launching CICS Explorer

To launch CICS Explorer, double-click the file cicsexplorer.exe (cicsexplorer on Linux), located in a subdirectory called CICS_Explorer. The first time CICS Explorer starts, the welcome screen is displayed.

Back to Top

Getting started

The CICS Explorer help documentation is integrated with the product and includes a basic tutorial and instructions to configure a connection. To display the CICS Explorer basic tutorial, use one of the following methods:
  • From the welcome screen, click the Tutorials icon. The icon names are displayed when you hover over them.
  • From the menu bar, click Help > Help Contents > CICS Explorer User Guide > Getting Started > Basic tutorial.

Back to Top

Known issues and limitations

The following limitations exist in CICS Explorer Version 5.1.1:
  • Important: It is a limitation of Eclipse that before you can revert to a previous version of CICS Explorer, you must have access to an update site that contains the source code for the previous level. You can download the update site source code from the IBM Fix central web site, located at http://www.ibm.com/support/fixcentral.
  • The Eclipse software update function does not fully support Eclipse Update-Sites secured with HTTP Basic Authentication. If you are connecting to an Eclipse update site that prompts for a username and password, do not select the option to save your password when prompted, because CICS Explorer does not provide a method to change your password after it is set. If the password is not saved, it must be entered each time the CICS Explorer connects to the update site. If a password is saved and subsequently needs changing, manual editing of configuration files would be required.
  • If you are running CICS Explorer SDK on Windows 7, with Java™ 7, and the windows firewall enabled, the following error might occur:
    java.net.SocketException: Connection reset
    You can use one of the following methods to resolve the issue:
    • Use Java 6
    • Add a firewall exception for the Java binary
    • Add the following vm arg to your eclipse.ini file:
      -Djava.net.preferIPv4Stack=true
      .

Back to Top