IMS TM 资源适配器消息和异常

IMS™ TM 资源适配器消息和异常的扩展和用户操作

当开发使用 IMS TM 资源适配器(也称为 IMS Connector for Java™)的 Java 程序时,可能会遇到程序抛出异常的情况。这些异常有些是由 IMS TM 资源适配器抛出的,而其他异常则是由 IMS TM 资源适配器使用的类库(例如,Java 类库)抛出的。本主题提供了有关 IMS TM 资源适配器 J2C 应用程序生成的异常的信息。

在下面的消息描述中,用斜体显示的下列术语在运行时将被替换为具体的值。

hostname
运行 IMS Connect 的机器的 TCP/IP 主机名。
innermethodname
最初抛出此异常的方法的名称。此异常已被 IMS Connector for Java 捕获,并且正在按照“公共连接器框架”规范重新抛出至另一个异常。
length
数据的长度。
libraryFileName
“本地选项”本机库文件名。
llvalue
LL 的值。
maxlength
数据的最大有效长度。
methodname
当前抛出此异常的方法的名称。
mode
IMS TM 资源适配器与主机上的 IMS Connect 组件之间的交互类型,正如 interactionSpec 中定义的那样。
nativeMethodName
“本地选项”本机方法名。
portnumber
为 IMS Connect 指定的端口号。
propertyname
属性的名称。
propertyvalue
属性的值。
reasoncode
IMS Connect 返回的原因码。
rectype
记录的类型。
returncode
IMS Connect 返回的返回码,采用十进制格式。
sensecode
IMS OTMA 返回的检测代码,采用十进制格式。
socketexception
套接字异常。
source_exception
当在内部方法中首次发生错误时所抛出的异常。
source_methodname
在其中首次发生了错误的内部方法。
state
IMS Connector for Java 的内部状态。

相关阅读资料

IMS Connector for Java J2C 应用程序生成的异常

当检测到错误情况时,使用 Java 2 Platform, Enterprise Edition(J2EE)连接器体系结构(J2C)类库构建的应用程序就会产生下列异常消息。

ICO0001E
javax.resource.spi.EISSystemException:
ICO0001E: methodname error.
IMS Connect returned error:
RETCODE=[returncode], REASONCODE=[reasoncode].
reasoncode_string.

说明: IMS Connect 返回的错误。将不会复用出错的连接。reasoncode_string 提供对 reasoncode(如果有)的简要描述。

用户操作:请检查 MVS™ 控制台并找到相关联的 IMS Connect 错误消息。IMS Connect 错误消息以字符“HWS”开头。有关返回码(returncode)和原因码(reasoncode)值的诊断信息以及 IMS Connect 错误消息,请参阅 IMS Connect Guide and Reference

ICO0002E
javax.resource.spi.EISSystemException:
ICO0002E:methodname error.
IMS OTMA returned error:
SENSECODE=[sensecode], REASONCODE=[otmareasoncode].
[source_methodname:source_exception]

说明: IMS OTMA 返回 NAK 错误。

用户操作:有关该 NAK 错误的检测代码(sensecode)和 OTMA 原因码(otmareasoncode)值的诊断信息,请参阅 IMS OTMA Guide and Reference。注意,IMS Connector for Java 将以十进制显示 sensecodeotmareasoncode。如果应用程序正在采用两阶段落实运行,您可能会随 NAK 错误接收到下列检测代码值:
  • 检测代码 = 17 (decimal, 23 Hex)

    未启用 IMS 进行 RRS 处理。确保 IMS 在启用了 RRS 的情况下进行“受保护对话”处理。有关更多信息,请参阅两阶段落实先决条件

  • 检测代码 = 46 (decimal, 2E Hex)

    IMS Connect 和 IMS Connector for Java 都不支持 RRS 和两阶段落实处理。确保 IMS Connect 和 IMS Connector for Java 的版本至少都是版本 2.1.0 或更高版本。

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

说明: IMS Connector for Java 未能连接至主机和端口。java_exception 指示了连接失败的原因。有关其他信息,请参阅下面的“用户操作”部分。

用户操作:请检查 java_exception 以确定未能连接至主机的原因。java_exception 的一些值是:
  • java.net.UnknownHostException:hostname

    您在配置应用程序所使用的连接工厂时指定的主机名无效,或者应用程序指定了无效主机名。检查主机名的拼写是否正确。可能需要使用主机名或 IP 地址的标准路径。

  • java.net.ConnectException:连接被拒绝
    发生该异常的一些可能原因是:
    • 端口号无效。确保 IMS Connect 正在使用由 hostname 指示的有效端口号。
    • 指定的端口已停止。可以使用 IMS Connect 命令 VIEWHWS 来确定该端口是否已停止。如果该端口已停止,其状态将为 NOT ACTIVE(不活动)。使用 IMS Connect 命令 OPENPORT dddd 来启动该端口,其中 dddd 就是指定的端口号。
    • 指定主机上的 IMS Connect 未运行。在该主机上启动 IMS Connect。
    • 在下列情况时重新启动了 TCP/IP:没有先取消再重新启动 IMS Connect 的情况下;或者没有在主机上发出 STOPPORT 然后发出 OPENPORT 的情况下。
  • java.net.SocketException:连接(代码=10051)
    发生该异常的一些可能原因是:
    • 在 TCP/IP 网络上无法访问具有指定主机名的机器。确保在 TCP/IP 网络中可以访问该主机。通过对指定的主机发出 ping 命令来验证是否可以对其进行访问。在正在运行 IMS Connector for Java 的机器上输入 ping 命令。如果该主机上尚未启动 TCP/IP,则将其启动。
    • 虽然重新启动了 TCP/IP,但是应用程序使用的端口的状态为 NOT ACTIVE(不活动)。要更正这种情况,请执行下列其中一项操作:
      • 使用 IMS Connect 命令 OPENPORT dddd 来激活该端口,其中 dddd 是端口号
      • 重新启动 IMS Connect
ICO0005E
javax.resource.spi.CommException:
ICO0005E:methodname error.
A communication error occurred while sending or receiving the IMS message.
[java_exception]

说明: IMS Connector for Java 未能成功地完成与目标 IMS Connect 之间的发送和接收交互。java_exception 指示未能完成该交互的原因。有关其他信息,请参阅下面的“用户操作”部分。

用户操作:请检查 java_exception 以确定该故障的原因。java_exception 的一些值是:

ICO0006E
javax.resource.ResourceException:
ICO0006E:methodname error.
The value provided for DataStoreName is null or an empty string.

说明:使用空的 DatastoreName 参数调用了 methodname 中所指示的方法。当使用空的 DatastoreName 参数启动连接工厂时,此错误消息就会出现在跟踪日志中。此消息后面将接着出现一条 J2EE 连接器警告:

