tprecv

ANSI C，C++の形式

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

K&R版 Cの形式

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

『●cd

記述子を設定します。』

『●data

受信したデータを格納するバッファへのポインタのアドレスを設定します。』

『●len

受信したデータの長さを格納する領域のアドレスを設定します。』

『●flags

フラグを示します。』

『●revent

イベントを示すlong型へのポインタを示します。』

flagsには，次に示す値を設定します。

TPNOCHANGE

*dataで指しているバッファタイプと異なる型のデータを受信したとき，このフラグを設定していなければ，*dataのバッファ型は，受け取り側がそのバッファタイプを認識しているかぎり，受信したデータのバッファ型に変換されます。このフラグを設定した場合は，*dataで指しているバッファのタイプは変換されません。つまり，受信したバッファのtypeとsubtypeと，*dataで指されたバッファのtypeとsubtypeは必ず一致させてください。

TPNOBLOCK

tprecv()はデータの到着を待ちません。データがすでに受信できる状態の場合は，tprecv()はデータを受信してリターンします。このフラグを設定しないで，データが使えない状態の場合は，呼び出し側はデータが到着するまでブロックします。

TPNOTIME

呼び出し側を無期限にブロックして，ブロッキングタイムアウトが起こらないことを意味します。トランザクションタイムアウトは起こります。

TPSIGRSTRT

シグナルが実行中のシステムコールを中断したら，中断したシステムコールを再び呼びます。

イベント

記述子cdにイベントが存在して，tprecv()がエラーにならなかった場合は，reventにイベントタイプがリターンされます。dataはイベントのTPEV_SVCSUCC，TPEV_SVCFAIL，TPEV_SENDONLYと一緒に受信できます。tprecv()で有効なイベントは次のとおりです。

TPEV_DISCONIMM

会話のサブオーディネータに受信されるこのイベントは，会話のオリジネータがtpdiscon()を呼び出してコネクションをすぐに切断したか，コネクションをオープンしたままでtpreturn()，tx_commit()，またはtx_rollback()を呼び出したことを表します。また，このイベントは，通信エラーのためにコネクションが切断された場合（例えば，サーバ，マシン，ネットワークがダウンしたとき），オリジネータ，またはサブオーディネータにリターンされます。コネクションの切断はすぐに通知されるので（正常終了ではなく異常終了として），転送中のデータは捨てられます。二つのプログラムが同じトランザクションに参加している場合は，トランザクションはrollback_only状態になります。このコネクションに使われている記述子は，無効になります。

TPEV_SENDONLY

コネクションの他端点のプログラムは，コネクションの制御権を放棄しています。このイベントの受け取り側はデータの送信が許可されていますが，制御権を放棄するまではデータを受信できません。

TPEV_SVCERR

会話のオリジネータに受信されるこのイベントは，会話のサブオーディネータがtpreturn()を呼び出していることを示します。tpreturn()は，サービスが成功してリターンすることを妨げるエラーに遭遇しました。例えば，tpreturn()に間違った引数が渡されていたり，サービスがほかのサブオーディネータのためにコネクションをオープンしている間に，tpreturn()が呼ばれたりした場合です。このイベントの性質のために，アプリケーションで定義されたデータやリターン値は役に立ちません。このコネクションは切断されて，cdは無効になります。このイベントが受け取り側のトランザクションの一部で起こった場合は，トランザクションはrollback_only状態となります。

TPEV_SVCFAIL

会話のオリジネータで受信されるこのイベントは，会話の他端点上のサブオーディネータのサービスがアプリケーションで指定されて，不成功に終了した（つまり，tpreturn()がTPFAILで呼ばれた）ことを示します。tpreturn()が呼ばれたとき，サブオーディネータのサービスがこのコネクションを制御する場合は，サービスは会話のオリジネータへ型付きバッファを渡せます。サービス関数の終了の部分で，サーバはコネクションを切断します。よって，cdは無効になります。このイベントが受け取り側のトランザクションの一部で起こった場合は，トランザクションはrollback_only状態となります。

TPEV_SVCSUCC

会話のオリジネータで受信されるこのイベントは，会話の他端点上のサブオーディネータのサービスがアプリケーションで指定されて，成功して終了した（つまり，tpreturn()がTPSUCCESSで呼ばれた）ことを示します。サービス関数の終了の部分で，サーバはコネクションを切断します。よって，cdは無効になります。このイベントが受け取り側のトランザクションの一部で起こった場合は，コミットまたはロールバックするために，サーバ（もまた，トランザクションモードの場合）によってなされた処理を引き起こしたトランザクションのコミット（受け取り側が（トランザクションを）開始した場合）や，ロールバックのどちらかを実行できます。

エラー

次のような場合，tprecv()はエラーリターンして，次のうちどれか一つの値をtperrnoに設定します。