PM60735: MQ ADAPTER FAILING BUFFER REALLOCATION RESULTING IN A SOURCE NOT AVAILALBE ERROR ALONG WITH AN MQ 2080 ERROR

APAR status

• Closed as program error.

Error description

• When reading MQ messages, a buffer reallocation error can
  occur resulting in a WTX source not available error.  If the WTX
  MQ adapters trace feature is enabled, it is observed that MQ
  generates a 2080 error and this in turn produces a source not
  available error with WTX.
  
  This error occurs when a buffer reallocation is attempted and
  the from value of the reallocation is greater than 4196.  A
  typical realloation message looks like:
  
  
  buffer reallocation from xxxx to yyyy bytes
  
  If the from value, xxxx, is greater than 4196 an error is
  generated in the WTX MQ adapter trace file of:
  
  Adapter error rc = -1005
  [Message_could_not_be_retrieved_from_the_queue]
  MQSeries warning (ReasonCode = 2080)
  [m4mqsGet] (rc = -1005) *** ERROR ***
  
  This set of messages results in a source not available error to
  the invoking map.
  

Local fix

• WTXCQ - WTX00040259
  TR / TR
  Circumvention: None
  

Problem summary

• Users Affected:
  WebSphere Transformation Extender MQ Adapter users that retrieve
  large input messages.
  
  Problem Description:
  Large input messages cannot be retrieved from a triggered input
  queue.
  
  Platforms Affected:
  ALL
  

Problem conclusion

• The MQ Adapter will handle multiple re-allocation requests when
  attempting to retrieve a large message from an input queue.
  Before this fix, the MQ Adapter would only handle one
  re-allocation request.  A re-allocation request occurs whenever
  the initial buffer size is insufficient to store a given input
  message.  Typically, only one allocation request is needed,
  since MQ usually indicates the correct size after the initial
  message truncation error.  However, in certain environments, the
  MQ API may not return the complete size of the message after the
  first re-allocation.  Now the MQ Adapter will continue
  re-allocating until the entire message has been received without
  truncation.
  
  Delivered in:
  8.3.0.5, 8.4.0.2
  

Temporary fix

Comments

APAR Information

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

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

Fix information

• Fixed component name

  WEBSPHERE LAUNC

• Fixed component ID

  5724M4011

Applicable component levels

• R810 PSY

     UP

• R820 PSY

     UP

• R830 PSY

     UP

• R840 PSY

     UP