IBM Support

PM40783: DFHFC0435 WITH REASON X'90D60022'

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • F4 0257 DFHFC0435 DBV DATA TABLE ACCESS REQUEST FOR A REMOTE
    FILE HAS FAILED FOR REASON X'90D60022'.
    
    In F4 FCT the file is defined REMOTE with SYSID=TRAN .
    In CICS running in F3  with sysid=TRAN the file is defined
    as CICS DataTable (DFHFCT TYPE=CICSTABLE) .
    The issue comes up if the FOR is canceled while the AOR is
    active.
    The same message can be produced some time later when the AOR
    retries the Datatable connect request.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Message DFHFC0435 with reason code      *
    *                      X'90D60022' when a CICS Data table      *
    *                      server partition is restarted.          *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    When a CICS Data Table server partition (FOR) is restarted while
    Data Table client (AOR) partitions are still active, it is
    possible to receive error message DFHFC0435 with reason code
    X'90D60022'.
    
    It is also possible to receive DFHFC0435 for a remote file
    that is not a Data Table as CICS does not know that it is
    not a Data Table when it first tries to open it.
    
    AOR programs that use the Data Table will still work, but
    Function Shipping will be used instead. After approximately
    10 minute intervals, the AOR may retry to connect to the Data
    Table, but it will never be able to do that.
    
    The only way to restore Data Table access is to restart all
    AOR partitions that use the Data Table FOR partition.
    
    DFHDTSVS uses VSE cross-memory services to enable Data
    Table usage. When the FOR opens Data Table services, it requests
    an LX value, which is passed to any AOR that requires Data
    Table access. The AOR must then issue ETCON to receive the
    appropriate cross-memory authorization.
    
    DFHDTSVS expects the FOR to be assigned a new LX value when
    it is restarted, but VSE typically assigns the same value.
    When the AOR tries to re-connect to the Data Table, it believes
    that the LX is still valid, but VSE invalidated it when the
    FOR was shut down. That results in an S0D6 abend with reason
    code 22 for the LX-exception program check.
    
    VSE passes control to the DFHDTSVS error recovery routine and
    indicates that there has been an asynchronous error, and the
    asynchronous error flag results in the DFHFC0435 message.
    
    Additional keywords: msgDFHFC0435 abendS0D6 abend0D6
    

Problem conclusion

  • DFHDTSVS has been changed to ignore the asychronous error flag
    set by VSE so that unnecessary DFHFC messages are not produced.
    
    DFHDTSVS has been changed to detect when the server has been
    restarted and re-issue the ETCON in order to use Data Table
    services instead of Function Shipping.
    
    The CICS Supplementary Data Areas manual LY33-6087-04 has been
    changed in the section "DTSPS Data tables SVC routine anchor
    blocks" to modify DTSPS structures as follows:-
    
    Offset  Type      Len  Name (Dim)       Description
     Hex
      (0)   STRUCTURE  84  DTRGN_ANCHOR     Data Tables Region
                                            Anchor
      . . .
      (44)  CHARACTER   8   DTRGN_INIT_TOD  TOD when CICS logged on
                                            to Data Table Services
                                            as a client
      (4C)  CHARACTER   8   DTRGN_SAVE_TOD  A copy of DTRGN_INIT_TOD
                                            for debugging
    
    Offset  Type      Len  Name (Dim)       Description
     Hex
      (0)   STRUCTURE  56  DTSRV_ELEMENT    Data Tables Server
                                            Element
      . . .
      (30)  CHARACTER   8   DTSRV_INIT_TOD  TOD when CICS logged on
                                            to Data Table Services
                                            as a server
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM40783

  • Reported component name

    CICSTS FOR VSE

  • Reported component ID

    564805400

  • Reported release

    B0P

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2011-06-06

  • Closed date

    2011-08-15

  • Last modified date

    2012-05-15

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

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

Modules/Macros

  •    DFHDTSDS DFHDTSVS
    

Publications Referenced
LY33608704    

Fix information

  • Fixed component name

    CICSTS FOR VSE

  • Fixed component ID

    564805400

Applicable component levels

  • RB0P PSY UK70824

       UP11/10/14 P E511

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":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.1.1","Edition":""}]

Document Information

Modified date:
15 May 2012