IBM Support

IT38931: Client REST API does not allow newline (CRLF) characters to be delivered to the destination.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Currently the IBM MQ REST API will remove Newlines from the
    message body on the HTTP POST operation.
    
    "Newlines in incoming strings are stripped out on the HTTP POST
    operation. REST applications should not use newlines in messages
    that are sent or published using the REST API, as they will be
    lost."
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This affects users of the IBM MQ REST API.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    Using the REST API to post a message to a Local Queue will
    remove the CR/LF/NL characters from the message.
    
    So that in the following example:
    
    Message Body:
    Line 1
    Line 2
    Line 3
    Line 4
    Line 5
    
    Will be placed on the Local Queue as:
    Line 1Line 2Line 3Line 4Line 5
    

Problem conclusion

  • The REST API has been updated to pass through these characters.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v9.1 LTS   9.1.0.22
    v9.2 LTS   9.2.0.26
    v9.x CD    9.2.4
    
    The latest available maintenance can be obtained from
    'IBM MQ Recommended Fixes'
    https://www.ibm.com/support/pages/recommended-fixes-ibm-mq
    
    If the maintenance level is not yet available information on
    its planned availability can be found in 'IBM MQ
    Planned Maintenance Release Dates'
    https://ibm.biz/mqplannedmaintenance
    
    ---------------------------------------------------------------
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT38931

  • Reported component name

    MQ BASE V9.2

  • Reported component ID

    5724H7281

  • Reported release

    923

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-11-02

  • Closed date

    2022-01-19

  • Last modified date

    2024-06-21

  • 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

    MQ BASE V9.2

  • Fixed component ID

    5724H7281

Applicable component levels

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"923","Line of Business":{"code":"LOB67","label":"IT Automation \u0026 App Modernization"}}]

Document Information

Modified date:
21 June 2024