Readme for IBM CICS Explorer version 1.0.0.5

ProductCICS Explorer
Version1.0.0.5
Build ID201002151453
APARs IncludedIZ70464
Date Published26 Feb 2010

Abstract

Readme documentation for IBM CICS Explorer version 1.0.0.5 including installation instructions; prerequisites and co-requisites; and a list of fixes included.

Table of Contents

Additional Information

Additional information can be found included with the CICS Explorer. From within the CICS Explorer, click Help -> Help Contents to display the help for CICS Explorer.

Additional information on the CICS Explorer can also be found online at: CICS Explorer homepage. There are several links on there to extra information about the CICS Explorer including a link to video tutorials and podcasts on the CICS Explorer and CICS TS: System z Videos/Podcasts

See also the forums for the CICS Explorer and CICS Tools plug-ins for the CICS Explorer where information is posted, and questions can be posted.

About this Update

This update contains the following APAR fixes: IZ70464
More information on these APARs is displayed below:

APAR IZ70464
Problem Description

Release of CICS Explorer v1.0.0.5

Problem Summary

This APAR tracks the release of CICS Explorer version 1.0.0.5.

This update provides the following new functionality:

* Additional support for CICSPlex SM Workload Management
* Search for related tasks that have been started under the same network Unit of Work or Transaction Group ID.
* New Task Associations (TASKASSC) view
* Additional general documentation topics.

For more information on all these, search for "What's new in version 1.0.0.5" section in the CICS Explorer Help.

The following defects have also been fixed as part of this update:

6978 - Lack of Clarity on Action Confirm panel - targeted resource(s)
6980 - N/A indicates both N/A code & not valid for release which is confusing
7958 - Messages not appearing in status bar
8229 - Copy and Paste Transaction into an existing CSD Group tells me that the group does not exist
8233 - Perform Operation->Perform Copy Operation typo in message
9338 - Event Binding Editor export specification produces incorrect namespace with cbe format
9415 - CMAS Name attribute missing from Managed Region attributes
9466 - Managed Region attributes unsupported on older releases show as "?"
9519 - CICS Explorer connects multiple times with incorrect password causing user ID to become revoked
9521 - Validation error creating a TSQ backed DocTemplate
10236 - Trace menu item not available in Resource perspective
11043 - MAXWIN condition on Data Interface when MASes are slow

More InformationMore information on APAR IZ70464 can be found here

Prerequisites

None.

Co-requisites

None.

Installation Instructions

