セクション 3c

ドキュメントのダウンロード

サイトマップ

用語集

検索

e-docs > Tuxedo > Tuxedo C リファレンス > セクション 3c - C 関数

Tuxedo C リファレンス

tprecv(3c)

名前

tprecv()－会話型接続でメッセージを受信するルーチン

形式

#include <atmi.h>
int tprecv(int cd, char **data, long *len, long flags, long ¥ 
   *revent)

機能説明

tprecv() は、別のプログラムからオープン接続を介してデータを受け取るときに使用します。tprecv() の最初の引数 cd は、データを受け取るオープン接続を指定します。cd には、tpconnect() から返される記述子、あるいは会話型サービスに渡される TPSVCINFO パラメータに含まれる記述子のいずれかを指定します。2 番目の引数 data は、tpalloc() によって以前に割り当てられたバッファを指すポインタのアドレスです。

data は、前に tpalloc() が割り当てたバッファへのポインタのアドレスでなければなりません。また、len は long 型 (tprecv() が受信したデータのサイズに設定した) を指さなければなりません。*data は応答を含んでいるバッファを指し、*len は、バッファのサイズを含みます。FML と FML32 バッファは、通常最小サイズ 4096 バイトを確保します。したがって、応答が 4096 バイトより大きい場合は、バッファ・サイズは返されるデータを入れるのに十分な大きさに拡大します。

容量まで満たされていない送信側のバッファ (たとえば、FML および STRING バッファ) は、送信に使用された大きさになります。システムは、受信データのサイズを任意の量で拡大します。これは、受信者が送信者の割り当てたバッファ・サイズより小さく、送信されたデータのサイズより大きいバッファを受け取ることを意味します。

受信バッファのサイズは、増加することも減少することもあります。また、アドレスもシステムがバッファを内部で交換するごとに常に変更されます。応答バッファのサイズが変わったどうか (また変わったとしたらどれくらい変わったのか) を決定するには、tprecv() が *len とともに発行される前に、合計サイズを比べてください。バッファ管理の詳細については、C 言語アプリケーション・トランザクション・モニタ・インターフェイスについてを参照してください。

*len が 0 の場合、データは受け取られず、*data も、それが指すバッファも、変更されていません。data、*data または len が NULL であると、エラーになります。

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

次に、有効な flags の一覧を示します。

TPNOCHANGE

デフォルトでは、*data が指すバッファ型と異なるバッファ型を受信すると、*data のバッファ型は受信したバッファ型に変更されます (受信プロセスがそのバッファ型を認識できる場合)。このフラグが設定されていると、*data が指すバッファのタイプは変更されません。つまり、受信されたバッファのタイプおよびサブタイプは、それぞれ *data が指すバッファのタイプおよびサブタイプと一致しなければなりません。

TPNOBLOCK

tprecv() はデータが到着するまで待機しません。すでにデータが受信できる状態であると、tprecv() はデータを取り込んで終了します。このフラグが設定されておらず、かつ受信できるデータがない場合、呼び出し元はデータが到着するまでブロックされます。

TPNOTIME

このフラグは、呼び出し元が無制限にブロックでき、ブロッキング・タイムアウトの対象にならないようにすることを指定します。ただし、トランザクション・タイムアウトはあいかわらず有効です。

TPSIGRSTRT

シグナルが関数内部の受信システム・コールを中断させると、呼び出しが再度出されます。

記述子 cd に対してイベントが存在すると、tprecv() は終了し、tperrno を TPEEVENT に設定します。イベントのタイプが revent で返されます。TPEV_SVCSUCC、TPEV_SVCFAIL および TPEV_SENDONLY イベントとともに、データを受け取ることができます。tprecv() の有効なイベントを次に示します。