IBM CICS Performance Analyzer for z/OS plug-in 5.4.0 CICSPA-5.4.0-FP00013 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.2
http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.2/

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

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

The CICS PA plug-in 5.4.0 system requirements are listed on the CICS Performance Analyzer for z/OS System Requirements page.

The CICS PA plug-in 5.4.0 can be installed in CICS Explorer for Aqua 3.2 or CICS Explorer for Aqua 3.3 (where Aqua refers to IBM Explorer z/OS Aqua), based on whether you have CICS Explorer 5.5 (Aqua 3.2 - Eclipse 4.8 base) or CICS Explorer 5.5 (Aqua 3.3 - Eclipse 2022-03 base) installed.  CICS Explorer 5.5 runs on IBM Explorer for z/OS 3.2 and 3.3. Refer to the CICS Performance Analyzer for z/OS plug-in 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 Performance Analyzer 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 following URL (the composite update site).  Further details are available on the Aqua Download page:
   • CICS Explorer 5.5 - Aqua 3.2 - Eclipse 4.8 base - http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.2/
   • CICS Explorer 5.5 - Aqua 3.3 - Eclipse 2022-03 base - http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.3/
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 Performance Analyzer 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 into the Location text box:
         • CICS Explorer 5.5 - Aqua 3.2 - Eclipse 4.8 base - http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.2/
         • CICS Explorer 5.5 - Aqua 3.3 - Eclipse 2022-03 base - http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua3.3/
      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 Performance Analyzer help documentation is integrated with the product. To display the CICS PA 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 PA plug-in User Guide.

Other links of interest:

• CICS Performance Analyzer User Guide
• CICS Performance Analyzer for z/OS Overview
• Aqua Download page (z/OS Explorer, CICS Explorer and CICS Tools plug-ins for 5.3 onwards)
• 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 Performance Analyzer for z/OS plug-in 5.4.0 page.

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

Fix Pack 13 (5.4.0.13) -- 20240606-1249

Fix Pack 12 (5.4.0.12) -- 20231009-1539

Fix Pack 11 (5.4.0.11) -- 20230607-1512

Fix Pack 10 (5.4.0.10) -- 20220607-1236

Fix Pack 9 (5.4.0.9) -- 20220304-1617

Fix Pack 8 (5.4.0.8) -- 20211029-1735

Fix Pack 7 (5.4.0.7) -- 20210519-1430

Fix Pack 6 (5.4.0.6) -- 20200601-1722

Fix Pack 5 (5.4.0.5) -- 20190503-1535

Fix Pack 4 (5.4.0.4) -- 20181129-1753

Fix Pack 3 (5.4.0.3) -- 20180926-1259

Fix Pack 2 (5.4.0.2) -- 20180918-1537

Fix Pack 1 (5.4.0.1) -- 20180712-2001