J2CA0007W: An exception occurred while invoking method setDataStoreName on
com.ibm.connector2.ims.ico.IMSManagedConnectionFactory used by resource
Connection_Factory_JNDI_name.
在 IMS Connect 发送响应之后,处理将继续导致其他错误消息,指出找不到具有 null 名称的数据存储器。触发其他消息的基本消息是:
javax.resource.spi.EISSystemException: ICO0001E:
com.ibm.connector2.ims.ico.IMSTCPIPManagedConnection@.processOutputOTMAMsg(byte[],
InteractionSpec, Record) error. IMS Connect returned error: RETCODE=[4],
REASONCODE=[NFNDDST ]. Datastore not found.
发生此错误时,在正在运行 IMS Connect 的主机的 MVS 控制台上就会显示相应的 HWSS0742W 警告消息。此 HWSS0742W 消息将提供一个字段来显示试图查找的数据存储器名称,但在这种情况下该字段全部为空白:
DESTID=        ;

用户操作:请为 DatastoreName 参数提供有效名称。在受管环境中,DatastoreName 是在您配置连接工厂以供 WebSphere Application Server 使用时指定的。而在非受管环境中,DatastoreName 是在 Java 应用程序中指定的。

ICO0007E
javax.resource.NotSupportedException:
ICO0007E:methodname error.
The [propertyName] property value [propertyValue] is not supported.

说明:propertyName 属性指定的值 propertyValue 不受支持。

用户操作:请为指定的属性提供一个受支持的值。例如,此发行版的 IMS Connector for Java 中的 IMSInteractionSpec 类就不支持在 J2C 体系结构中为 InteractionSpec 类的 InteractionVerb 属性定义的某些值。另外,在专用持久套接字连接上也不支持 ReRoute 的值为 TRUE。

ICO0008E
javax.resource.ResourceException:
ICO0008E:methodname error. The value [propertyValue] of the [propertyName]
property exceeds the maximum allowable length
of [maxPropertyLength].

说明:propertyName 属性提供的值 propertyValue 的长度超过了 maxPropertyLength,这是 propertyName 属性值允许的最大长度。

用户操作:请为指定属性提供一个长度不超过 maxPropertyLength 的值。

ICO0009E
javax.resource.ResourceException:
ICO0009E:methodname error.
The [propertyName] property value [propertyValue] is invalid.

说明:propertyName 属性指定的值 propertyValue 无效。

用户操作:请提供一个对于指定属性有效的值。例如,IMSInteractionSpec 类的 Javadoc 文档中就列示了 IMS TM 资源适配器的 InteractionSpec 类的 InteractionVerb 属性的有效值。

ICO0010E
javax.resource.spi.IllegalStateException:
ICO0010E:methodname error.
Method invoked on invalid IMSConnection instance.

说明:对无效的 IMSConnection 实例调用了 methodname 中所指示的方法。如果 methodnamelazyEnlist,则尝试在当前事务中加入未能加入的连接。

用户操作:很可能对一个已关闭的 IMSConnection 实例发出了指定的方法。

  • 如果 methodname 不是 lazyEnlist,则在试图使用或关闭 IMSConnection 实例之前确保它尚未关闭。
  • 如果 methodnamelazyEnlist,则应确保应用程序在受管环境中使用的不是非受管连接,这是因为只有受管连接才适用于“懒惰事务参与优化”。有关更多信息,请参阅在 WebSphere Application Server 6.0 在线信息中心中找到的延迟参与这一主题。
ICO0011E
javax.resource.spi.IllegalStateException:
ICO0011E:methodname error.
Method invoked on invalid IMSInteraction instance.

说明:对无效的 IMSInteraction 实例调用了 methodname 中所指示的方法。

用户操作:很可能对一个已关闭的 IMSInteraction 实例发出了指定的方法。在试图使用或关闭 IMSInteraction 实例之前确保它尚未关闭。

ICO0012E
javax.resource.ResourceException:
ICO0012E:methodname error.
The value provided for HostName is null or an empty string.

说明:使用 null 或空的 HostName 参数调用了 methodname 中所指示的方法。

用户操作:请提供有效的 HostName 参数。在受管环境中,属性值是在您配置连接工厂以供 WebSphere Application Server 使用时指定的。而在非受管环境中,属性值是在 Java 应用程序中指定的。

ICO0013E
javax.resource.ResourceException:
ICO0013E:methodname error.
ConnectionManager is null.

说明:调用了 methodname 中所指示的方法。应用程序服务器使用值为 null 的 ConnectionManager 对象调用了 IMSManagedConnectionFactory 类的 createConnectionFactory 方法。

用户操作:请提供有效的 HostName 参数。这种形式的 createConnectionFactory 方法用于受管环境中。客户机程序通常不会调用这种方法。请与应用程序服务器的服务人员联系。

ICO0014E
javax.resource.ResourceException:
ICO0014E:methodname error.
Input record contains no data.

说明:使用一个不包含任何数据的输入记录调用了 methodname 中所指示的方法。

用户操作:请确认所提供的输入记录不为空。

ICO0015E
ResourceAdapterInternalException
ICO0015E:methodname error.
Unexpected error encountered while processing the OTMA message.
[java_exception]

说明:当处理 OTMA 消息时遇到意外的内部错误。

用户操作:请与 IBM® 服务代表联系。

ICO0016E
javax.resource.ResourceException:
ICO0016E:methodname error.
The value provided for DataStoreName is null or an empty string.

说明:使用空的 DatastoreName 参数调用了 methodname 中所指示的方法。当使用空的 DatastoreName 参数启动连接工厂时,此错误消息就会出现在跟踪日志中。此消息后面将接着出现一条 J2EE 连接器警告:

J2CA0007W: An exception occurred while invoking method setDataStoreName on
com.ibm.connector2.ims.ico.IMSManagedConnectionFactory used by resource
Connection_Factory_JNDI_name.
在 IMS Connect 发送响应之后,处理将继续导致其他错误消息,指出找不到具有 null 名称的数据存储器。触发其他消息的基本消息是:
javax.resource.spi.EISSystemException: ICO0001E:
com.ibm.connector2.ims.ico.IMSTCPIPManagedConnection@.processOutputOTMAMsg(byte [],
 InteractionSpec, Record) error. IMS Connect returned error: RETCODE=[4],
REASONCODE=[NFNDDST ].  Datastore not found.
发生此错误时,在正在运行 IMS Connect 的主机的 MVS 控制台上就会显示相应的 HWSS0742W 警告消息。此 HWSS0742W 消息将提供一个字段来显示试图查找的数据存储器名称,但在这种情况下该字段全部为空白:
DESTID=        ;

用户操作:请为 DatastoreName 参数提供有效名称。在受管环境中,DatastoreName 是在您配置连接工厂以供 WebSphere Application Server 使用时指定的。而在非受管环境中,DatastoreName 是在 Java 应用程序中指定的。

ICO0017E
ResourceAdapterInternalException
ICO0017E:methodname error.
Invalid value provided for TraceLevel.

说明:指定了无效的跟踪级别。

用户操作:请指定有效的跟踪级别。(可选)由于将对此连接工厂使用缺省跟踪级别,因此其实可以忽略该异常。在此情况下,该连接工厂仍然可用,但是,跟踪级别将为缺省跟踪级别。

ICO0018E
javax.resource.ResourceException:
ICO0018E:methodname error.
The value provided for PortNumber is null.

