Java™ アプリケーションが IMS と 対話をする場合は、構成済みの IMSInteractionSpec オブジェクトを提供する必要があります。 IMSInteractionSpec オブジェクトのプロパティーの値は、IMS との 対話を記述します。IMSInteractionSpec のプロパティーの値は共通クライアント・インターフェースを使用するアプリケーションによって、直接 set メソッドにより提供されるか、またはアプリケーションのコードを生成する IDE のウィザードに提供される場合があります。 プロパティーの中には入力専用プロパティー、入出力プロパティー、出力専用プロパティーがあります。 出力専用プロパティーは、対話についての追加情報を決定するために Java アプリケーション (アプリケーション・コンポーネントともいう) によって問い合わせられます。
次のリストは、IMSInteractionSpec のすべてのプロパティーについて説明したものです。
値 | IMSInteractionSpecProperties の名前付き定数 | 説明 |
---|---|---|
1 | IMS_REQUEST_TYPE_IMS_TRANSACTION |
この要求は IMS トランザクションです。
IMS が
戻す標準のトランザクション出力は、アプリケーションの出力メッセージにデータを
取り込むために使用されます。
IMS が
「DFS™」
メッセージを戻すと、IMS リソース・
アダプターは、その「DFS」
メッセージを含む IMSDFSMessageException をスローします。
imsRequestType のこの値は、WebSphere® Studio MFS サポートを使用しないで作成されるアプリケーションに使用されます。 |
2 | IMS_REQUEST_TYPE_IMS_COMMAND | この要求は IMS コマンドです。
IMS が
戻すコマンド出力 (「DFS」
メッセージを含みます) は、アプリケーションの出力メッセージにデータを
取り込むために使用されます。
IMSDFSMessageException はスローされません。 imsRequestType のこの値は、IMS コマンドを出すアプリケーションに 使用されます。 |
3 | IMS_REQUEST_TYPE_MFS_TRANSACTION |
imsRequestType のこの値は、WebSphere
Studio MFS サポートを使用して作成されるアプリケーションのために予約されています。
IMS が 戻すトランザクションの標準出力および「DFS」 メッセージは、アプリケーションの出力メッセージにデータを取り込むために 使用されます。 IMSDFSMessageException はスローされません。 |
値 | IMSInteractionSpecProperties の名前付き定数 | 説明 |
---|---|---|
0 | SYNC_SEND | IMS TM リソース・アダプターは、IMS Connect から IMS に クライアント要求を送信しますが、IMS からの 応答は予期しません。 SYNC_SEND 対話では、クライアントは、IMS から応答を同期的に受信する必要はありません。 SYNC_SEND は、共用可能永続的ソケット接続と専用永続的ソケット接続の両方で サポートされており、commitMode 0 対話でのみ使用可能です。 interactionVerb を SYNC_SEND に設定すると、実行タイムアウト値とソケット・ タイムアウト値は無視されます。注: imsRequest タイプ 2 を SYNC_SEND とともに使用することはできません。例外が生成されます。 |
1 | SYNC_SEND_RECEIVE | IMS 対話を実行することにより、IMS への 要求の送信と応答の受信が同期的に行われます。 一般的な SYNC_SEND_RECEIVE 対話では、入力レコード (the IMS トランザクションの入力メッセージ) が IMS に送られ、IMS が出力レコード (IMS トランザクションの出力メッセージ) を戻す、という非会話型 IMS トランザクションが実行されます。 SYNC_SEND_RECEIVE 対話は、会話型 IMS トランザクションの 反復にも使用されます。 会話型トランザクションは commitMode 1 を必要とします。非会話型 トランザクションは、commitMode 1 を使用して実行することも、commitMode 0 を 使用して実行することもできます。専用永続的ソケットで commitMode 0 を 使用する場合は、IMSConnectionSpec の clientID プロパティーに値を指定する 必要があります。 共用可能永続ソケットで commitMode 0 を使用する場合は、IMSConnectionSpec の clientID プロパティー の値を指定してはなりません。 |
3 | SYNC_END_CONVERSATION | interactionVerb を SYNC_END_CONVERSATION に設定してアプリケーションが
対話を実行する場合は、IMS
TM リソース・アダプターはメッセージを送信して、IMS 会話型
トランザクションを強制的に終了させます。 interactionVerb に SYNC_END_CONVERSATION が指定されている場合は、IMSInteractionSpec プロパティーの commitMode、および IMSConnectionSpec プロパティーの clientID は適用されません。 |
4 | SYNC_RECEIVE_ASYNCOUTPUT | interactionVerb SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT は、共用可能永続的ソケット
接続と専用永続的ソケット接続の両方で有効です。 SYNC_RECEIVE_ASYNCOUTPUT は、
配信されなかった非同期出力を検索するために使用されます。
専用永続的ソケットで SYNC_RECEIVE_ASYNCOUTPUT を使用する場合は、IMSConnectionSpec の
clientID プロパティーに値を指定する必要があります。 共用可能永続的ソケット接続での SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT 対話は、元の SYNC_SEND または SYNC_SEND_RECEIVE 対話と同じアプリケーション内になければならず、かつ、 同じ共用可能永続的ソケット接続を使用しなければなりません。 これは、基本的には、実行タイムアウトに続いて発生します。 このタイプの 対話では、Java クライアントは、 単一のメッセージのみを受信できます。 要求が出されたときに clientID の IMS OTMA 非同期キューにメッセージがない場合は、メッセージを検索する試みは これ以上行われません。戻される メッセージはなく、SYNC_RECEIVE_ASYNCOUTPUT 対話の executionTimeout プロパティーで指定された時間が経過するとタイムアウトになります。 |
5 | SYNC_RECEIVE_ASYNCOUTPUT_ |
interactionVerb SYNC_RECEIVE_ASYNCOUTPUT_ 共用可能永続的ソケット接続での
SYNC_RECEIVE_ASYNCOUTPUT_ SINGLE_NOWAIT 対話は、元の SYNC_SEND または SYNC_SEND_RECEIVE 対話と同じアプリケーション内になければならず、かつ同じ共用可能永続的ソケット接続を使用しなければなりません。これは、基本的には、実行タイムアウトに続いて発生します。このタイプの
対話では、Java クライアントは、
単一のメッセージのみを受信できます。
要求が出されたときに clientID の IMS
OTMA 非同期キューにメッセージがない場合は、メッセージを検索する試みは
これ以上行われません。
SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT 対話の executionTimeout プロパティーで指定された時間が経過すると、戻されるメッセージなしでタイムアウトになります。注: 対話 Verb、SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT、および
SYNC_RECEIVE_ASYNCOUTPUT_ SYNC_RECEIVE_ASYNCOUTPUT_ |
6 | SYNC_RECEIVE_ASYNCOUTPUT_ |
interactionVerb SYNC_RECEIVE_ASYNCOUTPUT_ 共用可能永続的ソケット接続での
SYNC_RECEIVE_ASYNCOUTPUT SINGLE_WAIT 対話は、元の SYNC_SEND または SYNC_SEND_RECEIVE 対話と同じアプリケーション内になければならず、 かつ同じ共用可能永続的ソケット接続を使用しなければなりません。これは、基本的には、実行タイムアウトに続いて発生します。このタイプの
対話では、Java クライアントは、
単一のメッセージのみを受信できます。
要求が出されたときに clientID の IMS
OTMA 非同期キューにメッセージがない場合は、IMS
Connect は、OTMA がメッセージを戻すのを待ちます。
IMS Connect は、
SYNC_RECEIVE_ASYNCOUTPUT_ |
J2EE Connection Architecture (JCA) の値 SYNC_RECEIVE (2) は、 現在サポートされていません。
このプロパティーの値は、クライアント・アプリケーションが LTERM オーバーライド名を提供する場合に設定できます。この 名前は、IMS アプリケーション・プログラムの 入出力 PCB に入れられます。IMS アプリケーションは、 このオーバーライド値に基づいて論理決定を行います。
このプロパティーの値は、クライアント・アプリケーションが LTERM オーバーライド名を提供する場合に設定できます。この 名前は、IMS アプリケーション・プログラムの 入出力 PCB に入れられます。IMS アプリケーションは、 このオーバーライド値に基づいて論理決定を行います。
入力の場合は、一般に mapName プロパティーの値は、MFS メッセージ出力記述子、すなわち「MOD」の名前です。MOD の 名前は、入出力 PCB に入れられて IMS アプリケーション・プログラムに提供されます。
出力の場合、mapName プロパティーの値は、MFS メッセージ出力記述子、すなわち「MOD」の名前です。これは、 トランザクション出力メッセージを入出力 PCB に挿入するときに IMS アプリケーション・プログラムが指定した MOD 名です。
注: 入出力メッセージが WebSphere Studio MFS サポートによって生成されるエンタープライズ・サービスを使用する Java アプリケーションでは、mapName フィールドを使用しないでください。
入力の場合は、一般に mapName プロパティーの値は、MFS メッセージ出力記述子、すなわち「MOD」の名前です。MOD の 名前は、入出力 PCB に入れられて IMS アプリケーション・プログラムに提供されます。
出力の場合、mapName プロパティーの値は、MFS メッセージ出力記述子、すなわち「MOD」の名前です。これは、 トランザクション出力メッセージを入出力 PCB に挿入するときに IMS アプリケーション・プログラムが指定した MOD 名です。
入出力メッセージが WebSphere Studio MFS サポートによって生成されるエンタープライズ・サービスを使用する Java アプリケーションでは、mapName フィールドを 使用しないでください。
このプロパティーは、共用可能永続的ソケット接続上で、IMS の 対話 verb である SYNC_SEND_RECEIVE を使用する対話でのみ有効です。 これは、専用永続的ソケット接続で行われる対話では無効です。 このプロパティーはコミット・モード 0 の対話に適用されます。 コミット・モード 1 の対話には適用されません。 ただし、コミット・モード 1 対話がプログラム間の切り替えを実行する場合、切り替えられたプログラムはコミット・モード 0 を実行するため、結果としてこのプロパティーが適用されます。
このプロパティーは、共用可能永続的ソケット接続上で、IMS の 対話 verb である SYNC_SEND_RECEIVE を使用する対話でのみ有効です。 これは、専用永続的ソケット接続で行われる対話では無効です。 このプロパティーはコミット・モード 0 の対話に適用されます。 コミット・モード 1 の対話には適用されません。 ただし、コミット・モード 1 対話がプログラム間の切り替えを実行する場合、切り替えられたプログラムはコミット・モード 0 を実行するため、結果としてこのプロパティーが適用されます。 このプロパティーは、 配信されない出力を、reRouteName フィールドで指定された宛先に転送するかどうかを 決定します。reRoute が TRUE の場合は、非同期出力は、生成された clientID の TPIPE にキューイングされません。 その代わり、非同期出力は、reRouteName フィールドで指定された宛先に キューイングされます。reRoute のデフォルト値は FALSE です。
reRoute と purgeAsyncOutput の両方を TRUE に設定すると、例外がスローされます。
プロパティー reRouteName は、共用可能永続的ソケット接続での SYNC_SEND_RECEIVE 対話でのみ有効です。これは、専用永続的ソケット接続で行われる対話では無効です。