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

Obtain the fix for this APAR.

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.
  
  This is a forward fit of IMS High Performance Fast Path
  Utilities V320 APAR PM28698.
  
  Keyword: MSGFAB0140E
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All DEDB Pointer Checker users of HPFPU FP   *
  *                 Basic Tools in Fast Path Solution Pack       *
  *                 Version 1 Release 1 who define SDEP segment  *
  *                 type in DBD definition (FMID: HAHQ110).      *
  ****************************************************************
  * PROBLEM DESCRIPTION: Forward Fit APAR of HPFPU V3R2 FPB      *
  *                      PM28698.                                *
  *                      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.         *
  ****************************************************************
  Forward Fit APAR of HPFPU V3R2 FPB PM28698.
  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 Fast Path Solution Pack for z/OS Version 1 Release 1
  IMS High Performance Fast Path Utilities User's Guide
  (SC19-2914-00).
  
  7.0 Troubleshooting
  7.1 Messages and codes of IMS HP Fast Path Utilities
  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.
  

Temporary fix

Comments

APAR Information

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

  PM28698

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

  UK63338

Modules/Macros

• DA1WRK10 DA5EOJR0 DA5MAIN0 DA5MSGT0 DA5PRNT0
  DA5WRKG0 FABADA1  FABADA5  FABADMAC FABAFDAR
  

Fix information

• Fixed component name

  IMS FP SOLUTION

• Fixed component ID

  5655W1400

Applicable component levels

• R110 PSY UK63338

     UP10/12/21 P F012

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.