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

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に設定します。

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

tpadvertise()

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