A fix is available
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 number
PH14288
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
90M
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2019-07-09
Closed date
2019-09-06
Last modified date
2019-10-30
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.
[{"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":"5.2","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":"5.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
30 October 2019