IBM Support

PI17724: COMPATIBILITY APAR REQUIRED CONNECTING CICSPLEX SM 4.1 OR 4.2 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 V4R1M0 and V4R2M0 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 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 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=0410') if the current *
    *                 release is CPSM V4R1M0 or                    *
    *                 PARM=('TARGETVER=0420') if the current       *
    *                 release is CPSM V4R2M0), 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 V4R1M0
    or V4R2M0 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/15 FIX IN ERROR. SEE APAR PI25736  FOR DESCRIPTION
    ž**** PE14/09/10 FIX IN ERROR. SEE APAR PI25447  FOR DESCRIPTION
    

APAR Information

  • APAR number

    PI17724

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    60M

  • 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:

    PI17722

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

    UI19880 UI19881

Modules/Macros

  • EYUA2802 EYUA2836 EYUC2802 EYUC2836 EYUE2802 EYUE2836 EYUK2802
    EYUK2836 EYUL2802 EYUL2836 EYUP2802 EYUP2836 EYUS2802 EYUS2836
    EYUTXDDA EYUT2802 EYUT2836 EYUY2802 EYUY2836 EYU0DVNT EYU0PECD
    EYU0TICT EYU0TMRF EYU0TMRI EYU0TQSR EYU0TREH EYU0TRMC EYU0TSCJ
    EYU0TSCM EYU0TSCN EYU0TSDD EYU0TSEM EYU0TSGC EYU0TSG2 EYU0TSG3
    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 EYU9PSRU EYU9PSR3
    EYU9PSR4
    

Publications Referenced
SC34703200SC34720400   

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R60M PSY UI19880

       UP14/07/30 P F407 ½

  • R70M PSY UI19881

       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":"4.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
18 September 2014