IBM MQ 訂閱內容

您可以為所有類型的訂閱設定內容。 部分內容不適用於所有類型的訂閱,部分內容特定於 z/OS® 訂閱。

下表列出您可以設定的所有內容:

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

「一般」頁面

下表列出您可以在「 訂閱內容 」對話框的 一般 頁面上設定的內容。

內容 意義 MQSC 參數
訂閱名稱 唯讀。 在建立之後,您就不能變更訂閱的名稱。 SUBNAME
主題名稱 訂閱所使用的主題物件名稱。 主題名稱可提供選用的根主題。 最多可接受 48 個字元。 TOPICOBJ
主題字串 該屬性指定訂閱的完整主題名稱,或含有萬用字元的主題集合。

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

TOPICSTR
萬用字元用法 在解譯主題字串所包含的任何萬用字元時,會使用這個架構。 其兩個值如下:

TOPIC:萬用字元代表主題階層的部分。

CHAR:萬用字元代表字串的部分。

WSCHEMA
範圍 範圍決定此訂閱是否轉遞至其他佇列管理程式,讓訂閱者接收其他那些佇列管理程式上發佈的訊息。 其兩個值如下:
全部
訂閱將轉遞給直接透過發佈/訂閱群體或階層連接的所有佇列管理程式。
QMGR
訂閱只轉遞對此佇列管理程式中的主題發佈的訊息。
附註: 個別訂閱者只能限制 SUBSCOPE。 如果在主題層次將該參數設定為 ALL,則個別訂閱者可以針對此訂閱將其限制為 QMGR。 但是,如果在主題層次將該參數設定為 QMGR,則將個別訂閱者設定為 ALL 沒有任何作用。
SUBSCOPE
目的地類別 「目的地」類別會指定訂閱所使用的目的地是否為受管理目的地。 其兩個值如下:

MANAGED:目的地為受管理目的地。

PROVIDED:目的地為佇列。 這是預設值。

DESTCLAS
目的地佇列管理程式 發佈給訂閱之訊息的目的地佇列管理程式。 DESTQMGR
目的地名稱 指定要放置此訂閱訊息的別名、本端、遠端或叢集佇列的名稱。 DEST
相關性 ID 相關性 ID 的值會放到傳送給訂閱的所有訊息的訊息描述子中。 如果未指定任何相關性 ID 參數,則訊息會放到 CorrelId 為 MQCI_NONE 的目的地。

空白值(預設值)會導致使用系統產生的相關性 ID。

如果設為 '000000000000000000000000000000000000000000000000'(48 個零),則發佈應用程式所設定的 CorrelId 將保留在遞送至訂閱的訊息副本中,除非訊息是透過發佈/訂閱階層結構進行傳送。

DESTCORL
附註: 無法以程式化方式使用 JMS來設定 DESTCORL 內容。
可延續 當建立應用程式關閉其訂閱控點時,不會刪除可延續訂閱。 訂閱的可延續參數可以是是的。 當可延續設定為時,當建立的應用程式關閉其訂閱控點時,不會刪除訂閱。 可延續
類型 訂閱的類型指出如何建立訂閱。 訂閱類型如下:

API:透過 MQSUB API 要求建立的訂閱。

ADMIN:透過 DEF SUB MQSCPCF 指令建立的訂閱。 ADMIN 也可用來指出已透過管理指令修改訂閱。

PROXY:在內部建立的訂閱,透過佇列管理程式網路遞送發佈。

嘗試變更時,不會將 PROXY 類型訂閱修改為 ADMIN 類型。

類型不能修改。

SUBTYPE
內容 內容判斷如何將發佈/訂閱相關的訊息內容,加入傳送給訂閱的訊息。 可用的選項如下:

相容性: 在訊息中新增發佈/訂閱內容,以維護與 IBM WebSphere® MQ 6.0 發佈/訂閱的相容性。

訊息內容:將發佈/訂閱內容新增為訊息內容。

:不將發佈/訂閱內容新增至訊息。

