IBM CICS Performance Analyzer for z/OS 5.3.0 CICSPA-5.3.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 Performance Analyzer 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/aqua/

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

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

The CICS PA plug-in V5.3.0 must be installed in CICS Explorer V5.3.0. CICS Explorer runs on IBM Explorer for z/OS V3.0. Please refer to the IBM Explorer for z/OS and CICS Performance Analyzer 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 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 URL http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua/ 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 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 http://public.dhe.ibm.com/ibmdl/export/pub/software/htp/zos/tools/aqua/ 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 Performance Analyzer 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 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 page on the Mainframe Development Center
• CICS Performance Analyzer 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 Performance Analyzer for z/OS 5.3.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 5 (5.3.0.5) -- 20180712-1829

Fix Pack 4 (5.3.0.4) -- 20170509-1122

Fix Pack 3 (5.3.0.3) -- 20161010-0952

Fix Pack 2 (5.3.0.2) -- 20160512-0744

Fix Pack 1 (5.3.0.1) -- 20160426-0842