IBM MQ サブスクリプション・プロパティー
すべてのタイプのサブスクリプションにプロパティーを設定することができます。 一部のプロパティは、すべてのタイプのサブスクリプションに適用されるわけではありません。 いくつかのプロパティは、z/OS® サブスクリプションに固有です。
下の表には、設定できるすべてのプロパティーがリストされています。
それぞれのプロパティーについて、その構成時に必要となる簡単な説明を記載しています。 また、表には、DEFINE、ALTER、および DISPLAY SUB コマンド用の同等の MQSC パラメーターも記載してあります。 MQSC コマンドについて詳しくは、「 IBM Documentation」の「 MQSC コマンドを使用した IBM® MQ の管理 」を参照してください。
「一般」ページ
下の表には、 「サブスクリプション・プロパティー」 ダイアログの 「一般」 ページで設定するプロパティーがリストされています。
Property | 意味 | MQSC パラメーター |
---|---|---|
サブスクリプション名 | 読み取り専用。 作成後にはサブスクリプションの名前を変更できません。 | SUBNAME |
トピック名 | サブスクリプションで使用するトピックの名前。 トピック名でトピック・ルートを指定するかどうかは任意です。 最大で 48 文字を使用できます。 | TOPICOBJ |
トピック・ストリング | サブスクリプションの完全修飾トピック名またはワイルドカード・トピック・セットを指定します。 このストリングで使用するスラッシュ (/) 文字には特別な意味があります。 これは、トピック・ツリー内の要素を区切るために使用されます。 トピック・ストリングの先頭を (/) 文字にすることはできますが、そうする必要はありません。 (/) 文字で始まるストリングと、(/) 文字で始まっていないストリングは、同じではありません。 |
TOPICSTR |
ワイルドカード使用法 | このスキームは、Topic string に含まれるワイルドカード文字を解釈するときに使用されます。 以下の 2 つの値があります。 「TOPIC」: ワイルドカード文字は、トピック階層の一部に相当します。 「CHAR」: ワイルドカード文字は、ストリングの一部に相当します。 |
WSCHEMA |
範囲 | この有効範囲は、このサブスクリプションを他のキュー・マネージャーに転送するかどうかを指定します。転送すると、サブスクライバーがそれらの他のキュー・マネージャーでパブリッシュされたメッセージも受信できるようになります。 以下の 2 つの値があります。
注: 個々のサブスクライバーが制限できるのは、 SUBSCOPEのみです。 このパラメーターがトピック・レベルで ALL に設定された場合、個々のサブスクライバーはこのサブスクリプションについて QMGR に制限できます。 一方、このパラメーターがトピック・レベルで QMGR に設定された場合、個々のサブスクライバーを ALL に設定しても効果はありません。
|
SUBSCOPE |
宛先クラス | 「宛先クラス」では、サブスクリプションで使用する宛先を管理対象の宛先にするかどうかを指定します。 以下の 2 つの値があります。 「MANAGED」: 宛先は管理対象です。 「PROVIDED」: 宛先はキューです。 これがデフォルト値です。 |
DESTCLAS |
宛先キュー・マネージャー | サブスクリプションに対してパブリッシュするメッセージの宛先キュー・マネージャー。 | DESTQMGR |
宛先名 | このサブスクリプションのメッセージが書き込まれる別名、ローカル、リモート、またはクラスター・キューの名前を指定します。 | DEST |
相関 ID | Correlation identifier の値が、サブスクリプションに送信されるすべてのメッセージのメッセージ記述子に組み込まれます。 Correlation
identifier パラメーターが指定されていない場合、メッセージは CorrelId MQCI_NONE の宛先に配置されます。 ブランクの値 (デフォルト) を指定すると、システムが生成した相関 ID が使用されます。 パブリッシュ側アプリケーションによって「 |
DESTCORL 注: JMSを使用してプログラマチックに DESTCORL プロパティーを設定することはできません。
|
永続 | 永続サブスクリプションは、作成元のアプリケーションがサブスクリプション・ハンドルを閉じても削除されません。 サブスクリプションの Durable パラメーターは、Yes または No のいずれかにすることができます。 Durable が Yes に設定されている場合、作成元のアプリケーションがサブスクリプション・ハンドルを閉じても、サブスクリプションは削除されません。 | DURABLE |
タイプ | サブスクリプションの Type では、サブスクリプションが作成された方法を確認できます。 サブスクリプションのタイプを以下にまとめます。 API: MQSUB API 要求によって作成されたサブスクリプション。 ADMIN: DEF SUB MQSC または PCF コマンドによって作成されたサブスクリプション。 サブスクリプションが管理コマンドで変更された場合も、「ADMIN」になります。 「PROXY」: キュー・マネージャー・ネットワークでパブリケーションをやり取りするために内部で作成されたサブスクリプション。 変更時に、PROXY タイプのサブスクリプションを ADMIN に変更することはできません。 Type は変更できません。 |
SUBTYPE |
プロパティー | Properties は、サブスクリプションに送信されるメッセージに pub/sub 関連メッセージ・プロパティーが追加される仕組みを決定します。 使用可能なオプションは、次のとおりです。 互換性: IBM WebSphere® MQ 6.0 パブリッシュ/サブスクライブとの互換性を維持するために、パブリッシュ/サブスクライブ・プロパティーがメッセージに追加されます。 メッセージ・プロパティー: パブリッシュ/サブスクライブ・プロパティーをメッセージ・プロパティーとして追加します。 なし: パブリッシュ/サブスクライブ・プロパティーをメッセージに追加しません。 RFH2: パブリッシュ/サブスクライブをメッセージの RFH 2 ヘッダー内に追加します。 |
PSPROP |
ユーザー・データ | オプションで、サブスクリプションに送信されるメッセージにおいて User data の値をメッセージ・プロパティーとして渡すことができます。 | USERDATA |
セレクター | Selector は、名前付きトピックにパブリッシュされるメッセージに適用される SQL92 ストリングであり、そのストリングに基づいて、そのメッセージがサブスクリプションにとって適格であるかどうかが選択されます。 | セレクター |
セレクター・タイプ | 指定されている SelectionString のタイプ。 この表示プロパティーは計算され、オブジェクトには関連付けられません。 セレクター・タイプを (例えば、WHERE 節を使用して) フィルターに掛けることができ、これにより、管理者は内部のセレクターのみ、または外部のセレクターのみの表示が可能になります。 | SELTYPE |
「拡張」ページ
下の表には、 「サブスクリプション・プロパティー」 ダイアログの 「拡張」 ページで設定するプロパティーがリストされています。
Property | 意味 | MQSC パラメーター |
---|---|---|
可変ユーザー ID | サブスクリプションの作成者以外のユーザーがサブスクリプションに接続して、サブスクリプションの所有権を取得できるようにするかどうかを指定します。 以下の 2 つの値があります。 「ANY」: 他のユーザーもサブスクリプションに接続できます。ただし、そのユーザーが正しいトピック権限検査と宛先権限検査を受けていることが条件です。 これがデフォルト値です。 「FIXED」: 他のユーザーはサブスクリプションに接続できません。 |
VARUSER |
ユーザー | このサブスクリプションを所有するユーザー・プロファイルを指定します。 | SUBUSER |
アプリケーション識別データ | Application identity data の値は、サブスクリプションに送信されるメッセージに使用されます。 Application identity data が指定されない場合は、空のデフォルト値が使用されます。 | PUBAPPID |
アカウンティング・トークン | Accounting token の値は、サブスクリプションに送信されるメッセージに使用されます。 Accounting token が指定されない場合は、デフォルト値 MQACT_NONE が使用されます。 | PUBACCT |
パブリッシュ優先順位 | Publish priority は、サブスクリプションに送信されるメッセージに pub/sub 関連メッセージ・プロパティーが追加される仕組みを決定します。 有効なオプションは以下のとおりです。 パブリケーションの値を継承: これは、このサブスクリプションにメッセージの優先順位が送信され、パブリッシュされたメッセージ中に指定された優先順位から取得されることを意味します。 キュー定義に従う: これは、このサブスクリプションにメッセージの優先順位が送信され、宛先として定義されたキューのデフォルト優先順位から取得されることを意味します。 優先順位の値: ユーザーが優先順位を 0 から 9 の範囲で指定できます。 |
PUBPRTY |
サブスクリプション ID | Subscription ID の値は、このサブスクリプションの常時固有 ID としてキュー・マネージャーによって割り当てられています。 この ID は、MQSC コマンド DISPLAY、ALTER、DELETE のターゲットとして、形式上の理由から SUBNAME を指定できない場合や、サブスクリプションを作成したアプリケーションで SUBNAME が指定されていない場合に、SUBNAME の代わりとして使用できます。 | SUBID |
Expiry | サブスクリプションの作成日時からの存続時間。 Expiry は 1/10 秒単位で測定されます。 以下の 2 つの値があります。 無制限: これは、サブスクリプションの有効期限が絶対に満了しないこと、またはユーザーが独自の値を (1/10 秒単位で) 入力できることを意味します。 デフォルト値はゼロです。 |
EXPIRY |
要求のみ | リクエストは、サブスクライバがMQSUBPRQ
APIによって更新をポーリングするかどうかだけを示します。 以下の 2 つの値があります。 「すべて」を指定すると、すべてのパブリケーションがサブスクリプションに送信されることになります。 これはデフォルト値です。 要求時は、出版物がMQSUBPRQ APIに応答してのみ購読に配信されることを意味します。 |
REQONLY |
サブスクリプション・レベル | これはサブスクリプションに関連付けられているレベルです。 パブリケーションがこのサブスクリプションに配布されるのは、SubLevel の最高値がパブリケーション時に使用される PubLevel 値以下のサブスクリプション・セット中にこのサブスクリプションが含まれている場合のみです。 値は 0 から 9 の範囲でなければなりません。 ゼロが最低レベルです。 | SUBLEVEL |
「統計」ページ
下の表には、 「サブスクリプション・プロパティー」 ダイアログの 「統計」 ページで設定するプロパティーがリストされています。 「統計」ページは、サブスクリプションのヒストリーについての情報を表示します。 「統計」ページに表示される情報は読み取り専用で、ユーザーが変更することはできません。
Property | 意味 | MQSC パラメーター |
---|---|---|
作成日 | 読み取り専用。 これは、サブスクリプションが作成された日付です。 | CRDATE |
作成時刻 | 読み取り専用。 これは、サブスクリプションが作成された時刻です。 | CRTIME |
変更日付 | 読み取り専用。 このプロパティーは、サブスクリプションのプロパティーが最後に変更された日付です。 | ALTDATE |
変更時刻 | 読み取り専用。 このプロパティーは、サブスクリプションのプロパティーが最後に変更された時刻です。 | ALTTIME |