RFH2:發佈 / 訂閱內容會新增至 RFH 2 標頭內的訊息中。

PSPROP
使用者資料 您可以選擇是否要將使用者資料的值,當作訊息中的訊息內容傳送給訂閱。 USERDATA
選取元 選取器是一個 SQL92 字串,其會套用到針對指名主題發佈的訊息,以選取其是否可供訂閱。 SELECTOR
選取元類型 已指定的 SelectionString 類型。 系統會計算這個顯示內容,且此內容不會與物件相關聯。 選取器類型將可以過濾(例如,使用 WHERE 子句),讓管理者只顯示內部或只顯示外部選取器。 SELTYPE

「延伸事項」頁面

下表列出您可以在「 訂閱內容 」對話框的 延伸事項 頁面上設定的內容。

內容 意義 MQSC 參數
可變的使用者 ID 指定訂閱建立者以外的使用者是否可以連接訂閱,並取得訂閱的所有權。 其兩個值如下:

ANY:如果其他使用者有正確的主題授權檢查和目的地授權檢查,則可以連接訂閱。 這是預設值。

FIXED:其他使用者不能連接訂閱。

VARUSER
使用者 指定擁有此訂閱的使用者設定檔。 SUBUSER
應用程式身分資料 應用程式身分資料的值將用於傳送給訂閱的訊息。 如果未指定應用程式身分資料,則會使用空的預設值。 PUBAPPID
帳戶記號 帳戶記號的值會用於傳送給訂閱的訊息中。 如果未指定帳戶記號,則會使用預設值 MQACT_NONE。 PUBACCT
發佈優先順序 發佈優先順序判斷如何將發佈/訂閱相關的訊息內容,加入傳送給訂閱的訊息。 可用的選項如下:

如同已發佈表示傳送給此訂閱的訊息優先順序,取自已發佈訊息所提供的優先順序。

如同已定義的佇列表示傳送給此訂閱的訊息優先順序,取自定義為目的地的佇列的預設優先順序。

優先順序值可讓您指定 0 到 9 範圍內的優先順序。

PUBPRTY
訂閱 ID 佇列管理程式會將訂閱 ID 的值,指派為訂閱的長期唯一 ID。 此 ID 可用作 SUBNAME 的替代項,因為 DISPLAYALTERDELETE MQSC 指令的目標因其格式不符合要求而無法提供 SUBNAME,或者未針對應用程式建立的訂閱提供 SUBNAME SUBID
期限 從建立日期和時間起的訂閱保持作用中時間。 期限是以十分之一秒來測量。 其兩個值如下:

無限制表示訂閱永不到期,或使用者可以輸入自己的值(以十分之一秒為測量單位)。 預設值是零。

EXPIRY
僅要求 「僅要求」指出訂閱者是否會透過 MQSUBPRQ API 來輪詢更新項目。 其兩個值如下:

全部表示所有發佈都會遞送給訂閱。 這是預設值。

於要求時表示只有在回應 MQSUBPRQ API 時,才將發佈遞送給訂閱。

REQONLY
訂閱層次 這是與訂閱相關聯的層次。 如果訂閱所屬的訂閱集合所具有的最高 SubLevel 值小於或等於發佈時使用的 PubLevel,則發佈只會遞送至此訂閱。 值必須介於 0 - 9 的範圍內。 零是最低層次。 SUBLEVEL

「統計資料」頁面

下表列出「 訂閱內容 」對話框之 統計資料 頁面上的內容。 統計資料頁面會顯示訂閱歷程的相關資訊。 統計資料頁面顯示的資訊是唯讀的,使用者不能變更。

內容 意義 MQSC 參數
建立日期 唯讀。 這是建立訂閱的日期。 CRDATE
建立時間 唯讀。 這是建立訂閱的時間。 CRTIME
變更日期 唯讀。 這是前次變更訂閱內容的日期。 ALTDATE
變更時間 唯讀。 這是前次變更訂閱內容的時間。 ALTTIME