APAR status
Closed as program error.
Error description
An MQ V8.0.0.3 classes for Java application subscribes to the topic to receive application activity trace data generated by a queue manager. However, when the application gets a message published on this topic, an exception is thrown containing the message MQJE001: Completion Code '2', Reason '3013' The call stack of the exception is shown below: at com.ibm.mq.headers.MQHeaderIterator.nextHeader() at com.ibm.mq.headers.MQHeaderIterator.next() at com.ibm.mq.headers.MQHeaderList.read() at com.ibm.mq.headers.MQHeaderList.read() at com.ibm.mq.headers.MQHeaderList.<init> at com.ibm.mq.MQMessage.readPropertiesRfh2() at com.ibm.mq.MQMessage.performProcessingAfterGet() at com.ibm.mq.MQDestination.getInt() at com.ibm.mq.MQDestination.get()
Local fix
Problem summary
**************************************************************** USERS AFFECTED: This issue affects users of: - The MQ V8.0 classes for Java who have: - Enabled application activity trace on an MQ V8.0 appliance. - Created a subscription to collect the application activity trace data by following the instructions in the <b>Creating subscriptions to application activity trace</b> topic in the IBM MQ Appliance 8.0.0 section of IBM Knowledge Center (the URI for this topic is http://www-01.ibm.com/support/knowledgecenter/SS5K6E_1.0.0/com.i bm.mqa.doc/monitoring/mo00022_.htm). - Written an MQ V8.0.0.3 classes for Java application that opens the subscription and receives the subscription messages. Platforms affected: MultiPlatform **************************************************************** PROBLEM DESCRIPTION: Application activity trace data is contained within PCF reply messages. The messages consist of a PCF Header, which has the Type field set to: MQCFT_APP_ACTIVITY and a set of parameters containing the trace data. More information about the format of these reply messages can be found in the <b>Application activity trace message reference</b> topic within the MQ V8.0 section of IBM Knowledge Center. The URI for this topic is http://www-01.ibm.com/support/knowledgecenter/SSFKSJ_8.0.0/com.i bm.mq.mon.doc/q037590_.htm?lang=en. When the classes for Java receive a PCF reply message, they look at the the PCF Header, to see what type of reply the message represents. They then perform the appropriate processing on that data. The classes for Java did not recognise the value <b>MQCFT_APP_ACTIVITY</b> as a valid value for the Type field for the MQCFH structure. As such, when attempting to interpret this value, an MQException containing MQ Reason Code 3013 (MQRCCF_STRUCTURE_TYPE_ERROR) was thrown.
Problem conclusion
The MQ classes for Java have been updated to recognise <b>MQCFT_APP_ACTIVITY</b> as a valid value for the Type field for the MQCFH structure. This ensures that any PCF reply messages containing application activity trace data are correctly returned to MQ classes for Java applications. --------------------------------------------------------------- The fix is targeted for delivery in the following PTFs: Version Maintenance Level 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
IT12709
Reported component name
IBM MQ APPL M20
Reported component ID
5725S1400
Reported release
800
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2015-12-16
Closed date
2016-03-11
Last modified date
2016-03-11
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
IBM MQ APPL M20
Fixed component ID
5725S1400
Applicable component levels
R800 PSY
UP
[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SS5K6E","label":"IBM MQ Appliance"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.0","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]
Document Information
Modified date:
11 March 2016