PI66472: ABEND ARZ2 DFHXMAB DFHIR3783 DFHPI0997 REQUEST STREAMS RZ

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CICS webservice received by CICS v5.3
  is forwarded to an AOR running CICS v5.1.
  .
    The lower release level AOR gets:
  DFHAC2236 Transaction abend ARZ2 in program DFHXMAB.
     Updates to local recoverable resources will be backed out.
  .
    The higher release TOR gets:
  DFHIR3783 Transaction Connected transaction abended ...
  DFHPI0997 PIPELINE xxxx WEBSERVICE yyyy
    The CICS pipeline manager has encountered an error:
  target program unavailable or abended.
  
  DFHAC2246 Transaction termination processing ...
    could not be completed normally
    because a connected system has requested that
    the unit of work be rolled back.
       DFHAC2262 System sent message (sense code 0824089E).
  .
    In the dump of abendARZ2, this trace is issued
  during task initialization:
  .
  XM 1204 XMER  ENTRY SET_DEFERRED_ABEND    ARZ2
  .
   The abend is deferred because the task
  has not been initialized far enough to process the abend.
  As soon as initialization is complete, the abend is processed.
  .
   The problem is due to WLM data sent across from the 5.3 system
  that has a different length than the receiving R5.1 system
  expects.  This is caused by the DFHDYPDS structure.
  WLM data ends up inside the RZ RQS control block.
  The lower release has a smaller size and can't hold the
  larger data sent by R5.3.
    The lower level system should be able to tolerate additional
  data sent from a higher level system by simply ignoring it.
  There doesn't seem to be any reason to abend the request
  given that all the rest of the data is correct.
  
  Additional Symptom(s) Search Keyword(s): KIXREVxxx
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Abend ARZ2 during request stream bind   *
  *                      processing.                             *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  CICS is a web service provider and uses a context switch
  to run the apphandler under a separate task. That task is then
  routed to a different region.  If the web owning region is a 5.3
  region and the AOR is a 5.1 region (or below) the AOR task will
  abend with abend code ARZ2.  The cause of the task's ARZ2 abend
  is the request stream logic called by DFHMRXM during task
  initialisation.  In the bind_xm_client phase the RZ code
  attempts to read in the request sent from the WOR. This involves
  receiving each RZ header in turn. When the WLM header is
  received, the length is not what is expected. This is because
  CICS TS 5.2 increased the size of DFHDYPDS by 208 bytes to add
  CICS cloud resource information for platform, application and
  operation data. The DFHDYPDS structure is part of the r_wlmdata
  field. Since the length of data received is more than is
  expected by CICS TS 5.1 or below, a disaster response is
  returned and abend ARZ2 is issued.
    Note - If the WOR and AOR region levels were reversed then the
  routed task would still abend ARZ2 because the length is not an
  exact match, even though the data is smaller and so could fit in
  the r_wlmdata field.
  KEYWORDS: abendarz2 rzwlmexs
  

Problem conclusion

• DFHRZXM has been changed to tolerate receiving different
  lengths of WLM data. Smaller lengths (implying data came from
  a back level system) are received; the area is already cleared
  to nulls when the rqs block was created. Larger lengths (which
  imply the data came from a higher level system) mean the code
  will receive the amount that will fit into rqs.r_wlmdata.
  After that, the remaining additional data is received into a
  temporary area (rzwlmexs) acquired using rzvp_allocate and then
  discarded.
  

Temporary fix

•             *********
              * HIPER *
              *********
  FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PI66430

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

  UI42132 UI42133

Modules/Macros

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

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R800 PSY UI42132

     UP16/11/14 P F611 ¢

• R900 PSY UI42133

     UP16/11/14 P F611 ¢

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.