IZ88175: Zero results from  "Uses Resources" or "Used By Programs" for alias mirror transaction

APAR status

• Closed as program error.

Error description

• 3.1.0.7-WS-CICSIA-WinLin-IZ80010
  
  You right click on an alias mirror transaction id from the CICS
  Interdependency Analyzer plugin for the CICS Explorer to view
  the "Uses Resources" or "Used By Programs", but you receive
  zero results.
  .
  Additional Symptom(s) Search Keyword(s): plug-in DFHMIRS
  transaction identifier link dpl remote
  kixrevwjb
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Interdependency Analyzer plug-in    *
  *                 users                                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: No results shown in Resource Usage tree *
  *                      for function shipped transactions       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When using the CICS Explorer with the Interdependency Analyzer
  (IA) plugin, querying for the resources used by transactions
  that have shipped function using the CICS mirror transaction
  DFHMIRS returns no results.
  
  The database query that determines the initial program that was
  started by a transaction does not account for the CICS mirror
  program DFHMIRS and so subsequent queries for resources used by
  that transaction do not return any results.
  
  Correcting this issue revealed that the results returned from
  the database are displayed incorrectly in the Resource Usage
  tree. Rather than showing distinct trees of resources used by a
  transaction or program per region, the resources were
  incorrectly merged into a single tree structure, duplicated for
  each region the transaction/program had been run in. This view
  therefore incorrectly represented the resource usage by a
  transaction/program in an individual region.
  

Problem conclusion

• | MDVREGR 3.1.0.7-WS-CICSIA-WinLin-IZ80010 |
  
  The IA plug-in has been updated so that querying for resources
  used by transactions that use CICS function shipping will ignore
  the mirror program DFHMIRS when calculating the initial program
  that was invoked by the transaction.
  
  The IA plug-in has also been updated to address the issue of the
  incorrect merged display of result data. When querying for the
  resources used by a transaction or program, the Resource Usage
  tree will now display the region name that the
  transaction/program was run in, underneath which the distinct
  resources used by that transaction/program in that region are
  displayed.
  
  Version 3.1.0.9 has been released for IBM CICS Interdependency
  Analyzer plug-in for CICS Explorer. This is available via two
  options:
  
  1. Update from within the CICS Explorer using the IBM-hosted
  Update-Site.
  2. Download the update from Fix Central to be installed locally
  into the CICS Explorer.
  
  This update requires the CICS Explorer to be at least at
  1.0.0.7. Before installing this CICS Interdependency Analyzer
  plug-in update the CICS Explorer should be updated to at least
  this level.
  
  Updating using the Update-Site
  To update the CICS Explorer using the 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
  Interdependency Analyzer plug-in is done the update-site needs
  to be added to the CICS Explorer. On subsequent updates the
  following step can be skipped.
     * Click the Add Site button and in the Add Site dialog type
  in the following update-site into the Location text box:
      http://download.boulder.ibm.com
      /ibmdl/pub/software/htp/cics/updates/ia/3.1/latest
  (concatenate URL). Click OK.
  5. On an initial install of the CICS Interdependency Analyzer
  plug-in only: Select the check-box alongside the tool name, and
  click Install...
  6. Alternatively to update an existing CICS Interdependency
  Analyzer plug-in installation select the Installed Software tab,
  and then click Update...
     * The update-site will be checked and a dialog will appear
  indicating if an update is available. If no update is currently
  available then your version of the CICS Interdependency Analyzer
  plug-in is up-to-date, and no update is necessary.
  7. If an update is available for the CICS Interdependency
  Analyzer 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 Interdependency Analyzer 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
  Interdependency Analyzer plug-in now installed and up-to-date.
  
  Optionally, verify that the CICS Interdependency Analyzer
  plug-in version has been updated:
    * Select Help -> Software Updates from the main menu, click on
  the Installed Software tab, and note the version of the CICS
  Interdependency Analyzer plug-in; it should be
  3.1.0.9_201103071102 or higher.
  
  Note: The version of the CICS Interdependency Analyzer plug-in
  may now be higher than 3.1.0.9 as the update updates to the
  latest version. All updates are cumulative so the latest version
  contains this update as well as any later updates.
  
  The CICS Interdependency Analyzer plug-in is now up-to-date with
  this update installed, and no further action is necessary.
  
  Updating using the IBM Fix Central
  To update the CICS Interdependency Analyzer plug-in using the
  Fix Central follow the instructions below:
  
  * Open a browser and go to the Fix Central website:
  http://www.ibm.com/support/fixcentral/
  * Select WebSphere from the Product Group drop-down menu.
  * Select CICS Interdependency Analyzer for z/OS from the Product
  drop-down menu.
  * Select All from the Installed Version drop-down menu.
  * Select All (or your platform) from the Platform drop-down menu
  * Click Continue.
  * Select the "APAR or SPR" option and enter IZ88175 into the
  text box next to it.
  * Click Continue.
  * Select the corresponding Fix Pack's checkbox and click
  Continue.
  * Select the desired download mechanism and click Continue.
  * Optionally, click on the readme to view it.
  * Download the Update Site zip.
  
  Once the download has completed:
  
  * Start CICS Explorer.
  * Select Help -> Software Updates... from the main menu.
  * Click the Available Software tab.
  * Click Add Site...
  * Click the Archive... button.
  * Find the update-site zip just downloaded, and click Open.
  * Click OK to add that update-zip as an available update.
  * Click the Installed Software tab and click Update...
  * The update should be found for the Interdependency Analyzer
  plug-in, verify that the update version is 3.1.0.9_201103071102
  * Click Finish to install the update.
  * Once the update has completed you'll be prompted to restart
  the CICS Explorer for the update to take effect. Click Yes.
  * Optionally, verify that the CICS Interdependency Analyzer
  plug-in version has been updated:
    * Select Help -> Software Updates from the main menu, click on
  the Installed Software tab, and note the version of the CICS
  Interdependency Analyzer plug-in; it should now be 3.1.0.9.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  IV50512 IV50513

Fix information

• Fixed component name

  CICS IA EXPL PL

• Fixed component ID

  5655U8601

Applicable component levels

• R310 PSY

     UP