APAR status
Closed as program error.
Error description
The WebSphere MQ V7.5 resource adapter has been deployed into an application server. An application running inside the application server is performing outbound messaging, and calls either the method QueueConnectionFactory.createConnection() or the method QueueConnectionFactory.createConnection(String username, String password) . The method fails with a JMSException containing the message: MQJCA1026: An operation on a domain specific object was not valid
Local fix
Problem summary
**************************************************************** USERS AFFECTED: This issue affects users of: - The WebSphere MQ V7.5 Resource Adapter. - The WebSphere MQ V8.0 Resource Adapter. who have applications that perform outbound messaging and call the methods shown below: - QueueConnectionFactory.createConnection() - QueueConnectionFactory.createConnection(String, String) - TopicConnectionFactory.createConnection() - TopicConnectionFactory.createConnection(String, String) Platforms affected: MultiPlatform **************************************************************** PROBLEM DESCRIPTION: The JMS Specification defines three types of ConnectionFactory objects: - QueueConnectionFactory - TopicConnectionFactory - ConnectionFactory QueueConnectionFactories should be used by JMS applications that want to perform point-to-point messaging and TopicConnectionFactories are used by applications that want to do publish/subscribe messaging. The ConnectionFactory object (also known as a "unified ConnectionFactory") can be used by applications that perform either point-to-point or publish/subscribe messaging. To create a JMS Connection from these objects, applications can call one of the following methods: - ConnectionFactory.createConnection() - ConnectionFactory.createConnection(String, String) - QueueConnectionFactory.createConnection() - QueueConnectionFactory.createConnection(String, String) - QueueConnectionFactory.createQueueConnection() - QueueConnectionFactory.createQueueConnection(String, String) - TopicConnectionFactory.createConnection() - TopicConnectionFactory.createConnection(String, String) - TopiconnectionFactory.createTopicConnection() - TopicConnectionFactory.createTopicConnection(String, String) The methods: - QueueConnectionFactory.createConnection() - QueueConnectionFactory.createConnection(String, String) - TopicConnectionFactory.createConnection() - TopicConnectionFactory.createConnection(String, String) appear on the QueueConnectionFactory and TopicConnectionFactory objects as both of these objects inherit the method from the Connection object (which is their parent). As the JMS Specification did not define what the behaviour should be when one of the four methods shown above were called, the WebSphere MQ V7.5 and V8.0 Resource Adapters contained logic that prevented applications that were performing outbound messaging from calling them. If an application attempted to call one of these methods, a JMSException containing the message: MQJCA1026: An operation on a domain specific object was not valid was generated.
Problem conclusion
The WebSphere MQ V7.5 and V8.0 Resource Adapters have been modified to no longer throw a JMSException if an application calls one of the methods shown below: - QueueConnectionFactory.createConnection() - QueueConnectionFactory.createConnection(String, String) - TopicConnectionFactory.createConnection() - TopicConnectionFactory.createConnection(String, String) --------------------------------------------------------------- The fix is targeted for delivery in the following PTFs: Version Maintenance Level v7.5 7.5.0.5 v8.0 8.0.0.1 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
IT02539
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
2014-06-13
Closed date
2014-09-17
Last modified date
2014-09-17
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
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