IBM MQ 訂閱內容

您可以對所有類型的訂閱設定屬性。某些屬性不適用於所有類型的訂閱,某些屬性專屬於 z/OS® 訂閱。

下表列出您可以設定的所有屬性:

每一個屬性都有關於您何時可能需要配置該屬性的簡要說明。這些表格也提供了同等的 MQSC 參數。如需 MQSC 指令的相關資訊,請參閱 IBM® MQ 線上產品說明文件中的 Script (MQSC) 指令

「一般」頁面

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

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

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

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

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

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

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

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

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

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

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

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

DESTCORL
可延續 當建立應用程式關閉其訂閱控點時,不會刪除可延續訂閱。訂閱的可延續參數 可以為。當可延續設定為 時,則在建立的應用程式關閉其訂閱控點時,就不會刪除訂閱。 可延續
類型 訂閱的類型指出如何建立訂閱。訂閱類型如下:

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

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

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

[V9.0.2 Mar 2017][V9.0.0.1 May 2017]嘗試變更時,不會將 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 的替代方案,當因為格式問題而無法提供 SUBNAME,或在應用程式建立的訂閱中未提供任何 SUBNAME 時,可用作 DISPLAYALTERDELETE MQSC 指令的目標。 SUBID
期限 從建立日期和時間起的訂閱保持作用中時間。期限是以十分之一秒來測量。其兩個值如下:

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

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

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

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

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

「統計資料」頁面

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

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

參考 參考

反饋

「時間戳記」圖示 前次更新時間: Wednesday, 14 February 2018
http://www.ibm.com/support/knowledgecenter/SSFKSJ_9.0.0/com.ibm.mq.explorer.doc/com.ibm.mq.explorer.doc/e_properties_subs.htm