PK32063: RECEIVING DFHIR2321 DURING SHUTDOWN PROCESS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Your AOR regions are running at CICS TS V2.3, got the following
  error during shutdown process, the regions had to be canceled
  and warm started.
  The TOR region (also V2.3) had already shutdown and runs on
  different MVS image from the AOR regions.
  DFHIR2321 T01ACS 604
   MRO/IRC COMMUNICATION BEING TERMINATED. SESSION(S) WITH THE
   FOLLOWING NETNAME(S) ARE STILL ACTIVE:
            TT0ACS   -
  In the trace, we saw the following trace entries happened
  over and over again,
  DD18 CRNP  EVENT - DEQUEUE WORK ELEMENT TYPE
                      (DISCONNECT WHEN POSSIBLE)
                     SESSION NAME T>1  SYSTEM TT0ACS
  DD18 CRNP  EVENT - DEQUEUE WORK ELEMENT TYPE
                     (DISCONNECT WHEN POSSIBLE)
                     SESSION NAME T>2  SYSTEM TT0ACS
  TCP domain shows the following,
  TCTTE.T>1 at offset x'14' - the task # 1491 is associated
  with it.
  TCTTE.T>1 26B3EBD0 TCT TERMINAL ENTRY
     0000  E36EF140 D1000004 269B7000 269B7000
           00061080 0001491C 00000000 00000000
  .
  This task is no longer in system but the TCTTE has a task
  number associated with it.
  .
  A user transaction has been routed to an AOR and completed
  normally.
  During task termination a user TRUE TASK-END got control and
  attempted to function ship a READQ TS back to the TOR.
  During session allocation DFHZISP has call DFHRMLN ADD_LINK
  but failed with an exception response with a reason code
  invalid_syncpoint_state.
  The exception response returned is valid in that case.
  This is because the CICS syncpoimt manager has already been
  invoked(See CICS customization Guide under task-related user
  exit program and limitation).
  The error is returned to the user TRUE as a SYSIDERR
  condition.
  .
  The source of the problem is in the user TRUE where it try to
  use a CICS command that need to register with the CICS
  syncpoint manager.
  However, the error is not handled very well.
  Once DFHZISP ALLOCATE has found a suitable MRO session for the
  function ship request, it update the TCA user chain, TCTTECA
  is updated with the TCA address and TCTE_TRANNUM with TCATXNO.
  Then it call DFHRMLN ADD_LINK which return the exception
  response. DFHZISP then return to the caller with a response of
  x'041C' indicating the failure leaving the TCTTE on the TCA
  user chain and TCTTECA/TCTE_TRANNUM with invalid information.
  That session MRO is now unusable and causes the problem
  experience by the customer during shutdown.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHIR2321 during CICS shutdown because  *
  *                      MRO/IRC session invalidly marked as     *
  *                      still active.                           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  An end of task TRUE attempts to perform a function ship request
  to a remote CICS region. DFHZISP is called to allocate a
  session. This succeeds and the session gets bound to the task.
  Finally, recovery manager is called to add an RMLK link for the
  connection which this task now owns. This is rejected with an
  exception because the task's syncpoint state is not in flight.
  This RMLK exception results in a SYSIDERR being returned on the
  function ship request (EXEC CICS READQ TS) but the session
  remains in an allocated state even though the allocating task
  now terminates.
  This leads to MSGDFHIR2321 during CICS shutdown.
  
  ADDITIONAL KEYWORDS :- DFHZC2352 MSGDFHZC2352 IN_FLIGHT
  

Problem conclusion

• DFHZISP has been changed so that it releases an allocated
  session after a DFHRMLN ADD_LINK failure.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PK27695

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

  UK20512

Modules/Macros

•    DFHZISP
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK20512

     UP06/12/19 P F612

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.