PM77599: WMQ V701 RFH2 HEADER FORMAT FIELD EMPTY OR GARBAGE NOT MQSTR MQHRF2 FORMAT FIELD INCORRECT WHEN CONVERTING SBCS - DBCS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When a JMS client sends a message as TextMessage, MQRHF2 Format
  field of the message is normally set to MQSTR.
  Intermittently the format field is empty.
  Good case:
  MQRFH2     = ( ['MQHRF2' : 0x492b917220]
  Value):Version        = 2 (INTEGER)
  Value):Format         = 'MQSTR   ' (CHARACTER)
  Bad case:
  MQRFH2     = ( ['MQHRF2' : 0x492b903540]
  Value):Version        = 2 (INTEGER)
  Value):Format         = '' (CHARACTER)    missing format type
  .
  From GTF trace:
  CSQA_INCOMPATIBLE_CCSIDS  00C10016
  .
  The problem occurs when an applicaton, in this case WMB,
  running in code page 1047 (or any other SBCS code page)
  gets a message with an RFH2 from a queue-manager 1399 (or any
  other DBCS code-page).
  CSQMHDRS tries to convert the format field of the RFH2 from
  1399 to 1047, but this conversion is not possible
  the conversion fails and there is 'garbage' in the Format field
  of the RFH2 passed back to the application.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of WebSphere MQ for z/OS Version 7 *
  *                 Release 0 Modification 1 and Release 1       *
  *                 Modification 0.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: When getting messages containing an     *
  *                      MQRFH2 header, the MQRFH2.Format field  *
  *                      incorrectly contains residual values.   *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When getting a message containing message properties (which
  could originally have been part of an MQRFH2 header), CSQMHDRS
  is called to convert the message properties in to a MQRFH2
  header, which is generated in the application's native CCSID.
  When the header is chained into the message, the format field
  from the MQMD is converted from the queue manager's ccsid to the
  application's ccsid, and is then stored in MQRFH2.Format.
  
  If the queue manager is running in a mixed EBCDIC codepage this
  conversion fails, and residual values are copied in to the
  format field.
  

Problem conclusion

• CSQMHDRS is changed to only copy the converted field value over
  the unconverted value if the conversion succeeded.
  010Y
  100Y
  CSQMHDRS
  

Temporary fix

Comments

• ×**** PE13/04/25 FIX IN ERROR. SEE APAR PM84706  FOR DESCRIPTION
  

APAR Information

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

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

  UK90861 UK90862

Modules/Macros

• CSQMHDRS
  

Fix information

• Fixed component name

  WMQ Z/OS V7

• Fixed component ID

  5655R3600

Applicable component levels

• R010 PSY UK90861

     UP13/02/05 P F302

• R100 PSY UK90862

     UP13/02/05 P F302

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.