トピック・プロパティー

IBM® MQ トピックは、パブリケーションの内容を識別する IBM MQ オブジェクトです。 トピックにプロパティーを設定することができます。 一部のトピック属性は、z/OS® トピックに固有のものです。 さらに、トピックの作成中にのみ変更可能なプロパティーもいくつかあります。 IBM MQ トピックの作成後にこれらのプロパティーを変更することはできません。

以下の表に、 IBM MQ トピックのすべてのプロパティーをリストします。

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

一般

下表に、「IBM MQ トピック・プロパティー」ダイアログの「一般」ページで設定するプロパティーを示します。
プロパティー 意味 MQSC パラメーター
トピック名 トピックの作成後に、この値を変更することはできません。 このパラメーターは必須であり、空ストリングを組み込むことはできません。

作成する管理トピック定義の固有 ID。 最大で 48 文字を使用できます。

「トピック名」を、選択したキュー・マネージャーで定義されている他のトピック定義と同じ名前にすることはできません。

TOPNAME
トピック・タイプ この値は読み取り専用です。 この値は、トピックがローカル (Local) またはクラスター (Cluster) のいずれであるかを定義します。 なし
トピック・ストリング トピックの作成後に、この値を変更することはできません。 このパラメーターは必須であり、空ストリングを組み込むことはできません。

このストリング内の (/) 文字には特別な意味があります。 これは、トピック・ツリー内の要素を区切るために使用されます。 トピック・ストリングの先頭は「/」文字にできますが、必須ではありません。 「/」文字で始まるストリングは、「/」文字なしで始まるストリングとは異なります。

「トピック・ストリング」を、他のトピック・オブジェクト定義で既に記述されている他のトピック・ストリングと同じ内容にすることはできません。 トピック・ストリングの最大長は 10 240 文字です。

TOPICSTR
説明 この値は、管理者が入力するストリングです。 内容は、トピックに関する説明情報です。 表示可能文字だけを含めることができます。 最大で 64 文字です。

選択したキュー・マネージャーのコード化文字セット ID (CCSID) に含まれていない文字を使用すると、別のキュー・マネージャーに情報が送信されたときに、それらの文字が誤変換される可能性があります。

DESC
パブリッシュ このプロパティーでは、メッセージをトピックにパブリッシュできるかどうかを制御します。 デフォルト値は「親と同じ」です。 その他の 2 つの有効なオプションは以下のとおりです。

「許可」を指定すると、許可アプリケーションがメッセージをトピックにパブリッシュできるようになります。

「禁止」を指定すると、メッセージをトピックにパブリッシュできなくなります。

PUB
サブスクライブ このプロパティーでは、トピックに対するメッセージをサブスクライブできるかどうかを制御します。 デフォルト値は「親と同じ」です。 その他の 2 つの有効なオプションは以下のとおりです。

「許可」を指定すると、許可アプリケーションがトピックに対してサブスクリプションを作成できるようになります。

「禁止」を指定すると、アプリケーションはトピックにサブスクライブできなくなります。

SUB
永続サブスクリプション このプロパティーでは、トピックに対する永続サブスクリプションを許可するかどうかを制御します。 デフォルト値は「親と同じ」です。 その他の 2 つの有効なオプションは以下のとおりです。

「許可」を指定すると、アプリケーションはトピックに対する永続サブスクリプションを作成できるようになります。

「禁止」を指定すると、アプリケーションはトピックに対する永続サブスクリプションを作成できなくなります。

DURSUB
デフォルト優先順位 トピックにパブリッシュされるメッセージのデフォルトの優先順位。 デフォルト値は「親と同じ」です。

デフォルトの優先順位は、0 (最低の優先順位) から 9 (最高の優先順位) の範囲で設定できます。

DEFPRTY
デフォルト持続性 新しいトピックのデフォルトの持続性は「親として」です。 MQPER_PERSISTENCE_AS_Q_DEF を使用するアプリケーションによって作成されたメッセージを持続メッセージにすることを指定する場合は、「持続」を選択します。 MQPER_PERSISTENCE_AS_Q_DEF を使用するアプリケーションによって作成されたメッセージを非持続メッセージにすることを指定する場合は、「持続しない」を選択します。 DEFPSIST
モデル永続キュー

