PK87588: MIRROR TASK WAITS FOREVER 09/09/08 PTF PECHANGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Mirror tasks started because of a DPL request received from a
  CTG client end up in a DSSR SUSPEND resource IRLINK wait
  forever because the TCTTEs principal and secondary facility
  fields TCTTECA and TCTE_TRANNUM and TCA fields TCATCUCN and
  TCAFCAAA have been initialized incorrectly.
  This problem only occurred when RRMS is used.
  Additional Keywords and Symptoms:
  Batch job using EXCI to open/close VSAM files hangs on
  IRLINK WAIT for resource EXCG.
  XCPRH_IRP_PROTOCOL_ERR IRP_PROTOCOL_ERROR
  DFHEX0002 0620 EX0620 severe error
  MSGDFHEX0002 Severe error x'0620' in DFHXCRPH
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users with PK65373 applied.              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Mirror tasks hang because DFHMIRS takes *
  *                      the wrong codepath when sending a       *
  *                      transactional EXCI DPL response.        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Mirror tasks hang when sending a response to the second or
  subsequent DPL request in a series of transactional EXCI
  requests using RRMS.
  The problem occurs if a DPL request arrives when the mirror task
  associated with the request is performing session cleanup after
  sending the response to the previous request in the series. Code
  added to DFHRXUW by PK65373 examines the state of the mirror
  task when the request arrives. If the mirror task is not already
  waiting for the next request, it is assumed that an
  out-of-sequence request has arrived. The DFHRXUW
  PUT_CLIENT_REQUEST returns a value of NO_AND_NOT_READY to
  DFHCRNP to indicate an out-of-sequence request has arrived. In
  these circumstances the session TCTTE used for the new request
  is not initialized correctly because it is assumed that the
  mirror task is not expecting this request. Specifically
  TCTE_TRANNUM and TCTEURAD are never initialized.
  In fact the mirror task does eventually pick up this request as
  it is not out-of-sequence.
  However, when the response to this request is sent by DFHMIRS,
  the wrong codepath is taken because TCTEURAD has not been set
  in the session TCTTE. The mirror task now hangs.
  TCTTE
  ADDITIONAL KEYWORDS :- RRMS IRLINK
  

Problem conclusion

• UK41496 UK41497
  A new DFHRXUW domain call - SET_READY_STATE has been created to
  allow the mirror task to signal its readiness to receive the
  next request in a series of transactional EXCI DPL requests.
  When the next request arrives, DFHRXUW PUT_CLIENT_REQUEST checks
  this state and will return a RXUW_NEW_UR value of NO_AND_READY
  if the mirror task is logically ready for the next request.
  
  The CICS TS 3.1 Supplementary Data Areas ( GC34690501 ) and
  the CICS TS 3.2 Supplementary Data Areas ( GC34686401 ) will
  be updated. Control block RXUR1 at offset X'D9' will now read :-
  
   (D9) UNSIGNED Prot 1 SERVER_READY        Server task state
  

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:

  PK95604 UK50535 UK50536

Modules/Macros

•    DESRXUR  DESRXUW  DFHCRNP  DFHMIRS  DFHRXUCC
  DFHRXURC DFHRXUR1 DFHRXUR2 DFHRXUW  DFHRXUWA DFHRXUWC DFHRXUWM
  DFHRXUWT DFHRXXMA DFHRXXMM DFHRXXMT
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK50535

     UP09/10/05 P F910

• R500 PSY UK50536

     UP09/10/05 P F910

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.