IBM Support

IC77690: BY DEFAULT, THE WEBSPHERE MQ V7 CLASSES FOR JAVA PUT MESSAGES OUTSIDE OF A SYNCPOINT ON Z/OS

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as documentation error.

Error description

  • When using the WebSphere MQ V7 classes for Java to put a
    message onto a queue on a WebSphere MQ for z/OS queue manager
    using the method:
    
    MQQueueManager.put(int, String, MQMessage)
    
    the message is put outside of SYNCPOINT. The WebSphere MQ V7
    InfoCenter implies that the message should be put inside
    SYNCPOINT.
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users of the WebSphere MQ V7 classes for
    Java who have applications that put messages onto a queue.
    
    Platforms affected:
    All Distributed (iSeries, all Unix and Windows) +Java
    ****************************************************************
    PROBLEM SUMMARY:
    By default, the WebSphere MQ V7 classes for Java specify the
    MQPutMessageOption:
    
    MQPMO_NO_SYNCPOINT
    
    when putting messages onto a queue.
    
    This was not documented, and so caused confusion for customers
    who expected the WebSphere MQ V7 classes for Java to use the
    default value MQPMO_SYNCPOINT.
    

Problem conclusion

  • The JavaDoc for the following methods:
    
    - MQQueueManager.put(int, String, MQMessage)
    - MQQueueManager.put(int, String, MQMessage,
    MQPutMessageOptions)
    - MQQueueManager.put(int, String, String, String, MQMessage)
    - MQQueueManager.put(int, String, String, String, MQMessage,
    MQPutMessageOptions)
    - MQQueueManager.put(int, String, String, String, MQMessage,
    MQPutMessageOptions, String)
    
    have been updated to indicate that messages will be put using
    the MQPutMessageOption MQPMO_NO_SYNCPOINT by default, on all
    platforms.
    
    In addition to this, the JavaDoc for the:
    
    options
    
    field on the:
    
    MQPutMessageOptions
    
    class has also been changed to state that, by default,
    MQPutMessageOptions objects are created with the:
    
    MQPMO_NO_SYNCPOINT
    
    option specified.
    ---------------------------------------------------------------
    

Temporary fix

Comments

APAR Information

  • APAR number

    IC77690

  • Reported component name

    WMQ WINDOWS V7

  • Reported component ID

    5724H7220

  • Reported release

    700

  • Status

    CLOSED DOC

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2011-07-25

  • Closed date

    2011-07-26

  • Last modified date

    2011-07-26

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

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

Fix information

Applicable component levels

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCPQ63","label":"APAR \/ Maintenance"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
26 July 2011