TPRECV(3cbl)

名前

TPRECV() - 会話接続でメッセージを受信する

形式

01 TPSVCDEF-REC.
 COPY TPSVCDEF 
 
01 TPTYPE-REC.
 COPY TPTYPE. 
 
01 DATA-REC.
 COPY User data. 
 
01 TPSTATUS-REC.
 COPY TPSTATUS. 
 
CALL "TPRECV" USING TPSVCDEF-REC TPTYPE-REC DATA-REC TPSTATUS-REC.

機能説明

TPRECV() は、別のプログラムからオープン接続を介してデータを受け取るときに使用します。 COMM-HANDLE は、データを受け取るオープン接続を指定します。 COMM-HANDLE は、TPCONNECT() または TPSVCSTART() から返される通信ハンドルです。 DATA-REC は、メッセージが読み込まれる場所を指定し、入力時には LEN が DATA-REC に移動される最大バイト数を示します。

正常終了の場合、およびいくつかのイベント・タイプの場合、LEN には DATA-REC に移動された実際のバイト数が入ります。 REC-TYPE および SUB-TYPE には、それぞれデータのタイプおよびサブタイプが入っています。 メッセージが DATA-REC より大きい場合は、DATA-REC にはこのレコードに入るバイト数分のみが入ります。 応答の残りは破棄され、TPRECV() は TPTRUNCATE を設定します。

正常終了時に LEN が 0 である場合は、応答にはデータ部がなく、DATA-REC は変更されていません。 入力時に LEN を 0 にすると、エラーになります。

TPRECV() は、接続の制御をもたないプログラムしか出せません。

次に、TPSVCDEF-REC の有効な設定の一覧を示します。

戻り値

TPRECV() は正常終了時には、TP-STATUS に [TPOK] を設定します。 TP-STATUS に [TPEEVENT] が設定され、TPEVENT() が TPEV-SVCSUCC または TPEV-SVCFAIL の場合、APPL-RETURN-CODE には、TPRETURN() の一部として送信されたアプリケーション定義の値が入ります。 着信メッセージの大きさが入力時に LEN に指定されたより大きい場合は、TPTRUNCATE() が設定され、LEN 分のデータのみが DATA-REC に移動されて残りのデータは破棄されます。

エラー

次の条件が発生すると、TPRECV() は異常終了し、TP-STATUS に次の値を設定します。特に説明がなければ、この障害は呼び出し元のトランザクションには影響しません。

使用法

TPRETURN() が呼び出されたとき、サーバは、アプリケーション定義の戻り値および型付きレコードを渡すことができます。 この戻り値は APPL-RETURN-CODE にあり、レコードは、DATA-REC にあります。

関連項目