Readme for IBM CICS Explorer version 1.0.0.7

ProductCICS Explorer
Version1.0.0.7
Build ID201007091330
APARs IncludedIZ79765
Date Published15 Jul 2010

Abstract

Readme documentation for IBM CICS Explorer version 1.0.0.7 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: IZ79765
More information on these APARs is displayed below:

APAR IZ79765
Problem Description

Release of CICS Explorer v1.0.0.7

Problem Summary

This APAR tracks the release of CICS Explorer version 1.0.0.7.

This update provides the following new functionality:

* A new Preferences Credentials page has been added for recording user IDs and passwords.
* You can now configure the CICS Explorer to use a proxy server when connecting to the internet.
* Ability to disable a JVM server using the options PHASEOUT, PURGE, FORCEPURGE, or KILL.
* Changes to the Preferences Connections view to use credentials instead of user ID and password.
* One new Operations view and two new Administration views are added.
* Support for Microsoft® Windows® 7 32 bit.

For more information on the new updates search for "What's new in version 1.0.0.7" section in the CICS Explorer Help.

APAR IZ76428 has also been fixed by this update. A summary of the problem is below, but see that APAR for more detailed information.

IZ76428 concerned not being able to access resources in an SMSS region where it's APPLID contained a '#' character in it due to its special meaning in a URL. This update fixes it by URL-encoding the APPLID in the CMCI request to avoid the problem.

Note: The fix for IZ76428 requires a corresponding fix to CICS TS 4.1 in order for it to work. This is APAR PM15358. More information on this can be found in both IZ76428 and PM15358.

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

1187: All RegionGroupDefinitions are incorrectly nested beneath all RegionGroupDefinitions in the CICSplex Repositories View when using a Data connection
6117: Group List Definitions window needs a deselect option
6121: multiple selections in Group List Definitions view has no affect
6159: Error msg if CSD is OPEN = CNX0220E Connection Error TABLEERROR DATAERROR, should be returning the Error Code (CSD error)
6175: Selecting a CICS System group as the SCOPE in the CICSplexRepositories view is broken - Regression
6180: Create of an invalid new CSD resource via the Explorer returns inadequate error
6223: CSDLIST and CSDGROUP navigation tree is not available to SMSS users
7022: INSTALL failures in CREATE cmd not properly returned in CNX msg
7436: Error numbers should translate to text
9447: "CNX0222W Warning threshold" set message not always displayed
9522: Cannot create a URIMAP that points to a document template
10617: Accessibility issue with N/A values
10665: Unable to modify WLM target status in absence of routing region(s)
10721: CICS Explorer and FEPI... is it supported at all?
10772: Error handling in ResourceDefinitionEditor causing an IndexOutOfBoundsException in ExceptionMessageHelper
11603: Documented Search of CICS V4r1 InfoCenter fails with "I/O exception during search"
12248: NPE after trying to issue a CSDLOCK on a CSD GROUP or CSD LIST
12755: Event Binding Editor hang importing a language structure
12898: Various errors in 'Export to System z USS' dialog
12972: UI elements to be hidden for RDz
13046: errors logged opening SM perspective when rdz filtering is active
13121: CICS Explorer and RDz shell sharing issues
13142: Broken API in use by RDz
13589: INVOKE SERVICE URIMAP filter value field does not accept the full set of valid characters for URIMAP names
13595: Character filter value error does not refresh when changing codepage
13602: CICSplex Explorer Workload Routers list of regions incorrect when multiple instances of Workload
13956: Check "Go to Explorer icon" in doc
13995: The Help-About IBM Rational Developer for System z  cannot be opened
14171: openrelated actions expose resources outside RDz subset
14751: Empty codepage attribute on datafilter tag in Event Binding
14822: Explorer is not collecting 'folder path' correctly when export to HFS
14928: Help description for Error message CNX0222W is inconsistent with the Error
14947: Undocumented message: CNX0597E: Attribute Name (NAME) Error(PROGDEF_INV_DATA) RESP(DUPRES) RESP2(1)
14962: Column titles need updating on TS Queue views
14994: Incorrect terminology in Export Bundle dialog
15154: Precision spinner in the Application Data Predicate window doesn't refresh the validation
15197: Can't open a CICS object editor on 2 resources with matching key attributes from different contexts
15210: When Explorer is restarted an SM connection is attempted regardless of the active perspective
15248: Credential / Conn may be lost when changing name
15320: CNX0624E error not documented
15401: Deletion of disconnected connection leaves trim widget blank or with invalid name
15403: URIMAP application command option on INVOKE SERVICE does not work in information sources
15489: Minor changes to enhance CNX0106E

More InformationMore information on APAR IZ79765 can be found here

Prerequisites

The following prerequisites are required to be installed before installing this update.

CICS TS 4.1PM08661

APAR PM08661 is required to use the new JVM server Disable actions: PHASEOUT, PURGE, FORCEPURGE, and KILL.

CICS TS 4.1PK94205

APAR PK94205 is required to be installed on CICS TS 4.1 in order to install a bundle using the new HTTP Event Processing adapter.

Bundles can be created in the CICS Explorer using the new HTTP Event Processing adapter without PK94205 being first applied on the target system, however that bundle won't be able to be installed into the CICS TS 4.1 region until PK94205 has been applied.

Co-requisites

The following co-requisites are required to be installed alongside this update.

CICS TS 4.1PM15358

APAR PM15358 is required to be installed on CICS TS 4.1 in order to fix the CICS Explorer problem reported by APAR IZ76428 which this update addresses.

This issue affects connecting to SMSS regions with an APPLID containing special characters such as '#'. Before this update and the CICS TS APAR regions with special characters were unable to be accessed successfully from the CICS Explorer.

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

Please read the known issues with this update below to make sure this update is appropriate in your environment.

Installing Remote Resources

You can not install remote resources using the CICS Explorer.

CICS Explorer Help

You can set your help search scope to search the CICS TS 4.1 information center. Setting the search scope to include previous version of the CICS TS information centers is not supported and might cause errors.

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.

Known Limitations of this update

None.

Change History

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

1.0.0.7Fixed APAR(s): IZ79765
IZ79765Release of CICS Explorer v1.0.0.7
 More Information: http://www-01.ibm.com/support/docview.wss?uid=swg1IZ79765
1.0.0.6Fixed APAR(s): IZ74916
IZ74916Release of CICS Explorer v1.0.0.6
 More Information: http://www-01.ibm.com/support/docview.wss?uid=swg1IZ74916
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

15 Jul 2010Initial version
Valid XHTML 1.0 Strict

Back to the top