A fix is available
APAR status
Closed as program error.
Error description
With the upcoming GA release of CICS Transaction Server for z/OS Version 5 Release 4, a compatibility APAR is required for pre-V5R4M0 CPSM regions before they start communicating with V5R4M0 CPSM regions.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V4R1M0 and V4R2M0 Users * **************************************************************** * PROBLEM DESCRIPTION: A compatibility APAR is required to * * tolerate a task load of zero (0) in a * * CPSM WLM target region, which can occur * * due to changes introduced in CICS * * Transaction Server for z/OS Version 5 * * Release 4 (CTS V5R4M0). * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all CMASes and MASes must be * * restarted. Note that the restarts do not * * need to occur at the same time. * * * * This fix is being provided across all * * pre-V5R4M0 supported releases of CPSM as * * follows: * * * * - CPSM V4R1M0 - APAR PI81778 * * - CPSM V4R2M0 - APAR PI81778 * * - CPSM V5R1M0 - APAR PI81780 * * - CPSM V5R2M0 - APAR PI81780 * * - CPSM V5R3M0 - APAR PI81780 * * * * While the restarts do not need to occur at * * the same time, all pre-V5R4M0 CPSM CMASes * * and MASes should be restarted to run with * * the PTF that resolves the APAR for its * * release, before connecting into a CPSM * * network that contains CPSM V5R4M0 CMASes * * and MASes. * **************************************************************** Updates made in CTS V5R4M0 change most CPSM tasks in a MAS running with both CICS and CPSM at the CTS V5R4M0 level, including all long running MAS tasks, from user to system tasks. As such, it is possible for a CPSM target region running both CICS and CPSM at the CTS V5R4M0 level, to have a task load of zero (0). Updates are required for pre-CTS V5R4M0 CPSM regions to accommodate this: - MAS method EYU0WNAL (WNAL), which runs in a CPSM WLM routing region during route selection processing, must be updated to correct a situation where a task load of zero (0) for a target region could result in an affinity not being created. - CMAS methods EYU0WABA (WABA) and EYU0WABB (WABB), which run in a CMAS to create WLMAWAOR (WABA) and WLMATARG (WABB) resource table records when requested through the CPSM API, WUI or Explorer, must be updated to correct a situation where a task load of zero (0) for a target region could result in the ROUTEWGHT attribute being incorrect. Additionally, another update is required to the CPSM V4R1M0 versions of WABA and WABB to ensure that the ROUTEWGNT attribute calculation is the same as post V4R1M0 versions of CPSM.
Problem conclusion
Updates have been made to WNAL, WABA and WABB to allow for target regions with a task load of zero (0), and the V4R1M0 versions of WABA and WABB have been updated to calculate the ROUTEWGHT attribute the same as post V4R1M0 versions of CPSM.
Temporary fix
********* * HIPER * ********* FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PI81778
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 / Xsystem
Submitted date
2017-05-17
Closed date
2017-05-24
Last modified date
2017-06-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PI81780 UI47507 UI47508
Modules/Macros
CJA0WNAL CJB0WNAL CJC0WNAL EYU0WABA EYU0WABB EYU0WNAL
Fix information
Fixed component name
CICS TS Z/OS V4
Fixed component ID
5655S9700
Applicable component levels
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:
02 June 2017