说明:使用值为 null 的 PortNumber 调用了 methodname 中所指示的方法。

用户操作:请提供有效的 PortNumber 参数。在受管环境中,属性值是在您配置连接工厂以供 WebSphere Application Server 使用时指定的。而在非受管环境中,属性值是在 Java 应用程序中指定的。

ICO0020E
javax.resource.ResourceException:
ICO0020E:methodname error.
Alternate ClientID is not supported for Interaction Verb [Interaction Verb].
Alternate ClientID can only be specified for Interaction Verbs SYNC_RECEIVE_ASYNCOUTPUT,
SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT, and SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT.

说明:对备用 clientID 检索异步输出交互指定的交互动词值无效。

用户操作:请提供有效交互动词值。对于交互动词 SYNC_RECEIVE_ASYNCOUTPUT、SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT 和 SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT,只能指定备用 ClientID。

ICO0024E
javax.resource.ResourceException:
ICO0024E:methodname error.
Invalid segment length (LL) of [llvalue] in input object.[java_exception]

说明:由 Java 程序为 IMS 应用程序提供的输入消息的段长度值为:负数、0 或者大于消息段中数据的字节数。

用户操作:请为输入消息的段长度提供正确的值。

ICO0025E
javax.resource.IllegalArgumentException:
ICO0025E:methodname error.
Invalid segment length (LL) of [llvalue] in OTMA message.

说明:IMS 应用程序为输出消息提供的段长度的值为:负数、0 或者大于消息段中数据的字节数。IMS 应用程序提供的输出消息包含在 OTMA 消息中。

用户操作:请确保 IMS 应用程序为它的输出消息中的各个段提供有效长度。

ICO0026E
javax.resource.ResourceException:
ICO0026E:methodname error.
An error was encountered while processing the IMS message.
[source_methodname:source_exception]

说明:处理 IMS 事务输入或输出消息时出错。 source_exception 提供了有关错误原因的更多信息。

用户操作:请检查 source_exception 以获取有关错误原因的更多信息。需要根据 source_exception 的值来执行的一些建议操作是:
  • java.io.IOException

    准备输入或输出记录时出错。确保为 J2C 体系结构正确定义了提供给 IMS Connector for Java 以用作 IMS 事务输入和输出的对象。例如,确保它们要实现 javax.resource.cci.Recordjavax.resource.cci.Streamable 接口。

  • com.ibm.ims.ico.IMSConnResourceException

    包含 IMS 事务输出消息的 OTMA 消息中包含无效的长度字段,即,LLLL <= 0。如果在验证 IMS 应用程序返回有效输出消息之后仍然产生此错误,请与 IBM 服务代表联系。

  • java.lang.IllegalArgumentException

    从 IMS Connect 返回的输出消息无效。确保 IMS Connector for Java 和 IMS Connect 的发行版级别兼容。例如,如果使用 IMS Connector for Java V2.1 来构建一个处理事务所必需的 EJB 应用程序以通过 TCP/IP 执行两阶段落实事务,而您在运行时使用 IMS Connect V1.2 而不是 V2.1,则会产生此错误消息。因此,可以更新为 IMS Connect V2.1,或者创建一个非全局事务的 EJB 应用程序。

ICO0027E
javax.resource.ResourceException:
ICO0027E:methodname error.
The OTMA header of the IMS output message did not contain a segment_name segment. 

说明: IMS 事务输出消息中的 OTMA 头未正确构建。它没有包含 segment_name 所标识的段。

用户操作:请通过构建消息头的方式来更正此问题。例如,发生这种错误的一种情况是:执行 SYNC_RETRIEVE_ASYNCHOUTPUT_WAIT(或 _NOWAIT)交互(例如,3270 终端交互)以检索由非 IMS Connector for Java 客户机进行排队的消息。由非 IMS Connector for Java 客户机进行排队的消息通常不包含 IMS Connector for Java 所需的 OTMA 头。要更正此情况,请确保 IMS Connector for Java 和非 IMS Connector for Java 客户机对其各自的异步输出使用的是单独的队列。

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.

说明: IMS 事务输出消息中的 OTMA 头未正确构建。OTMA 头中的前缀标记指定在消息的 OTMA 头中应包含哪些段,但是消息的总长度(应包含头和消息数据)小于指定头的长度之和。消息总长度应等于或大于头的总长度,具体情况取决于消息是否包含任何数据,但决不能小于头的总长度。

用户操作:请通过构建消息头的方式来更正此问题。导致这种情况的原因通常是:用户消息错误地修改了消息头;IMS Connect 或 IMS Connector for Java 出现内部错误。如果使用的用户出口是随产品提供的,未做任何修改,或者您无法确定消息头未能正确构建的原因,请与 IBM 服务代表联系。

ICO0030E
javax.resource.spi.ApplicationServerInternalException:
ICO0030E:methodname error.
[source_methodname:source_exception]

说明:交互期间,在 methodname 中检测到运行时错误或异常。source_methodname:source_exception 指示在 methodname 中检测到的错误或异常最初发生的位置,还可能会提供有关该错误的原因的更多信息。

用户操作:请检查 source_exception 以获取有关错误原因的更多信息。应根据 source_methodname:source_exception 的值来执行相应的操作。需要根据 source_methodname:source_exception 的值来执行的一些建议操作是:
  • java.lang.OutOfMemoryError

    如果 Java 虚拟机由于内存不足,且垃圾回收器无法提供更多可用内存而无法分配某个对象时,则将抛出此错误。增加可供 WAS 使用的虚拟机使用的内存量。

  • java.io.InterruptedIOException

    抛出 InterruptedIOException,指出输入或输出传输因执行它们的线程终止而终止。调查该线程终止的原因。

ICO0031E
javax.resource.spi.IllegalStateException:
ICO0031E:methodname error.
Protocol violation. The Interaction Verb [interactionverb] is not allowed for
the current state [state].
[java_exception]

说明:应用程序尝试执行的交互导致了协议违例。[interactionverb] 是用于交互的 IMSInteractionSpec 对象的 interactionVerb 属性的值。[state] 是用于 IMS Connector for Java 与 IMS Connect 之间的交互的协议的当前状态。

例如,如果 Java 程序没有与 IMS 进行对话,但是尝试了使用 interactionVerb 属性的 SYNC_END_CONVERSATION 值来与 IMS 进行交互,这样就会发生协议违例。

用户操作:请确保对 IMSInteractionSpec 的 interactionVerb 属性使用正确的值。查阅 IMS Connector for Java 文档,以了解 IMS Connector for Java 支持的 interactionVerb 属性的值。IMS Connector for Java 的特定发行版可能无法支持 J2EE 连接器体系结构定义的所有值。

ICO0034E
javax.resource.NotSupportedException:
ICO0034E:methodname error.
Auto-commit not supported.

说明: IMS Connector for Java 当前不支持自动落实。

用户操作:请确保 Java 应用程序使用适合于 IMS Connector for Java 当前提供的支持级别的类和方法。

ICO0035E
javax.resource.NotSupportedException:
ICO0035E:methodname error.
Local Transaction not supported.

说明: IMS Connector for Java 当前不支持“本地事务”。

