PM40783: DFHFC0435 WITH REASON X'90D60022'

Obtain the fix for this APAR.

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 is sysrouted FROM one or more of the following:

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

Modules/Macros

•    DFHDTSDS DFHDTSVS
  

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.