IBM Support

PK51293: RETRY OF REQUESTS FOLLOWING 0878 MUST BE SYNCHRONOUS

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • If VSAM requires additional storage when a request is issued
    from an L9 TCB the request is rejected with an 0878 response
    code. CICS will switch to the QR and retry. Whilst this normally
    works, VSAM can schedule ASY work on a TCB other than the one
    from which the request was made. can schedule ASY work on a TCB
    This means than it could schedule the retry which was issued on
    the QR TCB on an L9 TCB. This could therefore get another 0878.
    
    The solution proposed is to retry the work on QR with options
    SYN WTX. This would therefore prevent an 0878.
    
    The is an additional problem resulting from this solution which
    occurs if the file is NSR. NSR request cannot be SYN. Therefore
    we need to prevent NSR from causing the 0878 in the first place.
    The solution proposed is to run ALL NSR requests on the QR if
    storage protect is on.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users                                    *
    ****************************************************************
    * PROBLEM DESCRIPTION: Transaction abends 0c4 with             *
    *                      STGPROT=YES running on an open tcb      *
    *                      against a file defined for NSR.         *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    When running with STGPROT=YES a program running on an open TCB
    issuing a file control API request against a local NSR VSAM file
    can occasionally get an abend0c4 or an ILLOGIC response with an
    0878 VSAM return code. If this isn't handled the transaction
    will abend AEIU.
    addition keywords
    offset X'FFFF' DFHFCVR AKEA s0c4 abends0c4 abendaeiu rc0878
    FC0001 abendfc0001 RETRY_KEY9_REQUEST 0499 FCVR ED080078
    

Problem conclusion

  • VSAM returns an 0878 response if it is trying to get subpool 0
    storage whilst in key 9. As L9, J9 etc TCBs don't support
    subpool 0 VSAM rejects the request. CICS will then retry on the
    QR TCB. For performance reasons VSAM can execute ASY requests on
    any available TCB, irrespective of the TCB on which they were
    issued. This means that a request issued on a QR TCB could be
    executed on a key 9 TCB and rejected 0878.
    To fix this when the system is defined with STGPROT=YES requests
    are issued with the SYN option.
    DFHFCVR has therefore been amended to run all NSR requests for
    STGPROT=YES on the QR TCB.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PK51293

  • 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-21

  • Closed date

    2007-10-16

  • Last modified date

    2007-11-02

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

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

    UK30252

Modules/Macros

  •    DFHFCFR  DFHFCVR  DFHFCVS
    

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R500 PSY UK30252

       UP07/10/19 P F710

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 November 2007