Readme for IBM CICS Explorer version 1.1.1.2

ProductCICS Explorer
Version1.1.1.2
Build ID
APARs IncludedIV19014, IV20931, IV24248
Date PublishedWed Aug 08 10:28:53 BST 2012

Abstract

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

Table of Contents

Additional Information

Additional information on the CICS Explorer 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: IV19014, IV20931, IV24248
More information on these APARs is displayed below:

APAR IV19014
Problem Description

SERVER ERROR DETAILS NOT EXPOSED TO EXPLORER STATUS BAR
Problem Summary

When a user encounters a connection error over CMCI, the XML error response back to the client is only logged to the CICS Explorer trace. This makes it harder to identify an incorrectly configured CMCI host. In this case, a "DFHWU4301" message would have assisted the user to identify this problem.

More Information More information on APAR IV19014 can be found here
APAR IV20931
Problem Description

SECURITY APAR
Problem Summary

Updates required in the bundled Eclipse Help System, Eclipse Rich Client Platform and Java(TM) Runtime Environment for security reasons.
More Information More information on APAR IV20931 can be found here
APAR IV24248
Problem Description

Insufficient trace in CICS Explorer code. JCL Save-As does not update the title of the editor.
Problem Summary

The CICS Explorer requires increased tracing capability for effective problem determination. When editing JCL files, using the Save As function does not update the editor title to reflect the name of the file.
More Information More information on APAR IV24248 can be found here

Prerequisites

None.

Co-requisites

None.

Installation Instructions

For APAR IV20931, this fixpack resolves a security risk by including an updated IBM Runtime Environment Java(TM) Technology Edition Version 6, bundled in the standalone versions of CICS Explorer.
This component cannot be updated using Eclipse updates and instead users can manually replace the runtime environment.
Users can do this by removing their CICS Explorer installation, replacing it with the latest version available from the the CICS Explorer downloads page at http://www.ibm.com/software/htp/cics/explorer/download/ and subsequently re-installing the plugins they use.
This does not require removal of the CICS Explorer workspace, usually in the user's home directory.

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

  1. Update the CICS Explorer from within the CICS Explorer using the IBM-hosted Update-Site.
    (http://download.boulder.ibm.com/ibmdl/pub/software/htp/cics/updates/explorer/1.1/latest/).
  2. Download the update from Fix Central to be installed locally into the CICS Explorer.
    (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/

Updating 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. Select Help->Check for Updates from the main menu.
  3. An update should be found for the CICS Explorer.
  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. Select Help -> Check for Updates from the main menu.
  7. If an update is available, an Update dialog box will appear to confirm the installation of the update. Click through the rest of the wizard.
  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 Explorer from Fix Central follow the instructions below:

  1. Download the update archive from FixCentral.
  2. Launch the CICS Explorer
  3. Click Window->Preferences.
  4. Select the Install/Update->Available Software Sites preferences
  5. Click the Add... button.
  6. Provide a name for the local update site
  7. Locate and select the CICS Explorer zipped update-site file you downloaded previously, and click Open.
  8. Click OK to exit the Add Site dialog.
  9. Click OK to exit the Preferences dialog.
  10. To update the CICS Explorer select Help -> Check for Updates from the main menu.
  11. 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 through the rest of the wizard.
  12. 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

None.

Change History

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

1.1.1.1Fixed APAR(s): IV21830
IV21830SERVICEABILITY CHANGES
 More Information: http://www-01.ibm.com/support/docview.wss?uid=swg1IV21830
1.1.1.2Fixed APAR(s): IV19014, IV20931, IV24248
IV19014ADDITIONAL MESSAGE DETAILS NOT EXPOSED TO EXPLORER STATUS BAR
 More Information: http://www-01.ibm.com/support/docview.wss?uid=swg1IV19014
IV20931SECURITY APAR
 More Information: http://www-01.ibm.com/support/docview.wss?uid=swg1IV20931
IV24248SERVICEABILITY APAR TO ADD Z/OS CONNECTION LOGGING.
 More Information: http://www-01.ibm.com/support/docview.wss?uid=swg1IV24248

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.

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.

Eclipse and the Eclipse logo are trademarks of Eclipse Foundation, Inc.

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

Wed Aug 08 10:28:53 BST 2012Initial version
Valid XHTML 1.0 Strict

Back to the top