PH34170: DFHCSDUP EXECUTION WITH STATICALLY LINKED CCVCSDUT MODULE REPLACES THAT MODULE WITH ONE DYNAMICALLY LOADED FROM THE LINKLST.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• PROBLEM DESCRIPTION
  
  The following improvements and
  corrections are addressed in this
  APAR:
  
  1. DFHCSDUP execution
  with statically linked CCVCSDUT module replaces
   that module
  with one dynamically loaded from the LINKLST.
  
   CICS
  Configuration Manager provides an auditing feature for
  
  DFHCSDUP CSD updates, whereby CICS CM modules are linked into
  
  DFHCSDUP.
  
   During DFHCSDUP execution, CICS CM attempts to
  dynamically load
   and thereby replace the statically linked
  modules CCVCSDUT (audit
   control table) and CCVCSDEX (step
  termination exit). The intent
   is to provide a method to
  override these programs with customized
   versions drawn from
  the STEPLIB data sets assigned in the JCL.
  
   However, if the
  CICS CM SCCVLINK data set is link listed (LINKLST)
   then stub
  (uncustomized) versions of those modules supplied with
   CICS
  CM can be dynamically loaded, replacing customized versions
  
  statically linked into DFHCSDUP. In this case, the audit
  feature
   is effectively disabled for the DFHCSDUP execution.
  
  
  2. DFHCSDUP audit obtains the CICS TS release of the CSD
  based on the
   INITIALIZE release saved in the CSD control
  record, without
   considering if a CSD UPGRADE has occurred.
  
  
   The DFHCSDUP INITIALIZE and UPGRADE commands save CICS TS
  release
   information into separate areas in the CSD control
  record. The
   CICS CM DFHCSDUP audit feature obtains the CSD's
  CICS release based
   on the saved INITIALIZE release only.
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of CICS Configuration Manager      *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHCSDUP execution with statically      *
  *                      linked CCVCSDUT module replaces that    *
  *                      module with one dynamically loaded from *
  *                      the LINKLST.                            *
  *                                                              *
  *                      DFHCSDUP audit obtains the CICS TS      *
  *                      release of the CSD based on the         *
  *                      INITIALIZE release saved in the CSD     *
  *                      control record, without considering if  *
  *                      a CSD UPGRADE has occurred.             *
  ****************************************************************
  CICS Configuration Manager provides an auditing feature for
  DFHCSDUP CSD updates, whereby CICS CM modules are linked into
  DFHCSDUP.
  During DFHCSDUP execution, CICS CM attempts to dynamically load
  and thereby replace the statically linked modules CCVCSDUT
  (audit control table) and CCVCSDEX (step termination exit). The
  intent is to provide a method to override these programs with
  customized versions drawn from the STEPLIB data sets assigned in
  the JCL.
  However, if the CICS CM SCCVLINK data set is link listed
  (LINKLST) then stub (uncustomized) versions of those modules
  supplied with CICS CM can be dynamically loaded, replacing
  customized versions statically linked into DFHCSDUP. In this
  case, the audit feature is effectively disabled for the DFHCSDUP
  execution.
  
  The DFHCSDUP INITIALIZE and UPGRADE commands save CICS TS
  release information into separate areas in the CSD control
  record. The CICS CM DFHCSDUP audit feature obtains the CSD's
  CICS release based on the saved INITIALIZE release only.
  

Problem conclusion

• CICS Configuration Manager is corrected.  The dynamic load for
  modules CCVCSDUT (audit control table) and CCVCSDEX (step
  termination exit) is adjusted to honour modules found in the
  STEPLIB or JOBLIB data sets, but not from the LINKLST.
  Therefore, the DFHCSDUP execution will use the CCVCSDUT and
  CCVCSDEX modules linked into DFHCSDUP (refer SCCVSAMP samples
  CCVXDUP5 and CCVXDUP9), unless the STEPLIB or JOBLIB data sets
  contain an override version of those modules.
  
  When obtaining the CICS release of the CSD, both the INITIALIZE
  and UPGRADE releases in the CSD control record are now checked.
  

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:

  UI74540 UI74541 UI74542

Modules/Macros

• CCVCSDUP CCVH0213
  

Fix information

• Fixed component name

  CICS CONFIG MGR

• Fixed component ID

  5697CIC00

Applicable component levels

• R540 PSY UI74540

     UP21/03/24 P F103

• R54E PSY UI74541

     UP21/03/24 P F103

• R54K PSY UI74542

     UP21/03/24 P F103

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.