IBM Support

PK58234: ABEND0C4 IN DFHFCN OFFSET F52 00000F52 WHEN ISSUING SHOWCAT MACRO ON DATA ON INDEX COMPONENT OF VSAM DATASET

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • ABEND0C4 in DFHFCN when issuing SHOWCAT against the data or
    index component of a VSAM cluster. CICS customer would have to
    go out of their way to define a dataset in this format.
    Customer will request the Open that has the .INDEX or .DATA
    component on the dataset. Instead of the RDO definition having
    DSNAME USASSC1.FILEA it has USASSC1.FILEA.INDEX.
    .
    DFHFCN issues a SHOWCAT with the DSNAME to find associations in
    routine FMOCFC08. This returns with RC00 and offset 8, SHWTYPE,
    set to C9 (I) indicating it is an Index entry, SHOWCAT would
    return C4 (D) if the data entry was in the RDO definition.
    .
    Since offset 8 (SHWTYPE) is not a C7 (AIX) or D9 (PATH) CICS
    marks it as ISABASE and branches to routine FMOCFC60 to get the
    associated INDEX and DATA entries.
    .
    In FMOCFC60 CICS sets R2 to the first association and R6 to the
    the number of associations. Since SHOWCAT returned an I (INDEX)
    map, and CICS treats it as a C (CLUSTER) map they set R6 to
    zeros (which is actually Relative Key Position for I type).
    .
    CICS then tries to find the C9 (I) INDEX entry for the first
    association and it's not equal so R2 is bumbed by four bytes to
    the next association and BCTR using R6 (which was 00000000 and
    now goes negative) and try the next association. CICS will stay
    to a page of until we either getto a page of storage that is
    not allocated or is fetch protected and receive ABEND0C4 or
    happen to find a C9 after many BCTRs.
    

Local fix

  • Do not include .INDEX or .DATA on File RDO definition
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS Users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: msgDFHFC0304 and a system dump issued   *
    *                      when attempting to open an INDEX or     *
    *                      DATA component of a file cluster.       *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    If a user mistakenly attempts to open an INDEX or DATA component
    of a file, the request will abend with AEXZ. The console will
    show msgDFHFC0974 followed by msgDFHFC0304 which will issue a
    system dump. This is due to code in DFHFCN being processed on
    the assumption that the request is being made against the base.
    
    Additional Keywords: DFHFC0304 FC0304 0304 .INDEX .DATA
                         msgDFHFC0978 FC0978 0978 811C
    

Problem conclusion

  • Policing code has been added to DFHFCN to ensure that open
    requests against an INDEX or DATA component are rejected with
    console message DFHFC0978 with new return code X'811C' in module
    DFHFCFS.
    
    The CICS Transaction Server for z/OS Version 3 Release 1
    CICS Messages and Codes, GC34-6442-03, Chapter 1: DFH messages;
    DFHFCxxxx messages; DFHFC0978 has been altered.
    There is now an additional return code.
    811C   The open was requested against the data association or
           the index association. The base cluster, AIX or path
           should be specified instead.
    
    The CICS Transaction Server for z/OS Version 3 Release 2
    CICS Messages and Codes, GC34-6827-00, Chapter 1: DFH messages;
    DFHFCxxxx messages; DFHFC0978 has been altered.
    There is now an additional return code.
    811C   The open was requested against the data association or
           the index association. The base cluster, AIX or path
           should be specified instead.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PK58234

  • Reported component name

    CICSTS V3 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    400

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2007-12-17

  • Closed date

    2007-12-21

  • Last modified date

    2008-01-03

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

    PK57143

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

    UK32537 UK32549

Modules/Macros

  •    DFHFCFS  DFHFCN   DFHFCNO  DFHMEFBE DFH58234
    MFHMEFBE
    

Publications Referenced
GC34644203GC34682700   

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R400 PSY UK32537

       UP07/12/25 P F712

  • R500 PSY UK32549

       UP07/12/25 P F712

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.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":"3.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
03 January 2008