To install updates for the CICS Explorer, there are two options:

  1. Update the CICS Explorer from within the CICS Explorer, using the built in update-site.
    (http://download.boulder.ibm.com/ibmdl/pub/software/htp/cics/updates/explorer/).
  2. Or alternatively download a zipped version of the update-site and install it locally.
    (Known as an archive update-site).

An advantage of using the IBM-hosted update-site is that it is kept up-to-date with the latest version. Users can search for any available updates to the CICS Explorer periodically from within the CICS Explorer. They can choose if and when to install them at their convenience. Alternatively the user can choose to get the CICS Explorer to automatically search for updates and inform the user when they become available.

Otherwise updates can be downloaded on demand from Fix Central, but users will need to check the Fix Central website for any further updates available, and download them as appropriate. Fix Central: http://www.ibm.com/support/fixcentral/

Installation via the Update-Site

To update the CICS Explorer using the IBM-hosted update-site follow the instructions below:

  1. Launch the CICS Explorer
  2. Click Help on the CICS Explorer menu bar and click Software Updates in the drop-down menu. The Software Updates and Add-ons window is displayed.
  3. Click the Available Software tab.
  4. A link to the CICS Explorer update-site is included with the product by default, but to check if the update-site is present:
  5. If the update site is present as it should be, the following step can be skipped:
  6. To update the CICS Explorer select the Installed Software tab, and then click Update...
  7. If an update is available, an Update dialog box will appear to confirm the installation of the update. Click Finish.
  8. The CICS Explorer is then updated, and you'll be asked to restart to apply the changes. Click Yes to restart the CICS Explorer, once it has restarted it will now be up-to-date.

Installation via Fix Central

To update the CICS Performance Analyzer plug-in from Fix Central follow the instructions below:

  1. Launch the CICS Explorer
  2. Click Help on the CICS Explorer menu bar and click Software Updates in the drop-down menu. The Software Updates and Add-ons window is displayed.
  3. Click the Available Software tab.
  4. Click the Add Site button and in the Add Site dialog click the Archive button. The Repository archive dialog box is displayed.
  5. Locate and select the CICS Explorer zipped update-site file you downloaded previously, and click Open.
  6. Click OK in the Add Site dialog box. The dialog box closes and the tool is displayed in the Software Updates and Add-ons dialog box.
  7. To update the CICS Explorer select the Installed Software tab, and then click Update...
  8. If the CICS Explorer's version is earlier than the version of the CICS Explorer in the zip being downloaded, an Update dialog box will appear to confirm the installation of the update. Click Finish.
  9. The CICS Explorer is then updated, and you'll be asked to restart to apply the changes. Click Yes to restart the CICS Explorer, once it has restarted it will now be up-to-date.

Known Issues of this update

None.

Known Limitations of this update

Please read the known limitations with this update below to understand what is covered by this update.

Installing Remote Resources

You can not install remote resources using the CICS Explorer.

Column Sorting

The column sorting function is not enabled in the CICS Explorer.

Secured Eclipse Update-Sites

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, you should not select the option to save your password when prompted, because CICS Explorer does not provide a method for changing your password once set. If the password is not saved, then 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.

Problems on Ubuntu 9.10 and Fedora 12

A problem has been identified when running the CICS Explorer on the Linux platforms Ubuntu 9.10 and Fedora 12. These platforms are NOT supported by the IBM CICS Explorer, however there is a workaround that you can use if you want to use these unsupported platforms.

The problem relates to issues between the GTK and Mozilla releases and the SWT implementation in Eclipse 3.4.2 on which the CICS Explorer is currently based. The issue you might experience is that buttons in the CICS Explorer might not respond to mouse clicks, but will work from the keyboard.

The workaround is to launch the cicsexplorer executable from the shell script below:

#!/bin/bash
export GDK_NATIVE_WINDOWS=1
./cicsexplorer $*

As previously stated, the Linux platforms Ubuntu 9.10 and Fedora 12 are unsupported.

Change History

Below describes the changes made to the CICS Explorer since the beginning of the release.

1.0.0.5Fixed APAR(s): IZ70464
IZ70464Release of CICS Explorer v1.0.0.5
 More Information: http://www-01.ibm.com/support/docview.wss?uid=swg1IZ70464
1.0.0.4Fixed APAR(s): IZ66786
IZ66786Release of CICS Explorer v1.0.0.4
 More Information: http://www-01.ibm.com/support/docview.wss?uid=swg1IZ66786
1.0.0.3Fixed APAR(s): IZ65446
IZ65446Deleting a CICS TS Queue in the CICS Explorer deletes all TS Queues
 More Information: http://www-01.ibm.com/support/docview.wss?uid=swg1IZ65446
1.0.0.2Fixed APAR(s): IZ62254
IZ62254Release of CICS Explorer v1.0.0.2
 More Information: http://www-01.ibm.com/support/docview.wss?uid=swg1IZ62254
1.0.0.1Fixed APAR(s): IZ62213
IZ62213Release of CICS Explorer v1.0.0.1
 More Information: http://www-01.ibm.com/support/docview.wss?uid=swg1IZ62213
1.0.0.0General Release

Copyright and Trademark Information

http://www.ibm.com/legal/copytrade.shtml

Notices

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Microsoft, Windows, and Windows Server are trademarks of Microsoft Corporation in the United States, other countries, or both.

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Other company, product, or service names may be trademarks or service marks of others.

THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION

The license agreement for this product refers you to this file for details concerning terms and conditions applicable to third party software code included in this product, and for certain notices and other information IBM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided or referenced below. Please note that any non-English version of the licenses below is unofficial and is provided to you for your convenience only. The English version of the licenses below, provided as part of the English version of this file, is the official version.

Notwithstanding the terms and conditions of any other agreement you may have with IBM or any of its related or affiliated entities (collectively "IBM"), the third party software code identified below are "Excluded Components" and are subject to the following terms and conditions:

Document Change History

26 Feb 2010Initial version
Valid XHTML 1.0 Strict

Back to the top