IMS リソース・アダプター・メッセージおよび例外

IMS Connector for Java を使用する Java™ プログラムの開発中に、プログラムが 例外をスローすることがあります。これらの例外には IMS Connector for Java によってスローされるものと、IMS Connector for Java が使用するクラス・ライブラリー (Java クラス・ライブラリーなど) によってスローされるものがあります。このトピックでは、IMS Connector for J2C アプリケーションによって生成される 例外に関する情報を提供します。

メッセージの説明において、以下のイタリック体 の用語は、実行時に特定の値で置き換えられます。

hostname
IMS Connect を実行しているマシンの TCP/IP ホスト名です。
innermethodname
この例外を最初にスローしたメソッドの名前です。この例外は IMS Connector for Java によってキャッチされたもので、Common Connector Framework 仕様に従って、別の例外に再スローされます。
length
データの長さです。
libraryFileName
Local Option のネイティブ・ライブラリーのファイル名です。
llvalue
LL の値です。
maxlength
データの最大有効長です。
methodname
当該の例外をスローするメソッドの名前です。
mode
IMS Connector for Java とホスト上の IMS Connect コンポーネントの間の対話のタイプです (interactionspec で定義されています)。
nativeMethodName
Local Option のネイティブ・メソッドの名前です。
portnumber
IMS Connect に割り当てられているポート番号です。
propertyname
プロパティーの名前です。
propertyvalue
プロパティーの値です。
reasoncode
IMS Connect が戻す理由コードです。
rectype
レコードのタイプです。
returncode
IMS Connect から戻される、10 進数でフォーマットされた戻りコードです。
sensecode
IMS OTMA から戻される、10 進数でフォーマットされたセンス・コードです。
socketexception
ソケット例外です。
source_exception
内部メソッドでエラーが最初に発生したときにスローされた例外です。
source_methodname
エラーが最初に発生した内部メソッドです。
state
IMS Connector for Java の内部状態です。

関連資料

IMS Connector for Java J2C アプリケーションによって生成される 例外

以下の例外メッセージは、エラー状態が検出されたときに、Java 2 Platform, Enterprise Edition (J2EE) Connector Architecture (J2C) クラス・ ライブラリーによって生成されるものです。

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

説明: IMS Connect がエラーを戻しました。 エラーが発生した接続は再使用されません。reasoncode_string は、reasoncode の簡単な説明があればそれを提供します。

