IBM Support

PK50963: CPSM IS ROUTING WORK TO A CICS REGION THAT'S SHUTTING DOWN. AS A RESULT, CICS PASSES BACK A TERMERR AND THE WORK IS NOT REROUTED.

A fix is available

Subscribe

You can track all active APARs for this component.

 

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
    

Publications Referenced
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