A fix is available
APAR status
Closed as program error.
Error description
CPSM is routing work to a CICS Region that is in the process of shutting down. Instead of passing back a response that let's CPSM know that it is in shutdown process, it returns a TERMERR and instead of the work being rerouted to a Region that's still active it's terminated.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users. * **************************************************************** * PROBLEM DESCRIPTION: Dynamically routed DPL request ends * * with ABENDASPN even though it was * * successfully re-routed to another * * region following notification that the * * original region was in the process of * * being shutdown. * **************************************************************** * RECOMMENDATION: * **************************************************************** A dynamically routed EXEC CICS LINK request to a remote region fails because the partner region is in the process of shutting down. The partner region returns a FMH7 (Abort) with sense codes 081C07D7 (MRO) or 084C0000 (APPC), along with the message DFHAC2007 in the buffer. Although no work has taken place in the partner's region, TCABRPSR (backout required) is incorrectly left on, even though the dynamic routing program is able to route the request successfully to another region. At the next syncpoint the task abended ASPN because TCABRPSR is still set. If a static remote EC LINK request had been issued the failure would have been incorrectly reported as TERMERR instead of SYSIDERR. Additional keywords msgDFHAC2007 msgDFHIR3783 DFHIR3783 msgDFHZC3433 DFHZC3433 TCEMCQU xmer_txn_unavail_during_quiesce CPSM CICSPLEX TCZBRPSR
Problem conclusion
DFHZERH has been modified for APPC processing to look for message DFHAC2007 in the FMH7 buffer when the non-unique sense codes 084C0000 are returned. If found, this is communicated back to DFHISP's Converse processing via the TCTE_SENSE_RC field containing TCEMCQU (x'84'- txn_unavail_during_quiesce). DFHISP has been modified :- For APPC processing to check for sense codes 084C0000 and the Reason for the Sense Code (TCTE_SENSE_RC) being TCEMCQU. For MRO processing to check for unique sense codes 081C07D7. If either is found then SYSIDERR is set and TCABRPSR (backout required) is reset if the DPL request is successfully routed to another region. This fix will also correct other users of DFHISP's CONVERSE e.g. EC START (remote), EC READ FILE (Remote), EC READQ TD (Remote) so that they also produce a SYSIDERR when these sense codes are returned. The documentation in the following manual has been changed :- CICS Transaction Server for z/OS Version 3 Release 2 Data Areas Document Number GC34-6863-00 Change Page 1087 - TCTTE Terminal Entry After TCTETRND replace :- (114) BITSTRING 1 * reserved with :- (114) BITSTRING 1 TCTE_SENSE_RC Reason Code for 084C0000
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PK50963
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
500
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2007-08-15
Closed date
2008-01-30
Last modified date
2008-02-02
APAR is sysrouted FROM one or more of the following:
PK43450
APAR is sysrouted TO one or more of the following:
UK33292
Modules/Macros
DFHISP DFHTCTTE DFHTCTZE DFHZERH
GC34686300 |
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R500 PSY UK33292
UP08/02/01 P F801
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":"3.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":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 February 2008