tpunadvertise

名称

サービス名の広告の取り消し

形式

ANSI C ,C++ の形式

#include <xatmi.h>
int   tpunadvertise(char *svcname)

K&R版 Cの形式

#include <xatmi.h>
int   tpunadvertise(svcname)
char    *svcname;

機能

関数tpunadvertise()は,あるサーバにそのサーバで提供する,あるサービスの広告を取り消すことを許可します。この関数を呼び出さない場合,サーバのサービスは,ブート時に広告されて,シャットダウンされたときに広告を取り消されます。

関数tpunadvertise()は,サーバで宣伝していたsvcnameを削除します。svcnameには,NULLやNULL文字列("")は使えません。また,svcnameは15文字以下になるようにしてください。svcnameが15文字よりも長い場合は,15文字に切り詰められます。切り詰められた名称がほかのサービス名と一致しないようにしてください。

『引数』

『●svcname

サービスのサービス名を設定します。』

リターン値

エラー時には,-1をリターンして,tperrnoにエラーの状態を示す値を設定します。

エラー

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

リターン値リターン値(数値)意味
TPEINVAL4引数svcnameがNULLかNULL文字("")が設定されています。
TPENOENT6引数svcnameは,現在このサーバで広告されていません。
TPEOS7オペレーティングシステムにエラーが起こりました。厳密なエラーの性質は,product-specificな方法で定義されます。
TPEPROTO9tpunadvertise()が間違った状況で呼ばれました。
TPESYSTEM12コミュニケーションリソースマネジャシステムでエラーが起こりました。厳密なエラーの性質は,product-specificな方法で定義されます。

関連項目

tpadvertise()

『OpenTP1で使う場合の注意事項』

  1. 『一つのノードで負荷分散している場合(マルチサーバ),tpunadvertise()をどれか一つのプロセスが呼び出すと,負荷分散しているプロセスすべてでサービスを受け付けられなくなります。その後,tpadvertise()で再びサービスを広告すれば,サービス要求を受け付けられるようになります。』
  2. 『複数のノードで負荷分散している場合(ノード間負荷バランス機能およびノード間負荷バランス拡張機能),tpunadvertise()を呼び出したプロセスのノードではサービスを実行しなくなりますが,ほかのノードのサーバでサービスを受け付けられます。その後,tpadvertise()で再びサービスを広告すれば,サービス要求を受け付けられるようになります。』
  3. 『OSI TP通信をするXATMIのエラーは,従来のTCP/IPとエラー動作が異なる場合があります。』