ICO0003E   javax.resource.spi.CommException:
ICO0003E:methodname error.
Failed to connect to host [hostname],
port [portnumber].
[java_exception]

Explanation

The IMS™ TM resource adapter was unable to connect to the host and port combination. java_exception indicates the reason for the failure to connect.

User response

Examine java_exception to determine the reason for the failure to connect to the host. Some values for java_exception are:
Table 1. Exceptions for ICO0003E
Exception Description
java.net.UnknownHostException: hostname

The host name that you specified when you configured the connection factory that is used by your application is invalid, or your application specified an invalid host name. Check the spelling of the host name. You might need to use the fully qualified path for the host name or the IP address.

java.net.ConnectException: Connection refused
Some possible reasons for the exception are:
  • The port number is invalid. Ensure that you are using a valid port number for the IMS Connect that is indicated by hostname.
  • The specified port is stopped. Check the status of the port by using the IMS Connect command VIEWHWS. If the port is stopped, its status is NOT ACTIVE. To start the port, use the IMS Connect command, OPENPORT dddd, where dddd is the specified port number.
  • IMS Connect on the specified host is not running. Start IMS Connect on the host system.
  • TCP/IP was restarted without canceling and restarting IMS Connect or issuing STOPPORT followed by OPENPORT on the host.
java.net.SocketException: connect (code=10051)
Some possible reasons for the exception are:
  • The system with the specified host name is unreachable on the Internet Protocol network. Verify that the host system is accessible from the Internet Protocol network by issuing the ping command to the specified host system. Enter the ping command on the system on which the IMS TM resource adapter is running. Start TCP/IP on the host, if it is not started.
  • TCP/IP was restarted but the status of the port that is used by the application was NOT ACTIVE. To correct this situation, take one of the following actions:
    • Use the IMS Connect command OPENPORT dddd, where dddd is the port number, to activate the port.
    • Restart IMS Connect.