PH22005: CICS CM MIGRATE OF CHANGE PACKAGE REQUEST FAILED RC=16 RSN=0012 (ANALYZER ABEND)

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• MIGRATE request failed RC=16 RSN=0012 (Analyzer Abend)
  following an occurrence of the CICS message:
  
  DFHCA4823 ...
  DFHCSD not open
  
  Multiple CSD LIST definitions are left in an
  incomplete state with undefined GROUP entries
  appearing in the LIST, or required GROUP
  entries omitted from the list.
  
  
  
  KIXREVDAM
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of CICS Configuration Manager      *
  ****************************************************************
  * PROBLEM DESCRIPTION: MIGRATE request failed RC=16 RSN=0012   *
  *                      (Analyzer Abend) following an           *
  *                      occurrence of the CICS message:         *
  *                                                              *
  *                         DFHCA4823 ... DFHCSD not open        *
  *                                                              *
  *                      Multiple CSD LIST definitions are left  *
  *                      in an incomplete state with undefined   *
  *                      GROUP entries appearing in the LIST, or *
  *                      required GROUP entries omitted from the *
  *                      LIST.                                   *
  ****************************************************************
  A MIGRATE API command is adding new GROUPs and/or removing old
  GROUPs from a CSD, resulting in the update of a CSD LIST. The
  affected LIST has a large number of GROUP entries, the update of
  which requires exclusive access to the CSD for more than 20
  elapsed seconds.
  
  While the LIST definition is being updated, the CICS region
  reports the message:
  
     DFHCA4823 <region> CCVA Unable to perform request -
                        DFHCSD not open
  
  The MIGRATE API request fails RC=16 RSN=0012 (Analyzer Abend).
  Auto-BACKOUT processing ensues, but this also fails and the LIST
  being updated is left in an incomplete state. A subsequent COLD
  START of the region suffers errors owing to undefined GROUPs in
  the LIST, or required GROUPs not appearing in the LIST.
  
  CICS Configuration Manager is updating CSD LISTs by deleting and
  recreating the LIST; this approach work well for small LISTs but
  customers who use large LISTs suffer a performance impact.
  

Problem conclusion

• CICS Configuration Manager is corrected.  Conditions affecting
  the exclusive access to the DFHCSD file have been amended, along
  with coding improvements to the way CSD LISTs are updated:
  
  (1)  The delay/retry threshold for tasks waiting on the DFHCSD
       file has been increased.  The retry count has been
       increased from 20 to 120.  This provides a longer time for
       interleaving tasks to wait for the CSD whilst lengthy
       updates, like large LIST updates, complete.
  
  (2)  When the delay/retry threshold is exceeded, the affected
       task no longer changes the DFHCSD file state. Those changes
       lead to the "DFHCA4823 DFHCSD not open" condition, which
       resulted in failure of the task holding the CSD file for
       the large LIST update.
  
  (3)  The method of updating CSD LIST definitions is improved.
  
       Formerly, the CSD LIST was reconstructed afresh by removing
       all Groups (this deletes the LIST), then adding all
       required Groups to the LIST in the required sequence (this
       redefines the LIST).
  
       The improved method assesses the Group changes to the LIST.
       When practical, only the Groups that need removal or adding
       are processed.  For LISTs containing many Groups, this
       greatly improves performance and avoids DFHCSD contention.
  

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:

  UI70351

Modules/Macros

• CCVAMG70 CCVARECV CCVAUPD  CCVSMCSD CCVSRCSD
  

Fix information

• Fixed component name

  CICS CONFIG MGR

• Fixed component ID

  5697CIC00

Applicable component levels

• R540 PSY UI70351

     UP20/07/09 P F007

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.