Readme for IBM CICS Configuration Manager Plug-in for CICS Explorer version 2.1.0.4

ProductCICS Configuration Manager Plug-in
Version2.1.0.4
Build ID200911270230
APARs IncludedIZ66788
Date Published18 Dec 2009

Abstract

Readme documentation for IBM CICS Configuration Manager Plug-in for CICS Explorer version 2.1.0.4 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 Configuration Manager plug-in. From within the CICS Explorer, click Help -> Help Contents to display the help for CICS Configuration Manager. Select CICS CM Plug-in User Guide from the contents tree in the left-hand pane.

Additional information on this product can also be found online at: CICS Configuration Manager homepage and the announcement letter which details capabilities of the CICS Configuration manager plug-in.

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: IZ66788

More information on these APARs is displayed below:

APAR IZ66788
Problem Description

Release of CICS Configuration Manager Plug-in v2.1.0.4

Problem Summary

This APAR tracks the release of update 2.1.0.4 of the IBM CICS Configuration Manager plug-in for the CICS Explorer.

This update provides the following new functionality:

* Search History for Configurations and Groups.
  More Information: Search for "Searching for history" in the CICS Configuration Manager plug-in Help.
* Install Groups if you have a CICSPlex® SM connection.
  More Information: Search for "Installing a group" in the CICS Configuration Manager plug-in Help.
* Install CSD definitions if you have a CICSPlex SM or CMCI connection.
  You can now install CSD definitions if you have a CICSPlex SM or CMCI connection.

For more information on all these, search for "What's new in V2.1.0.4" section in the CICS CM plug-in Help.

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

1422: Add resource to group: unable to debug problem from error message
6050: Search Dialog won't expand to include context help
8670: Date value section in CM Search options doesn't show widgets correctly (Linux)
8694: Can select more than one group in CM Search History
8703: Cannot select check sum on compare of 2 definitions
8836: CM Search History: Need hover help for Groups
8838: History view menu > Select Filters - menu should be in alpha order
8839: History view menu > Select Filters > Type - pull-down should be in alpha order
8664: Cannot see all options in the filter panel

This update also adds the IBM hosted Eclipse Update-Site as part of the plug-in to allow users to more easily search for updates to the plug-in when they choose.

More InformationMore information on APAR IZ66788 can be found here

Prerequisites

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

CICS Explorer1.0.0.4 or later

The CICS Explorer needs to be at this version before this Configuration Manager plug-in update can be installed.

For existing CICS Explorer downloads make sure the version is at least 1.0.0.4 by clicking Help -> About IBM CICS Explorer. It should state the version to be 1.0.0.4 or higher, if not your CICS Explorer installation will need to be updated.

The CICS Explorer by default includes a link to its update-site (http://download.boulder.ibm.com/ibmdl/pub/software/htp/cics/updates/explorer/). If it's there you can just update it by selecting Help -> Software Updates... and on the "Installed Software" tab, click on "Update...". It should then find an Update for the CICS Explorer. If so, install it, restart when prompted and then install this CICS Configuration Manager plug-in as normal.

If there was not an update for the CICS Explorer and your version is less than 1.0.0.4 make sure the default update-site is present in the CICS Explorer. You can do this by selecting Help -> Software Updates... from the main menu. Click the "Available Software" tab and click the "Manage Sites..." and the update-site should normally be there, if not, add it manually by clicking "Add Site...". Once that's done retry updating the CICS Explorer and the update should be found.

Co-requisites

None.

Installation Instructions

To install the CICS Configuration Manager plug-in, there are two options:

  1. Add the IBM-hosted CICS Configuration Manager plug-in update-site to the CICS Explorer and install it from there: http://download.boulder.ibm.com/ibmdl/pub/software/htp/cics/updates/cm/.
  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 Configuration Manager plug-in periodically 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 Configuration Manager plug-in 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. The first time an update or install of the CICS Configuration Manager plug-in is done the update-site needs to be added to the CICS Explorer. On subsequent updates the following step can be skipped.
  5. On an initial install of the CICS Configuration Manager plug-in only: Select the check-box alongside the tool name, and click Install...
  6. Alternatively to update an existing CICS Configuration Manager plug-in installation select the Installed Software tab, and then click Update...
  7. If an update is available for the CICS Configuration Manager plug-in, an Update dialog box will appear (for a new install an Install dialog will appear). Confirm the installation by clicking Finish.
  8. The CICS Configuration Manager plug-in is then installed/updated, and you'll be asked to restart to apply the changes. Click Yes to restart the CICS Explorer with the CICS Configuration Manager plug-in now installed and up-to-date.

Installation via Fix Central

To update the CICS Configuration Manager 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 Configuration Manager plug-in zip 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. On an initial install of the CICS Configuration Manager plug-in only: Select the check-box alongside the tool name, and click Install...
  8. Alternatively to update an existing CICS Configuration Manager plug-in installation select the Installed Software tab, and then click Update...
  9. If an update is available, or for the initial install of the CICS Configuration Manager plug-in, an Update or Install dialog box will appear respectively, confirm the installation by clicking Finish.
  10. The CICS Configuration Manager plug-in is then installed/updated, and you'll be asked to restart to apply the changes. Click Yes to restart the CICS Explorer with the CICS Configuration Manager plug-in now installed and 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.

Create Definition Wizard

In the Create Definition wizard there is a Data Repository field, that has content assist. If you press Ctrl+SPACE when you are in the text box, you see a list of repositories.  In CICS CM, Ctrl+SPACE display repositories for CICSPlex SM connections only. It does not display information for CICS CM connections, and you cannot currently disable it.

Do not change the value in the repository after you have opened the dialog. However, you can change the value in the resource group text box in the dialog.

Known Limitations of this update

None.

Change History

Below describes the changes made to the IBM CICS Configuration Manager Plug-in for CICS Explorer since the beginning of the release.

2.1.0.4Fixed APAR(s): IZ66788
IZ66788Release of CICS Configuration Manager Plug-in v2.1.0.4
 More Information: http://www-01.ibm.com/support/docview.wss?uid=swg1IZ66788
2.1.0.3Fixed APAR(s): IZ62888
IZ62888Release of CICS Configuration Manager Plug-in v2.1.0.3
 More Information: http://www-01.ibm.com/support/docview.wss?uid=swg1IZ62888
2.1.0.2Fixed APAR(s): IZ62228
IZ62228Release of CICS Configuration Manager Plug-in v2.1.0.2
 More Information: http://www-01.ibm.com/support/docview.wss?uid=swg1IZ62228
2.1.0.1Compatibility updates and bug fixes
2.1.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

18 Dec 2009Initial version
Valid XHTML 1.0 Strict

Back to the top