J2CA0056I, WLTC0017E, HWSP1445E, and HWSSL00E Error Messages

Descriptions of the error messages.

J2CA0056I

When IMS™ TM resource adapter throws an exception, it can be caught by a component other than your Java™ application. For example, when you run a deployed application, IMS Connector for Java exceptions are often caught by the WebSphere® Application Server. WebSphere Application Server may then issue its own message, including in it the message from the IMS TM resource adapter exception. For example, when execution timeout occurs, you see the following on the Console:
  • J2CA0056I: The Connection Manager received a fatal connection error
    from the
    Resource Adaptor for resource myConnFactry.  The exception which
    was received is
    ICO0080E:
    com.ibm.connector2.ims.ico.IMSTCPIPManagedConnection@e59583c.
    processOutputOTMAMsg(byte[],IMSInteractionSpec, int) error. 
    Execution timeout has occurred for this interaction.
    The executionTimeout was [0] milliseconds.  The IMS Connect TIMEOUT
    was used.

J2CA0056I is an informational message from WebSphere Application Server. The fatal connection error refers to the fact that IMS Connect closes the socket in the case of an execution timeout, which results in WebSphere Application Server's Connection Manager removing the connection object for the socket from the connection pool.

Another example occurs when a transaction (non-persistent) socket is used for a commit mode 0 interaction. In this case, you see the following on the Console:
  • J2CA0056I: The Connection Manager received a fatal connection error
    from the
    Resource Adaptor for resource  myConnFactry.  The exception which
    was received is
    ICO0089I:
    com.ibm.connector2.ims.ico.IMSTCPIPManagedConnection@6db5d83a.call(Connection,
    InteractionSpec, Record, Record). Non-persistent socket closed for
    Commit Mode 0 IMS transaction.

J2CA0056I is an informational message from WebSphere Application Server. The fatal connection error refers to the fact that IMS Connect closes the transaction socket and the IMS TM resource adapter causes WebSphere Application Server's Connection Manager to remove the connection object for the socket from the connection pool.

WLTC0017E

A local transaction containment (LTC) is used to define the application server behavior in an unspecified transaction context. For example, if a single method within a container managed EJB that has a transaction attribute of NotSupported is called outside of any transaction scope, WebSphere will create a local transaction to handle resources used during the execution of that method. The message above is produced by the WebSphere Transaction Monitor to indicate that the resources enlisted with the LTC were rolled back instead of committed due to setRollbackOnly() being called on the LTC. This message does not require any action by the user and is for your information only.
  • WLTC0017E: Resources rolled back due to setRollbackOnly() being
    called.

Note: The prefix of a WebSphere Application Server message indicates the component that issued the message. You can find documentation of these messages, by component, in Integration Edition's Help using WebSphere Application Server Enterprise > Quick reference > Messages. All messages are documented with user/system action and explanation. These messages are also documented in the WebSphere Application Server Version 5 Information Center.

HWSP1445E

When you provide Connection Properties to the New IMS Service wizard in Integration Edition or when you configure a Connection Factory for use by your Java application, you choose whether or not you are using SSL with the SSLEnabled property. If you are using SSL (SSLEnabled=TRUE), then the port number you provide must be configured as an SSL port in IMS Connect. If you accidentally provide a non-SSL port for your Java application, unexpected results will occur when you run your application.
  • IMS Connector for Java will throw an exception indicating a communication error:
    javax.resource.spi.CommException:
    ICO0003E:
    com.ibm.connector2.ims.ico.IMSTCPIPManagedConnection@56503fc6.connect()
    error.
    Failed to connect to host [CSDMEC13], port [9999].
    [java.net.SocketException:
    Connection reset by peer: socket closed]
  • The following IMS Connect message will be displayed on the MVS™ console:
    HWSP1445E UNKNOWN EXIT NAME SPECIFIED IN MESSAGE PREFIX; MSGID=    
       /9  * !hR, M=SDRC

The first step in establishing an SSL connection involves the SSL handshake protocol, in which the client (IMS Connector for Java) sends the server (IMS Connect) an SSL "Hello" message. In the scenario described above, IMS Connect is waiting for an incoming message on a non-SSL port. When IMS Connect receives the handshake message it interprets it as an OTMA message with a valid Exit name in the prefix and issues message HWSP1445E.

HWSSSL00E

The opposite scenario to the one above occurs when you are not using SSL (SSLEnabled=FALSE), but the port number you provide for your Java application is configured as an SSL port in IMS Connect. In this case:
  • IMS Connector for Java will throw an exception indicating a communication error:
    javax.resource.spi.CommException: ICO0005E:
    com.ibm.connector2.ims.ico.IMSTCPIPManagedConnection@5bcdcdd4.receive()
    error. A communication error occurred while sending or receiving
    the IMS message.
    [java.net.SocketException: Connection reset by peer: socket closed]
  • The following IMS Connect message will be displayed on the MVS console:
    HWSSSL00E Unable to initialize the SSL socket:Error while reading
    or writing data

IMS Connect's attempt to initialize the SSL socket fail, since it does not receive the initial client "Hello" message that is part of the SSL handshake protocol.

Related tasks
Logging and tracing with the IMS TM resource adapter
Related reference
Diagnosing problems when using the IMS TM resource adapter
IMS TM resource adapter messages and exceptions

Feedback