ユーザー処置: 関連する IMS Connect エラー・メッセージがないか、MVS™ コンソールを調べてください。 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 を 10 進数で表示します。アプリケーションが 2 フェーズ・コミットで実行されている場合、NAK エラーが発生すると、 以下のセンス・コード値が戻されます。
  • センス・コード = 17 (10 進数、23 Hex)

    ご使用の IMS では RRS 処理を行うことができません。 ご使用の IMS で RRS による保護会話処理が行えるようにしてください。 詳しくは、『2 フェーズ・コミットの前提条件』を参照してください。

  • センス・コード = 46 (10 進数、2E Hex)

    RRS および 2 フェーズ・コミット 処理が IMS Connect および IMS Connector for Java でサポートされていません。 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: Connection refused
    次のようなものが、例外の理由として考えられます。
    • ポート番号が無効である。hostname で示されている IMS Connect のために有効なポート番号を使用していることを確認してください。
    • 指定されたポートが停止している。これは、IMS Connect コマンド VIEWHWS を 使用することによって判断できます。ポートが停止している場合は、その状況は NOT ACTIVE になります。IMS Connect コマンド OPENPORT dddd (dddd は指定されたポート番号を表します) を使用してポートを開始してください。
    • 指定されたホスト上の IMS Connect が実行されていない。ホスト・マシンで IMS Connect を開始してください。
    • IMS Connect の取り消しと再始動を行わずに TCP/IP を再始動したか、ホスト側で STOPPORTOPENPORT を 連続して発行しないで TCP/IP を再始動した。
  • java.net.SocketException: connect (code=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.

説明: methodname で示されているメソッドが、空の DatastoreName パラメーターを使用して呼び出されました。このエラー・メッセージは、空の DatastoreName パラメーターを持つ接続ファクトリーが開始したときにトレース・ログに書き込まれます。このメッセージの後に J2EE Connector 警告が書き込まれます。

J2CA0007W: An exception occurred while invoking method setDataStoreName on 
com.ibm.connector2.ims.ico.IMSManagedConnectionFactory used by resource 
Connection_Factory_JNDI_name.
この場合、処理は続行されますが、名前がヌルのデータ・ストアが見つけられなかったことを示す 応答を IMS Connect が送信した後で、他のエラー・メッセージが表示されます。他のメッセージを起動する、基礎となるメッセージには以下のものがあります。
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 メッセージには、IMS Connect が見つけようとしたデータ・ストアの名前を表示するフィールド (この場合は、すべてブランク) が含まれます。
DESTID=        ;

ユーザー処置: DatastoreName パラメーターに有効な名前を指定してください。管理環境では、WebSphere Application Server が使用する接続ファクトリーを構成するときに、DatastoreName が 指定されます。非管理環境では、DatastoreName は、Java アプリケーションで 指定されます。

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

説明: プロパティー propertyName に指定された値 propertyValue はサポートされていません。

ユーザー処置: 当該のプロパティーに、サポートされている値を設定してください。 例えば、J2C アーキテクチャーで定義される InteractionSpec クラスの InteractionVerb プロパティーのいくつかの値は、このリリースの IMS Connector for Java の IMSInteractionSpec クラスではサポートされていません。また、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 の長さが、プロパティー propertyName の値に 指定可能な最大長 maxPropertyLength を超えています。

ユーザー処置: 当該のプロパティーに maxPropertyLength を超えない値を指定してください。

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

説明: プロパティー propertyName に対して指定された値 propertyValue が無効です。

ユーザー処置: 当該のプロパティーに対して有効な値を設定してください。例えば、IMS Connector for Java の InteractionSpec クラスの InteractionVerb プロパティーの 有効な値は、IMSInteractionSpec クラスの Javadoc にリストされています。

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

説明: methodname で示されたメソッドが、無効な IMSConnection インスタンスで呼び出されました。 methodnamelazyEnlist である場合、登録できなかった現行トランザクション内の接続を、登録する試行がありました。

ユーザー処置: 当該のメソッドは、すでに閉じている IMSConnection インスタンスに対して発行された可能性が最も高いと思われます。

  • methodnamelazyEnlist ではない場合、IMSConnection インスタンスを使用する試行または閉じる試行の前に、それがまだ閉じられていないことを確認してください。
  • methodnamelazyEnlist である場合、ご使用のアプリケーションが管理環境で非管理接続を使用していないことを確認してください。 トランザクションの参加の遅延最適化に対しては、管理接続のみが適格となります。詳しくは、WebSphere Application Server 6.0 のオンライン情報センターにある、 『据え置き参加』のトピックを参照してください。
ICO0011E
javax.resource.spi.IllegalStateException:
ICO0011E:methodname error.
Method invoked on invalid IMSInteraction instance.

説明: methodname で示されているメソッドが、無効な IMSInteraction インスタンスで呼び出されました。

ユーザー処置: 当該のメソッドが 、すでに閉じている IMSInteraction インスタンスに対して発行された可能性があります。IMSInteraction インスタンスを使用または閉じる前に、それがまだ閉じられていないことを確認してください。

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

説明: methodname で示されているメソッドが、ヌルまたは空の HostName パラメーターを使用して呼び出されました。

ユーザー処置: 有効な HostName パラメーターを指定してください。管理環境では、 プロパティー値は、WebSphere Application Server が使用する接続ファクトリーを構成するときに指定されます。非管理環境では、プロパティー値は、Java アプリケーションで 指定されます。

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

説明: methodname で示されているメソッドが呼び出されました。アプリケーション・サーバーは、IMSManagedConnectionFactory クラスの createConnectionFactory メソッドを、ヌルの ConnectionManager オブジェクトを使用して呼び出しました。

ユーザー処置: 有効な 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.

説明: methodname で示されているメソッドが、空の DatastoreName パラメーターを使用して呼び出されました。このエラー・メッセージは、空の DatastoreName パラメーターを持つ接続ファクトリーが開始したときにトレース・ログに書き込まれます。このメッセージの後に J2EE Connector 警告が書き込まれます。

J2CA0007W: An exception occurred while invoking method setDataStoreName on 
com.ibm.connector2.ims.ico.IMSManagedConnectionFactory used by resource 
Connection_Factory_JNDI_name.
この場合、処理は続行されますが、名前がヌルのデータ・ストアが見つけられなかったことを示す 応答を IMS Connect が送信した後で、他のエラー・メッセージが表示されます。他のメッセージを起動する、基礎となるメッセージには以下のものがあります。
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 メッセージには、IMS Connect が見つけようとしたデータ・ストアの名前を表示するフィールド (この場合は、すべてブランク) が含まれます。
DESTID=        ;

ユーザー処置: DatastoreName パラメーターに有効な名前を指定してください。管理環境では、WebSphere Application Server が使用する接続ファクトリーを構成するときに、DatastoreName が 指定されます。非管理環境では、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.

説明: methodname で示されているメソッドが、ヌルの PortNumber を使用して呼び出されました。

ユーザー処置: 有効な PortNumber パラメーターを指定してください。管理環境では、 プロパティー値は、WebSphere Application Server が使用する接続ファクトリーを構成するときに指定されます。非管理環境では、プロパティー値は、Java アプリケーションで 指定されます。

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

説明: IMS アプリケーション・プログラムのための Java プログラムによって指定された入力メッセージに、負の値、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

    入力または出力レコードの準備中のエラーです。IMS トランザクションの入力および出力として使用するために IMS Connector for Java に提供するオブジェクトが、J2C アーキテクチャー用に 適切に定義されていることを確認してください。 例えば、それらのオブジェクトがインターフェース 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 バージョン 2.1 を使用して TCP/IP 経由で 2 フェーズ・コミット・トランザクションを実行するために、必須トランザクション EJB アプリケーションを作成した場合、実行時に IMS Connect バージョン 2.1 の 代わりにバージョン 1.2 を使用すると、このエラー・メッセージが出されます。この場合は、IMS Connect バージョン 2.1 に更新するか、あるいはグローバルでない トランザクション EJB アプリケーションを作成してください。

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 がサポートしている interactionVerb プロパティーの 値については、IMS Connector for Java の資料を調べてください。 IMS Connector for Java の特定のリリースが、J2EE Connector Architecture によって 定義されているすべての値をサポートしているとは限りません。

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 は現在、ResultSets をサポートしていません。

ユーザー処置: 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 になっていません。対話における 現時点においては、このプロトコルの状態は 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 は、2 つの入力パラメーターを受け取って javax.resource.cci.Record 型のオブジェクトを戻す形式の execute メソッドをサポートしていません。

ユーザー処置: クラス IMSInteraction でサポートされている execute メソッドの形式を使用してください。サポートされている execute メソッド形式には、以下のシグニチャーがあります。

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

説明: クラス com.ibm.connector2.ims.ico.IMSInteraction の execute メソッドに、無効な InteractionSpec オブジェクトが渡されました。

ユーザー処置: クラス 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.

説明:「入力」パラメーターとして com.ibm.connector2.ims.ico.IMSInteraction の execute メソッドに渡す入力オブジェクトがヌルであったか、インターフェース javax.resource.cci.Streamable を実装していませんでした。 この例外は、アプリケーションが J2EE Connector Architecture Common Client Interface (CCI) を使用するように作成されている場合に発生します。この例外は、WebSphere Studio Application Developer Integration Edition を使用して入力メッセージをビルドする場合は発生しません。

execute メソッドは、一部のタイプの対話に対しては、ヌルの入力オブジェクトを許可しています。例えば、interactionVerb の値が SYNC_END_CONVERSATION および SYNC_RECEIVE_ASYNCOUTPUT の場合は、ヌルの入力オブジェクトを使用できます。

ユーザー処置: execute メソッドへの「入力」パラメーターに、有効な 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 メソッドに渡す出力オブジェクトがヌルであったか、インターフェース javax.resource.cci.Streamable を実装していませんでした。 この例外は、アプリケーションが J2EE Connector Architecture Common Client Interface (CCI) を使用するように作成されている場合に発生します。この例外は、WebSphere Studio Application Developer Integration Edition を使用して出力メッセージをビルドする場合は発生しません。

ユーザー処置: 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.

説明: IMS Connector for Java のメソッドに、無効な ConnectionRequestInfo オブジェクトが渡されました。

ユーザー処置: 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 型にキャストできませんでした。 Common Client Interface が、サポートされているすべてのコネクターの connectionSpec オブジェクトを受け入れるのに対し、IMS Connector for Java が その connectionSpec として使用するのは、IMSConnectionSpec または IMSConnectionSpec の派生物のみです。

ユーザー処置: アプリケーションで使用する connectionSpec が、IMSConnectionSpec であるか、IMSConnectionSpec を継承していることを確認してください。

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

説明: IMS Connector for Java が、ConnectionManager によってこの接続用に割り振られた 接続オブジェクトを、IMSConnection 型にキャストできませんでした。 IMS Connector for Java がその接続オブジェクトとして使用するのは、IMSConnection または IMSConnection の派生物のみです。このエラーは、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.

説明: Local Option 接続用に管理接続ファクトリーを使用するためには、IMSManagedConnectionFactory インスタンスの IMSConnectName プロパティーの設定が必須です。さらに、IMS Connector for Java を使用するアプリケーションが z/OS または OS/390 のプラットフォーム上で実行している場合、Local Option を使用してのみ 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.

説明: Local Option を使用して IMS Connect と 通信できるのは、Commit Mode 1 を選択して IMS Connector for Java を 使用している場合のみです。

ユーザー処置: IMS Connector for Java を使用するアプリケーションとともに Commit Mode 1 を 使用することが選択されていることを確認してください。アプリケーションを Commit Mode 0 で実行する場合は、TCP/IP 通信を使用するようアプリケーションを 訂正してください。

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

説明: Commit Mode 0 では対話 SYNC_END_CONVERSATION はサポートされていません。

ユーザー処置: IMS Connector for Java は、SYNC_END_CONVERSATION と Commit Mode 1、SYNC_SEND_RECEIVE と Commit Mode 0、および SYNC_RECEIVE_ASYNCOUTPUT と Commit Mode 0 の 組み合わせによる対話をサポートします。

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

説明: Local Option のネイティブ・ライブラリーが、libpath にリストされているどのディレクトリーにも見つかりませんでした。

ユーザー処置: Local Option ネイティブ・ライブラリーが、LIBPATH 環境変数にリストされているディレクトリーの 1 つに存在していることを確認してください。WebSphere Application Server for z/OS® および OS/390® で IMS Connector for Java を実行する場合は、Local Option のネイティブ・ライブラリー・ファイルを含むディレクトリーのフルネームが、ご使用の J2EE サーバーの LIBPATH 環境変数に定義されていることを確認してください。 詳しくは、WebSphere Application Server バージョン 6.0 Information Center 内の『基本オペレーティング・システムの準備』 を参照してください。

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

説明: Local Option を使用して IMS Connect と通信できるのは、IMS Connector for Java を 使用するアプリケーションが、z/OS または OS/390 プラットフォームで実行されている場合のみです。

ユーザー処置: 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].

