tpsend

ANSI C，C++の形式

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

K&R版 Cの形式

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

『●cd

記述子を設定します。』

『●data

送信するデータが格納されたバッファへのポインタを設定します。』

『●len

バッファの長さを設定します。』

『●flags

フラグを示します。』

『●revent

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

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

TPRECVONLY

このフラグは，呼び出し側のデータが送信されたあと，呼び出し側は，コネクションの制御を放棄することを意味します（つまり，呼び出し側は，これ以上tpsend()を呼び出せません）。コネクションの他端点である受信側が，tpsend()から送信されてきたこのデータを受信したとき，コネクションの制御を示すイベント（TPEV_SENDONLY）も受信します（これ以上，tprecv()の呼び出しができません）。

TPNOBLOCK

ブロッキング状態の場合（例えば，送信されたメッセージで内部バッファが満杯），データやイベントは送信されません。TPNOBLOCKが設定されていないで，ブロッキング状態のときは，呼び出し側は状況が収まるか，タイムアウト（トランザクション，またはブロッキングタイムアウト）が起こるまで，ブロッキングしています。

TPNOTIME

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

TPSIGRSTRT

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

イベント

記述子cdにイベントが存在した場合は，tpsend()は，呼び出し側のデータを送信しないで失敗します。reventにイベントタイプがリターンされます。tpsend()で有効なイベントは次のとおりです。

TPEV_DISCONIMM

会話のサブオーディネータに受信されるこのイベントは，会話のオリジネータがtpdiscon()を使ってコネクションをすぐに切断したか，コネクションをオープンしたままでtpreturn()，tx_commit()，またはtx_rollback()を呼び出したことを表します。また，このイベントは，通信エラーのためにコネクションが切断された場合（例えば，サーバ，マシン，ネットワークがダウンしたとき），オリジネータ，またはサブオーディネータにリターンされます。

TPEV_SVCERR

会話のオリジネータに受信されるこのイベントは，会話のサブオーディネータが通信の制御権がない状態でtpreturn()を発行していることを表します。tpreturn()は，次に説明するTPEV_SVCFAILとは異なった方法で使われます。

TPEV_SVCFAIL

会話のオリジネータで受信されるこのイベントは，会話の他端点上のサブオーディネータが通信の制御権がない状態でtpreturn()を呼び出したことを示します。さらに，tpreturn()はTPFAILとdataなしで呼び出されました（つまり，rvalはTPFAILを設定されて，dataにはNULLが入っています）。

これらのイベントは，コネクションがすぐに切断されたことを示します（正常終了ではなく異常終了として）。そのため，送信中のデータは失われます。このコネクションに使われている記述子は，無効になります。二つのプログラムが，同じトランザクションにある場合は，そのトランザクションはrollback_only状態になります。

エラー

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