PK55498: INCORRECT DATA RECEIVED FROM RETRIEVE COMMAND WHEN DFXXXXXX QUEUENAME WRAPS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• EXEC CICS RETRIEVE command incorrectly returns data to the
  application without stripping off 5 words of header information.
  The problem occurs when the original START command specifies
  RTRANSID, and the DFxxxxxx queue name built by CICS wraps
  around to a DFxxxxxx queue that has not yet been actioned.
  .
  Initially, with RTRANSID specified on the START, DFHEIIC adds
  a 5 word header, and calls DFHICP with a PUT HEADER request.
  DFHICP tests bit ICPUTHDR to see if a header is present, and
  since it is, sets FMH(YES) for the call to DFHTSPT. DFHICP then
  turns off ICPUTHDR. Now when the queue name generated by DFHICP
  wraps around to a DFxxxxxx queue that still exists from a prior
  START FROM command, temporary storage returns a duplicate name
  response to DFHICP. With PQ95134 applied, DFHICP generates a new
  queuename by incrementing the counter, and then retries the
  request. However, since field ICPUTHDR was turned off the first
  time through, DFHICP does not set FMH(YES). So the data is
  written to temporary storage flagged as FMH(NO). And when the
  STARTed task attempts to retrieve the data, it fails because the
  5 word header is not stripped back off.
  .
  Additional keywords:
  CKTI FMH MQOPEN receives MQRC_UNKNOWN_OBJECT_NAME 2085 X'825'
  MQRC2085 MQ 5655F1000 DF tspt_reason  tspt_duplicate_name
  duplicate_name  icp_s_unique_id
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: Invalid data returned on a RETRIEVE     *
  *                      from a STARTed task.                    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  An EXEC CICS START TRANSID RTRANSID FROM command is issued.
  DFHICP constructs the call to DFHTSPT to create the
  associated temporary storage queue. It happens that the same
  queuename already exists, as the result of a long-running
  STARTed task still in the system. This results in DFHICP
  handling the duplicate queuename response and issuing
  another call to DFHTSPT with a new suffix for the name of the
  queue. However, the logic had already turned ICPUTHDR off
  as part of the original request, and so the subsequent call
  to DFHTSPT fails to set the FMH indicator in the domain
  call. This prevents temporary storage from allowing for the
  length of the FMH data within the request. As a result, when
  the STARTed task attempts to retrieve the data, there are
  subsequent errors because the FMH is not stripped off. The
  results are unpredictable, and depend upon decisions the
  application makes based upon the data returned for the
  RETRIEVE command. In the user's case, a trigger message
  placed on a queue contained nulls as the trigger queue.
  MQRC_UNKNOWN_OBJECT_NAME and a 2085 error were returned
  when trying to open the queue.
  KEYWORDS: WMQ WebSphere MQ TSPT TSPTM DFHTSPTM LENGERR
  

Problem conclusion

• DFHICP has been modified to turn off ICPUTHDR after a successful
  call to write the START data to temporary storage.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PK54699

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

  UK31324 UK31326

Modules/Macros

•    DFHICP
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK31324

     UP07/11/22 P F711

• R500 PSY UK31326

     UP07/11/22 P F711

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.