主題內容
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),則當資訊傳送給另一個佇列管理程式時,可能無法正確轉換。 |
降冪 |
發佈 | 這個內容會控制訊息是否可以發佈至主題。 預設值是作為母項。 其他兩個可用的選項如下: 允許表示訊息可以由獲授權的應用程式發佈至主題。 禁止表示訊息不能發佈至主題。 |
PUB |
訂閱 | 這個內容會控制訊息是否可以訂閱主題。 預設值是作為母項。 其他兩個可用的選項如下: 允許表示可以由獲授權的應用程式進行訂閱該主題。 禁止表示應用程式不能訂閱主題。 |
SUB |
可延續訂閱 | 這個內容會控制主題是否允許進行可延續訂閱。 預設值是作為母項。 其他兩個可用的選項如下: 允許表示可以由應用程式對主題進行可延續訂閱。 禁止表示不能由應用程式對主題進行可延續訂閱。 |
DURSUB |
預設優先順序 | 發佈至主題之訊息的預設優先順序。 預設值是作為母項。 預設優先順序可以設為 0(最低優先順序)到 9(最高優先順序)。 |
DEFPRTY |
預設持續性 | 新主題的預設持續性為作為母項。 選取持續會指定由應用程式使用 MQPER_PERSISTENCE_AS_Q_DEF 所建立的訊息會成為持續的。 選取非持續,指定由應用程式使用 MQPER_PERSISTENCE_AS_Q_DEF 所建立的訊息會變成非持續的。 | DEFPSIST |
模型可延續佇列 | 這個值是由管理者輸入的字串。 其包含用於可延續訂閱之模型佇列的名稱,這些訂閱會要求佇列管理程式管理發佈的目的地。 該名稱最多可接受 48 個字元。 如果這個欄位是空白,則會視為作為母項。 如果您指定叢集主題的模型佇列,則必須確定佇列是在叢集中的各個佇列管理程式中定義,在該叢集中可產生使用此主題的可延續訂閱。 從此模型建立的動態列具有字首 |
MDURMDL |
模型不可延續佇列 | 這個值是由管理者輸入的字串。 其包含用於不可延續訂閱之模型佇列的名稱,會要求佇列管理程式管理發佈的目的地。 該名稱最多可接受 48 個字元。 如果這個欄位是空白,則會視為作為母項。 如果您指定叢集主題的模型佇列,則必須確定佇列是在叢集中的各個佇列管理程式中定義,在該叢集中可以產生使用此主題的不可延續訂閱。 從此模型建立的動態列具有字首 |
MNDURMDL |
QSG 性質 | 主題的佇列共用群組處置方式。 您可以將佇列共用群組處置方式設為下列三個值之一:
|
QSGDISP |
預設放置回應類型 | 訊息放置的預設回應類型。 預設值是作為母項。 其他兩個可用的選項如下: 同步表示回應會同步放置。 非同步表示回應會非同步放置。 |
DEFPRESP |
非持續訊息遞送 | 發佈至這個主題之非持續訊息的遞送方法。 4 個選項如下: 作為母項 使用的遞送機制是根據在與這個主題相關的主題樹狀結構中,找到的第一個母項管理節點的設定而定。 這是 IBM MQ 隨附的預設值,但您的安裝可能已變更它。 至所有可用的訂閱者 非持續訊息會遞送給可接受訊息的所有訂閱者。 如果無法遞送訊息給任一訂閱者,並不會使其他訂閱者無法接收訊息。 至所有可延續的訂閱者 非持續訊息必須遞送給所有可延續的訂閱者。 如果無法遞送非持續訊息給任一不可延續的訂閱者,並不會傳回錯誤給 MQPUT 呼叫。 如果可延續訂閱者的遞送失敗,則其他訂閱者皆無法接收訊息,且 MQPUT 呼叫會失敗。 至所有訂閱者 非持續訊息必須遞送給所有訂閱者,不管 MQPUT 呼叫的延續性是否回報成功。 如果任何訂閱者的遞送失敗,則其他訂閱者皆無法接收訊息,且 MQPUT 呼叫會失敗。 |
NPMSGDLV |
持續性訊息遞送 | 發佈至這個主題之持續訊息的遞送方法。 其四個選項如下: 作為母項 使用的遞送機制是根據在與這個主題相關的主題樹狀結構中,找到的第一個母項管理節點的設定而定。 這是 IBM MQ 隨附的預設值,但您的安裝可能已變更它。 至所有可用的訂閱者 持續訊息會遞送給可接受訊息的所有訂閱者。 如果無法遞送訊息給任一訂閱者,並不會使其他訂閱者無法接收訊息。 至所有可延續的訂閱者 持續訊息必須遞送給所有可延續的訂閱者。 如果無法遞送持續訊息給任一不可延續的訂閱者,並不會傳回錯誤給 MQPUT 呼叫。 如果可延續訂閱者的遞送失敗,則其他訂閱者皆無法接收訊息,且 MQPUT 呼叫會失敗。 至所有訂閱者 持續訊息必須遞送給所有訂閱者,不管 MQPUT 呼叫的延續性是否回報成功。 如果任何訂閱者的遞送失敗,則其他訂閱者皆無法接收訊息,且 MQPUT 呼叫會失敗。 |
PMSGDLV |
萬用字元作業 | 這個值會控制與主題相關之萬用字元訂閱的行為。 2 個值如下: 區塊。 如果訂閱的萬用字元主題不如這個主題物件的主題字串明確,則訂閱不會接收針對這個主題或是比這個主題更明確的主題字串所發佈的資訊。 透通。 如果訂閱的萬用字元主題不如這個主題物件的主題字串明確,則訂閱會接收針對這個主題或是比這個主題更明確的主題字串所發佈的資訊。 這是預設值。 |
WILDCARD |
使用無法傳送郵件的佇列 | 指定在無法將發佈訊息遞送至其正確的訂閱者佇列時,是否使用無法傳送郵件的佇列。 有三個可能的值: | USEDLQ |
自訂 | 包含 Custom 參數僅供 IBM 使用,在引進個別內容之前保留用於新特性的配置。 可能的值是使用 MQSC 樣式語法,並以至少一個個空格分隔的零個以上內容/值配對清單。 內容名稱及值區分大小寫,且必須以大寫來指定。 這些值可包含空格、括弧以及單引號(必須使用另一個單引號跳出)。 如果要併入其他字元,包括巢狀括弧 (),則可以將其含括在兩個單引號中(每側各一個)。 有效的語法範例如下:
佇列管理程式會剖析該值,但如果無法根據這些規則來剖析字串,或是字串包含無法辨識的內容或值,佇列管理程式將會忽略這些錯誤。 |
CUSTOM |
![]() |
從這個物件繼承內容的訊息發佈到主題之前的時間上限 (以十分之一秒為單位) 會保留在系統中,直到它變成適合到期處理程序為止。 如需訊息到期處理的相關資訊,請參閱 強制縮短有效期限。
|
CAPEXPRY |
分散式發佈/訂閱
下表列出 IBM MQ 主題內容對話框中的分散式發佈/訂閱頁面上的內容。內容 | 意義 | MQSC 參數 |
---|---|---|
Proxy 訂閱行為 | Proxy 訂閱與建立它們的佇列管理程式名稱相關聯。 如果含有發佈主題的 Proxy 訂閱存在,則發佈只會傳送給直接連接的佇列管理程式。 這個值的兩個選項如下: 強制。 這會強制將與此主題物件相關聯之主題字串的萬用字元 Proxy 訂閱,不論是否已進行任何本端訂閱,都會從叢集中的每一個佇列管理程式,傳送至發佈/訂閱拓蹼中其他的每個佇列管理程式。 在將此強制的 Proxy 訂閱延伸到整個拓蹼之後,任何新的訂都閱會立即收到來自其他連接之佇列管理程式的所有發佈,不會出現任何延遲;不過不論訂閱是否有要求,所有發佈都會延伸到叢集中的所有其他佇列管理程式。 在主題樹狀結構中的給定層次設定此值,亦可防止為主題樹狀結構中後續層次的個別主題字串產生 Proxy 訂閱,進而減少 Proxy 訂閱的額外負荷。 初次使用。 對於此主題物件中或其下面的每個唯一主題字串,在下列範例情節中,皆會以非同步方式將 Proxy 訂閱傳送至所有鄰接的佇列管理程式:
|
PROXYSUB |
發佈範圍 | 您可以使用 PUBSCOPE 主題屬性,於管理上控制發佈的範圍。 屬性可設為下列三個值的其中之一:
|
PUBSCOPE |
訂閱範圍 | 您可以使用 SUBSCOPE 主題屬性,於管理上控制訂閱的範圍。 屬性可設為下列三個值的其中之一:
|
SUBSCOPE |
多重播送 | 此內容控制此主題是否被視為可以使用多重播送進行傳輸。 有四個可能的值: 作為母項。 主題的多重播送內容繼承自母項。 已停用。 此節點不容許任何多重播送流量。 已啟用。 此節點容許多重播送流量。 僅限。 只容許來自具有多重播送功能用戶端的訂閱。 |
MCAST |
通訊資訊 | 通訊資訊物件名稱。 因為樹狀結構中有多個主題需要相同的多重播送傳輸內容,請考慮在可以參照的個別物件中使用這些內容。 | COMMINFO |
叢集
下表列出 IBM MQ 主題內容對話框中的叢集頁面上的內容。內容 | 意義 | MQSC 參數 |
---|---|---|
叢集名稱 | 若要使主題成為叢集主題,請配置此內容。 這樣做時,在主題樹狀結構中該點或以下,發佈者或訂閱者所使用的任何主題,皆會在叢集中的所有佇列管理程式之間共用,而發佈至主題樹狀結構叢集分支的訊息,會自動遞送至叢集中其他佇列管理程式上的訂閱。 | CLUSTER |
叢集物件狀態 | 此叢集中,此主題物件的現行狀態。 值如下:
|
CLSTATE |
叢集遞送 | 用於 CLUSTER 參數所定義之叢集的主題遞送行為。 有兩個可能的值:
|
CLROUTE |
統計資料
下表列出 IBM MQ 主題內容對話框中的統計資料頁面上的內容。內容 | 意義 | MQSC 參數 |
---|---|---|
變更日期 | 這個值不能變更,它僅供參考用。 這是前次變更主題內容的日期。 |
ALTDATE |
變更時間 | 這個值不能變更,它僅供參考用。 這是前次變更主題內容的時間。 |
ALTTIME |