IBM Support

PH31304: MQ Z/OS V9. SENDER CHANNEL NOT CONVERTING PROPERLY THE ENCODING

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Sender qmgr on z/OS and the receiver qmgr on another platform.
    
    If receiving qmgrs do not support conversion between source
    CCSID and target CCSID, but z/OS qmgrs do, the conversion is
    being done on the sender end.
    
    When converting data, character fields are converted between
    the source and target CCSID, but numeric fields are also
    converted between the source and target encoding.
    
    When a z/OS sender channel is responsible for conversion, the
    encoding is not being converted properly, causing the target
    qmgr to report an invalid encoding value.
    
    Where group messages are being sent over the channel, the
    invalid encoding stops the target qmgr from interpreting the
    MQMDE header correctly, so the group attributes of the message
    are not applied when the message is got from the target queue.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
    *                 Release 0 Modification 0, Release 1          *
    *                 Modification 0 and Release 2 Modification 0. *
    ****************************************************************
    * PROBLEM DESCRIPTION: Depending on the sender and receiver    *
    *                      QMGR CCSIDs, when using CONVERT(YES) on *
    *                      a sender channel to a little-endian     *
    *                      receiver, the MQMD.Encoding may not be  *
    *                      converted to a little-endian format.    *
    *                                                              *
    *                      This can occur when using message       *
    *                      grouping, since version 2 MQMD are      *
    *                      stored internally as a version 1 MQMD   *
    *                      with an MQMDE header.                   *
    ****************************************************************
    In most cases, the conversion of a message is done by the
    receiver QMGR. If the receiver QMGR cannot perform the
    conversion then the message will be converted by the sender QMGR
    before being sent. A defect in this conversion logic can result
    in the MQMD.Encoding not being converted properly when sending
    messages to a little-endian receiver.
    

Problem conclusion

  • The conversion logic has been changed to correctly convert the
    MQMD.Encoding for outbound messages.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH31304

  • Reported component name

    IBM MQ Z/OS V9

  • Reported component ID

    5655MQ900

  • Reported release

    000

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-11-05

  • Closed date

    2020-12-10

  • Last modified date

    2021-02-01

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

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

    UI73050 UI73051 UI73052

Modules/Macros

  • CSQXRMTR
    

Fix information

  • Fixed component name

    IBM MQ Z/OS V9

  • Fixed component ID

    5655MQ900

Applicable component levels

  • R000 PSY UI73050

       UP21/01/28 P F101

  • R100 PSY UI73052

       UP21/01/28 P F101

  • R200 PSY UI73051

       UP21/01/28 P F101

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.

[{"Line of Business":{"code":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.0"}]

Document Information

Modified date:
02 February 2021