Release notes for CICS Explorer Version 5.1.1

Copyright statement

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 Contents

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 Contents

Downloading CICS Explorer

You can now use IBM Installation Manager to install CICS Explorer. For more information about installing CICS Explorer by using Installation Manager, see Installing the CICS Explorer 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:

Click the download link for the relevant operating system.
In the resulting dialog, select Save and save the compressed file to a temporary directory.
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 Contents

Downloading the CICS Explorer SDK

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 Contents

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 Contents

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 Contents

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 https://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 Contents