マップされた会話の例 (CPI-C)

マップされた会話の次の例は、会話の開始、データの交換、および会話の終了に使用される共通プログラミングインターフェイス (CPI-C) 呼び出しを示しています。呼び出しパラメーターはかっこ内にあります。

次の段落では、マップされた会話で使用される呼び出しについて説明します。

マップされた会話を開始するための呼び出し

会話を開始するために、呼び出し元トランザクションプログラム (TP) は次の呼び出しを発行します。

Initialize_Conversation、会話の特性を定義する値を設定するように CPI-C に要求します。 Initialize_Conversation呼び出しでは、メモリ内のサイド情報テーブル内のエントリに関連付けられているシンボリック宛先名を指定します。サイド情報では、パートナー TP、パートナー LU、モード、セキュリティなどを指定します。
割り当て。 CPI-C が呼び出し側 TP と呼び出し可能 TP の間の会話を確立することを要求します。

呼び出し可能 TP は、呼び出し元 TP との会話を開始する準備ができていることを CPI-C に通知する、Accept_Conversation呼び出しを発行します。

Send_Data呼び出しは、ローカル論理ユニット (LU) の送信バッファーに 1 つのデータレコード (送信するアプリケーションデータを含むレコード) を格納します。パートナー TP へのデータ転送は、次のいずれかのイベントが発生するまで行われません。

送信バッファーがいっぱいになります。
送信側 TP は、CPI-C がバッファーをフラッシュし、パートナー TP にデータを送信するように強制する呼び出しを行います。

送信バッファーには、データレコードに加えて、(データレコードの前にある) 割り当て要求も含まれます。

前の例では、割り当て解除によって送信バッファーがフラッシュされ、割り当て要求とデータがパートナー TP に送信されます。バッファーをフラッシュするその他の呼び出しは、Confirm と Flush です。

Receive 呼び出しは、パートナー TP からデータレコードと状態情報を受信します。現在使用できるデータまたは状態情報がない場合、ローカル TP は既定でデータの到着を待機します。

Receiveの data_received パラメーターは、データを受信したかどうか、および受信した場合は、データが完了しているかどうかをプログラムに通知します。

会話を終了するために、TP の 1 つが割り当て解除を発行します。これにより、CPI-C は 2 つの TP 間の会話の割り当てを解除します。