IBM Support

IT12926: MQSUB WITH MQSO_NEW_PUBLICATIONS_ONLY GIVES OPTIONS_ERROR WHEN RESUMING SUBSCRIPTIONS CREATED WITHOUT THAT OPTION

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as unreproducible in next release.

Error description

  • The MQSUB API allows applications to combine the options
    MQSO_CREATE, MQSO_ALTER and MQSO_RESUME to create a subscription
    if it does not exist, or alter/resume an existing subscription.
    The MQSO_NEW_PUBLICATIONS_ONLY option is valid when creating a
    new publication, but MQSUB fails with MQRC_OPTIONS_ERROR if the
    subscription already exists and was created without using the
    MQSO_NEW_PUBLICATIONS_ONLY option.  This makes it impossible to
    issue an MQSUB call that will create a new subscription with the
    MQSO_NEW_PUBLICATIONS_ONLY option and reliably alter/resume an
    existing subscription which was created without that option.
    

Local fix

  • Retry the MQSUB call without the MQSO_NEW_PUBLICATIONS_ONLY
    option if it fails with MQRC_OPTIONS_ERROR.
    

Problem summary

  • IBM has tested an equivalent configuration using combinations of
    the options above. The reported problem could not be recreated.
    
    Accordingly, no product changes have been made under this APAR.
    

Problem conclusion

  • ****************************************************************
    USERS AFFECTED:
    User of WebSphere MQ with subscribing applications.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    The APAR description specifies a problem when using subscription
    options
        00000001 MQSO_ALTER
        00000002 MQSO_CREATE
        00000004 MQSO_RESUME
        00000008 MQSO_DURABLE
        00000020 MQSO_MANAGED 	
        00001000 MQSO_NEW_PUBLICATIONS_ONLY
        00002000 MQSO_FAIL_IF_QUIESCING
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT12926

  • Reported component name

    WMQ BASE MULTIP

  • Reported component ID

    5724H7251

  • Reported release

    800

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2015-12-23

  • Closed date

    2016-09-30

  • Last modified date

    2016-09-30

  • 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

    WMQ BASE MULTIP

  • Fixed component ID

    5724H7251

Applicable component levels

  • R800 PSY

       UP

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

Document Information

Modified date:
30 September 2016