説明: Local Option のネイティブ・メソッドが 見つかりません。

ユーザー処置: システムに インストールされている IMS Connector for Java リソース・アダプターおよび Local Option のネイティブ・ライブラリーのレベルが正しいことを確認してください。 必ず、WebSphere Application Server for z/OS および OS/390 システムに インストールした IMS リソース・アダプターに付属しているバージョンの Local Option のネイティブ・ライブラリーを使用してください。 詳しくは、『IMS Connector for Java を 使用するための前提条件』を参照してください。

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

説明: Local Option のネイティブ・メソッドで内部エラーが発生しました。

ユーザー処置: IBM サービス技術員に連絡してください。

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

説明: IMS Connector for Java がサポートしている使用可能なセキュリティー信任状が、WebSphere Application Server が提供しているサブジェクトに含まれていませんでした。

ユーザー処置: インストールされている WebSphere Application Server for z/OS および OS/390 の レベルが正しいことを確認してください。 詳しくは、『IMS Connector for Java を 使用するための前提条件』セクションを参照してください。 IMS Connector for Java がサポートしているセキュリティー信任状を 提供するように、WebSphere Application Server for z/OS および OS/390 を 構成してください。IMS Connector for Java は、TCP/IP 接続には PasswordCredential を、Local Option 接続には 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 の Transaction Manager にアクセスしているときに、エラーが発生しました。

