IBM MQ サブスクリプション・プロパティー

すべてのタイプのサブスクリプションにプロパティーを設定することができます。 一部のプロパティーはすべてのタイプのサブスクリプションに適用されるわけではなく、一部のプロパティーは z/OS® サブスクリプションに固有のものです。

下の表には、設定できるすべてのプロパティーがリストされています。

それぞれのプロパティーについて、その構成時に必要となる簡単な説明を記載しています。 また、表には、DEFINE、ALTER、および DISPLAY SUB コマンド用の同等の MQSC パラメーターも記載してあります。 MQSC コマンドについて詳しくは、 MQSC コマンドを使用した管理を参照してください。

「一般」ページ

下の表には、 「サブスクリプション・プロパティー」 ダイアログの 「一般」 ページで設定するプロパティーがリストされています。

プロパティー 意味 MQSC パラメーター
サブスクリプション名 読み取り専用。 作成後にはサブスクリプションの名前を変更できません。 SUBNAME
トピック名 サブスクリプションで使用するトピックの名前。 トピック名でトピック・ルートを指定するかどうかは任意です。 最大で 48 文字を使用できます。 TOPICOBJ
トピック・ストリング サブスクリプションの完全修飾トピック名またはワイルドカード・トピック・セットを指定します。

このストリングで使用するスラッシュ (/) 文字には特別な意味があります。 これは、トピック・ツリー内の要素を区切るために使用されます。 トピック・ストリングの先頭を (/) 文字にすることはできますが、そうする必要はありません。 (/) 文字で始まるストリングと、(/) 文字で始まっていないストリングは、同じではありません。

TOPICSTR
ワイルドカード使用法 このスキームは、Topic string に含まれるワイルドカード文字を解釈するときに使用されます。 以下の 2 つの値があります。

「TOPIC」: ワイルドカード文字は、トピック階層の一部に相当します。

「CHAR」: ワイルドカード文字は、ストリングの一部に相当します。

WSCHEMA
有効範囲 (Scope) この有効範囲は、このサブスクリプションを他のキュー・マネージャーに転送するかどうかを指定します。転送すると、サブスクライバーがそれらの他のキュー・マネージャーでパブリッシュされたメッセージも受信できるようになります。 以下の 2 つの値があります。
ALL
パブリッシュ/サブスクライブの集合または階層で直接接続されているすべてのキュー・マネージャーにサブスクリプションを転送します。
QMGR
サブスクリプションは、このキュー・マネージャー内でトピックにパブリッシュされたメッセージのみを転送します。
注: 個々のサブスクライバーが制限できるのは、 SUBSCOPEのみです。 このパラメーターがトピック・レベルで ALL に設定された場合、個々のサブスクライバーはこのサブスクリプションについて QMGR に制限できます。 一方、このパラメーターがトピック・レベルで QMGR に設定された場合、個々のサブスクライバーを ALL に設定しても効果はありません。
SUBSCOPE
宛先クラス 「宛先クラス」では、サブスクリプションで使用する宛先を管理対象の宛先にするかどうかを指定します。 以下の 2 つの値があります。

「MANAGED」: 宛先は管理対象です。

「PROVIDED」: 宛先はキューです。 これはデフォルト値です。

DESTCLAS
宛先キュー・マネージャー サブスクリプションに対してパブリッシュするメッセージの宛先キュー・マネージャー。 DESTQMGR
宛先名 このサブスクリプションのメッセージが書き込まれる別名、ローカル、リモート、またはクラスター・キューの名前を指定します。 DEST
相関 ID Correlation identifier の値が、サブスクリプションに送信されるすべてのメッセージのメッセージ記述子に組み込まれます。 Correlation identifier パラメーターが指定されていない場合、メッセージは CorrelId MQCI_NONE の宛先に配置されます。

ブランクの値 (デフォルト) を指定すると、システムが生成した相関 ID が使用されます。

'000000000000000000000000000000000000000000000000' (48 個のゼロ) に設定すると、メッセージがパブリッシュ/サブスクライブ階層で伝搬されない限り、パブリッシュしているアプリケーションが設定した CorrelId が、サブスクリプションに配信されるメッセージのコピーに維持されます。

DESTCORL
注: JMSを使用してプログラマチックに DESTCORL プロパティーを設定することはできません。
永続 永続サブスクリプションは、作成元のアプリケーションがサブスクリプション・ハンドルを閉じても削除されません。 サブスクリプションの Durable パラメーターは、Yes または No のいずれかにすることができます。 DurableYes に設定されている場合、作成元のアプリケーションがサブスクリプション・ハンドルを閉じても、サブスクリプションは削除されません。 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 ストリングであり、そのストリングに基づいて、そのメッセージがサブスクリプションにとって適格であるかどうかが選択されます。 selector
セレクター・タイプ 指定されている SelectionString のタイプ。 この表示プロパティーは計算され、オブジェクトには関連付けられません。 セレクター・タイプを (例えば、WHERE 節を使用して) フィルターに掛けることができ、これにより、管理者は内部のセレクターのみ、または外部のセレクターのみの表示が可能になります。 SELTYPE

「拡張」ページ

下の表には、 「サブスクリプション・プロパティー」 ダイアログの 「拡張」 ページで設定するプロパティーがリストされています。

プロパティー 意味 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 コマンド DISPLAYALTERDELETE のターゲットとして、形式上の理由から SUBNAME を指定できない場合や、サブスクリプションを作成したアプリケーションで SUBNAME が指定されていない場合に、SUBNAME の代わりとして使用できます。 SUBID
Expiry サブスクリプションの作成日時からの存続時間。 Expiry は 1/10 秒単位で測定されます。 以下の 2 つの値があります。

無制限: これは、サブスクリプションの有効期限が絶対に満了しないこと、またはユーザーが独自の値を (1/10 秒単位で) 入力できることを意味します。 デフォルト値はゼロです。

EXPIRY
要求のみ 「要求のみ」では、サブスクライバーが MQSUBPRQ API によって更新をポーリングするのかどうかを指定します。 以下の 2 つの値があります。

「すべて」を指定すると、すべてのパブリケーションがサブスクリプションに送信されることになります。 これはデフォルト値です。

「要求時」を指定すると、MQSUBPRQ API への応答としてのみ、パブリケーションがサブスクリプションに送信されることになります。

REQONLY
サブスクリプション・レベル これはサブスクリプションに関連付けられているレベルです。 パブリケーションがこのサブスクリプションに配布されるのは、SubLevel の最高値がパブリケーション時に使用される PubLevel 値以下のサブスクリプション・セット中にこのサブスクリプションが含まれている場合のみです。 値は 0 から 9 の範囲でなければなりません。 ゼロが最低レベルです。 SUBLEVEL

「統計」ページ

下の表には、 「サブスクリプション・プロパティー」 ダイアログの 「統計」 ページで設定するプロパティーがリストされています。 「統計」ページは、サブスクリプションのヒストリーについての情報を表示します。 「統計」ページに表示される情報は読み取り専用で、ユーザーが変更することはできません。

プロパティー 意味 MQSC パラメーター
作成日 読み取り専用。 これは、サブスクリプションが作成された日付です。 CRDATE
作成時刻 読み取り専用。 これは、サブスクリプションが作成された時刻です。 CRTIME
変更日付 読み取り専用。 このプロパティーは、サブスクリプションのプロパティーが最後に変更された日付です。 ALTDATE
変更時刻 読み取り専用。 このプロパティーは、サブスクリプションのプロパティーが最後に変更された時刻です。 ALTTIME