この値は、管理者が入力するストリングです。 内容は、キュー・マネージャーがパブリケーションの宛先を管理するように要求する永続サブスクリプションで使用するモデル・キューの名前です。

この名前には最大で 48 文字を使用できます。

このフィールドがブランクであれば、「親として」の処理になります。

クラスター・トピックのモデル・キューを指定する場合は、このトピックを使用する永続サブスクリプションを作成できるクラスター内のすべてのキュー・マネージャーでキューが定義されていることを確認する必要があります。

このモデルから作成される動的キューには、SYSTEM.MANAGED.DURABLE という接頭部が付きます。

MDURMDL
モデル非永続キュー この値は、管理者が入力するストリングです。 内容は、キュー・マネージャーがパブリケーションの宛先を管理するように要求する非永続サブスクリプションで使用するモデル・キューの名前です。

この名前には最大で 48 文字を使用できます。

このフィールドがブランクであれば、「親として」の処理になります。

クラスター・トピックのモデル・キューを指定する場合は、このトピックを使用する非永続サブスクリプションを作成できるクラスター内のすべてのキュー・マネージャーでキューが定義されていることを確認する必要があります。

このモデルから作成される動的キューには、SYSTEM.MANAGED.NDURABLE という接頭部が付きます。

MNDURMDL
QSG 処理 トピックのキュー共用グループ処理。 次の 3 つの値のいずれかにキュー共用グループ処理を設定することができます。
  • 「キュー・マネージャー」は、オブジェクト定義が、それをホストするキュー・マネージャーでのみ使用可能であることを意味します。
  • 「グループ」は、オブジェクト定義が共用リポジトリーに保管され、キュー共用グループ内の 各キュー・マネージャーに定義のコピーがあることを示しています。
  • 「コピー」は、オブジェクト定義が、共用リポジトリー内の定義のキュー・マネージャーのコピーであることを意味します。
このフィールドは、トピックのプロパティーを表示しているときに、読み取り専用として表示されます。
QSGDISP
デフォルト書き込み応答タイプ メッセージ配置のデフォルトの応答タイプ。 デフォルト値は「親と同じ」です。 その他の 2 つの有効なオプションは以下のとおりです。

「同期」を指定すると、応答は同期モードで配置されます。

「非同期」を指定すると、応答は非同期モードで配置されます。

DEFPRESP
非持続メッセージ送達

このトピックにパブリッシュする非永続メッセージの送達方式。 以下の 4 つのオプションがあります。

「親として」: 使用される送達機構は、このトピックに関連したトピック・ツリーに含まれている最初の親管理ノードの設定に基づきます。 これは IBM MQで提供されるデフォルトですが、ご使用のシステムで変更されている可能性があります。

「すべての有効なサブスクライバーへ」: 非持続メッセージは、そのメッセージを受け入れられるすべてのサブスクライバーに送達されます。 サブスクライバーへのメッセージ配信が失敗しても、他のサブスクライバーはメッセージを受け取ります。

「すべての永続サブスクライバーへ」: 非持続メッセージをすべての永続サブスクライバーへ送達する必要があります。 非永続サブスクライバーへの非永続メッセージの配信が失敗しても、MQPUT 呼び出しにエラーは返されません。 ただし、永続サブスクライバーに送達できなかった場合は、他のサブスクライバーがメッセージを受信できなくなり、MQPUT 呼び出しは失敗します。

「すべてのサブスクライバーへ」: 成功を報告する MQPUT 呼び出しの永続性にかかわりなく、非持続メッセージをすべてのサブスクライバーに送達する必要があります。 サブスクライバーへの配信が失敗した場合、他のサブスクライバーがメッセージを受け取ることはなく、MQPUT 呼び出しは失敗します。

NPMSGDLV
持続メッセージ送達

このトピックにパブリッシュする永続メッセージの送達方式。 以下の 4 つのオプションがあります。

