任意通知型メッセージの送信

BEA Tuxedo システムでは、要求/応答型呼び出しまたは会話型通信の処理を妨げずに、クライアント・プロセスに任意通知型メッセージを送信できます。

tpbroadcast() 関数の呼び出しには、次の文法を使用します。

int
tpbroadcast(char *lmid, char *usrname, char *cltname, char *data, long len, long flags)

次の表は、tpbroadcast() 関数の引数を示しています。

tpbroadcast( ) 関数の引数

引数	説明
lmid	クライアントの論理マシン識別子を指すポインタ。NULL 値をワイルドカードとして使用できるので、複数のクライアントにメッセージを送信できます。
usrname	クライアント・プロセスのユーザ名が存在する場合、そのユーザ名を指すポインタ。NULL 値をワイルドカードとして使用できるので、複数のクライアントにメッセージを送信できます。
cltname	クライアント・プロセスのクライアント名が存在する場合、そのクライアント名を指すポインタ。NULL 値をワイルドカードとして使用できるので、複数のクライアントにメッセージを送信できます。
data	メッセージの内容を指すポインタ。
len	メッセージ・バッファのサイズ。data が自己記述型のバッファ・タイプ (FML など) を指す場合、len に 0 を設定できます。
flags	フラグのオプション。使用できるフラグについては、『BEA Tuxedo C リファレンス』の tpbroadcast(3c) を参照してください。

tpbroadcast( ) の使用

char *strbuf;
 
 if ((strbuf = tpalloc("STRING", NULL, 0)) == NULL) {
          error routine
          }
 
 (void) strcpy(strbuf, "hello, world");
 
 if (tpbroadcast(NULL, NULL, NULL, strbuf, 0, TPSIGRSTRT) == -1)
              error routine

識別子によるメッセージのブロードキャスト

tpnotify() 関数の呼び出しには、次の文法を使用します。

int
tpnotify(CLIENTID *clientid, char *data, long len, long flags)

次の表は、tpnotify() 関数の引数を示しています。

tpnotify( ) 関数の引数

引数	説明
clientid	CLIENTID 構造体を指すポインタ。この構造体は、このサービスへの要求を持つ TPSVCINFO 構造体から取得されたものです。
data	メッセージの内容を指すポインタ。
len	メッセージ・バッファのサイズ。data が自己記述型のバッファ・タイプ (FML など) を指す場合、len に 0 を設定できます。
flags	フラグのオプション。使用できるフラグについては、『BEA Tuxedo C リファレンス』の tpnotify(3c) を参照してください。