OA67502: PFA PREDICITIVE FAILURE ANALYSIS COMMON_STORAGE_USAGE MAPREQ SYSTEMNAME.ALLDATA.MAPMVS FILE INVALID ENTRIES RETURN ADDRESS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Predictive Failure Analysis exception processing creates a
  diagnostic file in the pfa zfs
    ie:
  /var/pfa/PFA_COMMON_STORAGE_USAGE/EXC_20250206091956/systemName.
  
  
  
  This file contains the getmain information for the address
  spaces whose usage increased the most at the last model that
  were identified in the exception report.   Each record contains
  an entry describing a Jobname, Return Address, and how much
  storage is in use by that return address.   When PFA attempts to
  convert the return address to a module name and offset it
  incorrectly evaluates the start address of where the module
  found at the psw return address is loaded.  This results in the
  systemName.allData.mapmvs to either not map the PSW and leave it
  as the original value or replacing the correct return address
  with the wrong module name+offset to identify what getmained the
  storage in the trend under the identified job.
  
  The /var/pfa/PFA_COMMON_STORAGE_USAGE/data/systenNameMAPREQF.OUT
   which is used by the above exception processing is not copied
  to the /var/PFA/EXC_xxxxxxxxxxxx directory when the other
  exception data is copied in there.  Leaving this file in the
  /data/ path allows it to be overwritten at a future exception.
  

Local fix

• BYPASS/CIRCUMVENTION:
  none
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All z/OS 2.5 (HBB77D0) and above PFA         *
  *                 environments                                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: Changes to the MAPREQF.OUT format were  *
  *                      not reflected in the module that reads  *
  *                      the contend of the file leading to      *
  *                      the improper parsing of the start       *
  *                      and end addresses.                      *
  ****************************************************************
  

Problem conclusion

• The proper offsets were set for the start and end addresses in
  the module that reads the MAPREQ.OUT file.
  

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:

  UJ98380 UJ98381 UJ98382

Modules/Macros

• AIRHLJVM AIRHMEWV AIRHMEXC AIRJCART AIRJCHK  AIRLCSAC AIRLMARC
  AIRPAFUW
  

Fix information

• Fixed component name

  Z/OS PFA

• Fixed component ID

  5752SCPFA

Applicable component levels

• R7D0 PSY UJ98380

     UP25/11/26 P F511

• R7E0 PSY UJ98381

     UP25/11/26 P F511

• R7F0 PSY UJ98382

     UP25/11/26 P F511

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.