IBM MQ 訂閱內容
您可以對所有類型的訂閱設定屬性。某些屬性不適用於所有類型的訂閱,某些屬性專屬於 z/OS® 訂閱。
下表列出您可以設定的所有屬性:
每一個屬性都有關於您何時可能需要配置該屬性的簡要說明。這些表格也提供了同等的 MQSC 參數。如需 MQSC 指令的相關資訊,請參閱 IBM® MQ 線上產品說明文件中的 Script (MQSC) 指令。
「一般」頁面
下表列出您可以在「訂閱內容」對話框的一般頁面中設定的屬性。
屬性 | 意義 | MQSC 參數 |
---|---|---|
訂閱名稱 | 唯讀。在建立之後,您就不能變更訂閱的名稱。 | SUBNAME |
主題名稱 | 訂閱所使用的主題物件名稱。主題名稱可提供選用的根主題。最多可接受 48 個字元。 | TOPICOBJ |
主題字串 | 該屬性指定訂閱的完整主題名稱,或含有萬用字元的主題集合。 這個字串內的斜線 (/) 字元有特殊意義。它用來區隔主題樹狀結構中的元素。主題字串的開頭可以是 (/) 字元,但不是必要的。以 (/) 字元開頭的字串,與不是以 (/) 字元開頭的字串並不相同。 |
TOPICSTR |
萬用字元用法 | 在解譯主題字串所包含的任何萬用字元時,會使用這個架構。其兩個值如下: TOPIC:萬用字元代表主題階層的部分。 CHAR:萬用字元代表字串的部分。 |
WSCHEMA |
範圍 | 範圍決定此訂閱是否轉遞至其他佇列管理程式,讓訂閱者接收其他那些佇列管理程式上發佈的訊息。其兩個值如下:
註: 個別訂閱者只能限制 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 MQSC 或 PCF 指令建立的訂閱。ADMIN 也可用來指出已透過管理指令修改訂閱。 PROXY:在內部建立的訂閱,透過佇列管理程式網路遞送發佈。
類型不能修改。 |
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 時,可用作 DISPLAY、ALTER 及 DELETE MQSC 指令的目標。 | SUBID |
期限 | 從建立日期和時間起的訂閱保持作用中時間。期限是以十分之一秒來測量。其兩個值如下: 無限制表示訂閱永不到期,或使用者可以輸入自己的值(以十分之一秒為測量單位)。預設值是零。 |
EXPIRY |
僅要求 | 「僅要求」指出訂閱者是否會透過 MQSUBPRQ API 來輪詢更新項目。其兩個值如下: 全部表示所有發佈都會遞送給訂閱。這是預設值。 於要求時表示只有在回應 MQSUBPRQ API 時,才將發佈遞送給訂閱。 |
REQONLY |
訂閱層次 | 這是與訂閱相關聯的層次。如果訂閱所屬的訂閱集合所具有的最高 SubLevel 值小於或等於發佈時使用的 PubLevel,則發佈只會遞送至此訂閱。值必須在 0 到 9 的範圍內。0 是最低層次。 | SUBLEVEL |
「統計資料」頁面
下表列出「訂閱內容」對話框之統計資料頁面中的屬性。統計資料頁面會顯示訂閱歷程的相關資訊。統計資料頁面顯示的資訊是唯讀的,使用者不能變更。
屬性 | 意義 | MQSC 參數 |
---|---|---|
建檔日期 | 唯讀。這是建立訂閱的日期。 | CRDATE |
建檔時間 | 唯讀。這是建立訂閱的時間。 | CRTIME |
變更日期 | 唯讀。這是前次變更訂閱屬性的日期。 | ALTDATE |
變更時間 | 唯讀。這是前次變更訂閱屬性的時間。 | ALTTIME |