「親として」: 使用される送達機構は、このトピックに関連したトピック・ツリーに含まれている最初の親管理ノードの設定に基づきます。 これは IBM MQで提供されるデフォルトですが、ご使用のシステムで変更されている可能性があります。

「すべての有効なサブスクライバーへ」: 持続メッセージは、そのメッセージを受け入れられるすべてのサブスクライバーに送達されます。 サブスクライバーへのメッセージ配信が失敗しても、他のサブスクライバーはメッセージを受け取ります。

「すべての永続サブスクライバーへ」: 持続メッセージをすべての永続サブスクライバーへ送達する必要があります。 非永続サブスクライバーへの永続メッセージの配信に失敗しても、MQPUT 呼び出しにエラーは返されません。 ただし、永続サブスクライバーに送達できなかった場合は、他のサブスクライバーがメッセージを受信できなくなり、MQPUT 呼び出しは失敗します。

「すべてのサブスクライバーへ」: 成功を報告する MQPUT 呼び出しの永続性にかかわりなく、持続メッセージをすべてのサブスクライバーに送達する必要があります。 サブスクライバーへの配信が失敗した場合、他のサブスクライバーがメッセージを受け取ることはなく、MQPUT 呼び出しは失敗します。

PMSGDLV
ワイルドカード操作 この値では、トピックに関するワイルドカード・サブスクリプションの動作を制御します。 以下の 2 つの値があります。

ブロック。 このトピック・オブジェクトのトピック・ストリングよりも具体的でないワイルドカード・トピックに対するサブスクリプションは、このトピックまたはこのトピックよりも具体的なトピック・ストリングに対するパブリケーションを受信できなくなります。

パススルー。 このトピック・オブジェクトのトピック・ストリングよりも具体的でないワイルドカード・トピックに対するサブスクリプションは、そのトピックまたはそのトピックよりも具体的なトピック・ストリングに対するパブリケーションを受信できるようになります。 これはデフォルト値です。

WILDCARD
送達不能キューを使用 パブリケーション・メッセージを適切なサブスクライバー・キューに配信できない場合に、送達不能キューを使用するかどうかを指定します。 指定可能な値は以下の 3 つです。
  • 「いいえ」 は、 「非持続メッセージ送達」 および 「持続メッセージ送達」の設定に従って、正しいサブスクライバー・キューに送達できないパブリケーション・メッセージがメッセージの書き込み失敗として扱われ、トピックへのアプリケーションの MQPUT が失敗することを意味します。
  • 「はい」 は、キュー・マネージャーの 「送達不能キュー」 プロパティーに送達不能キューの名前が指定されている場合に、そのキューが使用されることを意味します。 そうでない場合は、「いいえ」と同じ動作になります。
  • 「親として」は、送達不能キューを使用するかどうかは、トピック・ツリー内で直近の親管理トピック・オブジェクトの設定に基づいて決定されることを意味します。 これは IBM MQ で提供されるデフォルトですが、ご使用のシステムで変更されている可能性があります。
USEDLQ
カスタム Custom パラメーターは IBM 専用に組み込まれており、個別のプロパティーが導入される前の新機能の構成用に予約されています。 可能な値は、ゼロ以上のプロパティーと値のペアのリストです。このリストは、MQSC スタイルの構文に従い、プロパティーと値のペアは 1 つ以上のスペースで区切られます。
プロパティー名と値は大/小文字が区別され、大文字で指定する必要があります。 値には、スペース、括弧、および単一引用符を含めることができます (別の単一引用符でエスケープする必要があります)。 ネストされた括弧 () を含む他の文字は、いずれかの側でそれらを 2 つの単一引用符で囲むことにより含めることができます。 有効な構文の例は次のとおりです。
  • CUSTOM('')
  • CUSTOM('A(B)')
  • CUSTOM('C(D) E(F)')
  • CUSTOM('G(5000) H(''9.20.4.6(1415)'')')

キュー・マネージャーは値を構文解析しますが、上記のルールに従ってストリングを構文解析できない場合や、認識できないプロパティーまたは値がストリングに含まれている場合には、キュー・マネージャーはエラーを無視します。

