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