PH39988: MIGRATING TO THE LATEST VERSION OF THE SMF EXTRACTOR MAY CAUSE A SYSTEM ABEND 21/08/30 PTF PECHANGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Migrating to the latest version of the SMF Extractor
  without an intervening system IPL may cause an overlay
  in the CSA storage causing the system to crash.
  
  Migration from version
  
  VSX0001I VSXUT1 Build: Version 4.7.1.M66 12/11/19 14.45
  to version
  CKKS001I CKKXMAI Build: Version 4.8.0.L68 01/27/21 12.20
  
  Various messages at system crash:
  
  IXG005I LOGR POLICY PROCESSING LINE# 5
  
  IXG002E LOGR POLICY PROCESSING ENDED WITH RETCODE=00000008
  RSNCODE=00000805
  
  IXG003I LOGR POLICY PROCESSING ENCOUNTERED AN UNEXPECTED ERROR.
  DIAGNOSIS INFORMATION: 00000008 00000008 01010001 B41C5F00
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of                                 *
  *                 IBM Decision Support for Z Version 1.9.0,    *
  *                 IBM Z Decision Support for Capacity Planning *
  *                 Version 2.1.0 and                            *
  *                 IBM Z Performance and Capacity Analytics     *
  *                 Version 3.1.0                                *
  *                 running the SMF Extractor.                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: The Z/OS system crashed with messages.  *
  *                      IXG005I LOGR POLICY PROCESSING LINE# 5  *
  *                      IXG002E LOGR POLICY PROCESSING ENDED    *
  *                      WITH                                    *
  *                      RETCODE=00000008 RSNCODE=00000805       *
  *                      IXG003I LOGR POLICY PROCESSING          *
  *                      ENCOUNTERED AN UNEXPECTED ERROR.        *
  *                                                              *
  *                      Depending on which program obtained     *
  *                      the CSA storage immediately following   *
  *                      the storage obtained by the SMF         *
  *                      Extractor the results may be different. *
  *                      If no other program has obtained CSA    *
  *                      storage after the SMF Extractor area    *
  *                      then there will be no problem.          *
  ****************************************************************
  * RECOMMENDATION: APPLY the PTF provided..                     *
  ****************************************************************
  IBM provides an anchor point for our products, within this
  anchor point we have a pointer to an anchor area for the
  SMF Extractor. This anchor area for the SMF Extractor is in
  CSA storage. With the change in version of the SMF Extractor,
  the anchor area increased in size from 144 bytes to 200 bytes.
  Once this area is allocated, it is persistent until the next
  IPL. Therefore, when the old SMF Extractor was stopped and
  new SMF Extractor started without an IPL the smaller CSA anchor
  area was reused, and not reallocated at the larger size.
  

Problem conclusion

• This new version of the SMF Extractor sets a version number in
  the CSA anchor area, allowing for future expansion (if required)
  without impacting other systems.
  This new version also checks the SMF Extractor CSA anchor area
  for a constant, that does not exist in older SMF Extractor CSA
  anchor areas, thus allowing this new SMF Extractor version to
  be implemented without the requirement of an IPL.
  

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:

  UI76973 UI76974

Modules/Macros

• DRLPKV83 DRLPKV86 DRLPKVLX DRLPKVMA
  

Fix information

• Fixed component name

  TDS FOR Z/OS

• Fixed component ID

  569510100

Applicable component levels

• R901 PSY UI76974

     UP21/09/02 P F109 ­

• RC01 PSY UI76973

     UP21/09/02 P F109 ­

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.