PM28698: WHEN FABADA1 PRODUCES FABA0140E, A FOLLOWING FABADA5 CONTINUES TO REPORT SDEP STATS WHEN IT SHOULDN'T

APAR status

• Closed as program error.

Error description

• FABADA1 produces the following error message:
  FABA0140E INVALID VALUE IN "DMACXVAL"/"DMACNXTS" - SDEP
  PROCESSING BYPASSED FOR AREA: areaname
  Thereafter when FABADA5 runs, it produces DSDEP stats in
  it's reports which is misleading since the SDEP processing
  was bypassed and an RC 00 is received whereas an RC 04 would
  be more appropriate.
  Keyword: MSGFAB0140E
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All DEDB Pointer Checker users of HPFPU FP   *
  *                 Basic Tools Version 3 Release 2 who define   *
  *                 SDEP segment type in DBD definition          *
  *                 (FMID: H31A320).                             *
  ****************************************************************
  * PROBLEM DESCRIPTION: When FABADA1 issues FABA0140E message,  *
  *                      the following FABADA5 reports that      *
  *                      the SDEP freespace is 0% that is a      *
  *                      misleading value.                       *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  FABADA1 produces the error message: FABA140E INVALID IN
  "DMACXVAL"/"DMACNXTS" - SDEP PROCESSING BYPASSED FOR AREA:
  areaname, which means that SDEP LB value or SDEP LE value is
  incorrect, so SDEP processing is bypassed.
  Thereafter FABADA5 reports in "DEDB AREA ANALYSIS
  REPORTS" that SDEP freespace is 0%, and its RC is 00 despite
  FABADA1 error. These are misleading value and RC.
  

Problem conclusion

• When FABADA1 issues FABA0140E message and bypasses SDEP
  processing for area,
  
  FABADA1 is modified to show "N/A" for SDEP FREESPACE INFORMATION
  value and SDEP SEGMENT INFORMATION value in "DEDB AREA INFORMATI
  ON REPORT".
  
       FREESPACE INFORMATION
          %FREESPACE - RAA BASE:  xx%
                       DOVF    :  xx%
                       IOVF    :  xx%
                       SDEP    :  N/A   <==
  
       SDEP SEGMENT INFORMATION
          NO. OF ROOT SEGS THAT HAVE SDEP SEGS:         N/A   <==
          NO. OF SDEP SEGMENTS                :         N/A   <==
          SDEP SEGMENT DEFINITION LENGTH (MAX):         xxx
          SDEP SEGMENT DEFINITION LENGTH (MIN):         xxx
          MAXIMUM SDEP SEGMENT LENGTH         :         N/A   <==
          MINIMUM SDEP SEGMENT LENGTH         :         N/A   <==
          AVERAGE SDEP SEGMENT LENGTH         :         N/A   <==
  
  FABADA5 is modified as follows;
  
  * Shows "N/A" for SDEP FREESPACE value in "DEDB AREA ANALYSIS RE
  PORTS" FREESPACE ANALYSIS.
  
       %FREESPACE - RAA BASE: xxx% %USABLE FREESPACE: xxx%
                    DOVF    : xxx%                    xxx%
                    IOVF    : xxx%                    xxx%
                    SDEP    :  N/A   <==
  
  * Issues new FABA0525W and FABA0534W messages
  * Changes its RC into 97
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS High Performance Fast Path Utilities for z/OS User's
  Guide Version 3 Release 2 (SC18-9869-04).
  
  7.0 Troubleshooting
  7.1 Messages and codes of IMS HPFPU
  7.1.1 Return codes
  7.1.1.2 Return codes of FPB
    The following Return code of FABADA5 should be added:
  
   | 97  SDEP warning message was issued.
   |     SDEP information is not reported.
  
  7.1.3 Messages
  7.1.3.1 FABA messages
    The following messages  of FABADA5 should be added:
  
      FABA0500I FABADA5 ENDED WITH WARNINGS
   |            - SDEP PROCESSING BYPASSED IN THE PREVIOUS STEP
  
   |  FABA0525W SDEP INFORMATION IS NOT REPORTED
   |  Explanation:
   |  Program FABADA5 encountered that SDEP information was not
   |  obtained in the previous step.
   |  See FABA0140E message that was issued in program FABADA1.
   |  System action:
   |  Program FABADA5 sets an end-of-job return code of 97, and
   |  continues processing. The SDEP information is not reported.
   |  Programmer response:
   |  None.
  
   |  FABA0534W SDEP INFORMATION WAS NOT OBTAINED BECAUSE THE SDEP
   |            PROCESSING WAS BYPASSED IN THE PREVIOUS STEP
   |  Explanation:
   |  Program FABADA5 encountered that SDEP information was not
   |  obtained in the previous step. See FABA0140E message that
   |  was issued in program FABADA1.
   |  System action:
   |  FABADA5 sets an end-of-job return code of 97 and continues
   |  processing.
   |  The SDEP information is not reported.
   |  Programmer response:
   |  See FABA0140E message.
  320Y
  DA1WRK10
  DA5EOJR0
  DA5MAIN0
  DA5MSGT0
  DA5PRNT0
  DA5WRKG0
  FABADA1
  FABADA5
  FABADMAC
  FABAFDAR
  

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:

  PM28789 UK63263

Modules/Macros

•    DA1WRK10 DA5EOJR0 DA5MAIN0 DA5MSGT0 DA5PRNT0
  DA5WRKG0 FABADA1  FABADA5  FABADMAC FABAFDAR
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R320 PSY UK63263

     UP10/12/21 P F012