用户操作:请确保 Java 应用程序使用适合于 IMS Connector for Java 当前提供的支持级别的类和方法。

ICO0037E
javax.resource.NotSupportedException:
ICO0037E:methodname error.
ResultSet not supported.

说明: IMS Connector for Java 当前不支持 ResultSet。

用户操作:请确保 Java 应用程序使用适合于 IMS Connector for Java 当前提供的支持级别的类和方法。

ICO0039E
javax.resource.spi.IllegalStateException:
ICO0039E:methodname error.
Not in CONNECT state.

说明: IMS Connector for Java 与 IMS Connect 之间的交互顺序无效。用于 IMS Connector for Java 与 IMS Connect 之间的交互的协议的当前状态不是 CONNECT,而交互中此时又要求它处于该状态。

用户操作:这很可能是 IMS Connector for Java 或 IMS Connect 中出错了。请与 IBM 服务代表联系。

ICO0040E
javax.resource.NotSupportedException:
ICO0040E:methodname error.
IMSConnector does not support this version of execute method.

说明: IMS Connector for Java 不支持以下形式的 execute 方法:采用两个输入参数,并且返回 javax.resource.cci.Record 类型的对象。

用户操作:请在 IMSInteraction 类中使用受支持的 execute 方法。受支持的 execute 方法具有以下特征:

boolean execute(InteractionSpec, Record input, Record output)
ICO0041E
javax.resource.ResourceException:
ICO0041E:methodname error.
Invalid interactionSpec specified [interactionSpec].

说明:将无效的 InteractionSpec 对象传递给了 com.ibm.connector2.ims.ico.IMSInteraction 类的 execute 方法。

用户操作:请确保传递给 com.ibm.connector2.ims.ico.IMSInteraction 类的 execute 方法的 InteractionSpec 对象属于 com.ibm.connector2.ims.ico.IMSInteractionSpec 类型。

ICO0042E
javax.resource.ResourceException:
ICO0042E:  methodname error.
Input is not of type Streamable.

说明:对于“input”参数,为 com.ibm.connector2.ims.ico.IMSInteraction 的 execute 方法提供的输入对象或者为 null 或者未实现 javax.resource.cci.Streamable 接口。当将应用程序编写为使用 J2EE 连接器体系结构公共客户机接口(CCI)时就很可能发生此异常。如果使用 Rational® Application Developer 来构建输入消息,就不会发生此异常。

对于某些类型的交互,execute 方法允许空输入对象。例如,interactionVerb 值为 SYNC_END_CONVERSATION 和 SYNC_RECEIVE_ASYNCOUTPUT 的交互就允许空输入对象。

用户操作:请确保为 execute 方法的“input”参数提供有效的 javax.resource.cci.Record 对象。例如,确保此对象实现 javax.resource.cci.Recordjavax.resource.cci.Streamable 接口。

ICO0043E
javax.resource.ResourceException:
ICO0043E:  methodname error.
Output is not of type Streamable. 

说明:com.ibm.connector2.ims.ico.IMSInteraction 的 execute 方法提供的输出对象或者为 null 或者未实现 javax.resource.cci.Streamable 接口。当将应用程序编写为使用 J2EE 连接器体系结构公共客户机接口(CCI)时就很可能发生此异常。如果使用 Rational Application Developer 来构建输出消息,就不会发生此异常。

用户操作:请确保为 execute 方法提供有效的输出对象。

ICO0044E
javax.resource.NotSupportedException:
ICO0044E:methodname error.
RecordFactory is not supported by IMS Connector for Java.

说明: IMS Connector for Java 当前不支持 RecordFactory。

用户操作:请确保 Java 应用程序使用适合于 IMS Connector for Java 当前提供的支持级别的类和方法。

ICO0045E
javax.resource.NotSupportedException:
ICO0045E:  methodname error.
Invalid type of ConnectionRequestInfo.

说明:将无效的 ConnectionRequestInfo 对象传递给了 IMS Connector for Java 方法。

用户操作:这很可能是 IMS Connector for Java 中出错了。请与 IBM 服务代表联系。

ICO0049E
javax.resource.NotSupportedException:
ICO0049E:methodname error.
The security credentials passed to getConnection do not match existing
security credentials.

说明:请求中的安全凭证与用来处理该请求的 IMSManagedConnection 实例的安全凭证不匹配。

用户操作:请与 IBM 服务代表联系。

ICO0053E
javax.resource.ResourceException:
ICO0053E: methodname error.
Invalid clientID value. Prefix HWS is reserved by IMS Connector for Java.

说明:为 clientID 属性指定的值无效。前缀“HWS”是 IMS Connector for Java 的保留项。

用户操作:请为 clientID 属性提供有效值。有效值应该满足下列规则:
  • 不是空字符串;
  • 不以空白字段开头;
  • 不以 IMS Connector for Java 保留的前缀“HWS”开头;
  • 长度为 8 个字符;
  • 使用有效字符 A - Z、0 - 9 以及 @、# 和 $。
ICO0054E
javax.resource.ResourceException:
ICO0054E:methodname error.
Invalid ConnectionSpec.

说明: IMS Connector for Java 未能将为此连接提供的 connectionSpec 强制转换为 IMSConnectionSpec 类型。虽然“公共客户机接口”将接受任何受支持的连接器的 connectionSpec 对象,但是,IMS Connector for Java 将只与 IMSConnectionSpec 协同工作,或者使用变型 IMSConnectionSpec 作为它的 connectionSpec。

用户操作:请确保应用程序使用的 connectionSpec 是 IMSConnectionSpec 或者继承于 IMSConnectionSpec。

ICO0055E
javax.resource.ResourceException:
ICO0055E:methodname error.
Failed to cast the connection object to IMSConnection.

说明: IMS Connector for Java 未能将 ConnectionManager 为此连接分配的 Connection 对象强制转换为 IMSConnection 类型。IMS Connector for Java 只能使用 IMSConnection 或者 IMSConnection 变型作为它的 Connection 对象。此错误可能是由于 ConnectionManager 存在的问题造成的。

用户操作:请与 IBM 服务代表联系。

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.

说明:要将受管连接工厂用于“本地选项”连接,必须设置 IMSManagedConnectionFactory 实例的 IMSConnectName 属性。而且,仅当使用 IMS Connector for Java 的应用程序在 OS/390® 或 z/OS® 平台上运行时,才可以使用“本地选项”来与 IMS Connect 进行通信。此异常表明虽然您已经为 IMSConnectName 属性指定了值,但应用程序既不是在 z/OS 平台上运行,也不是在 OS/390 平台上运行。

用户操作:请确保使用 IMS Connector for Java 的应用程序是在 z/OS 或 OS/390 上运行。注意,应用程序(更准确地说,是正在运行应用程序的 Web 服务器)还必须与 IMS Connect 在同一 MVS 映像中运行。如果不是这种情况,例如,您打算在工作站平台上运行应用程序;或者,您打算用来运行应用程序的 Web 服务器位于 z/OS 上,但是它与 IMS Connect 位于不同的 MVS 映像中,则应确保将该应用程序使用的连接工厂设置为使用 TCP/IP 通信。

