IMS TM resource adapter messages and exceptions
IMS™ TM resource adapter messages are Java™ exceptions that are thrown by the IMS TM resource adapter itself or by class libraries that it uses (such as the Java class libraries), and have the prefix of ICO.
This topic provides information about exceptions generated by IMS TM resource adapter J2C applications.
The following terms, in italics in the message descriptions that follow, are replaced by specific values at run time.
- hostname
- The TCP/IP host name of the system that is running IMS Connect.
- java_exception
- The Java exception that is thrown.
- length
- The length of the data.
- libraryFileName
- The Local Option native library file name.
- llvalue
- The value of LL.
- maxlength
- The maximum valid length of the data.
- methodname
- The name of the method that is throwing this exception.
- mode
- The type of interaction between the IMS TM resource adapter and the IMS Connect component on the host (as defined in the interactionSpec object).
- nativeMethodName
- The Local Option native method name.
- portnumber
- The port number that is assigned to IMS Connect.
- propertyname
- The name of the property.
- propertyvalue
- The value of the property.
- reasoncode
- The reason code that is returned by IMS Connect.
- For OTMA sense codes, a reason code of 0 indicates that the sense code does not have an associated reason code.
- rectype
- The type of the record.
- returncode
- The return code, formatted in decimal, that is returned by IMS Connect.
- sensecode
- The sense code, formatted in decimal, that is returned from IMS OTMA
- socketexception
- The socket exception.
- source_exception
- The exception thrown when the error first occurred in an internal method.
- source_methodname
- The internal method in which the error first occurred.
- state
- The internal state of the IMS TM resource adapter.
Exceptions generated by IMS TM resource adapter J2C applications
The following exception messages are produced by applications built with the Java EE Connector Architecture class libraries when an error condition is detected.
- ICO0001E
javax.resource.spi.EISSystemException: ICO0001E: methodname error. IMS Connect returned an error: RETCODE=[returncode], REASONCODE=[reasoncode]. reasoncode_string. - ICO0002E
javax.resource.spi.EISSystemException: ICO0002E:methodname error. IMS OTMA returned an error: SENSECODE=[sensecode], REASONCODE=[otmareasoncode]. [source_methodname:source_exception] - ICO0003E
javax.resource.spi.CommException: ICO0003E:methodname error. Failed to connect to host [hostname], port [portnumber]. [java_exception] - ICO0005E
javax.resource.spi.CommException: ICO0005E:methodname error. A communication error occurred during sending or receiving the IMS message. clientID=[clientid][java_exception] - ICO0006E
javax.resource.ResourceException: ICO0006E:methodname error. The value for DataStoreName is null or an empty string. - ICO0007E
javax.resource.NotSupportedException: ICO0007E:methodname error. The [propertyname] property value [propertyvalue] is not supported. - ICO0008E
javax.resource.ResourceException: ICO0008E:methodname error. The value [propertyvalue] of the [propertyname] property exceeds the maximum allowable length of [maxpropertylength]. - ICO0009E
javax.resource.ResourceException: ICO0009E:methodname error. The [propertyname] property value [propertyvalue] is not valid. - ICO0010E
javax.resource.spi.IllegalStateException: ICO0010E:methodname error. The method was invoked on an invalid IMSConnection instance. - ICO0011E
javax.resource.spi.IllegalStateException: ICO0011E:methodname error. The method was invoked on an invalid IMSInteraction instance. - ICO0012E
javax.resource.ResourceException: ICO0012E:methodname error. The value provided for HostName is null or an empty string. - ICO0013E
javax.resource.ResourceException: ICO0013E:methodname error. The ConnectionManager is null. - ICO0014E
javax.resource.ResourceException: ICO0014E:methodname error. The input record contains no data. - ICO0015E
ResourceAdapterInternalException ICO0015E: methodname error. An unexpected error occurred while the OTMA message was being processed. [java_exception] - ICO0016E
javax.resource.ResourceException: ICO0016E:methodname error. The message was encoded using an unsupported code page. [java_exception]. - ICO0017E
ResourceAdapterInternalException ICO0017E:methodname error. Invalid value provided for TraceLevel. - ICO0018E
javax.resource.ResourceException: ICO0018E:methodname error. The value provided for PortNumber is null. - ICO0020E
javax.resource.ResourceException: ICO0020E:methodname error. Alternate client ID is not supported for interaction [interactionverb]. - ICO0024E
javax.resource.ResourceException: ICO0024E:methodname error. Invalid segment length (LL) of [llvalue] in the input object. [java_exception] - ICO0025E
javax.resource.IllegalArgumentException: ICO0025E:methodname error. Invalid segment length (LL) of [llvalue] in the OTMA message. - ICO0026E
javax.resource.ResourceException: ICO0026E:methodname error. An error was encountered while processing the IMS message. [source_methodname:source_exception] - ICO0027E
javax.resource.ResourceException: ICO0027E:methodname error. The OTMA header of the IMS output message did not contain a segment_name segment. - ICO0028E
javax.resource.ResourceException: ICO0028E:methodname error. The Prefix flag in the OTMA header Message-Control Information segment of the IMS output message is not valid. - ICO0030E
javax.resource.spi.ApplicationServerInternalException: ICO0030E:methodname error. [source_methodname:source_exception] - ICO0031E
javax.resource.spi.IllegalStateException: ICO0031E:methodname error. Protocol violation. The interaction verb [interactionverb] is not allowed for the current state [state]. [java_exception] - ICO0034E
javax.resource.NotSupportedException: ICO0034E:methodname error. Auto-commit is not supported. - ICO0035E
javax.resource.NotSupportedException: ICO0035E:methodname error. Local transaction is not supported. - ICO0037E
javax.resource.NotSupportedException: ICO0037E:methodname error. ResultSet is not supported. - ICO0039E
javax.resource.spi.IllegalStateException: ICO0039E:methodname error. Not in CONNECT state. - ICO0040E
javax.resource.NotSupportedException: ICO0040E:methodname error. IMSConnector does not support this version of execute method. - ICO0041E
javax.resource.ResourceException: ICO0041E:methodname error. An invalid interactionSpec [interactionSpec] was specified. - ICO0042E
javax.resource.ResourceException: ICO0042E: methodname error. The input is not of type Streamable. - ICO0043E
javax.resource.ResourceException: ICO0043E: methodname error. The output is not of type Streamable. - ICO0044E
javax.resource.NotSupportedException: ICO0044E:methodname error. RecordFactory is not supported by IMS TM Resource Adapter. - ICO0045E
javax.resource.NotSupportedException: ICO0045E:methodname error. Invalid type of ConnectionRequestInfo. - ICO0049E
javax.resource.NotSupportedException: ICO0049E:methodname error. The security credentials passed to getConnection do not match existing security credentials. - ICO0050E
ICO0050E: methodname error. Invalid RACF user id is specified in SSLKeyStoreName or SSLTrustStoreName when specifying a RACF keystore or truststore. - ICO0053E
javax.resource.ResourceException: ICO0053E: methodname error. The client ID is not value. The prefix HWS is reserved by the IMS TM resource adapter. - ICO0054E
javax.resource.ResourceException: ICO0054E:methodname error. Invalid ConnectionSpec. - ICO0055E
javax.resource.ResourceException: ICO0055E:methodname error. Failed to cast the connection object to IMSConnection. - ICO0056E
javax.resource.ResourceException: ICO0056E:methodname error. IMSConnectName is only valid for Local Option connections which can only be used in z/OS or OS/390. - ICO0057E
javax.resource.spi.IllegalStateException: ICO0057E:methodname error. Invoked with invalid connection handle. - ICO0058E
javax.resource.ResourceException: ICO0058E:methodname error. Interactions SYNC_SEND_RECEIVE, SYNC_SEND, SYNC_RECEIVE_ASYNCOUTPUT, SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT and SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT interactions with Commit Mode 0 are not supported with Local Option. - ICO0059E
javax.resource.ResourceException: ICO0059E: methodname error. SYNC_END_CONVERSATION interaction with Commit Mode 0 is not supported. - ICO0060E
java.lang.UnsatisfiedLinkError: ICO0060E:methodname error. Error loading Local Option native library: libname=libraryfilename. [source_exception]. - ICO0061E
javax.resource.ResourceException: ICO0061E:methodname error. Local Option runs only in z/OS and OS/390. - ICO0062E
javax.resource.ResourceException: ICO0062E:methodname error. Error loading Local Option native method: libfilename=libraryFileName, methodname=nativeMethodName. [source_exception]. - ICO0063E
javax.resource.spi.ResourceAdapterInternalException: ICO0063E:methodname error. Exception thrown in native method. [source_exception]. - ICO0064E
javax.resource.spi.SecurityException: ICO0064E:methodname error. Invalid security credential. - ICO0065E
javax.resource.spi.SecurityException: ICO0065E:methodname error. Error obtaining credential data from the security credential. [source_exception]. - ICO0066E
javax.resource.ResourceException: ICO0066E:methodname error. Error loading WebSphere Application Server Transaction Manager. [source_exception]. - ICO0068E
javax.resource.ResourceException: ICO0068E:methodname error. Error obtaining the transaction object. [java_exception] - ICO0069E
javax.resource.spi.ResourceAllocationException ICO0069E:methodname error. Error obtaining RRS transaction context token. IMSConnResourceException: RRS retcode=[rrs_routinecode]. - ICO0070E
javax.resource.spi.EISSystemException ICO0070E:methodname error. IMS Connect reported an RRS error: IMS Connect Return Code=[returncode], RRS Routine name=[rrs_routine], RRS Return code=[rrs_routinecode]. - ICO0071E
javax.transaction.xa.xAException ICO0071E:methodname error. A communication error occurred when processing the XA commandtype operation. [java_exception] - ICO0072E
javax.transaction.xa.xAException: ICO0072E:methodname error. The associated UR for the Xid is not found. - ICO0073E
javax.transaction.xa.xAException: ICO0073E:methodname error. RRS is not available. - ICO0074E
javax.transaction.xa.xAException: ICO0074E: The RRS rrs_routine call returns with a return code [rrs_routinecode]. - ICO0075E
javax.transaction.xa.xAException: ICO0075E:methodname error. The transaction branch might have been heuristically completed. [rrs_exception] - ICO0076E
javax.resource.ResourceException: ICO0076E:methodname error. An internal error occurred. [rrs_exception] - ICO0077E
javax.resource.ResourceException: ICO0077E:methodname error. The transaction has already rolled back. [rrs_exception] - ICO0078E
javax.resource.ResourceException: ICO0078E: methodname error. A valid user-specified clientID is required for interactions on a dedicated persistent connection. - ICO0079E
com.ibm.connector2.ims.ico.IMSDFSMessageException: ICO0079E:methodname error. IMS returned a DFS message:DFS_message - ICO0080E
javax.resource.spi.EISSystemException: ICO0080E:methodname error. Execution timeout has occurred for this interaction. The executionTimeout was [executionTimeout_value] milliseconds. The IMS Connect TIMEOUT was used. - ICO0081E
javax.resource.spi.EISSystemException: ICO0081E:methodname error. Execution timeout has occurred for this interaction. The executionTimeout value specified was [executionTimeout_value] milliseconds. The value used by IMS Connect was [rounded_executionTimeout_value] milliseconds. - ICO0082E
javax.resource.NotSupportedException: ICO0082E:methodname error. Execution timeout has occurred for this interaction. The executionTimeout value of [{executionTimeout_value}] milliseconds is not supported. The valid range is [{executionTimeout_waitforever_flag}, 0 to {maximum_executionTimeout_value}] milliseconds. The IMS Connect TIMEOUT was used. - ICO0083E
javax.resource.ResourceException: ICO0083E:methodname error. SYNC_SEND_RECEIVE, SYNC_SEND, SYNC_RECEIVE_ASYNCOUTPUT, SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT and SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT interactions with Commit Mode 0 are not valid within the scope of a global transaction. - ICO0084E
javax.resource.ResourceException: ICO0084E:methodname error. An unexpected internal IMS TM Resource Adapter error occurred. [source_method] [source_exception] - ICO0085E
javax.resource.ResourceException: ICO0085E: methodname error. Protocol violation. A user-specified clientID is not allowed for interactions on a shareable persistent socket. - ICO0086E
javax.resource.ResourceException: ICO0086E:methodname error. Invalid value was specified for CommitMode property. - ICO0087E
javax.resource.ResourceException: ICO0087E: methodname error. Protocol violation. commit mode 1 is not allowed for interactions on a dedicated persistent socket. - ICO0088E
javax.resource.ResourceException: ICO0088E: methodname error. Protocol violation. SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT interactions are not allowed on a shareable persistent socket. - ICO0089I
javax.resource.ResourceException: ICO0089I: methodname. Non-persistent socket closed for Commit Mode 0 IMS transaction. - ICO0091E
javax.resource.ResourceException: ICO0091E: methodname error.SSL client context could not be created. [{1}] - ICO0096I
javax.resource.ResourceException: ICO0096I: methodname Warning. Invalid value provided for SSL parameter. - ICO0097E
javax.resource.ResourceException: ICO0097E:methodname error. The given value is invalid for 'SSLEncryptionType'. The value must be 'STRONG' for strong encryption, 'WEAK' for weak (export) encryption or 'ENULL' for null (no) encryption. - ICO0111E
javax.resource.ResourceException: ICO0111E:methodname error. SSLEnabled must be set to FALSE when using Local Option. - ICO0112E
ICO0112E:methodname error. Connection is closed due to transaction timeout. - ICO0113E
javax.resource.spi.CommException: ICO0113E: methodname error. Socket timeout has occurred for this interaction. The socket timeout value specified was [socket_timeout_value] milliseconds. [source_exception:exception_reason] - ICO0114E
javax.resource.ResourceException: ICO0114E: methodname error. The socket timeout value of [socket_timeout_value] milliseconds is not valid. [source_exception:exception_reason] - ICO0115E
javax.resource.spi.CommException: ICO0115E: methodname error. A TCP Error occurred. - ICO0116E
ICO0116E:methodname error. A Common Client Interface error occurred. - ICO0117E
javax.resource.ResourceException: ICO0117E: methodname error. Protocol violation: Commit Mode 1 is not allowed for SYNC_SEND, SYNC_RECEIVE_ASYNCOUTPUT, SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT and SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT interactions. - ICO0118E
javax.resource.ResourceException: ICO0118E: methodname error. Protocol violation. IMS request type 2 (IMS_REQUEST_TYPE_IMS_COMMAND) is not allowed for SYNC_SEND, SYNC_END_CONVERSATION, SYNC_RECEIVE_ASYNCOUTPUT, SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT and SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT interactions. - ICO0119E
javax.resource.ResourceException: ICO0119E: methodname error. A supported SSL provider was not found. [caught_exception] - ICO0121E
javax.resource.ResourceException: ICO0121E: methodname error. Invalid reRoute name value. Prefix HWS is reserved for use by IMS TM Resource Adapter. - ICO0122E
javax.resource.ResourceException: ICO0122E: methodname error. Invalid reRoute value. When purgeAsyncOutput value is true, reRoute value cannot be true. - ICO0123E
javax.resource.NotSupportedException: ICO0123E : methodname error . A Sync Level value of synclevel is not supported for commit-then-send (Commit mode 0) interactions. - ICO0124E
javax.resource.ResourceException: ICO0124E : methodname error . SYNC_SEND_RECEIVE interactions with Sync Level Confirm are not supported with Local Option. - ICO0125E
javax.resource.EISSystemException: ICO0125E : methodname error. An internal error occurred. The status of the IMS transaction associated with this SYNC_SEND_RECEIVE interaction with Commit Mode 1 and Sync Level 1 cannot be determined. - ICO0126E
javax.resource.ResourceException: ICO0126E : methodname error . IMS Connect reported a Commit Mode 1 Sync Level Confirm error: IMS Connect Return Code=[returncode], Reason Code=[reasoncode]. reasoncode_string - ICO0127E
com.ibm.ims.ico.IMSIllegalStateException: ICO0127E : methodname error. Protocol violation. The Mode [mode] is not allowed for the current state [state]. [java_exception] - ICO0128E
javax.resource.NotSupportedException ICO0128E : methodname error. The Sync Level property value of [synclevel] given is invalid. Sync Level NONE (0) and Sync Level CONFIRM (1) are the only values supported by the setSyncLevel(int) method. - ICO0129E
javax.resource.ResourceException: ICO0129E:methodname error. Specifying the Alternate ClientID is not allowed on a dedicated persistent connection. The Alternate ClientID value is supported on shareable persistent socket connections ONLY. - ICO0130E
javax.resource.ResourceException: ICO0130E:methodname error. The ignorePURGCall property is not allowed on a dedicated persistent connection. - ICO0131E
javax.resource.ResourceException: ICO0130E:methodname error. The property ignorePURGCall is not supported for interaction verb [SYNC_END_CONVERSATION or SYNC_RECEIVE_ASYNCOUTPUT_*]. The property ignorePURGCall can only be specified for interaction SYNC_SEND and SYNC_SEND_RECEIVE. - ICO0132E
IMS Connect returned an error during a conversational transaction: RETCODE=[{1}], REASONCODE=[{2}]. {3} - ICO0133E
The interactionVerb must be either SYNC_SEND_RECEIVE or SYNC_END_CONVERSATION when the value of the IMSInteractionSpec property useConvID is true (client-managed conversation state programming model). - ICO0134E
When the value of IMSInteractionSpec property useConvID is true (client-managed conversation state programming model), conversational transactions are supported on shareable persistent socket connections ONLY. - ICO0135E
When the value of IMSInteractionSpec property useConvID is true (client-managed conversation state programming model), conversational transactions are supported with Commit Mode 1 ONLY. - ICO0136I
The duplicate [queue] name name was removed. The list of [queue] names was reset to new_list. - ICO0137I
The maximum length of the property property_name was exceeded. old_property_value has been truncated to old_property_value. - ICO0138E
The value for property_name is invalid. The prefix HWS is reserved for use by IMS TM Resource Adapter. - ICO0139E
The message endpoint threw an exception. endpoint_exception - ICO0140I
Reconnecting in number_of_seconds seconds... - ICO0141E
The endpoint is already active. - ICO0142E
The endpoint is not found. - ICO0143E
An unexpected error occurred when the message was dispatched from IMS to the message endpoint. java_exception - ICO0144E
The IMS TM resource adapter encountered an error while sending the message to IMS. - ICO0145E
The IMS TM resource adapter encountered an error while sending the response message for a synchronous callout request to IMS. java_exception - ICO0146E
An error occurred when the error message for a synchronous callout request was back to IMS. java_exception - ICO0147E
No message listeners were started. There are no queues on which to listen. - ICO0148E
The ActivationSpec activationSpec_name is not supported. - ICO0150E
The IMS TM Resource Adapter is unable to listen for callout messages from IMS on queue queue_name because it is unable to connect to host host_name, port port_number.
Parent topic: Diagnosing problems
Related information: