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 |
範圍 | 範圍決定此訂閱是否轉遞至其他佇列管理程式,讓訂閱者接收其他那些佇列管理程式上發佈的訊息。 其兩個值如下:
附註: 個別訂閱者只能限制 SUBSCOPE。 如果在主題層次將該參數設定為 ALL,則個別訂閱者可以針對此訂閱將其限制為 QMGR。 但是,如果在主題層次將該參數設定為 QMGR,則將個別訂閱者設定為 ALL 沒有任何作用。
|
SUBSCOPE |
目的地類別 | 「目的地」類別會指定訂閱所使用的目的地是否為受管理目的地。 其兩個值如下: MANAGED:目的地為受管理目的地。 PROVIDED:目的地為佇列。 這是預設值。 |
DESTCLAS |
目的地佇列管理程式 | 發佈給訂閱之訊息的目的地佇列管理程式。 | DESTQMGR |
目的地名稱 | 指定要放置此訂閱訊息的別名、本端、遠端或叢集佇列的名稱。 | DEST |
相關性 ID | Correlation identifier 的值將放入傳送至訂閱之所有訊息的訊息描述子中。 如果未指定 Correlation
identifier 參數,則會將訊息放置在 CorrelId 為 MQCI_NONE 的目的地上。 空白值(預設值)會導致使用系統產生的相關性 ID。 如果設為 ' |
DESTCORL 附註: 無法以程式化方式使用 JMS來設定 DESTCORL 內容。
|
可延續 | 當建立應用程式關閉其訂閱控點時,不會刪除可延續訂閱。 訂閱的 Durable 參數可以是 Yes 或 No。 當 Durable 設為 Yes 時,當建立應用程式關閉其訂閱控點時,不會刪除訂閱。 | 可延續 |
類型 | 訂閱的 Type 指出如何建立訂閱。 訂閱類型如下: API: 透過 MQSUB API 要求建立的訂閱。 ADMIN: 透過 DEF SUB MQSC 或 PCF 指令建立訂閱。 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 的替代項,因為 DISPLAY、ALTER 和 DELETE MQSC 指令的目標因其格式不符合要求而無法提供 SUBNAME,或者未針對應用程式建立的訂閱提供 SUBNAME。 | SUBID |
期限 | 從建立日期和時間起的訂閱保持作用中時間。 Expiry 以十分之一秒為測量單位。 其兩個值如下: 無限制表示訂閱永不到期,或使用者可以輸入自己的值(以十分之一秒為測量單位)。 預設值是零。 |
EXPIRY |
僅要求 | 「僅要求」指出訂閱者是否會透過 MQSUBPRQ API 來輪詢更新項目。 其兩個值如下: 全部表示所有發佈都會遞送給訂閱。 這是預設值。 於要求時表示只有在回應 MQSUBPRQ API 時,才將發佈遞送給訂閱。 |
REQONLY |
訂閱層次 | 這是與訂閱相關聯的層次。 如果訂閱所屬的訂閱集合所具有的最高 SubLevel 值小於或等於發佈時使用的 PubLevel,則發佈只會遞送至此訂閱。 值必須介於 0 - 9 的範圍內。 零是最低層次。 | SUBLEVEL |
「統計資料」頁面
下表列出「 訂閱內容 」對話框之 統計資料 頁面上的內容。 統計資料頁面會顯示訂閱歷程的相關資訊。 統計資料頁面顯示的資訊是唯讀的,使用者不能變更。
內容 | 意義 | MQSC 參數 |
---|---|---|
建立日期 | 唯讀。 這是建立訂閱的日期。 | CRDATE |
建立時間 | 唯讀。 這是建立訂閱的時間。 | CRTIME |
變更日期 | 唯讀。 這是前次變更訂閱內容的日期。 | ALTDATE |
變更時間 | 唯讀。 這是前次變更訂閱內容的時間。 | ALTTIME |