TPUNADVERTISE

名称

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

形式

01 SERVICE-NAME PIC X(15).
01 TPSTATUS-REC.
  COPY TPSTATUS.

CALL "TPUNADVERTISE" USING SERVICE-NAME TPSTATUS-REC.

機能

TPUNADVERTISEは,あるサーバにそのサーバで提供する,あるサービスの広告を取り消すことを許可します。省略時には,サーバのサービスは,ブート時に広告されて,シャットダウンされたときに広告を取り消されます。

TPUNADVERTISEは,サーバで宣伝していたSERVICE-NAMEを削除します。SERVICE-NAMEには,SPACES(空白)は使えません。また,SERVICE-NAMEは15文字以下になるようにしてください。15文字よりも長い場合は,15文字に切り詰められます。切り詰められた名称が ほかのサービス名と一致しないようにしてください。

『データ領域』

『●SERVICE-NAME

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

『●TPSTATUS-REC

TPUNADVERTISEの実行結果を示すリターン値が設定されます。』

リターン値

成功した場合,TPUNADVERTISEはTP-STATUSにTPOKを設定します。

エラー

次のような場合,TPUNADVERTISEはエラーリターンして,次のうちどれか一つの値をTP-STATUSに設定します。

TPEINVAL
SERVICE-NAMEにSPACES(空白)を設定しています。
TPENOENT
SERVICE-NAMEは,現在このサーバで広告されていません。
TPEPROTO
TPUNADVERTISEが間違った状況で呼ばれました。
TPESYSTEM
コミュニケーションリソースマネジャシステムでエラーが起こりました。厳密なエラーの性質は,product-specificな方法で定義されます。
TPEOS
オペレーティングシステムにエラーが起こりました。厳密なエラーの性質は,product-specificな方法で定義されます。

関連項目

TPADVERTISE

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

  1. 『一つのノードで負荷分散している場合(マルチサーバ),TPUNADVERTISEをどれか一つのプロセスが実行すると,負荷分散しているプロセスすべてでサービスを受け付けられなくなります。その後,TPADVERTISEで再びサービスを広告すれば,サービス要求を受け付けられるようになります。』
  2. 『複数のノードで負荷分散している場合(ノード間負荷バランス機能およびノード間負荷バランス拡張機能),TPUNADVERTISEを実行したプロセスのノードではサービスを実行しなくなりますが,ほかのノードのサーバでサービスを受け付けることができます。その後,TPADVERTISEで再びサービスを広告すれば,サービス要求を受け付けられるようになります。』