ICO0057E
javax.resource.spi.IllegalStateException:
ICO0057E:methodname error.
Invoked with invalid connection handle.

说明:应用程序处于非法状态:用于此交互的连接句柄(IMSConnection 实例)无效。在应用程序打开了多个连接的情况下,如果应用程序试图使用先前使用过的连接的连接句柄或者使用错误连接的连接句柄,就可能会发生该错误。

用户操作:请确保应用程序为该连接使用当前有效的 IMSConnection 实例。

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.

说明:仅当应用程序在选择了落实方式 1 的情况下使用 IMS Connector for Java 时,才能使用“本地选项”协议与 IMS Connect 进行通信。

用户操作:请确保应用程序在选择了落实方式 1 的情况下使用 IMS Connector for Java。如果您打算采用落实方式 0 运行应用程序,则将该应用程序更正为使用 TCP/IP 通信。

ICO0059E
javax.resource.ResourceException:
ICO0059E: methodname error.
SYNC_END_CONVERSATION interation with Commit Mode 0 is not supported.

说明:在落实方式 0 下进行 SYNC_END_CONVERSATION 交互不受支持。

用户操作: IMS Connector for Java 支持下列交互组合:SYNC_END_CONVERSATION 与落实方式 1、SYNC_SEND_RECEIVE 与落实方式 0 以及 SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT 与落实方式 0。

ICO0060E
java.lang.UnsatisfiedLinkError:
ICO0060E:methodname error.
Error loading Local Option native library: libname=libraryFileName.
[source_exception].

说明:在 libpath 中列示的任何目录中都找不到“本地选项”本机库。

用户操作:请确保在 LIBPATH 环境变量的其中一个目录中存在“本地选项”本机库。如果您正在 WebSphere Application Server for z/OS and OS/390 中运行 IMS Connector for Java,则请确保在 J2EE 服务器的 LIBPATH 环境变量中定义了包含“本地选项”本机库文件的目录的全名。有关更多信息,请参阅 WebSphere Application Server V6.0 信息中心中的“准备基本操作系统”

ICO0061E
javax.resource.ResourceException:
ICO0061E:methodname error.
Local Option runs only in z/OS and OS/390.

说明:仅当使用 IMS Connector for Java 的应用程序在 z/OS 或 OS/390 平台上运行时,才可以使用“本地选项”来与 IMS Connect 进行通信。

用户操作:请确保使用 IMS Connector for Java 的应用程序是在 z/OS 或 OS/390 上运行。注意,应用程序(更准确地说,是正在运行应用程序的 Web 服务器)还必须与 IMS Connect 在同一 MVS 映像中运行。如果不是这种情况,例如,您打算在工作站平台上运行应用程序;或者,您打算用来运行应用程序的 Web 服务器位于 z/OS 上,但是它与 IMS Connect 位于不同的 MVS 映像中,则应确保将该应用程序使用的连接工厂设置为使用 TCP/IP 通信。

ICO0062E
javax.resource.ResourceException:
ICO0062E:methodname error.
Error loading Local Option native method: libfilename=libraryFileName,
methodname=nativeMethodName. [source_exception].

说明:找不到“本地选项”本机方法。

用户操作:请验证在您的系统上安装了正确级别的 IMS Connector for Java 资源适配器和“本地选项”本机库。请始终使用随安装在 WebSphere Application Server for z/OS 和 OS/390 系统中的 IMS TM 资源适配器一起交付的“本地选项”本机库的版本。有关更多信息,请参阅“使用 IMS Connector for Java 的先决条件”。

ICO0063E
javax.resource.spi.ResourceAdapterInternalException:
ICO0063E:methodname error.
Exception thrown in native method. [source_exception].

说明:“本地选项”本机方法中发生了内部错误。

用户操作:请与 IBM 服务代表联系。

ICO0064E
javax.resource.spi.SecurityException:
ICO0064E:methodname error.
Invalid security credential.

说明:WebSphere Application Server 所提供的主题中不包含 IMS Connector for Java 支持的可用安全凭证。

用户操作:请确保安装了正确级别的 WebSphere Application Server for z/OS and OS/390。有关详细信息,请参阅使用 IMS TM 资源适配器的先决条件一节。请配置 WebSphere Application Server for z/OS 和 OS/390,以提供 IMS TM 资源适配器支持的安全凭证。IMS TM 资源适配器支持 TCP/IP 连接的 PasswordCredential 和“本地选项”连接的 UToken GenericCredential。

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].

说明:访问 WebSphere Application Server 的事务管理器以处理事务请求时出错。

用户操作:请确保安装了正确级别的 WebSphere Application Server for z/OS and OS/390。有关详细信息,请参阅使用 IMS Connector for Java 的先决条件一节。

ICO0068E
javax.resource.ResourceException:
ICO0068E:methodname error.
Error obtaining the transaction object.  [java_exception]

说明:尝试使用 WebSphere Application Server 事务管理器来确定一个事务是否已启动时出错。

用户操作:请确保安装了正确级别的 WebSphere Application Server for z/OS and OS/390。有关详细信息,请参阅使用 IMS Connector for Java 的先决条件一节。

ICO0069E
javax.resource.spi.ResourceAllocationException
ICO0069E:methodname error.
Error obtaining RRS transaction context token.
IMSConnResourceException: RRS retcode=[rrs_routinecode].

说明:获取 RRS 事务上下文标记以处理全局事务时发生了意外的内部错误。

用户操作:请检查 RRS 作业日志以获取相关联的 RRS 错误消息。有关 RRS 返回码(rrs_routinecode)的诊断信息,请参阅您所使用的 z/OS 或 OS/390 发行版的 MVS Programming: Resource Recovery 手册。

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]."

说明: IMS Connect 返回了因 RRS 故障而产生的错误。

用户操作:请检查 MVS 控制台以获取相关联的 IMS Connect 和 RRS 错误消息。有关返回码(returncode)值的诊断信息以及 IMS Connect 错误消息,请参阅 IMS Connect Guide and Reference。有关 RRS 返回码(rrs_routinecode)的诊断信息,请在您所使用的 z/OS 或 OS/390 发行版的 MVS Programming: Resource Recovery 手册中找到 RRS 例程名(rrs_routine)。

ICO0071E
javax.transaction.xa.xAException
ICO0071E:methodname error.
A communication error occurred when processing the XA
commandtype operation. [java_exception]

说明:在处理全局事务期间发生通信故障有许多原因。可能发生了 TCP/IP 或套接字故障,也可能是 IMS Connect 已停止。将不会复用出错的连接。

用户操作:请检查 java_exception 以确定连接至主机时发生故障的原因。还要检查 MVS 控制台以获取相关联的 IMS Connect 或 TCP/IP 错误消息。验证通过 TCP/IP 可以访问机器,并且 IMS Connect 尚未停止。错误消息中所显示的命令类型(commandtype_string)表示发生此通信故障时在全局事务中所处的阶段:准备、落实、回滚、恢复或忽略。

ICO0072E
javax.transaction.xa.xAException:
ICO0072E:methodname error.
The associated UR for the Xid is not found.