ユーザー処置: インストールされている WebSphere Application Server for z/OS および OS/390 の レベルが正しいことを確認してください。 詳しくは、『IMS Connector for Java を 使用するための前提条件』セクションを参照してください。

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

説明: トランザクションが WebSphere Application Server の Transaction Manager を使用して開始されているかどうかを 判別しようとしているときに、エラーが発生しました。

ユーザー処置: インストールされている WebSphere Application Server for z/OS および 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 or 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]."

説明: RRS が失敗したため、IMS Connect がエラーを戻しました。

ユーザー処置: 関連する IMS Connect および RRS エラー・メッセージがないか、MVS コンソールを調べてください。 戻りコード (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 を調べて、ホストとの接続に失敗した理由を突き止めてください。また、関連する IMS Connect または TCP/IP のエラー・メッセージがないかどうか、MVS コンソールも 調べてください。 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 手引きおよび解説書」を参照してください。 その Xid に対応する UR がリストされていることを確認してください。 グローバル・トランザクションが、ヒューリスティック状態のまま取り残されなかったことを確認してください。

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

説明: RRS が ダウンしたか、あるいは RRS と IMS Connect との間の通信が終了しました。

ユーザー処置: 関連する IMS Connect および RRS エラー・メッセージがないか、MVS コンソールを調べてください。 z/OS または OS/390 システムで、RRS が ダウンしていないことを確認してください。 IMS Connect が 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 エラー・メッセージが出されました。

ユーザー処置: 関連する IMS Connect および RRS エラー・メッセージがないか、MVS コンソールを調べてください。 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 は、この発行に関連する RRS ルーチンと戻りコードを示しているエラー・メッセージ ICO0074E です。

ユーザー処置: RRS エラー・メッセージに関する詳細は、ICO0074E エラーの説明を参照してください。 WebSphere Application Server のログ内のトランザクション情報と Xid を入手するためのステップについては、 「WebSphere Application Server InfoCenter Reference Library」 を参照してください。 Xid およびそれぞれに関連する UR をリストするための IMS Connect の コマンドについては、「IMS Connect 手引きおよび解説書」を参照してください。 関係する Xid と UR、および IMS に コミットされた結果を判別してください。 IMS 内の値を検証して、ヒューリスティック状態が発生したことを確認してください。 次に、このトランザクションがコミットされた場合と同じ結果になるように IMS 内のデータを修正するための処置、または関係するその他のデータベースが、そのトランザクションを実行する前の状態に戻るように修正するための処置を 決定する必要があります。

ICO0076E
javax.resource.ResourceException:
ICO0076E:methodname error. 内部エラーが発生しました。[rrs_exception]

説明: IMS Connect から渡された RRS エラー・メッセージに関する情報を 抽出しようとしているときに、内部エラーが発生しました。 rrs_exception は、そのエラーに関連する RRS ルーチンと戻りコードを示している、エラー・メッセージ ICO0074E です。

ユーザー処置: 発生した RRS 障害に関する詳細については、ICO0074E エラー・メッセージの説明を参照してください。IBM サービス技術員に連絡してください。

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

説明: 同じ UR に対して、2 度目のトランザクションのロールバックを 行おうとしたことを示す RRS エラーが IMS Connect から渡されました。 RRS は、2 度目のロールバックを阻止し、そのような処置が試行されたことを示すエラーをスローします。rrs_exception は、そのエラーに関連する RRS ルーチンと戻りコードを示している、エラー・メッセージ ICO0074E です。

ユーザー処置: トランザクションはロールバックされるので、処置は不要です。発生した RRS 障害に関する詳細については、ICO0074E エラー・メッセージの説明を参照してください。予防措置として、 トランザクションを実行する前のデータが失われたり、変更されていないことを検証してください。

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 が、IMS トランザクションの出力ではなく、DFS_message によって 示されたメッセージを戻しました。 この例外は、対話において、IMSInteractionSpec の imsRequestType プロパティーに値 IMS_REQUEST_TYPE_IMS_TRANSACTION が使用される場合に発生します。

例えば、Java アプリケーションが、停止している IMS トランザクションを 実行しようとすると、この例外がスローされ、DFS_message の 値は
DFS065 hh:mm:ss TRAN/LTERM STOPPED
になります。

ユーザー処置:IMS Messages and Codes」 で 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 Connect の TIMEOUT 値を超えました。 IMS Connect の TIMEOUT 値は、以下のとおりです。
  • SYNC_SEND_RECEIVE 対話の場合は、IMS Connect の構成メンバー内で指定されます。
  • SYNC_RECEIVE_ASYNCOUTPUT、SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT、および SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT 対話の場合は 2 秒です。
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 にメッセージを送信し、その応答を受信するのにかかる時間が、適切な実行タイムアウト間隔に丸められた executionTimeout 値を超えました。 有効な実行タイムアウト値が設定されると、この値は IMS Connect で使用可能な 値に変換されます。

ユーザー処置: 丸められた実行タイムアウト値が 予想と異なる場合は、次の変換規則表で検証してください。

ユーザー指定値の範囲 変換規則
1 ~ 250 ユーザー指定値が 10 で割り切れない場合は、その値よりも大きい、次の 10 の倍数に変換されます。
251 ~ 1000 ユーザー指定値が 50 で割り切れない場合は、その値よりも大きい、次の 50 の倍数に変換されます。
1001 ~ 60000 ユーザー指定値は、その値に最も近い 1000 の倍数に変換されます。 1000 ごとの増分のちょうど中央にある値は、その値よりも大きい、次の 1000 の倍数に変換されます。
60001 ~ 3600000 ユーザー指定値は、その値に最も近い 60000 の倍数に変換されます。 60000 ごとの増分のちょうど中央にある値は、その値よりも大きい、次の 60000 の倍数に変換されます。

詳しくは、WebSphere Studio Application Developer Integration Edition 5.0.1 ヘルプの、『有効な実行タイムアウト値』のトピックを参照してください。

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 の範囲内 (両端を含む) の 10 進整数である必要があります。また、対話を時間制限なしに繰り返し実行したい場合は、-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.

説明: Commit Mode 0 での SYNC_SEND_RECEIVE、SYNC_SEND、SYNC_RECEIVE_ASYNCOUTPUT、SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT、 および SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT 対話は、グローバル・トランザクションの 有効範囲内では無効です。これは、現在、グローバル・トランザクションでは Commit Mode 1 でのみ有効な SYNC_LEVEL_SYNCPOINT および SYNC_LEVEL_SYNCPOINT の使用が必須であるためです。

ユーザー処置:
  • Commit Mode 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 が発生しました。 この例外が発生するのは、Java 2 セキュリティーが使用可能になっていて、呼び出し側プログラム 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 property)」フィールドで指定した 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.

