IBM CICS Configuration Manager for z/OS 5.4.0 CICSCM-5.4.0-FP0005 Readme

This fix can be obtained either by performing an Eclipse p2 update or an update in Installation Manager. NOTE: It is no longer possible to do a direct download of the fix pack for CICS Configuration Manager for z/OS plug-in V5.3 onwards.

The Eclipse composite update site and the IM composite site is here:
http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.1/

Below is a list of components, platforms, and file names that apply to this Readme file.

The CICS CM plug-in V5.4.0 system requirements are listed on the CICS Configuration Manager for z/OS System Requirements page.

The CICS CM plug-in V5.4.0 must be installed in CICS Explorer V5.4.0. CICS Explorer runs on IBM Explorer for z/OS V3.1. Please refer to the IBM Explorer for z/OS and CICS Configuration Manager for z/OS sections of the z/OS Explorer, CICS Explorer, and CICS tools plug-ins release compatibility reference tables.

Find further online installation instructions within the technote, entitled "Ordering maintenance for IBM CICS Explorer and CICS Explorer plug-ins".

Prior to installation

It is recommended that you take a backup of the CICS Explorer workspace before upgrading. Online instructions on how to do this for the CICS Explorer can be found here: "Taking a backup of the CICS Explorer workspace".

Note that in CICS Explorer Version 5.3 or later, the name of the default workspace has changed to .zosexplorer.

Installing

This is covered in the "Ordering maintenance for IBM CICS Explorer and CICS Explorer plug-ins" technote. There are two main ways of installing the CICS Configuration Manager for z/OS plug-in fix pack:

• IBM Installation Manager
• Eclipse P2 Update Site

1. Start Installation Manager and click File -> Preferences -> Repositories .
2. Click Add Repository and add the URL http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.1/ which is the composite update site. Further details are available on the Mainframe DEV's Eclipse Tooling web page.
3. Click OK .
4. Ensure the checkbox is selected against it once added.
5. Click OK in the Preferences Dialog to return
6. Click the Update option in the Installation Manager wizard and follow the prompts to update CICS Configuration Manager for z/OS plug-in.

If you would like to continue to use the Eclipse provided update method then follow these instructions:

1. Run the CICS Explorer as usual. If you intend to use the composite update site and you know that it is already available, you can skip to the next step.
   1. To add the composite update site, select Help -> Install New Software... from the top menu.
   2. Click the Available Software Sites hyperlink.
      1. Select the Add... button.
      2. Type in a name for this update site.
      3. Enter the following URL http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.1/ into the Location text box.
      4. Click OK .
      5. Ensure the checkbox is selected against it once added.
   3. Click OK in the Preferences Dialog to return.
   4. Click Cancel button or exit dialog to return.
2. Select Help -> Check For Updates
3. If any are available, follow instructions in the dialogs to install.

Performing the necessary tasks after installation

None

Troubleshooting installation problems from the Support site

The CICS Configuration Manager for z/OS support site

The CICS TS support site will also cover the CICS Explorer product.

Uninstalling if necessary

If using IBM Installation Manager, to revert back to the old version of the CICS Explorer, this can be achieved by using the Rollback function.

Otherwise, if you decide that you want to revert back to the old version of the CICS Explorer, you will be able to replace the .zosexplorer folder with the backup that you made prior to upgrading.

The CICS Configuration Manager help documentation is integrated with the product. To display the CICS CM help, 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 main menu bar, click: Help -> Help Contents -> CICS CM Plug-in User Guide.

Other links of interest:

• CICS Configuration Manager page on the Mainframe Development Center
• CICS Configuration Manager for z/OS Product Page
• Mainframe Developer Center (z/OS Explorer, CICS Explorer and CICS Tools plug-ins for V5.3 onwards)
• The DeveloperWorks CICS Explorer forums cover the CICS Explorer as well as the CICS Tools plug-ins and the IBM Explorer for z/OS. The forums provide a place where information and questions can be posted.
• Latest version of CICS Explorer and CICS tools plug-ins for CICS Explorer
• Getting started with the CICS Explorer

Here is a link to the Fix List for CICS Configuration Manager for z/OS 5.4.0 page.

A list of all fix packs for the CICS Configuration Manager for z/OS plug-in for CICS Explorer can be found from the Fixes by version for CICS Products document.

Fix Pack 5 (5.4.0.5) -- 20180927-1753

Fix Pack 4 (5.4.0.4) -- 20180604-1815

Fix Pack 3 (5.4.0.3) -- 20180315-1750

Fix Pack 2 (5.4.0.2) -- 20180124-1605

Fix Pack 1 (5.4.0.1) -- 20180111-1732