Delete Publication メッセージ

Delete Publication コマンド・メッセージは、 パブリッシャーまたは別のブローカーからブローカーに送信され、 指定したトピックのすべての保存パブリケーションを削除するように指示します。

このメッセージは、Publication ノードを含むメッセージ・フローの入力キューに送信されます。このキューにメッセージを入れたり、メッセージに指定されたトピックに関してパブリッシュしたりする権限がなければなりません。

入力キューは、元のパブリケーションの送信先と同じキューでなければなりません。

Delete Publication コマンド・メッセージに指定されているトピックの全部ではなく一部だけに対する権限をもつ場合、該当するトピックだけが削除されます。どのトピックが削除されないかは、ブローカー応答メッセージに示されます。

同様に、Publish コマンドに複数のトピックが入っている場合、そのようなトピックの全部ではなく一部だけに一致する Delete Publication コマンドは、 Delete Publication に指定されたトピックのパブリケーションだけを削除します。

ブローカーにコマンド・メッセージを送信する時に必要なメッセージ記述子 (MQMD) パラメーターの詳細については、 ブローカーへのコマンド・メッセージでの MQMD の設定を参照してください。

プロパティー

<Command> (MQPSC_COMMAND)
値は、DeletePub(MQPSC_DELETE_PUBLICATION) です。

このプロパティーは、指定する必要があります。

<Topic> (MQPSC_TOPIC)
値は、削除される保存パブリケーションを持つトピックを含むストリングです。ストリングにワイルドカード文字を含めて、複数のトピックに関するパブリケーションを削除することができます。

このプロパティーは、指定する必要があり、必要な数のトピックに合わせて繰り返すことができます。

<DelOpt> (MQPSC_DELETE_OPTION)
Delete Options プロパティーは、 以下のいずれかの値をとることができます。
Local (MQPSC_LOCAL)  

指定したトピックについてのすべての保存パブリケーションが、 Local オプションを指定してパブリッシュされたかどうかにかかわらず、 ローカル・ブローカー (つまり、このメッセージの送信先のブローカー) で削除されます。

他のブローカーにあるパブリケーションは影響を受けません。

None (MQPSC_NONE)  

すべてのオプションがデフォルト値を取ります。 これは、DelOpt プロパティーを省略するのと同じことです。他のオプションが同時に指定された場合、None は無視されます。

このプロパティーは、Local オプションを指定してパブリッシュされたかどうかにかかわらず、省略された場合のデフォルトでは、指定したトピックに関するすべての保存パブリケーションが、ネットワークのすべてのブローカーで削除されます。

以下に、Delete Publication コマンド・メッセージの NameValueData の例を示します。 これは、ローカル・ブローカーにある Team1 と Team2 との試合の最新のスコアが入った保存パブリケーションを削除するために、 サンプル・アプリケーションによって使用されます。
 <psc>
  <Command>DeletePub</Command>
  <Topic>Sport/Soccer/State/LatestScore/Team1 Team2</Topic>
  <DelOpt>Local</DelOpt>
 </psc>
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
aq06960_