IBM Support

IT23208: IT IS NOT POSSIBLE TO CONNECT TO MQTT WITHOUT A CLEAN SESSION

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • Closed as program error.

Error description

  • Desc: When using the Mqtt nodes the clean session attribute is
    always set to true, meaning that any messages outstanding for
    the client are deleted upon connection. This is not always the
    behaviour that is desired, some use cases require messages to
    be retained. This APAR adds the environment variable
    MQSI_MQTT_DONT_CLEAN_SESSION. When this environment variable is
    set to any value then the nodes will set the clean session flag
    to false when connecting to Mqtt.
    
    A restart of the Integration Node is required for changes to
    this setting to take effect.
    
    Additional Symptom(s) Search Keyword(s):
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    All users of IBM Integration Bus version 10 using the MQTT
    nodes.
    
    
    Platforms affected:
    z/OS, MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    When using the MQTT nodes the clean session attribute is always
    set to true, meaning that any messages outstanding for the
    client are deleted upon connection. This is not always the
    behaviour that is desired, some use cases require messages to be
    retained.
    

Problem conclusion

  • This APAR adds the environment variable
    MQSI_MQTT_DONT_CLEAN_SESSION. When this environment variable is
    set to any value then the nodes will set the clean session flag
    to false when connecting to MQTT.
    
    A restart of the Integration Node is required for changes to
    this setting to take effect.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v10.0      10.0.0.12
    
    The latest available maintenance can be obtained from:
    http://www-01.ibm.com/support/docview.wss?rs=849&uid=swg27006041
    
    If the maintenance level is not yet available,information on
    its planned availability can be found on:
    http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27006308
    ---------------------------------------------------------------
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT23208

  • Reported component name

    INTEGRATION BUS

  • Reported component ID

    5724J0540

  • Reported release

    A00

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-11-17

  • Closed date

    2018-03-20

  • Last modified date

    2018-03-20

  • 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

    INTEGRATION BUS

  • Fixed component ID

    5724J0540

Applicable component levels

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSNQK6","label":"IBM Integration Bus"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"10.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
20 March 2018