PM21355: DBRC REGION GETS ABEND 0C1 AFTER LIU PTF UK59427 (APAR PM17661) APPLIED.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This problem occurs after Integrity Checker PTF UK59427 is
  applied.
  
  When Integrity Checker is specified in STEPLIB DD of a DBRC
  procedure or a batch job, but global option module is not ready,
  Integrity Checker runs but do nothing except issuing a message
  "FABL0103W LIU INTEGRITY CHECKER DEACTIVATED". In the case, if
  DBRC auth request fails, Integrity Checker ends with ABEND S0C1.
  
  In a batch environment, the batch program will abend. In IMS
  online environment with non-BPE based DBRC, the DBRC region will
  abend and the IMS control region will abend. In IMS online
  environment with BPE based DBRC, the DBRC user exit will be
  disabled and there will be no effect.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IMS Library Integrity Utilities for z/OS,    *
  *                 Version 2 Release 1 (FMID=H27P210) users     *
  *                 who use Integrity Checker.                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: ABEND0C1 occurs when Integrity Checker  *
  *                      is specified in STEPLIB DD but          *
  *                      deactivated and DBRC authorization      *
  *                      request is failed after PTF UK59427 is  *
  *                      applied.                                *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  Integrity Checker gets ABEND0C1 in the following conditions:
  
  - APAR PM17661(PTF UK59427) is applied.
  - LIU library is specified in STEPLIB DD of a DBRC procedure in
    IMS online environment with non-BPE based DBRC or a batch job
    in a batch environment.
  - Integrity Checker is deactivated due to one of the followings:
    - No Global Option Module in the JOBLIB(STEPLIB) DD.
    - Errors occur in the initialization of Integrity Checker and
      INITERR=W is specified in the Global Option Module.
  - DBRC authorization request fails.
  
  If all of these conditions met, Integrity Checker erroneously
  refers incorrect area and gets ABEND0C1. In a batch environment,
  the batch program will abend. In IMS online environment with
  non-BPE based DBRC, the DBRC region will abend and the IMS
  control region will abend. In IMS online environment with BPE
  based DBRC, there will be no effect.
  

Problem conclusion

• The following modules and macros have been changed to fix the
  error.
  
  FABLAH1 FABLAH1A FABLAH1B FABLAH19 FABLVMNA FABLVMNB FABLVMN0
  FABLVMN9
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS Library Integrity Utilities for z/OS Version 2 Release 1
  User's Guide (Document Number: SC19-2479-00) should be changed
  as follows.
  ================================================================
  10.0 Troubleshooting
   10.1 Messages and codes
    10.1.4 IMS LIU messages
      10.1.4.1 FABL messages
  <<Delete a part of the following text>>
   FABL3302E VSAM mmmmm FAILED FOR DDNAME: dddddddd RC=rr RSN=ssss
   Explanation: The VSAM macro mmmmmm failed for the data set
   whose DDNAME was dddddddd. The return code is rr, and the
   reason code is ssss. FABL3302E is issued for the failure of
   VSAM macros requested for RPLs.
  |If Integrity Checker has encountered a GET or PUT error while
  |processing the RDE for which RECUPD=Y, RECLD=Y, or RECUL=Y was
  |specified, the subsystem name and the timestamp of when
  |Integrity Checker was run might remain in the record section of
  |the RDE.
  

Temporary fix

• *********
  * HIPER *
  *********
  

Comments

APAR Information

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

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

  UK60472

Modules/Macros

•    FABLAH1  FABLAH1A FABLAH1B FABLAH19 FABLVMNA
  FABLVMNB FABLVMN0 FABLVMN9
  

Fix information

• Fixed component name

  IMS LIBR INTEG

• Fixed component ID

  5655I4200

Applicable component levels

• R210 PSY UK60472

     UP10/09/18 P F009 «

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.