PK27718: FORWARD-FIT DRF V2R1 APAR PK25407

APAR status

• Closed as program error.

Error description

• Forward-fit DRF V2R1 APAR PK25407
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users with IMS Database Recovery Facility    *
  *                 Version 3 Release 1 installed.               *
  ****************************************************************
  * PROBLEM DESCRIPTION: Users may receive a MSGIEF238D DEVICE   *
  *                      NAME OR CANCEL if performing recovery   *
  *                      with an insufficient number of tape     *
  *                      devices available for parallel          *
  *                      processing.                             *
  *                                                              *
  *                      Users may receive an ABENDU0384-007     *
  *                      in FRXRDTH0 with a return code of 8 in  *
  *                      register 14 during early shutdown.      *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  When using the TAPECHK option, DRF is expected to recognize the
  number of available tape devices as specified by the user with
  the READNUM or ICNUM option.  DRF is expected to wait for the
  next available tape device before attempting to mount another
  tape in parallel to other running processes.  However, there are
  cases where image copy tapes are allocated to a device before
  log and change accumulation tapes had a chance to be unallocated
  from their devices.
  
  During early shutdown of log reader tasks, a return code of 8 is
  set and inadvertently passed to a subroutine responsible for
  processing any remaining update buffers.  Since this return code
  was saved in a global variable, it needed to be initialized
  prior to entering this subroutine.
  

Problem conclusion

• AIDS: RIDS/UTIL RIDS/DBS DBS/UTIL
    DEP: NONE
    GEN:
  
  *** END IMS KEYWORDS ***
  Allocation logic for log and change accumulation data sets is
  change to keep a count of the number of tape devices allocated
  for log and CA read.  This count will help prevent the
  subordinate address spaces from exceeding the number of
  available tape devices supplied on READNUM or ICNUM during image
  copy allocation.
  
  FRXRDTH0 is change to use a local variable in the SendBuffer
  subroutine to save the return code.
  

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:

  UK16863

Modules/Macros

• FRXAWEX  FRXMSTR0 FRXRDTH0 FRXRVRA  FRXYALL0
  FRXYUNA0
  

Fix information

• Fixed component name

  IMS DB RECOVERY

• Fixed component ID

  5655I4400

Applicable component levels

• R310 PSY UK16863

     UP06/08/08 P F608