CUSTOM
[MQ 9.3.1 2022 年 10 月]Cap 有効期限 このオブジェクトからプロパティーを継承するトピックにパブリッシュされたメッセージが有効期限処理の対象となるまでシステムに存続する最大時間 (10 分の 1 秒単位で表現)。
メッセージの有効期限処理について詳しくは、 有効期限を強制的に短くするを参照してください。
整数
1 から 999 999 999 までの範囲の値でなければなりません。
NOLIMIT
このトピックに書き込まれたメッセージの有効期限時刻には制限がありません。
ASPARENT
最大メッセージ有効期限時刻は、トピック・ツリー内で最も近い親管理トピック・オブジェクトの設定に基づきます。 これはデフォルト値です。
CAPEXPRY

分散パブリッシュ/サブスクライブ

下表に、「IBM MQ トピック・プロパティー」ダイアログの「分散パブリッシュ/サブスクライブ」ページで設定するプロパティーを示します。
プロパティー 意味 MQSC パラメーター
プロキシー・サブスクリプション動作 プロキシー・サブスクリプションは、作成元のキュー・マネージャー名に関連付けられています。 パブリケーション・トピックが含まれているプロキシー・サブスクリプションが存在すると、パブリケーションは、直接接続のキュー・マネージャーだけに転送されます。 この値には以下の 2 つのオプションがあります。

強制。 このトピック・オブジェクトに関連したトピック・ストリングに対するワイルドカード・プロキシー・サブスクリプションは、ローカル・サブスクリプションが作成されているかどうかにかかわりなく、クラスターのすべてのキュー・マネージャーからパブリッシュ/サブスクライブ・トポロジーのその他のすべてのキュー・マネージャーに強制的に送信されます。 サブスクリプションが要求したかどうかにかかわりなく、すべてのパブリケーションはクラスター内のその他のすべてのキュー・マネージャーに伝搬されますが、この強制プロキシー・サブスクリプションがトポロジー内に伝搬されていると、新しいサブスクリプションは、他の接続先のキュー・マネージャーからあらゆるパブリケーションをただちに (待ち時間なしで) 受け取るようになります。

トピック・ツリー内の特定のレベルでこの値を設定すると、トピック・ツリー内のそれに続くレベルの個々のトピック・ストリングに対してプロキシー・サブスクリプションが生成されなくなります。これにより、プロキシー・サブスクリプションのオーバーヘッドが削減されます。

「最初の使用」。 このトピック・オブジェクトまたはその下位にある固有トピック・ストリングごとに、下記のシナリオのプロキシー・サブスクリプションがすべての近隣キュー・マネージャーに非同期で送信されます。
  • ローカル・サブスクリプションが作成される場合。
  • 直接接続されたキュー・マネージャーにさらに伝搬する必要のあるプロキシー・サブスクリプションを受信した場合。
PROXYSUB
パブリケーション有効範囲
パブリケーションの有効範囲は、PUBSCOPE トピック属性を使用して、管理上の制御を行うことができます。 属性は以下の 3 つの値のいずれかに設定できます。
  • 「親として」。 これはデフォルト値です。 パブリケーション有効範囲は、親キュー・マネージャーと同じ値に設定されます。
  • キュー・マネージャー。 パブリケーションはローカル・サブスクライバーだけに配信されます。
  • All パブリケーションはローカル・サブスクライバーに配信され、直接接続されたキュー・マネージャーを介してリモート・サブスクライバーにも配信されます。
PUBSCOPE
サブスクリプション有効範囲
サブスクリプションの有効範囲は、SUBSCOPE トピック属性を使用して、管理上の制御を行うことができます。 属性は以下の 3 つの値のいずれかに設定できます。
  • 「親として」。 これはデフォルト値です。 サブスクリプション有効範囲は、親キュー・マネージャーと同じ値に設定されます。
  • キュー・マネージャー。 サブスクリプションはローカル・パブリケーションのみを受け取り、プロキシー・サブスクリプションはリモート・キュー・マネージャーに伝搬されません。
  • All プロキシー・サブスクリプションはリモート・キュー・マネージャーに伝搬され、サブスクライバーはローカル・パブリケーションとリモート・パブリケーションを受け取ります。
