主題內容

IBM® MQ 主題是一個 IBM MQ 物件,可識別發佈資訊的相關內容。 您可以為主題設定內容。 部分主題內容特定於 z/OS® 主題。 此外,還有些內容只能在您建立主題時變更。 在建立 IBM MQ 主題之後,您無法修改這些內容。

下表列出 IBM MQ 主題的所有內容。

每一項內容都有一個簡要說明,來說明您何時需要配置該內容。 這些表格也提供了 DEFINE、ALTER 及 DISPLAY TOPIC 指令的對等 MQSC 參數。 如需 MQSC 指令的相關資訊,請參閱 IBM Documentation中的 使用 MQSC 指令管理

一般

下表列出 IBM MQ 主題內容 對話框的 一般 頁面上的內容。
內容 意義 MQSC 參數
主題名稱 建立主題後,就不能變更這個值。 這個參數是必要的,且不能包含空字串。

這是要建立之管理主題定義的唯一 ID。 最多可接受 48 個字元。

主題名稱不能與選定佇列管理程式中定義的任何其他主題定義相同。

TOPNAME
主題類型 這個值是唯讀的。 此值定義主題是本端;Local,還是叢集中;Cluster N/A
主題字串 建立主題後,就不能變更這個值。 這個參數是必要的,且不能包含空字串。

此字串內的 (/) 字元具有特殊意義。 它用來區隔主題樹狀結構中的元素。 主題字串的開頭可以是 (/) 字元,但不是必要的。 以 (/) 字元開頭的字串,與不是以 (/) 字元開頭的字串並不相同。

主題字串不能與已由另一個主題物件定義所代表的任何其他主題字串相同。 主題字串的長度上限為 10 240 個字元。

TOPICSTR
說明 這個值是由管理者輸入的字串。 它包含主題的說明性資訊。 其只能包含可顯示的字元。 最多可為 64 個字元。

如果使用的字元不屬於選定佇列管理程式的編碼字集 ID (CCSID),則當資訊傳送給另一個佇列管理程式時,可能無法正確轉換。

DESC
發佈 這個內容會控制訊息是否可以發佈至主題。 預設值是作為母項。 其他兩個可用的選項如下:

允許表示訊息可以由獲授權的應用程式發佈至主題。

禁止表示訊息不能發佈至主題。

PUB
訂閱 這個內容會控制訊息是否可以訂閱主題。 預設值是作為母項。 其他兩個可用的選項如下:

允許表示可以由獲授權的應用程式進行訂閱該主題。

禁止表示應用程式不能訂閱主題。

SUB
可延續訂閱 這個內容會控制主題是否允許進行可延續訂閱。 預設值是作為母項。 其他兩個可用的選項如下:

允許表示可以由應用程式對主題進行可延續訂閱。

禁止表示不能由應用程式對主題進行可延續訂閱。

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 性質 主題的佇列共用群組處置方式。 您可以將佇列共用群組處置方式設為下列三個值之一:
  • 佇列管理程式表示物件定義只能用於管理它的佇列管理程式。
  • 群組表示物件定義會儲存在共用儲存庫中,且佇列共用群組中的每一個佇列管理程式都有一份定義副本。
  • 副本表示物件定義是佇列管理程式在共用儲存庫中的定義副本。
當您顯示主題的內容時,此欄位會以唯讀形式顯示。
QSGDISP
預設放置回應類型 訊息放置的預設回應類型。 預設值是作為母項。 其他兩個可用的選項如下:

同步表示回應會同步放置。

非同步表示回應會非同步放置。

DEFPRESP
非持續訊息遞送

發佈至這個主題之非持續訊息的遞送方法。 4 個選項如下:

作為母項 使用的遞送機制是根據在與這個主題相關的主題樹狀結構中,找到的第一個母項管理節點的設定而定。 這是 IBM MQ隨附的預設值,但您的安裝可能已變更它。

至所有可用的訂閱者 非持續訊息會遞送給可接受訊息的所有訂閱者。 如果無法遞送訊息給任一訂閱者,並不會使其他訂閱者無法接收訊息。

至所有可延續的訂閱者 非持續訊息必須遞送給所有可延續的訂閱者。 如果無法遞送非持續訊息給任一不可延續的訂閱者,並不會傳回錯誤給 MQPUT 呼叫。 如果可延續訂閱者的遞送失敗,則其他訂閱者皆無法接收訊息,且 MQPUT 呼叫會失敗。