说明:在事务处理期间,因人工干预或者因 IMS Connect 或 RRS 中的错误而消除了与特定 Xid 相关联的 UR。

用户操作:有关如何从 WebSphere Application Server 日志中获取事务信息和 Xid 的步骤,请参阅 WebSphere Application Server InfoCenter Reference Library。有关列示 Xid 及其相关联的 UR 的 IMS Connect 命令,请参阅 IMS Connect Guide and Reference。验证是否列示了该 Xid 的 UR。验证全局事务未处于试探状态。

ICO0073E
javax.transaction.xa.xAException:
ICO0073E:methodname error.
RRS is not available.

说明:RRS 已停止,或者 RRS 与 IMS Connect 之间的通信已结束。

用户操作:请检查 MVS 控制台以获取相关联的 IMS Connect 和 RRS 错误消息。确保 RRS 在 z/OS 或 OS/390 系统上尚未停止。有关可以用来验证是否已启用 RRS 的 IMS Connect 命令,请参阅 IMS Connect Guide and Reference

ICO0074E
javax.transaction.xa.xAException:
ICO0074E: The RRS rrs_routine call returns with a return code [rrs_routinecode].

说明:在处理全局事务期间,IMS Connect 产生了以下 RRS 错误消息。

用户操作:请检查 MVS 控制台以获取相关联的 IMS Connect 和 RRS 错误消息。有关 RRS 返回码(rrs_routinecode)的诊断信息,请在您所使用的 z/OS 或 OS/390 发行版的 MVS Programming: Resource Recovery 手册中找到 RRS 例程名(rrs_routine)。

ICO0075E
javax.transaction.xa.xAException:
ICO0075E:methodname error.
The transaction branch may have been heuristically completed. [rrs_exception]

说明:IMS Connect 产生了一个 RRS 错误,指示事务的处理因此受到影响,从而处于试探状态。因此,该事务就有可能一部分已落实,而另一部分在落实阶段遇到了错误,该错误将阻止它进行落实。rrs_exception 是 ICO0074E 错误消息,指出与此问题相关联的 RRS 例程和返回码。

用户操作:请参阅 ICO0074E 错误的文档,以获取关于 RRS 错误消息的更多信息。有关如何从 WebSphere Application Server 日志中获取事务信息和 Xid 的步骤,请参阅 WebSphere Application Server InfoCenter Reference Library。有关列示 Xid 及其相关联的 UR 的 IMS Connect 命令,请参阅 IMS Connect Guide and Reference。确定涉及到的 Xid 和 UR 以及应该已经落实至 IMS 的结果。验证 IMS 中的值以确保出现了试探状态。然后,必须决定执行一些操作来纠正 IMS 中的数据,以便使它与已经落实的结果相匹配;或者纠正涉及到的其他数据库,以返回到执行该事务之前的状态。

ICO0076E
javax.resource.ResourceException:
ICO0076E:methodname error. An internal error occurred. [rrs_exception]

说明:尝试抽取有关 IMS Connect 产生的 RRS 错误消息的信息时发生了内部错误。rrs_exception 是 ICO0074E 错误消息,指出与该错误相关联的 RRS 例程和返回码。

用户操作:请参阅 ICO0074E 错误的文档,以获取关于已经发生的 RRS 故障的更多信息。请与 IBM 服务代表联系。

ICO0077E
javax.resource.ResourceException:
ICO0077E:methodname error. The transaction has already rolled back. [rrs_exception]

说明:IMS Connect 产生了一个 RRS 错误,指示已经再次尝试对同一个 UR 回滚事务。RRS 将阻止进行第二次回滚,并且会抛出一个错误,指出正在尝试执行这样一个操作。rrs_exception 是 ICO0074E 错误消息,指出与该错误相关联的 RRS 例程和返回码。

用户操作:不需要执行任何操作,因为应该回滚该事务。参阅 ICO0074E 错误的文档,以获取关于已经发生的 RRS 故障的更多信息。作为一种预防措施,验证数据在执行事务之前尚未丢失或修改。

ICO0078E
javax.resource.ResourceException:
ICO0078E: methodname error.
A valid user-specified clientID is required for interactions on a
dedicated persistent connection.

说明:当为 commitMode 属性指定的值为 0,并且交互正在使用专用持久套接字连接时,需要为 clientID 属性指定一个有效的、用户指定的值。这适用于 SYNC_SEND_RECEIVE、SYNC_SEND、SYNC_RECEIVE_ASYNCOUTPUT、SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT 和 SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT 交互。

用户操作:请为 clientID 属性提供一个有效值。有效值应该满足下列规则:
  • 不是空字符串
  • 不以空白字段开头
  • 不以 IMS Connector for Java 保留的前缀“HWS”开头
  • 长度为 8 个字符
  • 具有有效字符 A - Z、0 - 9 以及 @、# 和 $
ICO0079E
com.ibm.connector2.ims.ico.IMSDFSMessageException:
ICO0079E:methodname error.
IMS returned DFS message:DFS_message

说明:IMS 返回了由 DFS_message 指示的消息,而不是返回 IMS 事务的输出。如果交互对 IMSInteractionSpec 的 imsRequestType 属性使用值 IMS_REQUEST_TYPE_IMS_TRANSACTION,则会抛出此异常。

例如,如果 Java 应用程序尝试运行一个已停止的 IMS 事务,则将抛出此异常,并且 DFS_message 的值为
DFS065 hh:mm:ss TRAN/LTERM STOPPED

用户操作:请在 IMS 消息和代码文档中查找与 DFS_message 相对应的说明和响应,然后解决 IMS 中的问题。

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.
说明:IMS Connect 将消息发送至 IMS 并从 IMS 接收响应所花的时间超过了 IMS Connect TIMEOUT 值。IMS Connect TIMEOUT 值具有下列特点:
  • 是在 SYNC_SEND_RECEIVE 交互的 IMS Connect 配置成员中指定的
  • 对于 SYNC_RECEIVE_ASYNCOUTPUT、SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT 和 SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT 交互,该值为两秒
之所以使用了 IMS Connect TIMEOUT 值,是因为没有指定此交互的 executionTimeout 属性或者已经将该属性设置为零。

用户操作:请确保应用程序设置了有效的 executionTimeout 值。要设置 executionTimeout 值,可以使用 WebSphere Studio,也可以使用 setExecutionTimeout 方法。有关详细的指示信息,请参阅“WebSphere Studio Application Developer Integration Edition 5.0.1 帮助”中的设置执行超时值这一主题。

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.

说明:IMS Connect 将消息发送至 IMS 并从 IMS 接收响应所花的时间超过了舍入到适当的执行超时时间间隔的 executionTimeout 值。一旦设置了有效的执行超时值,就会将此值转换为 IMS Connect 可以使用的值。

用户操作:如果执行舍入之后的执行超时值不是您期望的值,请按照下表中的转换规则进行验证:

