IBM MQ 訂閱內容

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

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

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

「一般」頁面

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

內容 意義 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