IBM Support

PI17722: COMPATIBILITY APAR REQUIRED CONNECTING CICSPLEX SM 3.1 TO CICSPLEX SM 5.2

A fix is available

Subscribe

You can track all active APARs for this component.

 

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 V3R1M0 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 V3R2M0 - the PTF for APAR PI17723  *
    *                   -  CPSM V4R1M0 - the PTF for APAR PI17724  *
    *                   -  CPSM V4R2M0 - the PTF for APAR PI17724  *
    *                   -  CPSM V5R1M0 - the PTF for APAR PI17725  *
    *                   -  CPSM V5R2M0 - the PTF for APAR PI18929  *
    *                                                              *
    *                 Additionally, all API programs that access   *
    *                 the CRESPRGM resource table 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 CRESPRGM record, which is      *
    *                 written to the EYUDREP file.  To ensure that *
    *                 the changed format of the record does not    *
    *                 clash with the previous format of the        *
    *                 record, 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=0310')), 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 V3R1M0
    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 PI25652  FOR DESCRIPTION
    

APAR Information

  • APAR number

    PI17722

  • Reported component name

    CPSM CICS 3.1

  • Reported component ID

    5655M1501

  • Reported release

    100

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2014-05-12

  • Closed date

    2014-07-22

  • Last modified date

    2014-09-18

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

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

    PI17723 PI17724 PI17725 UI19878

Modules/Macros

  •    EYUA2802 EYUC2802 EYUE2802 EYUK2802 EYUL2802
    EYUP2802 EYUS2802 EYUT2802 EYUY2802 EYU0DVNT EYU0PECD EYU0TMRF
    EYU0TMRI EYU0TQSR EYU0TREH EYU0TRMC EYU0TSCJ EYU0TSCM EYU0TSCN
    EYU0TSDD EYU0TSLG EYU0TSMB EYU0TSMC EYU0TSMI EYU0TSMJ EYU0TSMR
    EYU0TSMU EYU0TSRA EYU0TSRC EYU0TSRM EYU0TSRR EYU0TSSC EYU0TSSJ
    EYU0TSSM EYU0TSXC EYU9PSRU EYU9PSR3 EYU9PSR4
    

Publications Referenced
SC34647000    

Fix information

  • Fixed component name

    CPSM CICS 3.1

  • Fixed component ID

    5655M1501

Applicable component levels

  • R100 PSY UI19878

       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.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
22 February 2023