説明: Commit Mode プロパティーに指定された値 1 は無効です。この接続ファクトリーは専用永続的ソケット用に構成されているため、 この種類の接続ファクトリーで Commit Mode 1 を使用することはできません。

ユーザー処置: 専用永続的ソケット接続ファクトリーの場合、有効な対話は Commit Mode 0 対話がです。使用しているソケットが専用永続的ソケットであるかどうかを判別するためには、 この対話で使用している接続ファクトリーの CM0Dedicated プロパティーの値が TRUE になっているかどうかを調べてください。

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

説明: interactionVerb プロパティーに指定された値 SYNC_RECEIVE_ASYNCOUTPUT は無効です。この接続ファクトリーは共用可能永続的ソケット用に構成されているため、 この種類の接続ファクトリーで SYNC_RECEIVE_ASYNCOUTPUT を使用することはできません。

ユーザー処置: SYNC_SEND_RECEIVE、SYNC_SEND、 および SYNC_END_CONVERSATION は、共用可能永続的接続で行われる対話の場合に、interactionVerb プロパティーの有効な値です。使用している接続が共用可能永続的接続であるかどうかを判別するためには、 この対話で使用している接続ファクトリーの CM0Dedicated プロパティーの値が FALSE になっているかどうかを調べてください。

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

