J2C Java Bean の Java メソッドを定義する場合、Java メソッドで実行される IMS との対話を記述するプロパティーの値を指定する必要があります。これらは、IMSInteractionSpec の入力プロパティーの値です。以下のリストでは、アプリケーション・コンポーネントで設定されていないものも含め、 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 リソース・アダプターは、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 対話では、入力レコード (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 リソース・アダプターはメッセージを送って、IMS 会話型
トランザクションを強制的に終了させます。
interactionVerb に SYNC_END_CONVERSATION が指定されている場合は、IMSInteractionSpec プロパティーの commitMode、および IMSConnectionSpec プロパティーの clientID は適用されません。 |
4 | SYNC_RECEIVE_ASYNCOUTPUT | interactionVerb SYNC_RECEIVE_ASYNCOUTPUT は、共用可能永続的ソケット接続と専用永続的ソケット接続の両方で有効です。SYNC_RECEIVE_ASYNCOUTPUT は、
配信されなかった非同期出力を検索するために使用されます。専用永続的ソケットで SYNC_RECEIVE_ASYNCOUTPUT を使用する場合は、IMSConnectionSpec の
clientID プロパティーに値を指定する必要があります。 共用可能永続的ソケット接続での SYNC_RECEIVE_ASYNCOUTPUT 対話は、元の SYNC_SEND または SYNC_SEND_RECEIVE 対話と同じアプリケーション内になければならず、かつ、同じ共用可能永続的ソケット接続を使用しなければなりません。 これは、基本的には、実行タイムアウトに続いて発生します。 このタイプの対話では、Java クライアントは、単一のメッセージのみを受信できます。要求が出されたときに clientID の IMS OTMA 非同期キューにメッセージがない場合は、 メッセージを検索する試みはこれ以上行われません。戻される メッセージはなく、SYNC_RECEIVE_ASYNCOUTPUT 対話の executionTimeout プロパティーで指定された時間が経過するとタイムアウトになります。 |
5 | SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT |
interactionVerb SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT は、共用可能永続的ソケット接続と専用永続的ソケット接続の両方で有効です。これは、非同期出力を検索するために使用されます。共用可能永続的ソケット接続での
SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT 対話は、元の SYNC_SEND または SYNC_SEND_RECEIVE 対話と同じアプリケーション内になければならず、かつ、同じ共用可能永続的ソケット接続を使用しなければなりません。 これは、基本的には、実行タイムアウトに続いて発生します。このタイプの対話では、Java クライアントは、単一のメッセージのみを受信できます。要求が出されたときに clientID の IMS OTMA 非同期キューにメッセージがない場合は、
メッセージを検索する試みはこれ以上行われません。戻されるメッセージはなく、
SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT 対話の executionTimeout プロパティーで指定された時間が経過するとタイムアウトになります。注: interactionVerbs、SYNC_RECEIVE_ASYNCOUTPUT、
および
SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT は同じ機能を実行します。しかし、SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT を使用することをお勧めします。 |
6 | SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT |
interactionVerb SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT は、非同期出力を検索するために使用されます。これは、共用可能永続的ソケット接続と専用永続的ソケット接続の両方で 有効です。共用可能永続的ソケット接続での
SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT 対話は、元の SYNC_SEND または SYNC_SEND_RECEIVE 対話と同じアプリケーション内になければならず、 かつ、同じ共用可能永続的ソケット接続を使用しなければなりません。 これは、基本的には、実行タイムアウトに続いて発生します。このタイプの対話では、Java クライアントは、単一のメッセージのみを受信できます。要求が出されたときに clientID の IMS OTMA 非同期キューにメッセージが
ない場合は、IMS Connect は、OTMA がメッセージを戻すのを待ちます。
IMS Connect は、
SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT 対話の executionTimeout プロパティーで指定された長さの時間待ってから、例外を戻します。 |
J2EE Connection Architecture (JCA) の値 SYNC_RECEIVE (2) は、 現在サポートされていません。
このプロパティーの値は、クライアント・アプリケーションが LTERM オーバーライド名を提供する場合に設定できます。この名前は、IMS アプリケーション・プログラムの 入出力 PCB に入れられます。IMS アプリケーションは、 このオーバーライド値に基づいて論理決定を行います。
入力の場合は、一般に 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 対話でのみ有効です。これは、専用永続的ソケット接続で行われる対話では無効です。