名前

tpacall()−サービス要求の送信を行うルーチン

形式

#include <atmi.h>
int tpacall(char *svc, char *data, long len, long flags)

機能説明

tpacall() は、svc で指定されているサービスに要求メッセージを送ります。この要求は、以前の tpspri() で変更されていないかぎり、svc に対して定義されている優先順位で送信されます。data は、NULL でなければ、tpalloc() が以前に割り当てたバッファを指していなければなりません。len には送信するバッファに入るデータの量を指定します。ただし、data が長さの指定を必要としないバッファを指している場合 (FML フィールド化バッファなど)、len は無視されます (0 でかまいません)。data が NULL であると、len は無視され、要求はデータ部なしで送信されます。data のタイプとサブタイプは、svc が認識するタイプおよびサブタイプと一致しなければなりません。トランザクション・モードにあるときに送信される要求ごとに、最終的には対応する応答が受信されなければならないことに注意してください。

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

マルチスレッドのアプリケーションの場合、TPINVALIDCONTEXT 状態のスレッドは、tpacall() の呼び出しを発行できません。

戻り値

正常終了の場合、tpacall() は、送信した要求の応答を受信するために使用できる記述子を返します。

異常終了すると、tpacall() は -1 を返し、tperrno を設定してエラー条件を示します。

エラー

異常終了時には、tpacall() は tperrno を次のいずれかの値に設定します(特に記述した場合を除いては、エラーが呼び出し元のトランザクションに影響を及ぼすことはありません)。

関連項目