用户指定的值的范围 转换规则
1 - 250 如果用户指定的值不能被 10 除尽,则将它转换为下一个更大的、10 的整数倍值。
251 - 1000 如果用户指定的值不能被 50 除尽,则将它转换为下一个更大的、50 的整数倍值。
1001 - 60000 用户指定的值将被转换为它最接近的、1000 的整数倍值。刚好在 1000 的两个整数倍之间的值将被转换为下一个更大的、1000 的整数倍值。
60001 - 3600000 用户指定的值将被转换为它最接近的、60000 的整数倍值。刚好在 60000 的两个整数倍之间的值将被转换为下一个更大的、60000 的整数倍值。

有关更多示例,请参阅“Rational Application Developer 7.0 帮助”中的有效的执行超时值这一主题。

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.

说明:为 executionTimeout 属性指定的执行超时值低于最小值或者高于最大值。

用户操作:请确保应用程序对 executionTimeout 属性设置了有效值。执行超时值是以毫秒表示的,它必须是 1 到 3600000 范围内的十进制整数,包含 1 和 3600000。如果您想让交互在运行时没有时间限制,也可以将该值设置为 -1。

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.

说明:在全局事务作用域内,采用落实方式 0 的 SYNC_SEND_RECEIVE、SYNC_SEND、SYNC_RECEIVE_ASYNCOUTPUT、SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT 和 SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT 交互无效。这是因为目前全局事务要求 SYNC_LEVEL_SYNCPOINT 和 SYNC_LEVEL_SYNCPOINT 只有在落实方式 1 下才有效。

用户操作:
  • 如果想要使用落实方式 0,则应确保将应用程序配置为“非事务”应用程序。
  • 如果想要在全局事务作用域内运行交互,则 commitMode 属性值必须为 1。
ICO0084E
javax.resource.ResourceException:
ICO0084E:methodname error.
An unexpected internal IMS Connector for Java error occurred.
[source_method] [source_exception]

说明:methodname 中执行 [source_method] 调用时发生 PrivelegedActionException。如果启用了 Java2 安全性,但是与调用程序 methodname 或者当前调用堆栈中的任何程序相关联的用户都未被授权执行 [source_method],则将产生此异常。

用户操作:请确保正确设置了应用程序服务器的安全性,以便与调用程序以及当前调用堆栈中的任何程序相关联的用户在发生该异常时都有权执行 [source_method]。或者,您也可以关闭应用程序服务器中的 Java 2 安全性检查。

ICO0085E
javax.resource.ResourceException:
ICO0085E: methodname error.
Protocol violation. A user-specified clientID is not allowed for interactions
on a shareable persistent socket.

说明:不允许使用为 clientID 属性指定的值。这是因为已将连接工厂配置为用于可共享持久套接字,而在这种连接工厂中不允许使用用户指定的 clientID。

用户操作:对于可共享持久套接字连接工厂,IMS Connector for Java 提供了现成的 clientID。不允许使用用户指定的 clientID。要确定您使用的是否是可共享持久套接字,请检查交互所使用的连接工厂的 CM0Dedicated 属性值是否为 FALSE。

ICO0086E
javax.resource.ResourceException::
ICO0086E:methodname error.
Invalid value was specified for CommitMode property.

说明:您在 commitMode 属性字段中已指定的 CommitMode 值无效。

用户操作:请确保应用程序对 commitMode 属性设置了有效值。受支持的值包括:
  • 值为 1(SEND_THEN_COMMIT),指示 IMS 处理事务,然后在落实数据之前发送回响应。
  • 值为 0(COMMIT_THEN_SEND),指示 IMS 处理事务,然后在发送响应之前落实数据。
ICO0087E
javax.resource.ResourceException:
ICO0087E: methodname error.
Protocol violation. Commit Mode 1 is not allowed for interactions on a
dedicated persistent socket.

说明:将 CommitMode 属性的值指定为 1 是无效的。这是因为已将连接工厂配置为用于专用持久套接字,而在这种连接工厂中不允许使用落实方式 1。

用户操作:对于专用持久套接字连接工厂,落实方式 0 交互是有效的。要确定您使用的是否是专用持久套接字,请检查交互所使用的连接工厂的 CM0Dedicated 属性值是否为 TRUE。

ICO0088E
javax.resource.ResourceException:
ICO0088E: methodname error.
Protocol violation. SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAITinteractions
are not allowed on a shareable persistent sockets.

说明:为 interactionVerb 属性指定的值 SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT 无效。这是因为已将连接工厂配置为用于可共享持久套接字,而在这种连接工厂中不允许使用 SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT。

用户操作:对于可共享持续连接上的交互,interactionVerb 属性的有效值包括 SYNC_SEND_RECEIVE、SYNC_SEND 和 SYNC_END_CONVERSATION。要确定您使用的是否是可共享持续连接,请检查交互所使用的连接工厂的 CM0Dedicated 属性值是否为 FALSE。

ICO0089I
javax.resource.ResourceException::
ICO0089I: methodname.
 Non-persistent socket closed for Commit Mode 0 IMS transaction.

说明:如果对非持久套接字(事务套接字)运行落实方式 0,IMS Connector for Java 就会从连接池中强制除去受管 Connection 对象。

用户操作:这不是错误消息,不需要执行任何操作。

ICO0091E
javax.resource.ResourceException:
ICO0091E: methodname
error.SSL client context could not be created. [{1}]
说明:由于下列原因之一而未能创建 SSL 上下文:
  • 找不到用来检查密钥库的完整性的算法
  • 不能装入密钥库中的证书
  • 不能恢复密钥,例如,给定的密码是错误的。
用户操作:请确保满足下列条件:
  • 用来创建证书的算法必须是受 IBMJSSE 支持的算法。
  • 密钥库和信任库的密码是正确的。
ICO0096I
javax.resource.ResourceException:
ICO0096I: methodname
Warning. Invalid value provided for SSL parameter.

说明:使用 null 或空的 SSLKeystoreName、SSLKeystorePassword、SSLTruststoreName 或 SSLTruststorePassword 参数调用了 methodname 中所指示的方法。这是一条参考消息,主要是为了让用户知道以上提到的参数中的其中一个参数是 null 或空字符串。这并不会终止程序执行。

用户操作:请为 SSLKeystoreName、SSLKeystorePassword、SSLTruststoreName 和 SSLTruststorePassword 参数提供有效值。为了方便起见,可以将专用密钥和证书存储在密钥库或信任库中。因此,只需要一组有效值(或者是 SSLKeystoreName 与 SSLKeystorePassword,或者是 SSLTruststoreName 与 SSLTruststorePassword)就可以正确执行。

ICO0097E
javax.resource.ResourceException:
ICO0097E:methodname error.
{0} 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.

说明:为 SSLEncryptionType 参数提供了除 STRONG、WEAK 或 ENULL 之外的值。

用户操作:请为 SSLEncryptionType 参数提供 STRONG、WEAK 或 ENULL。该值不区分大小写。

ICO0111E
javax.resource.ResourceException:
ICO0111E:methodname error.
 SSLEnabled must be set to FALSE when using Local Option.

说明:IMSConnectName 属性被设置为非空值,SSLEnabled 属性被设置为 TRUE。然而,对于“本地选项”连接(通过为 IMSConnectName 参数提供值来指示),SSL 是不受支持的。

