PH18399: CPSM: INCOMPLETE HOLD DATA ON PH14288 19/10/24 PTF PECHANGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Reviewing the HOLD data for some service applied, there was
  mention of some CPSM related changes:
  .
  UI65181 ++HOLD(UI65181)
  SYSTEM FMID(HCI7200) REASON(ACTION) DATE(19240)
   COMMENT(
   This
  PTF adds a new field, HEXNAME, to the TSQSHR resource table.
  
  This increases the size of TSQSHR resource table records by 16
  
  bytes. After a CMAS has been updated to this PTF level, any
  
  CICSPlex SM API programs which fetch or map the TSQSHR structure
  
   may need to be recompiled to allow for this increase before
  
  reconnecting to that CMAS.
   The TSQSHR structure is mapped by
  copybooks EYUA0100, EYUC0100,
   EYUL0100, EYUP0100.
   ).
   .
  
  The text above is for the 5.5 HOLD data and PTF UI65179 gave
  the same text for CPSM 5.4 - there was an additional mention of
  needing to restart the ESSS at 5.4. When the 5.5 CMAS was
  recycled, the following message was issued and the CMAS was
  isolated from the plex:
  .
  EYUCP0022E Maintenance point for
  plexname on cmasid1 has a lower capability than cmasid2. CMAS
  cmasid2 will be isolated from the CICSplex.
  .
  A dump was also
  take for this CMAS out of CSLT for the LSRT
  transaction:
  EYUXZ0910I cmasid EYU0XZPT
  Dump,cmasid,cmasid,lpar,CMAS,LSRT,task#,TRAC,EYU0CSLT,date,time.
  
  .
  When the MP CMAS was later restarted it seemed to have
  connected and synchronized without issue, but the non-MP CMAS
  remained isolated from the plex. To resolve this isolation
  problem the non-MP CMAS would need to be restarted.
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CPSM Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: The PTFs for APAR PH14288 were          *
  *                      shipped with incomplete ++HOLD data.    *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that solves PH14288,  *
  *                 all regions (including CMAS, WUI and         *
  *                 MAS) must be restarted to pick up the        *
  *                 changes. Note that the restarts do not need  *
  *                 to occur 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, regardless of whether it is  *
  *                   running as a WUI server, is restarted      *
  *                   with the updated code, the CMAS to which   *
  *                   the MAS connects must be running with the  *
  *                   updated code.                              *
  *                                                            . *
  *                 - This fix is being provided across the      *
  *                   following releases of CICSPlex SM:         *
  *                                                            . *
  *                   -  CPSM V5R2M0 - APAR PH14288 / PH18399    *
  *                   -  CPSM V5R3M0 - APAR PH14288 / PH18399    *
  *                   -  CPSM V5R4M0 - APAR PH14288 / PH18399    *
  *                   -  CPSM V5R5M0 - APAR PH14288 / PH18399    *
  *                                                            . *
  *                   Before a CMAS running with the PTF that    *
  *                   resolves this APAR for its release         *
  *                   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 for its release.                       *
  ****************************************************************
  The PTFs for APAR PH14288 were shipped with incomplete
  HOLD data. Information describing the required action
  was included as a Comment in the PTF cover letter, rather
  than as a ++HOLD ACTION item.
  These PTFs must be replaced with new PTFs containing the
  additional ++HOLD ACTION information.
  

Problem conclusion

• UI65178 UI65180 UI65179 UI65182
  The affected PTFs have been superseded by new PTFs containing
  the required HOLD ACTION information.
  

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:

  UI66147 UI66148 UI66149 UI66150

Modules/Macros

• CJF0NAG0 CJFTNAGF CJG0NAG0 CJGTNAGG CJH0NAG0 CJHTNAGH EYU0NAG0
  EYUA0100 EYUC0100 EYUE0100 EYUL0100 EYUP0100 EYUT0100 EYUTNAGF
  EYUTNAGG EYUTNAGH EYUTNAGI EYUY0100
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R00M PSY UI66149

     UP19/10/31 P F910 {

• R10M PSY UI66148

     UP19/10/31 P F910 {

• R20M PSY UI66150

     UP19/10/31 P F910 {

• R90M PSY UI66147

     UP19/11/04 P F911 {

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.