DISPLAY CHSTATUS (MQTT)

使用 MQSC 指令 DISPLAY CHSTATUS (MQTT) 可顯示一或多個 IBM® MQ Telemetry 通道的狀態。

使用 MQSC 指令

如需如何使用 MQSC 指令的相關資訊，請參閱使用 MQSC 指令執行本端管理作業。

IBM i	AIX® 及 Linux®	Windows	z/OS®

附註: 對於遙測伺服器， AIX 是唯一支援的 UNIX® 平台。

同義字：DIS CHS

SummaryAttributes

DetailAttributes

附註：

預設行為是讓 RUNMQSC 傳回通道連線的摘要。如果指定 CLIENTID ，則 RUNMQSC 會傳回連接至通道之每一個用戶端的詳細資料。
可以指定 CLIENTID、 SUMMARY，也可以不指定兩者，但不能同時指定兩者。
與對 IBM MQ 通道執行指令時相比， IBM MQ Telemetry 的 DISPLAY CHSTATUS 指令可能會傳回更大的回應數目。因此， IBM MQ Telemetry 伺服器傳回的回應數不會超過回覆目的地佇列的適合度。回應數目限制為下列參數的 MAXDEPTH 參數值:SYSTEM.MQSC.REPLY.QUEUE佇列。當 RUNMQSC 處理 IBM MQ Telemetry 伺服器截斷的 IBM MQ Telemetry 指令時，會顯示 AMQ8492 訊息，指定根據 MAXDEPTH大小傳回的回應數目。
您可以使用這個指令來列出已斷線的用戶端。因為這些用戶端與特定通道沒有關聯，所以您可以使用萬用字元來列出它們。例如，
```
DIS CHS(*) CHLTYPE(MQTT) CLIENTID(*) WHERE(STATUS EQ DISCONNECTED).
```
當可能有大量斷線用戶端時，您應該小心使用這個指令。

您必須指定要顯示其狀態資訊的通道名稱。此參數可以是特定的通道名稱或通用通道名稱。利用通用的通道名稱，您可以顯示所有通道的狀態資訊，或符合所指定名稱的一個以上通道的狀態資訊。

( generic-channel-name )

要顯示其狀態資訊的通道定義的名稱。尾端星號 (*) 符合所指定詞幹後面跟著零個或多個字元的所有通道定義。只有獨自一個星號 (*) 表示指定所有通道定義。所有通道類型都需要值。

WHERE

指定過濾條件可顯示那些滿足過濾條件選取準則的通道的狀態資訊。

過濾條件有三個部分：filter-keyword、operator 及 filter-value：

filter-keyword

此參數用以顯示這個 DISPLAY 指令的屬性。

如果過濾關鍵字對某類型的通道無效，則不會顯示其狀態資訊。

運算子

這是用來判定通道是否滿足過濾關鍵字的過濾值。運算子如下：

過濾器值

必須使用運算子針對其測試屬性值的值。視 filter-keyword 而定，此值可以是:

明確值，這是所測試屬性的有效值。
您只能使用運算子 LT、GT、EQ、NE、LE 或 GE。不過，如果屬性值是來自參數上可能的值集 (例如， CHLTYPE 參數上的 SDR 值) ，則您只能使用 EQ 或 NE。
通用值。此值是結尾有星號的字串，例如 ABC*。如果運算子是 LK，則會列出其屬性值是以此字串（此範例中的 ABC）為開頭的所有項目。如果運算子是 NL，則會列出其屬性值不以此字串為開頭的所有項目。只允許單一尾端萬用字元（星號）。
您不能對於含有數值或一組值的其中一值的參數使用通用的 filter-value。
值清單中的項目。使用 CT 或 EX 作為運算子。比方說，如果使用運算子 CT 指定 DEF 值，則會列出其中一個屬性值是 DEF 的所有項目。

ALL

指定此參數以顯示每一個相關實例的所有狀態資訊。

如果指定此參數，則任何要求也指定之特定狀態資訊的參數都沒有作用; 會顯示所有資訊。

將 SUMMARY 新增至 MQSC 指令 DISPLAY CHSTATUS (MQTT) 時，連線數會顯示為 CONNECTIONS 屬性。下列屬性顯示每一個通道的摘要。

ALL: 指定此參數以顯示每一個相關實例的所有狀態資訊。如果沒有要求任何屬性，則此屬性為預設值。; 此參數適用於 MQTT 通道。; 如果指定此參數，則任何要求特定狀態資訊的指定參數都沒有作用; 且會顯示所有資訊。
CONNECTIONS: 此通道的現行連線數。
STATUS: 此通道的狀態。