SUBSCOPE
マルチキャスト このプロパティーは、トピックがマルチキャストを使用して送信可能と見なされるかどうかを制御します。 指定可能な値は以下の 4 つです。

「親として」。 トピックのマルチキャスト・プロパティーは、親から継承されます。

使用不可。 このノードでは、マルチキャスト・トラフィックは許可されません。

使用可能。 このノードでは、マルチキャスト・トラフィックは許可されます。

「のみ」。 マルチキャスト可能なクライアントからのサブスクリプションのみが許可されます。

MCAST
コミュニケーション情報 通信情報オブジェクト名。 同一のマルチキャスト伝送プロパティーを必要とする複数のトピックがツリー内に存在するため、それらのプロパティーを、参照可能な個別のオブジェクトに含めることを検討してください。 COMMINFO

クラスター

下表に、「IBM MQ トピック・プロパティー」ダイアログの「クラスター」ページで設定するプロパティーを示します。
プロパティー 意味 MQSC パラメーター
クラスター名 トピックをクラスター・トピックにするには、このプロパティーを構成します。 この構成を行うと、そのポイントまたはトピック・ツリーでパブリッシャーまたはサブスクライバーにより使用されたすべてのトピックが、クラスター内のすべてのキュー・マネージャーで共有されます。また、トピック・ツリーのクラスター・ブランチにパブリッシュされたメッセージが、そのクラスター内の他のキュー・マネージャー上のサブスクリプションに自動的に経路指定されます。 CLUSTER
クラスター・オブジェクト状態
このクラスターにおけるこのトピック・オブジェクトの現在の状態。 可能な値は次のとおりです。
ACTIVE
クラスター・トピックは、このキュー・マネージャーにより正しく構成され、準拠されています。
保留中
ホスト・キュー・マネージャーにのみ表示されるこの状態は、トピックが作成されたが、フル・リポジトリーによってまだクラスターに伝搬されていない場合に報告されます。 これは、ホスト・キュー・マネージャーがフル・リポジトリーに接続されていないか、またはフル・リポジトリーでトピックが無効と判断されたことが原因である可能性があります。
無効
このクラスター・トピック定義は、クラスターの以前の定義と矛盾しているため、現在アクティブではありません。
エラー
このトピック・オブジェクトに関してエラーが発生しました。
このパラメーターは通常、同じクラスター・トピックについて異なるキュー・マネージャーで複数の定義が作成され、それらの定義が同一ではない場合の診断を補助するために使用されます。
CLSTATE
クラスター・ルート
CLUSTER パラメーターで定義されたクラスター内のトピックに使用する経路指定の動作。 指定可能な値は以下の 2 つです。
DIRECT
直接経路指定されたクラスター・トピックをキュー・マネージャーで構成すると、クラスター内のすべてのキュー・マネージャーがクラスター内の他のすべてのキュー・マネージャーを認識するようになります。 パブリッシュおよびサブスクライブ操作の実行時に、各キュー・マネージャーは直接他のすべてのキュー・マネージャーに接続します。
TOPICHOST
トピック・ホスト経路指定を使用すると、クラスター内のすべてのキュー・マネージャーは、経路指定されたトピック定義をホストするクラスター・キュー・マネージャーを認識するようになります。 パブリッシュ操作およびサブスクライブ操作を行うとき、クラスター内のキュー・マネージャーは、それらのトピック・ホスト・キュー・マネージャーにのみ接続し、相互に直接接続されることはありません。 トピック・ホスト・キュー・マネージャーは、パブリケーションがパブリッシュされるキュー・マネージャーから、一致するサブスクリプションがあるキュー・マネージャーへのパブリケーションの経路指定を担当します。
CLROUTE

統計

下表に、「IBM MQ トピック・プロパティー」ダイアログの「統計」ページで設定するプロパティーを示します。
プロパティー 意味 MQSC パラメーター
変更日 この値は変更できません。通知専用です。

トピックのプロパティーが最後に変更された日付です。

ALTDATE
変更時刻 この値は変更できません。通知専用です。

トピックのプロパティーが最後に変更された時刻です。

ALTTIME