PK79893: DFHSM0133 CICS SOS IN ECDSA USING WEB SERVICES, SUBPOOL RZGENRAL LARGE WITH GETMAINS FOR RZISRUE STORAGE.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A  CICS Webservices region with incoming webservice requests
  is hitting SOS in the CICS ECDSA ( DFHSM0133 message )
  .
  A Tranclass is limiting the number of concurrent application
  transactions to 5 (this is as designed, not because of the SOS
  problem).
  The CICS dump taken on the DFHSM0133 message shows that the
  short on storage occurred because a user task is in a loop
  with getmains being issued for 'RZISRUEI' in the RZGENRAL
  subpool. The RZGENRAL subpool has become very large and used
  all of the storage within the EDSALIMIT.
  Previously, leading up to this loop web service requests had
  been arriving in CICS and matched by URIMAP which set the
  user transaction id 'tttt'. A TCLASS limit of 5 has been
  set for this transaction.
  During processing of 'tttt' was a context switch to change the
  required USERID. This caused another 'tttt' task to be started
  but this new transaction hit the TCLASS limit and was suspended.
  After 30 seconds one of the first 5 'tttt' transactions reached
  DTIMOUT limit and abended. In the log we saw messages:
  DFHPI0997 22/01/2009 13:22:14 CICSREG tttt PIPI0001 The CICS
  pipeline manager has encountered an error: unidentified problem.
  DFHPI0507 22/01/2009 13:22:33 CICSREG tttt The CICS Pipeline
  Manager has failed to receive a response from an application
  .
  After this, the loop of getmains started , issued by module
  DFHRZXM.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHSM0133 is issued and CICS is short   *
  *                      on storage above the line when acting   *
  *                      as a Web Service provider.              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  CICS is acting as a Web Service provider. A new request arrives
  and a pipeline task is started to process it. A handler program
  called by the pipeline changes the userid to be used when
  running the target application. This causes a context switch to
  occur and a new task to be started. The handler program didn't
  change the transaction id so the new task runs with the same
  transaction id as the currently running pipeline task. The newly
  attached task is unable to run due to exceeding the
  MAXACTIVE value for the TRANCLASS it is part of.
  
  The pipeline task places the data required by the new task in a
  buffer and then suspends waiting for the new task to complete.
  Eventually the pipeline task times out due to reaching the
  DTIMOUT limit.  The pipeline task then terminates.
  
  The termination of the pipeline task frees up a TRANCLASS slot
  and allows the new task to run. It attempts to receive the
  buffer of data created by the pipeline task. Due to the pipeline
  task no longer being in the system the multi task coordination
  built in to the request streams domain fails to work correctly
  and the new task enters a loop acquiring storage to receive its
  initial data. The loop ends when CICS goes short on storage. The
  storage used is all in the RZGENRAL domain subpool so will not
  be freed and CICS has to be cancelled.
  
  Additional keywords:
  SOS SM0133 DFHSM0133 MSGDFHSM0133 DFHPI0997 MSGDFHPI0997
  DFHPI0507 MSGDFHPI0507 RZCBNOTI
  

Problem conclusion

• DFHPIPM has been changed to obtain an ENQ on a unique resource
  to indicate that it is still active and able to process a
  response from the task attached due to the context switch.
  The use of the ENQ is passed via requeststreams to the
  newly attached task.
  
  DFHRZXM BIND_XM_CLIENT processing has been changed to detect if
  an ENQ is being used and if so, attempt to ENQ on the supplied
  resource. If the task is able to obtain the ENQ then that
  indicates the original pipeline task has terminated.
  Consequently the new task cannot reliably obtain its initial
  data anymore so will now abend ARZ5.
  
  
  The CICS Transaction Server for z/OS CICS Messages and Codes
  Version 3 Release 1 manual (GC34-6442-04) will be updated as
  follows:
  
  In Chapter 3 'Transaction abend codes', Section 'Abend codes
  ARxx' add new abend code ARZ5 at the appropriate point.
  
  ARZ5
  
  EXPLANATION:  The target request stream task detected that
  the source task was no longer active.  The target task is
  unable to process the request it was attached for.
  
  SYSTEM ACTION:  The request fails and the task is
  abnormally terminated with abend code ARZ5. CICS takes a
  transaction dump, unless module DFHDUIO is not loaded.
  
  USER RESPONSE:  Investigate why the source task has
  terminated before this target began initialisation.  There
  may be relevant messages in the CICS log.  Otherwise a CICS
  trace or system dump will be required to identify the
  problem.  One possible cause is that the source task was
  timed out and purged before the target task started.
  
  MODULE:  DFHRZXM
  
  The same change will be made to the CICS Transaction Server for
  z/OS CICS Messages and Codes Version 3 Release 2 manual
  (GC34-6827-01) in Chapter 3 'Transaction abend codes', Section
  'ARxx abend codes.
  

Temporary fix

•             *********
              * HIPER *
              *********
  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:

  UK44059 UK44073

Modules/Macros

•    CHAPT025 DESMRXM  DESPIIS  DESPIPM  DESRZIS
  DESRZRM  DESRZRS  DESRZST  DESRZTC  DESRZTR  DESRZTX  DESRZXM
  DFHMRXM  DFHPIAP  DFHPIISC DFHPIISI DFHPIPM  DFHRZISC DFHRZIX
  DFHRZRM  DFHRZRMC DFHRZRMD DFHRZRSC DFHRZRSD DFHRZRS1 DFHRZSO
  DFHRZSOA DFHRZSOJ DFHRZSOM DFHRZSOT DFHRZSOV DFHRZSO1 DFHRZTA
  DFHRZTCC DFHRZTCX DFHRZTRC DFHRZTRD DFHRZTR1 DFHRZTXC DFHRZXM
  DFH79893
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK44059

     UP09/02/25 P F902

• R500 PSY UK44073

     UP09/02/25 P F902

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.