PI89695: LOOP IN DFHRZSO1 CAUSES A LOT OF DFHAC2007 MESSAGES DURING CICS SHUTDOWN.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Customer has copied CPIH as ZSIH and during shutdown ZSIH is
  looping in DFHRZSO1 repeating an XMAT attach for transaction
  ZSWI. Each attempt gets a CSAC attached as well with DFHAC2007
  as ZSWI is not shutdown enabled.
  
  Trace shows :
  
  41522 L80A2 PG 1900 PGCR  ENTRY INQUIRE_CONTAINER
                 24E26750,DFHWS-ICRX
  41522 L80A2 PG 1901 PGCR  EXIT  INQUIRE_CONTAINER/EXCEPTION
                 CONTAINER_NOT_FOUND,0
  41522 L80A2 XM 1101 XMAT  ENTRY ATTACH
                 ZSWI,NONE,C,NO,NO,RZ_INSTORE_TRPORT
  41522 L80A2 XM 0401 XMLD  ENTRY LOCATE_AND_LOCK_TRANDEF ZSWI
  
  Looking in DFHRZSO1 UI44882 listing, at offset x'A24' is the
  return from the DFHPGCR INQUIRE_CONTAINER DFHWS-ICRX call which
  gets EXCEPTION PGCR_RESPONSE but the code at x'A30' is testing
  for pgcr_purged (6) and as not equal branch to x'A4E' and leads
  back to XMAT attach again at X'B0A'.
  

Local fix

• The transaction had to be defined as dynamic, with the sysid the
  same as the local system.  You also need to have the DSRTPGM SIT
  parameter specify a routing program to use.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: A loop in DFHRZSO1, with continual      *
  *                      DFHAC2007 messages, issued during       *
  *                      shutdown of a CICS system acting as a   *
  *                      web service provider.                   *
  ****************************************************************
  CICS is acting as a web service provider.  A context switch
  occurs as part of the pipeline processing.  This causes a new
  task to be attached using request streams.
  
  At some point one of the context switched transactions is
  defined with a REMOTESYSTEM value and DYNAMIC(NO).  This causes
  code in DFHRZSO1 to incorrectly sets a global routing flag to no
  which indicates that distributed routing of request streams is
  no longer being performed.
  
  When CICS is shutdown a new web service request arrives.  The
  transaction that will be run is defined with SHUTDOWN(DISABLED)
  and DYNAMIC(YES).  The distributed routing exit selects the
  current region to run the transaction.  Due to not being enabled
  for shutdown the task attach fails and CSAC runs instead.  The
  routing exit should be invoked again for route_error processing
  but due to the global routing flag being set to no the exit is
  not called.  Instead the request is marked to run locally and
  another task attach is performed.
  
  DFHRZSO1 is now in a loop attaching CSAC tasks, each of which
  will issue message DFHAC2007.
  
  KEYWORDS: msgdfhac2007 ac2007 ac 2007 request stream streams
            RZ
  

Problem conclusion

• DFHRZSO1 has been changed to not change the setting of the
  global routing flag when processing the attach of a single
  DYNAMIC(NO) transaction.
  

Temporary fix

Comments

• ×**** PE18/03/08 FIX IN ERROR. SEE APAR PI94867  FOR DESCRIPTION
  ×**** PE18/06/19 FIX IN ERROR. SEE APAR PI99329  FOR DESCRIPTION
  

APAR Information

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

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

  UI53949 UI53950

Modules/Macros

• DFHRZDM  DFHRZDUF DFHRZIX  DFHRZLN  DFHRZNR2 DFHRZRG2 DFHRZRM
  DFHRZRS1 DFHRZRT  DFHRZRT1 DFHRZRT2 DFHRZSO  DFHRZSO1 DFHRZTA
  DFHRZTCX DFHRZTR1 DFHRZTRI DFHRZXM
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R000 PSY UI53950

     UP18/02/20 P F802

• R100 PSY UI53949

     UP18/02/21 P F802

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.