至所有訂閱者 非持續訊息必須遞送給所有訂閱者,不管 MQPUT 呼叫的延續性是否回報成功。 如果任何訂閱者的遞送失敗,則其他訂閱者皆無法接收訊息,且 MQPUT 呼叫會失敗。

NPMSGDLV
持續性訊息遞送

發佈至這個主題之持續訊息的遞送方法。 其四個選項如下:

作為母項 使用的遞送機制是根據在與這個主題相關的主題樹狀結構中,找到的第一個母項管理節點的設定而定。 這是 IBM MQ隨附的預設值,但您的安裝可能已變更它。

至所有可用的訂閱者 持續訊息會遞送給可接受訊息的所有訂閱者。 如果無法遞送訊息給任一訂閱者,並不會使其他訂閱者無法接收訊息。

至所有可延續的訂閱者 持續訊息必須遞送給所有可延續的訂閱者。 如果無法遞送持續訊息給任一不可延續的訂閱者,並不會傳回錯誤給 MQPUT 呼叫。 如果可延續訂閱者的遞送失敗,則其他訂閱者皆無法接收訊息,且 MQPUT 呼叫會失敗。

至所有訂閱者 持續訊息必須遞送給所有訂閱者,不管 MQPUT 呼叫的延續性是否回報成功。 如果任何訂閱者的遞送失敗,則其他訂閱者皆無法接收訊息,且 MQPUT 呼叫會失敗。

PMSGDLV
萬用字元作業 這個值會控制與主題相關之萬用字元訂閱的行為。 2 個值如下:

區塊。 如果訂閱的萬用字元主題不如這個主題物件的主題字串明確,則訂閱不會接收針對這個主題或是比這個主題更明確的主題字串所發佈的資訊。

透通。 如果訂閱的萬用字元主題不如這個主題物件的主題字串明確,則訂閱會接收針對這個主題或是比這個主題更明確的主題字串所發佈的資訊。 這是預設值。

WILDCARD
使用無法傳送郵件的佇列 指定在無法將發佈訊息遞送至其正確的訂閱者佇列時,是否使用無法傳送郵件的佇列。 有三個可能的值:
  • 表示將無法遞送至其正確訂閱者佇列的發佈訊息視為無法放置訊息,且根據 非持續訊息遞送持續訊息遞送的設定,應用程式對主題的 MQPUT 失敗。
  • 表示如果佇列管理程式 無法傳送郵件的佇列 內容提供「無法傳送郵件的佇列」名稱,則會使用該佇列。 否則,其行為會與相同。
  • 作為母項表示根據主題樹狀結構中最近的管理主題物件設定,來決定是否使用「無法傳送郵件的佇列」。 這是 IBM MQ 隨附的預設值,但您的安裝可能已變更它。
USEDLQ
自訂 自訂 參數僅適用於 IBM 使用,保留用於在引進個別內容之前配置新特性。 可能的值是使用 MQSC 樣式語法,並以至少一個個空格分隔的零個以上內容/值配對清單。
內容名稱及值區分大小寫,且必須以大寫來指定。 這些值可包含空格、括弧以及單引號(必須使用另一個單引號跳出)。 如果要併入其他字元,包括巢狀括弧 (),則可以將其含括在兩個單引號中(每側各一個)。 有效的語法範例如下:
  • CUSTOM('')
  • CUSTOM('A(B)')
  • CUSTOM('C(D) E(F)')
  • CUSTOM('G(5000) H(''9.20.4.6(1415)'')')

佇列管理程式會剖析該值,但如果無法根據這些規則來剖析字串,或是字串包含無法辨識的內容或值,佇列管理程式將會忽略這些錯誤。

CUSTOM

分散式發佈/訂閱

下表列出 IBM MQ 主題內容 對話框的 分散式發佈/訂閱 頁面上的內容。
內容 意義 MQSC 參數
Proxy 訂閱行為 Proxy 訂閱與建立它們的佇列管理程式名稱相關聯。 如果含有發佈主題的 Proxy 訂閱存在,則發佈只會傳送給直接連接的佇列管理程式。 這個值的兩個選項如下:

強制。 這會強制將與此主題物件相關聯之主題字串的萬用字元 Proxy 訂閱,不論是否已進行任何本端訂閱,都會從叢集中的每一個佇列管理程式,傳送至發佈/訂閱拓蹼中其他的每個佇列管理程式。 在將此強制的 Proxy 訂閱延伸到整個拓蹼之後,任何新的訂都閱會立即收到來自其他連接之佇列管理程式的所有發佈,不會出現任何延遲;不過不論訂閱是否有要求,所有發佈都會延伸到叢集中的所有其他佇列管理程式。

