OA54007: A PREMATURE RETURN OF A FAILED GETMAIN COULD CAUSE A POOR PERFORMANCE IN REPRO

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• IDCAMS REPRO is not performing as expected.  Diagnostics show
  that the optimal number of buffers is not being requested.
  There is a logical error in the buffer processing
  module where a return code from a failed GETMAIN got corrupted
  and resulted in using the default buffers of 2 instead of
  optimal number of buffers.
  
  This problem can affect any tools that use IDCAMS
  REPRO, for example, some DB2 tools.
  CATKEYS: IDC2018 IDCREPRO IDCIO IDCPERF
  

Local fix

• Apply the PTF or Code AMP with BUFNO/BUFND/BUFNI/BUFFERSPACE in
  the JCL with optimal number of buffers
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * DFSMS users who use IDCAMS REPRO release 210                 *
  * and up affect.                                               *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * GETMAIN macro return code returns in                         *
  * R15 which should be restricted until                         *
  * it is saved.                                                 *
  * V23 compiler used R15 for saving LOCPTR                      *
  * pointer which could cause corruption of                      *
  * the saving of TESTRC (R15) after it.                         *
  * As a result of this corruption of R15,                       *
  * LOC_COMP_PROC exited after the first                         *
  * getmain and before it could set                              *
  * ACBBUFND. Since ACBBUFND was never set                       *
  * to AMDCIPCA, it caused a performance by                      *
  * not having the usual numbers of data                         *
  * buffers.                                                     *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The problem can be prevented by reversing the order of the
  instruction LOC_IN_PTR = G16STPTR and the macro USAVERC, so
  that the TESTRC is saved before R15 being used in LOC_IN_PTR =
  G16STPTR instruction.
  

Problem conclusion

• This apar will make change to avoid the return code R15 being
  corrupted.
  

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:

  UA94966 UA94967 UA94968

Modules/Macros

• IDCRP01
  

Fix information

• Fixed component name

  ACCESS METHOD S

• Fixed component ID

  5695DF103

Applicable component levels

• R210 PSY UA94967

     UP18/01/31 P F801

• R220 PSY UA94968

     UP18/01/31 P F801

• R230 PSY UA94966

     UP18/01/31 P F801

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.