PI17725: COMPATIBILITY APAR REQUIRED CONNECTING CICSPLEX SM 5.1 TO CICSPLEX SM 5.2

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Compatibility AAPR for CTS 5.2
  Additional Symptom(s) Search Keyword(s): kixdcfcic690
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V5R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: A compatibility APAR is required to     *
  *                      tolerate private program and library    *
  *                      resources in CTS 5.2.                   *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes and MASes must be recycled  *
  *                 to pick up the new code.                     *
  *                                                              *
  *                 The restarts need not be performed at the    *
  *                 same time, however if systems are not        *
  *                 restarted at the same time, the following    *
  *                 rules apply:                                 *
  *                                                              *
  *                 - Maintenance Point (MP) CMASes must be      *
  *                   restarted on the updated code before       *
  *                   non-MP CMASes.                             *
  *                                                              *
  *                 - If you have more than one MP CMAS and any  *
  *                   of those MP CMASes are connected directly  *
  *                   or indirectly, then those MP CMASes must   *
  *                   be restarted at the same time.             *
  *                                                              *
  *                 - Before a MAS is restarted with the updated *
  *                   code, the CMAS to which the MAS connects   *
  *                   must be running with the updated code.     *
  *                                                              *
  *                 - Before a CMAS running with the PTF that    *
  *                   resolves this APAR connects directly or    *
  *                   indirectly to a CMAS running a higher      *
  *                   release of CPSM, the higher release CMAS   *
  *                   must be restarted so that it is running    *
  *                   with the appropriate PTF from the          *
  *                   following list:                            *
  *                                                              *
  *                   -  CPSM V5R2M0 - the PTF for APAR PI18929  *
  *                                                              *
  *                 Additionally, all API programs that access   *
  *                 the CRESLIBR or CRESPRGM resource tables     *
  *                 should be reassembled or recompiled pointing *
  *                 to the libraries updated by the PTF that     *
  *                 resolves this APAR.                          *
  *                                                              *
  *                                                              *
  *                                                              *
  *                 The PTF that resolves this APAR changes the  *
  *                 format of the CRESLIBR and CRESPRGM records, *
  *                 which are written to the EYUDREP file.  To   *
  *                 ensure that the changed format of the        *
  *                 records does not clash with the previous     *
  *                 format of the records, then                  *
  *                                                              *
  *                   after applying the PTF that resolves this  *
  *                   APAR                                       *
  *                                                              *
  *                 or                                           *
  *                                                              *
  *                   after backing off the PTF that resolves    *
  *                   this APAR                                  *
  *                                                              *
  *                 and                                          *
  *                                                              *
  *                   before restarting a CMAS with the          *
  *                   libraries updated by applying or backing   *
  *                   off the PTF                                *
  *                                                              *
  *                 the EYU9XDUT utility must be run against the *
  *                 CMAS's EYUDREP, specifying the current       *
  *                 version as the target version parameter      *
  *                 (i.e, PARM=('TARGETVER=0510')), with STEPLIB *
  *                 pointing to the SEYUAUTH library updated by  *
  *                 applying or backing off the PTF.  This will  *
  *                 insure that all CRESxxxx records will be     *
  *                 removed from the EYUDREP file.               *
  *                                                              *
  *                 After the CMAS has been restarted, and it    *
  *                 connects and joins to MASes, the proper      *
  *                 versions of the CRESxxxx records will be     *
  *                 written to the CMAS's EYUDREP.               *
  ****************************************************************
  CTS 5.2 adds the concept of private programs and libraries.
  Various updates are required to tolerate this when a CPSM V5R1M0
  CMAS is connected to a CPSM V5R2M0 CMAS.
  

Problem conclusion

• Updates have beem made to tolerate the private program and
  library support added to CTS 5.2.
  

Temporary fix

• *********
              * HIPER *
              *********
  FIX AVAILABLE BY PTF ONLY
  

Comments

• ž**** PE14/09/12 FIX IN ERROR. SEE APAR PI25656  FOR DESCRIPTION
  

APAR Information

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

  PI17722

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

  UI19882

Modules/Macros

• EYU0DVNT EYU0PECD EYU0TICT EYU0TMRF EYU0TMRI EYU0TQSR EYU0TREH
  EYU0TRMC EYU0TSCJ EYU0TSCM EYU0TSCN EYU0TSDD EYU0TSEM EYU0TSG2
  EYU0TSG3 EYU0TSGC EYU0TSLG EYU0TSLM EYU0TSMB EYU0TSMC EYU0TSMD
  EYU0TSMH EYU0TSMI EYU0TSMJ EYU0TSMK EYU0TSMM EYU0TSMR EYU0TSMU
  EYU0TSRA EYU0TSRC EYU0TSRM EYU0TSRR EYU0TSSC EYU0TSSD EYU0TSSE
  EYU0TSSH EYU0TSSJ EYU0TSSM EYU0TSTP EYU0TSXC EYU0XDAD EYU0XDDI
  EYU9PSR3 EYU9PSR4 EYU9PSRU EYUA2802 EYUA2836 EYUC2802 EYUC2836
  EYUE2802 EYUE2836 EYUK2802 EYUK2836 EYUL2802 EYUL2836 EYUP2802
  EYUP2836 EYUS2802 EYUS2836 EYUT2802 EYUT2836 EYUTTTMJ EYUTXDDA
  EYUY2802 EYUY2836
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R80M PSY UI19882

     UP14/07/30 P F407 ½

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.