用户操作:请将 SSLEnabled 设置为 false。

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]

说明: IMS Connector for Java 接收来自 IMS Connect 的响应的时间超过了为 SocketTimeout 指定的时间。

用户操作:请确保 SocketTimeout 的时间值足够 IMS Connector for Java 接收来自 IMS Connect 的响应。否则应增大该值。如果给定的 SocketTimeout 的值足够大,则可能是网络问题导致了延迟。请与网络管理员联系。

ICO0114E
javax.resource.ResourceException:
ICO0114E: methodname error.
The Socket Timeout Property value of [socket timeout value] is invalid.
[source_exception:exception_reason]

说明:为 SocketTimeout 属性指定的值 [套接字超时值] 无效。

用户操作:请查看所提供的 exception_reason。确保为 SocketTimeout 给定一个正数值。

ICO0115E
javax.resource.spi.CommException:
ICO0115E: methodname error.
A TCP 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.

说明:对于 SYNC_SEND 交互,IMS TM 资源适配器目前仅支持落实方式 0。

用户操作:SYNC_SEND、SYNC_RECEIVE_ASYNCOUTPUT、SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT、SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT、SYNC_RECEIVE_ASYNCOUTPUT、SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT 和 SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT 交互必须采用落实方式 0。落实方式 1 对于 SYNC_SEND_RECEIVE 和 SYNC_END_CONVERSATION 交互有效。

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.

说明:将 imsRequestType 属性的值指定为 2(IMS_REQUEST_TYPE_IMS_COMMAND)是无效的。

用户操作:ImsRequestType 2(IMS_REQUEST_TYPE_IMS_COMMAND)仅对于 SYNC_SEND_RECEIVE 交互有效。SYNC_SEND、SYNC_END_CONVERSATION、SYNC_RECEIVE_ASYNCOUTPUT、SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT 和 SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT 交互必须采用 ImsRequestType 1(IMS_REQUEST_TYPE_IMS_TRANSACTION)。

ICO0119E
javax.resource.ResourceException:
ICO0119E: methodname error.
A supported SSL provider was not found. [caught_exception]

说明:当尝试初始化与 IMS Connect 的安全套接字层 TCP/IP 连接时,IMS Connector for Java 需要使用下面两个受支持的提供程序的其中一个:com.ibm.jsse.JSSEProvider 或 sun.security.provider.Sun。此错误指示这两个提供程序都不可用。

用户操作:缺省情况下,在 IBM JVM 中应该添加 com.ibm.jsse.JSSEProvider,而在 Sun JVM 中应该添加 sun.security.provider.Sun。如果您正在 WebSphere Application Server 中运行,则请确保在受支持的 IBM JVM 中运行的是 IMS Connector for Java;而在其他应用程序服务器中运行的是 Sun JVM。

ICO0121E
javax.resource.ResourceException:
ICO0121E: methodname error.
Invalid reRoute name value. Prefix HWS is reserved for use by
IMS Connector for Java.

说明:为 reRouteName 属性指定的值无效。前缀“HWS”是 IMS Connector for Java 的保留项。

用户操作:请为 reRouteName 属性提供有效值。有效值应该遵守下列规则:
  • 不是空字符串
  • 不以空白字段开头
  • 不以 IMS Connector for Java 保留的前缀“HWS”开头
  • 长度为 8 个字符
  • 使用有效字符 A - Z、0 - 9 以及 @、# 和 $
ICO0122E
javax.resource.ResourceException:
ICO0122E: methodname error.
Invalid reRoute value. When purgeAsyncOutput value is true, reRoute
value cannot be true.

说明:为 reRoute 属性指定的值无效。因为对 purgeAsyncOutput 属性指定的值为 TRUE,或者对 purgeAsyncOutput 属性使用了缺省值(TRUE)。

用户操作:如果想要将 reRoute 设置为 TRUE,则应确保将 purgeAsyncOutput 属性设置为 FALSE。

ICO0123E
 javax.resource.NotSupportedException:
ICO0123E : methodname error .
A Sync Level value of synclevel is not supported for commit-then-send
(Commit mode 0) interactions.  

说明:在“先落实后发送”(落实方式 0)交互中不支持使用为 IMSInteractionSpec.syncLevel 指定的值。在“先落实后发送”(落实方式 0)交互中,“确认(1)”是唯一受支持的 IMSInteractionSpec.syncLevel 值。

用户操作:请为 IMSInteractionSpec.syncLevel 属性指定值“确认(1)”,或接受“确认(1)”的缺省同步级别值以用于“先落实后发送”(落实方式 0)交互。

ICO0124E
javax.resource.ResourceException:
ICO0124E : methodname error .
SYNC_SEND_RECEIVE interactions with Sync Level Confirm are not supported
with Local Option. 

说明:在使用“本地选项”的情况下,不支持“先落实后发送”(落实方式 0)交互。在使用“本地选项”的情况下,不支持带有“同步级别确认(1)”的“先发送后落实”(落实方式 1)交互。

用户操作:请不要对此功能使用“本地选项”。

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. 

说明:作为“先发送后落实”(落实方式 1)同步级别确认(1)协议的一部分,IMS TM 资源适配器接收到来自 IMS 事务的输出消息、向 IMS Connect 发送了正面的确认,但接收到的是错误指示,而不是来自落实该事务的 IMS Connect 的预期指示。IMS TM 资源适配器接收到的输出消息未返回到应用程序组件。IMS 事务可能已落实,也可能没有落实。

用户操作:请手工确定事务是已落实还是已中止,并在必要时执行协调。

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	

说明:IMS Connect 返回的错误。将不会复用出错的连接。如果有原因码,则 reasoncode_string 将提供原因码的简短描述。

用户操作:请在 MVS™ 控制台中检查是否有相关联的 IMS Connect 错误消息。IMS Connect 错误消息以字符“HWS”开头。有关返回码(returncode)和原因码(reasoncode)值以及 IMS Connect 错误消息的诊断信息,请参阅 IMS Connect Guide and Reference。

ICO0127E
com.ibm.ims.ico.IMSIllegalStateException
ICO0127E : methodname error.
Protocol violation. The Mode [mode] is not allowed for the current state
[state]. [exception]

说明: IMS Connector for Java 处于非法状态。

用户操作:这很可能是 IMS Connector for Java 或 IMS Connect 中出错了。请与 IBM 服务代表联系。

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. 

说明:非 0 或非 1 值被指定为 setSyncLevel(int) 方法的输入。

用户操作:非 0 或非 1 值被指定为 setSyncLevel(int) 方法的输入。

用户操作:请指定 0 或 1 作为 setSyncLevel(int) 方法的同步级别属性值输入。

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.

说明:对使用备用 clientID 的异步输出的检索仅受可共享持久套接字连接支持。

用户操作:请使用可共享持久套接字连接来检索带有备用 clientID 的异步输出。

相关任务
使用 IMS TM 资源适配器进行记录和跟踪
相关参考
诊断使用 IMS TM 资源适配器时出现的问题
J2CA0056I、WLTC0017E、HWSP1445E 和 HWSSL00E 错误消息

反馈