IBM Support

IT13505: AMQRMPPA PROCESS RECEIVES A PROTOCOL ERROR WHEN ATTEMPTING TO RESUME A SUBSCRIPTION

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • An amqrmppa process receives a protocol error when attempting to
    resume a subscription
    
    An FDC is generated that may look like this:
    
    Probe Id          :- RM680108
    Application Name  :- MQM
    Component         :- rriBadDataReceived
    Program Name      :- amqrmppa
    Major Errorcode   :- rrcE_PROTOCOL_ERROR
    Minor Errorcode   :- OK
    Probe Type        :- MSGAMQ9504
    Probe Severity    :- 2
    Probe Description :- AMQ9504: A protocol error was detected for
    channel
      'XYZ.SVRCONN'.
    FDCSequenceNumber :- 20
    Arith1            :- 29 (0x1d)
    Arith2            :- 4 (0x4)
    Comment1          :- XYZ.SVRCONN
    MQM Function Stack
    ccxResponder
    rrxResponder
    ccxReceiveThreadFn
    cciProcessOne
    cciProcessUserData
    cciProcessAsyncRcv
    rriServerAsyncRcv
    rstReceiveMessageRequest
    rriBadDataReceived
    xcsFFST
    
    -----} zutLookupGet rc=zrcI_NOT_FOUND
    -----{ rriBadDataReceived
    ------{ rrxError
    ------} rrxError rc=rrcE_PROTOCOL_ERROR
    ------{ xcsBuildDumpPtr
    -------{ xcsGetMemFn
    -------} xcsGetMemFn rc=OK
    ------} xcsBuildDumpPtr rc=OK
    ------{ xcsFFST
    

Local fix

  • The problem is caused by the application passing in
    MQHO_UNUSABLE_HOBJ for the object handle when calling MQSUB.  A
    workaround
    for the problem would be to modify the application to pass in
    MQHO_NONE for the handle.
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Users of clients that use the MQSUB MQI call may be affected by
    this problem.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    An MQSUB call is made to resume a managed subscription and it is
    passed a handle containing the value MQHO_UNUSABLE_HOBJ.  A
    subsequent MQGET on the handle which was returned from the MQSUB
    call resulted in an FDC with probe identifier RM680108 being
    generated.
    
    There was a specific check on whether the input handle is
    MQHO_NONE and only if this is the case does the MQ channel code
    store the fact that the client was given a handle back to the
    destination queue for the managed subscription.  An MQGET that
    follows will fail if it tries to reference this handle as the
    channel did not store the fact that the application was returned
    the queue handle.
    

Problem conclusion

  • The code was modified so that it treats an input handle value of
    MQHO_UNUSABLE_HOBJ in the same way as it treats MQHO_NONE.  This
    ensures that the channel stores the fact that the application
    had been returned the queue handle.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v7.5       7.5.0.7
    v8.0       8.0.0.5
    
    The latest available maintenance can be obtained from
    'WebSphere MQ Recommended Fixes'
    http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
    
    If the maintenance level is not yet available information on
    its planned availability can be found in 'WebSphere MQ
    Planned Maintenance Release Dates'
    http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
    ---------------------------------------------------------------
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT13505

  • Reported component name

    WMQ BASE MULTIP

  • Reported component ID

    5724H7241

  • Reported release

    750

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-01-29

  • Closed date

    2016-04-21

  • Last modified date

    2016-05-04

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

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

    PI61239

Fix information

  • Fixed component name

    WMQ BASE MULTIP

  • Fixed component ID

    5724H7241

Applicable component levels

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSDEZSF","label":"IBM WebSphere MQ Managed File Transfer for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
31 March 2023