PH14288: CMCI DOES NOT RETUN TSQSHR NAME IN HEX

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are using the CICSPlex SM CMCI interface to inquire on
  CICS Shared Temporary Storage (Shared TS) Queues.
  The queue name in all records returned is translated into
  character data, which can lead to a loss of uniqueness
  compared to queue name when represented in hexadecimal.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of CPSM V5.2, V5.3, V5.4 and V5.5. *
  ****************************************************************
  * PROBLEM DESCRIPTION: Using CPSM CMCI interface to get shared *
  *                      temporary queue (TSQSHR) information.   *
  *                      The name of shared TSQs are translated  *
  *                      into characters which may lead to loss  *
  *                      of name uniqueness compared to queue    *
  *                      name when represented in hexadecimal.   *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that solves this      *
  *                 APAR, all regions (including CMAS, WUI and   *
  *                 MAS) must be restarted to pickup 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              *
  *                   -  CPSM V5R3M0 - APAR PH14288              *
  *                   -  CPSM V5R4M0 - APAR PH14288              *
  *                   -  CPSM V5R5M0 - APAR PH14288              *
  *                                                            . *
  *                   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.                       *
  ****************************************************************
  A CICS Shared TSQ name can contain a wide range of characters.
  When the CMCI interface is used to retrieve Shared TSQ records
  from a CICS system, the names returned in the CICS Shared
  TSQueue (cicssharedtsqueue) NAME field will be treated as
  character data. This means that some hex values may be
  translated to other printable characters.
  Where such translation occurs the NAME returned on the CICS
  Shared TSQueue record is not a true representation of the
  TSQ NAME in CICS, and could not be used to request further
  CMCI operations against that queue.
  

Problem conclusion

• A new field, HEXNAME, has been added to the TSQSHR
  resource table. This field is similar to the HEXNAME field
  on the TSQNAME resource table, in that it contains the name
  of the shared TS queue, represented in hexadecimal.
  Module EYU0NAG0 has been modified to support the new
  HEXNAME field on the resource table.
  
  For CICS TS for z/OS V5.5, the CMCI GraphQL server application
  is updated to recognise the new field.
  

Temporary fix

Comments

• ×**** PE19/10/22 FIX IN ERROR. SEE APAR PH18399  FOR DESCRIPTION
  

APAR Information

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

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

  UI65178 UI65179 UI65180 UI65181 UI65182

Modules/Macros

• CJF0NAG0 CJFTNAGF CJG0NAG0 CJGTNAGG CJH0NAG0 CJHTNAGH DFJ@H531
  DFJ@H532 DFJ@H533 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 UI65180

     UP19/09/10 P F909

• R10M PSY UI65179

     UP19/09/07 P F909

• R200 PSY UI65181

     UP19/09/07 P F909

• R20M PSY UI65182

     UP19/09/07 P F909

• R90M PSY UI65178

     UP19/09/11 P F909

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.