IBM MQ 訂閱內容

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

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

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

「一般」頁面

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

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

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

TOPICSTR
萬用字元用法 解譯 Topic string 中包含的任何萬用字元時,會使用此架構。 其兩個值如下:

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

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

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

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

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

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

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

如果設為 '000000000000000000000000000000000000000000000000'(48 個零),除非在發佈/訂閱階層中傳送訊息,否則發佈應用程式所設定的 CorrelId 會在遞送至訂閱的訊息副本中維護。

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

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

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

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

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

無法修改 Type

SUBTYPE
內容 Properties 決定如何將發佈/訂閱相關訊息內容新增至傳送至訂閱的訊息。 可用的選項如下:

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

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

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

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

PSPROP
使用者資料 在傳送至訂閱的訊息中,可以選擇性地傳遞 User data 的值作為訊息內容。 USERDATA
選取元 Selector 是 SQL92 字串,套用至在具名主題上發佈的訊息,以選取它們是否符合訂閱資格。 SELECTOR
選取元類型 已指定的 SelectionString 類型。 系統會計算這個顯示內容,且此內容不會與物件相關聯。 選取器類型將可以過濾(例如,使用 WHERE 子句),讓管理者只顯示內部或只顯示外部選取器。 SELTYPE

「延伸事項」頁面

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

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

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

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

VARUSER
使用者 指定擁有此訂閱的使用者設定檔。 SUBUSER
應用程式身分資料 Application identity data 的值將用於傳送至訂閱的訊息。 如果未指定 Application identity data,則會使用空的預設值。 PUBAPPID
帳戶記號 Accounting token 的值將用於傳送至訂閱的訊息。 如果未指定 Accounting token,則會使用預設值 MQACT_NONE。 PUBACCT
發佈優先順序 Publish priority 決定如何將發佈/訂閱相關訊息內容新增至傳送至訂閱的訊息。 可用的選項如下:

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

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

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

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

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

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

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

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

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

「統計資料」頁面

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

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