Message MQJE056 and MQ reason code 2397
 Technote (troubleshooting)
 
Problem(Abstract)
In WebSphere® Application Server, when connecting to a WebSphere MQ server over SSL, you might receive the following messages:

MQJE001: An MQException occurred: Completion Code 2, Reason 2397
MQJE056: Initial negotiation failure
MQJE001: Completion Code 2, Reason 2397
 
Cause
These messages suggest a certificate negotiation problem between the SSL client and server. MQ Reason Code 2397 is MQRC_JSSE_ERROR and is described below:
MQRC_JSSE_ERROR

JSSE reported an error (for example, while connecting to a queue manager using SSL encryption). The MQException object containing this reason code references the Exception thrown by JSSE; this can be obtained by using the MQException.getCause() method. From JMS, the MQException is linked to the thrown JMSException.

This reason code occurs only with Java applications.

Corrective action: Inspect the causal exception to determine the JSSE error.


The MQ Error logs, located in MQ home/qmgrs/queue_manager_name/errors, show further details about the JSSE/authentication problem.
 
Resolving the problem
Make sure that the client and server have the correct matching certificates necessary for the SSL handshake.

More details on how to set up SSL using GSKit or OpenSSL are on the WebSphere MQ support site at:
http://www-306.ibm.com/software/integration/wmq/support/

The support site contains the following technotes on how to set up SSL authentication between an MQ client and server:

How to set up 2-way authentication between a Java client and a queue manager using GSKit as the CA to sign certificates

Step by step setup to configure SSL server side authentication using openssl

 
 
Cross Reference information
Segment Product Component Platform Version Edition
Application Servers Runtimes for Java Technology Java SDK
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > Java Message Service (JMS)
Operating system(s): AIX
Software version: 6.0
Software edition:
Reference #: 1202488
IBM Group: Software Group
Modified date: Apr 6, 2005