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

This fix can be obtained either by performing an Eclipse p2 update or an update in Installation Manager.

The Eclipse composite update site and the IM composite site is here:

For Aqua 3.1
http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.1/

For Aqua 3.2
http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.2/

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

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

The CICS CM plug-in 5.4.0 can be installed in CICS Explorer for Aqua 3.1 or CICS Explorer for Aqua 3.2 (where Aqua refers to IBM Explorer z/OS Aqua), based on whether you have CICS Explorer 5.4 (Aqua 3.1) or CICS Explorer 5.5 (Aqua 3.2) installed.  CICS Explorer 5.4 runs on IBM Explorer for z/OS 3.1, whereas CICS Explorer 5.5 runs on IBM Explorer for z/OS 3.2. Refer to the CICS Configuration Manager for z/OS section 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".

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 (http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.2/ if you are using CICS Explorer 5.5 (Aqua 3.2)). 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/ (http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.2/ if you are using CICS Explorer 5.5 (Aqua 3.2)) 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

Visit the IBM support site.

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 before 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 overview
• 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 11 (5.4.0.11) -- 20220609-1515

Fix Pack 10 (5.4.0.10) -- 20201014-1158

Fix Pack 9 (5.4.0.9) -- 20190924-1656

Fix Pack 8 (5.4.0.8) -- 20190802-1555

Fix Pack 7 (5.4.0.7) -- 20190507-1220

Fix Pack 6 (5.4.0.6) -- 20181128-1753

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