在主題樹狀結構中的給定層次設定此值,亦可防止為主題樹狀結構中後續層次的個別主題字串產生 Proxy 訂閱,進而減少 Proxy 訂閱的額外負荷。

初次使用。 對於此主題物件中或其下面的每個唯一主題字串,在下列範例情節中,皆會以非同步方式將 Proxy 訂閱傳送至所有鄰接的佇列管理程式:
  • 建立本端訂閱時。
  • 收到必須傳送至進一步直接連接的佇列管理程式的 Proxy 訂閱時。
PROXYSUB
發佈範圍
您可以使用 PUBSCOPE 主題屬性,於管理上控制發佈的範圍。 屬性可設為下列三個值的其中之一:
  • 作為母項。 這是預設值。 發佈範圍會設為與母項佇列管理程式相同的值。
  • 佇列管理程式。 發佈只會遞送給本端訂閱者。
  • 全部。 發佈會透過直接連接的佇列管理程式,遞送給本端訂閱者和遠端訂閱者。
PUBSCOPE
訂閱範圍
您可以使用 SUBSCOPE 主題屬性,於管理上控制訂閱的範圍。 屬性可設為下列三個值的其中之一:
  • 作為母項。 這是預設值。 訂閱範圍會設為與母項佇列管理程式相同的值。
  • 佇列管理程式。 訂閱只會接收本端發佈,而 Proxy 訂閱不會延伸到遠端佇列管理程式。
  • 全部。 Proxy 訂閱會延伸到遠端佇列管理程式,且訂閱者會接收本端及遠端發佈。
SUBSCOPE
多重播送 此內容控制此主題是否被視為可以使用多重播送進行傳輸。 有四個可能的值:

作為母項。 主題的多重播送內容繼承自母項。

已停用。 此節點不容許任何多重播送流量。

已啟用。 此節點容許多重播送流量。

僅限。 只容許來自具有多重播送功能用戶端的訂閱。

MCAST
通訊資訊 通訊資訊物件名稱。 因為樹狀結構中有多個主題需要相同的多重播送傳輸內容,請考慮在可以參照的個別物件中使用這些內容。 COMMINFO

叢集

下表列出 IBM MQ 主題內容 對話框之 叢集 頁面上的內容。
內容 意義 MQSC 參數
叢集名稱 若要使主題成為叢集主題,請配置此內容。 這樣做時,在主題樹狀結構中該點或以下,發佈者或訂閱者所使用的任何主題,皆會在叢集中的所有佇列管理程式之間共用,而發佈至主題樹狀結構叢集分支的訊息,會自動遞送至叢集中其他佇列管理程式上的訂閱。 CLUSTER
叢集物件狀態
此叢集中,此主題物件的現行狀態。 值如下:
ACTIVE
叢集主題已正確地配置,且正由此佇列管理程式繼承。
擱置中
只有管理的佇列管理程式會看到,此狀態的報告時機是在已建立主題,但完整儲存庫尚未將它傳播到叢集時。 這可能是因為主機佇列管理程式未連接到完整儲存庫,或是因為完整儲存庫已認為主題無效。
無效的
這個叢集主題定義與叢集中的較早定義衝突,因此目前不在作用中。
錯誤
發生關於此主題物件的錯誤。
此參數通常用來在不同佇列管理程式上定義了相同叢集主題的多個定義,且這些定義不相同時輔助診斷。
CLSTATE
叢集遞送
用於 CLUSTER 參數所定義之叢集的主題遞送行為。 有兩個可能的值:
直接
當您在佇列管理程式上配置直接遞送的叢集主題時,叢集裡的所有佇列管理程式便可察覺叢集裡的所有其他佇列管理程式。 執行發佈和訂閱作業時,每一個佇列管理程式便可彼此直接連接。
主題主機
當您使用主題主機遞送時,叢集裡的所有佇列管理程式便可察覺管理遞送之主題定義的叢集佇列管理程式。 執行發佈和訂閱作業時,叢集中的佇列管理程式只會連接到這些主題主機佇列管理程式,而不會彼此直接連接。 主題主機佇列管理程式會負責從發佈的佇列管理程式將發佈遞送到具有相符訂閱的佇列管理程式。
CLROUTE

統計資料

下表列出 IBM MQ 主題內容 對話框的 統計資料 頁面上的內容。
內容 意義 MQSC 參數
變更日期 這個值不能變更,它僅供參考用。

這是前次變更主題內容的日期。

ALTDATE
變更時間 這個值不能變更,它僅供參考用。

這是前次變更主題內容的時間。

ALTTIME