PM40951: DFHIS0002 RECEIVED AFTER DISABLING APPLICATION TRANSACTIONS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are running CICS TS V4R1, with transactions arriving from
  CICS Transaction Gateway V8R0 over IPIC.  You disabled a number
  of transactions, and thereafter receive message DFHIS0002,
  indicating:
    A severe error (code X'0000') has occurred in module DFHISEM
  .
  Examining the trace, there is an exception trace entry:
    IS 062D,
  which indicates INVALID_MSG_SEQNO.  A "First in Chain" REQ_RECV
  is received by CICS, to which CICS issues RSP_SENT with "Last
  in Chain".  This is followed by a REQ_RECV with "Middle in
  Chain" set, which causes the error.  There is a timing problem
  between the mirror task CSAC and the CISR task receiving the
  chain of records from the socket.
  .
  KIXREVJHD
  .
  ADDITIONAL KEYWORDS:
  IS0002, IPCONN, invalid sequence number, FIC, MIC, LIC,
  CHAIN_SEQ, ISSR, ISSB, IS7
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message DFHIS0002 A severe error (code  *
  *                      X'0000') has occurred in module         *
  *                      DFHISEM.                                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A CTG client sends a DPL request over an IPIC connection which
  contains a large channel exceeding 60K in length, resulting
  in multiple chain elements. Transaction CISR, receives the
  the first of the chain of elements and attempts to attach
  the mirror transaction but this has been disabled. This
  causes DFHXMAT to instead attach the Abnormal Condition
  Transaction - CSAC.
  CSAC begins the process of sending the IS7 error response
  to the client but in doing so it sets the ISSB for the
  connection to send state and and also sets the message
  sequence number to 1. CSAC is then suspended.
  Whilst CSAC is suspended the next element in the chain is
  received and CISR attempts to process this. DFHISRR checks
  the sequence number in the header against the expected sequence
  number stored in the ISSB, however because the CSAC transaction
  has updated this, DFHISRR believes that there is an error and
  returns INVALID_MSG_SEQNO. Transaction CISE is attached to
  send another IS7 to the client to report this error, but CISE
  gets suspended before it completes its processing.
  CSAC is then resumed and completes its processing of the
  original IS7, it then freemains the ISSB control block.
  CISE is resumed and attempts to reference the freemained
  ISSB, resulting in message DFHIS0002 and a system dump.
  
  Additional keywords: msgDFHIS0002 INVALID_MSG_SEQNO
                       TRANS_DISABLED
  

Problem conclusion

• DFHISRR and DFHISXM, DFHISIS have been changed to allow a CSAC
  task to receive all of the elements in a chain before it sends
  an error response to the client because the mirror transaction
  cannot be attached.
  
  The CICS Transaction Server for z/OS Version 4 Release 1
  Supplementary Data Areas GC34-7015-02 has been changed in
  chapter "ISDCC ISC IP Domain Control Blocks",
  
  Change ISSB_FLAG2 ISSB - IS Session Block  Table 38. from
  
   (9B)  BIT(8)  1  ISSB_FLAGS2
    1... ....     *  spare
    .1.. ....     ISSB_CONV_ERROR   Conversation error queued
    ..1. ....     ISSB_ABEND        Task must abend when resumed
    ...1 ....     ISSB_ATTACH_ SENT Attach has been sent
    .... 1...     ISSB_IS7_SENT     Error IS field has been sent
    .... .1..     ISSB_SYSTEM       alloc'd as system_service(yes)
    .... ..1.     ISSB_ORPHANED_ DUE_TO_ERROR
  
  to
  
    (9B)  BIT(8)  1  ISSB_FLAGS2
     1... ....     ISSB_ATTACH_CHAIN xmat failed, chain coming
     .1.. ....     ISSB_CONV_ERROR  Conversation error queued
     ..1. ....     ISSB_ABEND       Task must abend when resumed
     ...1 ....     ISSB_ATTACH_ SENT Attach has been sent
     .... 1...     ISSB_IS7_SENT    Error IS field has been sent
     .... .1..     ISSB_SYSTEM      alloc'd as system_service(yes)
     .... ..1.     ISSB_ORPHANED_ DUE_TO_ERROR
  

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:

  PM46065 UK72594

Modules/Macros

•    DESISIS  DESISRR  DESISXM  DFHISDCC DFHISDCD
  DFHISIS  DFHISISA DFHISISM DFHISIST DFHISRR  DFHISRRA DFHISRRM
  DFHISRRP DFHISRRT DFHISXM
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R600 PSY UK72594

     UP11/10/08 P F110

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.