説明: 非永続 ソケット (トランザクション・ソケット) で CommitMode 0 を実行すると、IMS Connector for Java により、管理対象の接続オブジェクトが接続プールから強制的に除去されます。

ユーザー処置: これはエラー・メッセージではないので、処置は不要です。

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.

説明: methodname で示されているメソッドが、ヌルまたは空の SSLKeystoreName、SSLKeystorePassword、SSLTruststoreName、または SSLTruststorePassword パラメーターを使用して呼び出されました。これは、上述のパラメーターの 1 つが、ヌルまたは空のストリングであることをユーザーに知らせるための通知メッセージです。これにより、プログラムの実行が終了するわけではありません。

ユーザー処置: SSLKeystoreName、SSLKeystorePassword、SSLTruststoreName、および SSLTruststorePassword パラメーターに、有効な値を指定してください。便宜上、秘密鍵と証明書は、鍵ストアまたはトラストストアのいずれかに保管することができます。したがって、適切に実行するには、有効な値のセット 1 つ (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 or 'WEAK'
for weak encryption.

説明: SSLEncryptionType パラメーターに strong または weak 以外の値が指定されました。

ユーザー処置: SSLEncryptionType パラメーターには、strong または weak のいずれかを指定してください。この値は大/小文字を区別しません。

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

説明: プロパティー IMSConnectName が非ヌル値に設定され、プロパティー SSLEnabled が true に設定されています。しかし、SSL はローカル・オプション接続ではサポートされていません (このことは、IMSConnectName パラメーターに値を指定すると示されます)。

ユーザー処置:: 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 から応答を受け取るのに要した時間が、 ソケット・タイムアウトとして指定された時間を超えました。

ユーザー処置: ソケット・タイムアウトの値として指定した時間が、IMS Connector for Java が IMS Connect から応答を受け取るのに 十分な長さになっていることを確認してください。 時間が不十分な場合には、値を大きくしてください。 ソケット・タイムアウトに指定された値が十分な長さになっている場合には、 ネットワーク問題によって遅延が発生している可能性があります。ネットワーク管理者に連絡してください。

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

説明: ソケット・タイムアウト・プロパティー に指定された値 [socket timeout value] は無効な値です。

User Action: 提示された exception_reason を調べてください。 ソケット・タイムアウトに指定された数値が、正の値になっていることを確認してください。

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.

説明: IMS リソース・アダプターが現在サポートしているのは、SYNC_SEND 対話のための Commit Mode 0 のみです。

ユーザー処置: Commit Mode 0 は、SYNC_SEND、SYNC_RECEIVE_ASYNCOUTPUT、 SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT、および SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT 対話で必要です。 Commit Mode 1 は、SYNC_SEND_RECEIVE and 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 対話でのみ有効です。 ImsRequestType 1(IMS_REQUEST_TYPE_IMS_TRANSACTION) は、SYNC_SEND、SYNC_END_CONVERSATION、SYNC_RECEIVE_ASYNCOUTPUT、SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT、 および SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT 対話で必要です。

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

説明: IMS Connect での Secure Sockets Layer TCP/IP 接続を初期化する場合は、IMS Connector for Java では、2 つのサポートされるプロバイダー (com.ibm.jsse.JSSEProvider または sun.security.provider.Sun) のいずれかを 使用する必要があります。このエラーは、これらのプロバイダーのいずれも使用できないことを示します。

ユーザー処置: com.ibm.jsse.JSSEProvider をデフォルトで IBM JVM に追加して、sun.security.provider.Sun を デフォルトで Sun JVM に追加する必要があります。他のアプリケーション・サーバーで WebSphere Application Server または Sun JVM が実行されている場合は、 サポートされる IBM JVM で IMS Connector for Java が実行されていることを 確認してください。

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 が指定されているため、デフォルト値 (TRUE) が purgeAsyncOutput プロパティーに使用されます。

ユーザー処置: reRoute を TRUE に 設定する場合は、purgeAsyncOutput プロパティーを FALSE に設定してください。

関連タスク
IMS リソース・アダプターを使用したロギングおよびトレース
関連資料
IMS リソース・アダプターを使用した場合の問題の診断
J2CA0056I、WLTC0017E、HWSP1445E、および HWSSL00E エラー・メッセージ
ご利用条件 | フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.
(C) Copyright IBM Japan 2005.