PM52711: ABENDA06-04 OCCURS WHEN LIU INTEGRITY CHECKER RUNS IN BATCH PROGRAM AND IMSPLEX IS SPECIFIED

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• LIU Integrity Checker loads DFSVC000 module when it runs in
  batch programs which access IMS databases without loading
  DFSBSCD0.
  When batch programs run with IMSPlex is specified, the task can
  be interrupted by IRB process scheduled by DBRC.
  If the batch program is interrupted when LIU Integrity Checker
  is requesting SVC call to load DFSVC000, and LIU Integrity
  Checker runs in the IRB process, the load SVC call conflicts and
  following messages with ABENDA06 can occur.
     CSV000I REQUESTED MODULE DFSVC000 IS USED RECURSIVELY
     CSV028I ABENDA06-04  JOBNAME=xxxxxxxx  STEPNAME=xxxxxxxx
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IMS Library Integrity Utilities for z/OS,    *
  *                 Version 2 Release 1 (FMID=H27P210) users.    *
  ****************************************************************
  * PROBLEM DESCRIPTION: LIU Integrity Checker attempts to load  *
  *                      the DFSVC000 module and gets ABENDA06   *
  *                      in batch programs which access IMS      *
  *                      databases with DBRC=Y and IMSPlex are   *
  *                      specified.                              *
  *                                                              *
  *                      This problem occurs following messages: *
  *                       CSV000I REQUESTED MODULE DFSVC000 IS   *
  *                               USED RECURSIVELY               *
  *                       CSV028I ABENDA06-04  JOBNAME=xxxxxxx   *
  *                               STEPNAME=xxxxxxxx              *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  Whether LIU Integrity Checker is set up to use or not, LIU
  Integrity Checker loads DFSVC000 module to refer the IMS
  version when batch programs which access IMS databases without
  loading DFSBSCD0 run with DBRC=Y and STEPLIB DD which
  concatenates library of IMS Library Integrity Utilities.
  
  When the batch programs run with IMSPlex is specified, the task
  can be interrupted by asynchronous exit scheduled by DBRC using
  IRB. If the batch program is interrupted when LIU Integrity
  Checker is requesting SVC call to load DFSVC000, and LIU
  Integrity Checker runs in the asynchronous exit, the load SVC
  call conflicts and ABENDA06 can occur.
  

Problem conclusion

• The following modules and macro have been modified to avoid
  ABENDA06 by loading DFSBSCD0 instead of loading DFSVC000 when
  the load processes are conflicted:
  
  FABLIAPI,FABLRTS0,FABLWMT
  
  LIU integrity Checker is also changed to create a NAME/TOKEN to
  store IMS version when the load process succeeds. After the
  NAME/TOKEN is created, LIU Integrity Checker gets IMS version
  from the NAME/TOKEN and avoid loading DFSVC000 module.
  
  So, after this fix applied, FABL0114I IMS VERSION WAS RETRIEVED
  will be issued when batch programs which access IMS databases
  without loading DFSBSCD0 run with DBRC=Y and STEPLIB DD which
  concatenates library of IMS Library Integrity Utilities.
  
  Although this APAR can avoid ABENDA06 of IMS Tools products,
  it is recommended to apply the following APARs specifically
  supports the following products. After the fixes applied,
  Integrity Checker will not load IMS module DFSVC000 to avoid
  ABENDA06 when running the products.
  
  - PM47964 for IMS Library Integrity Utilities for z/OS Version 2
    Release 1 (FMID=H27P210)
  
  - PM49878 for IMS High Performance Pointer Checker for z/OS
    Version 3 Release 1 (FMID=HPC2310)
  - PM47967 for IMS High Performance Image Copy for z/OS Version 4
    Release 2 (FMID=H1J0420)
  - PM48003 for IMS Database Reorganization Expert for z/OS
    Version 4 Release 1 (FMID=H25N410)
  - PM50152 for IMS Index Builder for z/OS Version 3 Release 1
    (FMID=H22O310)
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS Library Integrity Utilities for z/OS Version 2 Release 1
  User's Guide (Document Number: SC19-2479-01) should be changed
  as follows.
  ================================================================
  --------------------------------------------------------------
  13.0 Troubleshooting
   13.4 IMS Library Integrity Utilities messages
    13.4.1 FABL messages
  <<Add the following message>>
  --------------------------------------------------------------
  FABL3015E ENQ FOR NAME/TOKEN SERVICE AND ALL RETRIES FAILED.
  RC=rr
  Explanation: The ENQ macro for the NAME/TOKEN Service and all
  of the retries failed. The return code is rr for the last ENQ
  macro.
  System action: The IMS batch job ends abnormally.
  User response: Find the reason for the ENQ failure. For the
  return code, see the z/OS MVS Programming Assembler Services
  Reference, Volume 1  (ABEND-HSPSERV). Correct the error, and
  rerun the batch job.
  --------------------------------------------------------------
  FABL3016E LOAD FAILED FOR MODULE DFSVC000 AND DFSBSCD0.
  RC=cccc RSN=ssss
  Explanation:
  The LOAD macro for the DFSVC000 and DFSBSCD0 failed.
  The reason code is 0A06 for the DFSVC000. The return code is
  cccc, and the reason code is ssss for the DFSBSCD0.
  System action: The IMS batch job ends abnormally.
  User response: Find the reason for the LOAD failure. For the
  return code and the reason code, see the z/OS MVS Programming
  Assembler Services Reference, Volume 2 (IARR2V-XCTLX).
  Check whether the correct program libraries are concatenated to
  the STEPLIB DD statement. Correct the error, and rerun the
  batch job.
  --------------------------------------------------------------
  

Temporary fix

Comments

• ×**** PE11/12/28 PTF IN ERROR. SEE APAR PM55052  FOR DESCRIPTION
  ×**** PE12/05/17 PTF IN ERROR. SEE APAR PM64916  FOR DESCRIPTION
  

APAR Information

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

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

  UK75103

Modules/Macros

• FABLRTS0 FABLWMT
  

Fix information

• Fixed component name

  IMS LIBR INTEG

• Fixed component ID

  5655I4200

Applicable component levels

• R210 PSY UK75103

     UP11/12/28 P F112

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.