DISPLAY CHSTATUS (顯示通道狀態)

使用 MQSC 指令 DISPLAY CHSTATUS 可顯示一個以上通道的狀態。

使用 MQSC 指令

如需如何使用 MQSC 指令的相關資訊，請參閱使用 MQSC 指令管理 IBM® MQ。

[z/OS] 您可以從來源 CR發出此指令。如需來源符號的說明，請參閱您可以在 IBM MQ for z/OS®上從中發出 MQSC 和 PCF 指令的來源。

同義字：DIS CHS

DISPLAY CHSTATUS

一般狀態

僅現行狀態

簡短狀態

附註：

¹ 只有在佇列管理程式是佇列共用群組的成員時，才適用於 z/OS 。
² 僅適用於 z/OS。
³ 也會透過選取 MONITOR 參數來顯示。
⁴ 如果在 z/OS上指定，則會忽略。

z/OS 上 DISPLAY CHSTATUS 的使用注意事項

如果尚未啟動通道起始程式，則指令失敗。
必須執行指令伺服器。
如果您想要查看通道的整體狀態 (即佇列共用群組的狀態) ，請使用指令 DISPLAY CHSTATUS SHORT，它會從 Db2®取得通道的狀態資訊。
如果有任何數值參數超過 999,999,999，它將顯示為 999999999。

針對 CHLDISP、 CMDSCOPE及狀態類型的各種組合所傳回的狀態資訊在表 1、表 2及表 3中彙總。

表 1. DISPLAY CHSTATUS CURRENT 的 CHLDISP 和 CMDSCOPE
CHLDISP	CMDSCOPE( ) 或 CMDSCOPE (local-qmgr)	CMDSCOPE (qmgr-name)	CMDSCOPE(*)
PRIVATE	在本端佇列管理程式上，現行專用通道的一般狀態和僅現行狀態	在指定的佇列管理程式上，現行專用通道的一般狀態和僅現行狀態	在所有佇列管理程式上，現行專用通道的一般狀態和僅現行狀態
SHARED	在本端佇列管理程式上，現行共用通道的一般狀態和僅現行狀態	在指定的佇列管理程式上，現行共用通道的一般狀態和僅現行狀態	在所有佇列管理程式上，現行共用通道的一般狀態和僅現行狀態
ALL	在本端佇列管理程式上，現行專用和共用通道的一般狀態和僅現行狀態	在指定的佇列管理程式上，現行專用和共用通道的一般狀態和僅現行狀態	在所有作用中的佇列管理程式上，現行專用和共用通道的一般狀態和僅現行狀態

表 2. DISPLAY CHSTATUS SHORT 的 CHLDISP 和 CMDSCOPE
CHLDISP	CMDSCOPE( ) 或 CMDSCOPE (local-qmgr)	CMDSCOPE (qmgr-name)	CMDSCOPE(*)
PRIVATE	在本端佇列管理程式上，現行專用通道的 STATUS 和簡短狀態	在指定的佇列管理程式上，現行專用通道的 STATUS 和簡短狀態	在所有作用中的佇列管理程式上，現行專用通道的 STATUS 和簡短狀態
SHARED	佇列共用群組中所有作用中佇列管理程式上現行共用通道的 STATUS 及簡短狀態	不允許	不允許
ALL	本端佇列管理程式上現行專用通道的 STATUS 及簡短狀態，以及佇列共用群組中現行共用通道的狀態 ( 5.a )	在指定的佇列管理程式上，現行專用通道的 STATUS 和簡短狀態	佇列共用群組中所有作用中佇列管理程式上現行專用及共用通道的 STATUS 及簡短狀態 ( 5.a )

附註：

在此情況下，對於在佇列管理程式上輸入的指令，您將得到兩組不同的回應：一個用於 PRIVATE，一個用於 SHARED。

表 3. DISPLAY CHSTATUS SAVED 的 CHLDISP 和 CMDSCOPE
CHLDISP	CMDSCOPE( ) 或 CMDSCOPE (local-qmgr)	CMDSCOPE (qmgr-name)	CMDSCOPE(*)
PRIVATE	在本端佇列管理程式上，已儲存之專用通道的一般狀態	在指定的佇列管理程式上，已儲存之專用通道的一般狀態	在所有作用中的佇列管理程式上，已儲存之專用通道的一般狀態
SHARED	佇列共用群組中所有作用中佇列管理程式上已儲存共用通道的一般狀態	不允許	不允許
ALL	本端佇列管理程式上已儲存專用通道及佇列共用群組中已儲存共用通道的一般狀態	在指定的佇列管理程式上，已儲存之專用通道的一般狀態	佇列共用群組中所有作用中佇列管理程式上已儲存專用及共用通道的一般狀態

所有平台上 DISPLAY CHSTATUS 的參數說明

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

您還可以指定是要現行狀態資料（僅屬於現行通道），還是要所有通道的已儲存狀態資料。

將顯示滿足選取準則的所有通道的狀態（無論通道是手動定義或自動定義）。

通道狀態可用的資料類別為 已儲存 及現行，以及 (僅限 z/OS ) short。

可用於已儲存資料的狀態欄位是現行資料可用的欄位子集，稱為一般狀態欄位。請注意，雖然一般資料欄位相同，但是已儲存和現行狀態的資料值可能不同。現行資料可用的其餘欄位稱為僅現行狀態欄位。

已儲存資料是由語法圖中指出的一般狀態欄位所組成。
- 對於傳送端通道，會在要求確認已收到一批訊息之前以及在收到確認時更新資料
- 對於接收端通道，會在確認已收到一批訊息之前立即重設資料
- 對於伺服器連線通道，不會儲存任何資料。
- 因此，從未處於現行狀態的通道無法有任何儲存狀態。
  附註: 除非透過通道傳輸持續訊息，或以 NORMAL 的 NPMSPEED 傳輸非持續訊息，否則不會儲存狀態。因為狀態會在每個批次結束時儲存，所以要等到至少傳輸了一個批次之後，通道才會有已儲存狀態。
現行資料是由語法圖中指出的一般狀態欄位和僅現行狀態欄位所組成。在傳送/接收訊息時會不斷地更新資料欄位。
簡短資料包含 STATUS 現行資料項目和簡短狀態欄位 (如語法圖中所述)。

此作業方法有下列結果：

非作用中通道可能沒有任何已儲存狀態 - 如果它從未處於現行狀態，或者尚未到達重設已儲存狀態的時間點。
對於已儲存及現行狀態，一般資料欄位可能具有不同的值。
現行通道一律有現行狀態，且可能有已儲存狀態。

通道可以是現行或非作用中通道：

現行通道

這些是已啟動的通道，或是已連接用戶端但尚未完成或正常斷線的通道。它們可能還沒有到達傳送訊息或資料的時間點，甚至是與友機建立聯絡關係的時間點。現行通道有現行狀態，也可能有已儲存狀態。

作用中一詞是用來描述一組未停止的現行通道。

非作用中通道

這些通道可能：

尚未啟動
未連接用戶端
已完成
已正常斷線

（請注意，如果通道已停止，尚未將其視為正常完成 - 因此，它仍然處於現行狀態。）非作用中通道可能是已儲存狀態，或者根本沒有任何狀態。

同一個指定接收端、要求端、叢集接收端或伺服器連線通道可以同時有多個實例（以要求端作為接收端）。如果不同佇列管理程式上的數個傳送端各自使用同一個通道名稱與此接收端起始了階段作業，就會發生這種情況。對於其他類型的通道，一次只能有一個現行實例。

然而，對於所有通道類型，一個通道名稱可以有多組已儲存狀態資訊。其中最多只有一組與該通道的現行實例相關，其餘則與先前的現行實例相關。如果相同的通道使用不同的傳輸佇列名稱或連線名稱，則會產生多個實例。這在下列情況下有可能發生：

在傳送端或伺服器上：
- 如果不同的要求端（僅限伺服器）已連接到相同的通道
- 如果已在定義中變更了傳輸佇列名稱
- 如果已在定義中變更了連線名稱
在接收端或要求端上：
- 如果不同的傳送端或伺服器已連接到相同的通道
- 如果已在定義中變更了連線名稱（用於起始連線的要求端通道）

可以在指令中使用 XMITQ、CONNAME 及 CURRENT 參數來限制為一個通道顯示的集合數量。

( generic-channel-name )

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

WHERE

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

過濾條件分為三個部分: filter-keyword、 operator及 filter-value:

過濾關鍵字

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

您無法使用下列參數作為 Multiplatforms上的過濾關鍵字 :COMPRATE、COMPTIME、CURRENT、EXITTIME、JOBNAME、NETTIME、SAVED、SHORT、XBATCHSZ 或 XQTIME。

您無法使用下列參數作為 z/OS上的過濾關鍵字 :CHLDISP、CMDSCOPE、MCASTAT 或 MONITOR。

如果您還要使用 CONNAME 或 XMITQ 來選取通道狀態，就不能使用它們作為過濾關鍵字。

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

operator

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

LT: 小於
GT: 大於
EQ: 等於
NE: 不等於
LE: 小於或等於
GE: 大於或等於
LK: 符合您提供作為 filter-value 的一般字串
NL: 不符合您提供作為 filter-value 的一般字串
CT: 包含指定的項目。如果 filter-keyword 是清單，您可以使用此選項來顯示其屬性包含指定項目的物件。
EX: 不包含所指定的項目。如果 filter-keyword 是清單，您可以使用此選項來顯示其屬性不包含指定項目的物件。

過濾器值

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

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

ALL

指定此值可顯示每個相關實例的所有狀態資訊。

如果指定 SAVED，這會導致僅顯示一般狀態資訊，而不顯示僅現行狀態資訊。

如果指定此參數，則同時指定的任何要求特定狀態資訊的參數將沒有作用；會顯示所有資訊。

CHLDISP

此參數僅適用於 z/OS ，並指定要顯示其資訊的通道處置 (如在 START 及 STOP CHANNEL 指令中使用) ，以及 QSGDISP 為通道定義設定的不。其值如下：

ALL

這是預設值，它顯示所要求的專用通道狀態資訊。

如果有共用佇列管理程式環境，而且是在發出指令的佇列管理程式上執行此指令，或者已指定 CURRENT，則此選項還會顯示所要求的共用通道狀態資訊。

PRIVATE

顯示所要求的專用通道狀態資訊。

SHARED

顯示所要求的共用通道狀態資訊。必須具有共用佇列管理程式環境，而且符合下列條件之一，才容許使用此值：

CMDSCOPE 為空白或是本端佇列管理程式
已指定 CURRENT

CHLDISP 顯示下列值：

PRIVATE: 為專用通道的狀態。
SHARED: 為共用通道的狀態。
固定共用: 為共用通道的狀態，與特定的佇列管理程式相關聯。

CMDSCOPE

此參數僅適用於 z/OS ，並指定當佇列管理程式是佇列共用群組的成員時如何執行指令。

' ': 指令會在輸入它的佇列管理程式上執行。這是預設值。
佇列管理程式-名稱: 指令會在您指定的佇列管理程式上執行，前提是佇列管理程式在佇列共用群組內處於作用中。
只有在您使用佇列共用群組環境且指令伺服器已啟用時，才可以指定佇列管理程式名稱 (不是輸入它的佇列管理程式)。
*: 指令在本端佇列管理程式上執行，也會傳遞至佇列共用群組中的每個作用中佇列管理程式。這與在佇列共用群組中的每一個佇列管理程式上輸入指令的效果相同。

您不能使用 CMDSCOPE 作為過濾關鍵字。

附註: 請參閱表 1、表 2和表 3 ，以取得 CHLDISP 和 CMDSCOPE 的允許組合。

CONNAME ( connection-name )

要顯示所指定通道的狀態資訊的連線名稱。

此參數可用來限制所顯示之狀態資訊的集合數量。如果未指定，則不會以此方式限制顯示。

CONNAME 的傳回值可能與通道定義中的值不同，而且在現行通道狀態與已儲存通道狀態之間，此值可能存在著差異。（因此，不建議使用 CONNAME 來限制狀態集的數量）。

例如，使用 TCP 時，如果通道定義中的 CONNAME：

為空白或採用主機名稱格式，通道狀態值具有已解析的 IP 位址。
包括埠號，現行通道狀態值包括埠號 ( z/OS 上除外)，但儲存的通道狀態值不包括。

[z/OS] 若為 SAVED 或 SHORT 狀態，此值也可以是遠端系統上的佇列管理程式名稱或佇列共用群組名稱。

對於 SAVED 狀態，此值也可以是:

遠端系統上的佇列管理程式名稱。
遠端系統上佇列管理程式名稱與佇列管理程式名稱的 QMID 組合。
對於第二個選項，格式為 QMNAME@QMID 或 QMNAME&QMID，其中 QMNAME 是佇列管理程式名稱，右側填補空白，最多 48 個字元。
若要顯示此情況，在下列範例中，字元 2 (在 QM2中) 與 @ 字元之間有 45 個空格。
```
CONNAME(QM2                                             @QM2_2023-07-18_12.24.06)
```

CURRENT

這是預設值，它指出僅顯示通道起始程式針對現行通道所保留的現行狀態資訊。

可以同時要求現行通道的一般狀態資訊和僅現行狀態資訊。

如果指定了此參數，則不會顯示簡短狀態資訊。

SAVED

指定此值可同時顯示現行通道和非作用中通道的已儲存狀態資訊。

只能顯示一般狀態資訊。如果指定了此參數，則不會顯示現行通道的簡短狀態資訊和僅現行狀態資訊。

SHORT

這指出僅顯示現行通道的簡短狀態資訊和 STATUS 項目。

如果指定了此參數，則不會顯示現行通道的其他一般狀態資訊和僅現行狀態資訊。

MONITOR

指定此參數可傳回線上監視參數集。這些參數是 COMPRATE、COMPTIME、EXITTIME、MONCHL、NETTIME、XBATCHSZ、XQMSGSA 及 XQTIME。如果您指定此參數，則特別要求的任何監視參數都沒有作用；仍會顯示所有監視參數。

XMITQ ( q-name )

要顯示所指定一個以上通道的狀態資訊的傳輸佇列名稱。

此參數可用來限制所顯示之狀態資訊的集合數量。如果未指定，則不會以此方式限制顯示。

對於每一組狀態資訊，一律傳回下列資訊：

通道名稱
傳輸佇列名稱（適用於傳送端和伺服器通道）
連線名稱
遠端佇列管理程式或佇列共用群組名稱 (僅適用於現行狀態，以及伺服器連線通道以外的所有通道類型)
遠端友機應用程式名稱（適用於伺服器連線通道）
所傳回狀態資訊的類型 (CURRENT 或 SAVED，或僅限 z/OS 、SHORT)
狀態 ( z/OS 上的 SAVED 除外)
在 z/OS上， CHLDISP
STOPREQ（僅適用於現行狀態）
SUBSTATE

如果沒有指定任何要求特定狀態資訊的參數（而且沒有指定 ALL 參數），則不會傳回任何進一步資訊。

如果所要求的狀態資訊與特定通道類型無關，則這不算是錯誤。

一般狀態

下列資訊適用於現行狀態資料集，以及已儲存狀態資料集。其中的一些資訊不適用於伺服器連線通道。

CHLTYPE

通道類型。這是下列其中一項：

SDR: 傳送端通道
SVR: 伺服器通道
RCVR: 接收端通道
RQSTR: 要求端通道
CLUSSDR: 叢集傳送端通道
CLUSRCVR: 叢集接收端通道
SVRCONN: 伺服器連線通道
AMQP: AMQP 通道

CURLUWID

對於傳送端或接收端通道，這是與現行批次相關聯的邏輯工作單元 ID。

如果是傳送通道，則當通道無法確定時，其為無法確定批次的 LUWID。

如果是儲存通道實例，則只有當通道實例無法確定時，這個參數才有具有意義的資訊。不過，即使通道實例並非無法確定，要求時仍會傳回參數值。

知道這個時，會以下一個批次的 LUWID 加以更新。

此參數不適用於伺服器連線通道。

CURMSGS

如果是傳送端通道，則這是已在現行批次中傳送的訊息數。每傳送一則訊息，此數字就會遞增，當通道變成不確定時，則指不確定的訊息數。

如果是儲存通道實例，則只有當通道實例無法確定時，這個參數才有具有意義的資訊。不過，即使通道實例並非無法確定，要求時仍會傳回參數值。

如果是接收端通道，則這是已在現行批次中接收的訊息數。每收到一則訊息，該值便會遞增。

當確定批次時，會將傳送端通道及接收端通道的值重設為零。

此參數不適用於伺服器連線通道。

CURSEQNO

如果是傳送端通道，則這是最後傳送之訊息的訊息序號。每傳送一則訊息，該值便會更新，且當通道變成不確定時，該值為在無法確定之批次中之最後一個訊息的訊息序號。

如果是儲存通道實例，則只有當通道實例無法確定時，這個參數才有具有意義的資訊。不過，即使通道實例並非無法確定，要求時仍會傳回參數值。

如果是接收端通道，則其為最後一個收到之訊息的訊息序號。每收到一則訊息，該值便會更新。

此參數不適用於伺服器連線通道。

INDOUBT

目前通道是否無法確定。

當傳送端「訊息通道代理程式」在等待傳送的訊息批次已順利接收的確認通知時，這個參數只能是 YES。其他所有時間為 NO，其中包括傳送訊息的週期期間，但要在要求認可之前。

對於接收端通道，此值一律為 NO。

此參數不適用於伺服器連線通道。

LSTLUWID

與所傳送的最後確定之訊息批次相關聯的邏輯工作單元 ID。

此參數不適用於伺服器連線通道。

LSTSEQNO

最後確定的批次中的最後一則訊息的訊息序號。如果非持續性訊息使用 NPMSPEED 為 FAST 的通道，則此數字不會遞增。

此參數不適用於伺服器連線通道。

STATUS

通道的現行狀態。這是下列其中一項：

BINDING

通道正在執行通道協商，尚未準備好傳送訊息。

INITIALIZING

通道起始程式正在嘗試啟動通道。

在 z/OS上，這會顯示為 INITIALIZI。

PAUSED

通道正在等待訊息重試間隔結束，然後才重試 MQPUT 作業。

REQUESTING

本端要求端通道正在向遠端 MCA 要求服務。

RETRYING

前次建立連線的嘗試已失敗。在指定的時間間隔之後，MCA 會重新嘗試連線。

RUNNING

此時通道正在傳送訊息，或是等待訊息到達傳輸佇列以便傳送。

STARTING

已發出啟動通道的要求，但通道尚未開始處理。如果某個通道正在等待變成作用中，則該通道就處於這種狀態。

STOPPED

這種狀態可能是由下列其中一項原因所造成：

手動停止通道
使用者對此通道輸入了停止通道指令。
達到重試限制
MCA 已達到建立連線的重試次數限制。不再嘗試自動建立連線。

處於這種狀態的通道只能透過發出 START CHANNEL 指令，或是以作業系統相依方式啟動 MCA 程式來重新啟動。

STOPPING

通道正在停止或已接收到關閉要求。

SWITCHING

通道正在切換傳輸佇列。

在 z/OS上，如果要求儲存的資料，則不會顯示 STATUS。

[UNIX、Linux、Windows、IBM i] 在 Multiplatforms上，在已儲存資料中傳回的 STATUS 欄位值是寫入已儲存狀態時通道的狀態。通常，已儲存狀態值是 RUNNING。若要查看通道的現行狀態，使用者可以使用 DISPLAY CHSTATUS CURRENT 指令。

附註: 對於非作用中通道，只有在通道是 INDOUBT 時， CURMSGS、CURSEQNO 及 CURLUWID 才具有有意義的資訊。但是如果提出要求，仍會顯示及傳回這些資訊。

僅現行狀態

下列資訊僅適用於現行通道實例。除非另有聲明，否則此資訊適用於所有通道類型。

AMQPKA

AMQP 通道的保持作用中時間 (毫秒)。如果 AMQP 用戶端在保持作用中間隔內未傳送任何訊框，則會以amqp:resource-limit-exceededAMQP 錯誤狀況。

此參數僅對於通道類型 (CHLTYPE) 為 AMQP 的通道才有效

BATCHES

此階段作業期間（自啟動通道以來）已完成的批次數量。

BATCHSZ

用於此階段作業的批次大小。

此參數不適用於伺服器連線通道，而且不會傳回任何值；如果在指令中指定了此參數，則會予以忽略。

BUFSRCVD

接收到的傳輸緩衝區數量。這包括只接收控制資訊的傳輸。

BUFSSENT

傳送的傳輸緩衝區數量。這只包括傳送控制資訊的傳輸。

BYTSRCVD

此階段作業期間（自啟動通道以來）接收到的位元組數。這包括訊息通道代理程式接收到的控制資訊。

如果 BYTSSENT 或 BYTSRCVD 的值超過 999999999 ，它會折返為零。

BYTSSENT

此階段作業期間（自啟動通道以來）傳送的位元組數。這包括訊息通道代理程式傳送的控制資訊。

如果 BYTSSENT 或 BYTSRCVD 的值超過 999999999 ，它會折返為零。

CHSTADA

啟動此通道的日期（其格式為 yyyy-mm-dd）。

CHSTATI

啟動此通道的時間（格式為 hh.mm.ss）。

COMPHDR

用來壓縮通道所傳送之標頭資料的技術。會顯示兩個值：

針對此通道協商的預設標頭資料壓縮值。
用於最後一則傳送訊息的標頭資料壓縮值。在傳送端通道訊息結束程式中，可變更標頭資料壓縮值。如果尚未傳送任何訊息，則第二個值為空白。

COMPMSG

用來壓縮通道所傳送之訊息資料的技術。會顯示兩個值：

針對此通道協商的預設訊息資料壓縮值。
用於最後一則傳送訊息的訊息資料壓縮值。在傳送端通道訊息結束程式中，可變更訊息資料壓縮值。如果尚未傳送任何訊息，則第二個值為空白。

COMPRATE

達到的壓縮率會顯示為最接近的百分比; 亦即， 25 表示訊息已壓縮至其原始長度的 75%。

會顯示兩個值：

第一個值是基於短期內的最近活動。
第二個值是基於較長期間內的活動。

每次啟動通道時都會重設這些值，只有當通道的 STATUS 是 RUNNING 時，才會顯示這些值。如果沒有收集監視資料或通道未傳送任何訊息，則這些值顯示為空白。

如果為此通道設定了 MONCHL，才會顯示此參數的值。請參閱設定監視器值。

COMPTIME

壓縮或解壓縮所耗費的每一則訊息的時間量 (以微秒顯示)。會顯示兩個值：

第一個值是基於短期內的最近活動。
第二個值是基於較長期間內的活動。

附註: 在 z/OS上， COMPTIME 是每一個訊息的時間量，前提是訊息不需要在區段中處理。當訊息為下列情況時，會對 z/OS 上的訊息進行此分段:

32 KB 以上，或者
16 KB 以上，且通道具有 TLS 加密。

如果訊息分割成數個區段，則 COMPTIME 是指壓縮每一個區段所花費的時間。這意味著分割成 8 段的一則訊息，在壓縮或解壓縮期間實際耗費 (COMPTIME * 8) 微秒。

如果為此通道設定了 MONCHL，才會顯示此參數的值。請參閱設定監視器值。

CURSHCNV

對於伺服器連線通道以外的所有通道類型，CURSHCNV 值都是空白。對於伺服器連線通道的每個實例，CURSHCNV 輸出提供目前對該通道實例執行的對話數目。

值零表示通道執行的方式與在 IBM WebSphere® MQ 7.0之前的產品版本中執行的方式相同，與下列相關:

管理者停止/靜止
活動訊號中
先讀
共用交談
用戶端非同步取用

EXITTIME

每則訊息處理使用者結束程式所花費的時間量（以微秒為單位）。會顯示兩個值：

第一個值是基於短期內的最近活動。
第二個值是基於較長期間內的活動。

這些值視系統的配置和行為以及系統內的活動層次而定，並作為系統正常執行的指標。這些值若有重大變動，表示系統有問題。每次啟動通道時都會重設這些值，只有當通道的 STATUS 是 RUNNING 時，才會顯示這些值。

當您指定 MONITOR 參數時，也會顯示此參數。

如果為此通道設定了 MONCHL，才會顯示此參數的值。請參閱設定監視器值。

HBINT

用於此階段作業的活動訊號間隔。

JOBNAME

識別目前提供及管理通道之 MQ 處理程序的名稱。

在 Multiplatforms上，此名稱是 MCA 程式的處理程序 ID 與執行緒 ID 的連結，以十六進位顯示。

在 z/OS上無法使用此資訊。如果指定了此參數，則會予以忽略。

您無法在 z/OS上使用 JOBNAME 作為過濾關鍵字。

KAINT

用於此階段作業的保留作用中間隔。這僅在 z/OS上有效。

LOCLADDR

通道的本端通訊位址。傳回的值取決於通道的 TRPTYPE（目前僅支援 TCP/IP）。

LONGRTS

剩下的長時間重試等待啟動的嘗試次數。這只適用於傳送端或伺服器通道。

LSTMSGDA

傳送最後一則訊息或處理 MQI 呼叫的日期，請參閱 LSTMSGTI。

LSTMSGTI

傳送最後一則訊息或處理 MQI 呼叫的時間。

如果是傳送端或伺服器，這是傳送最後一個訊息（如果它被分割的話則為最後一個部分）的時間。如果是要求端或接收端，其為最後一個訊息置入其目標佇列的時間。如果是伺服器連線通道，其為最後 MQI 呼叫完成時的時間。

如果是共享對話的伺服器連線通道實例，這是指對通道實例上執行的任何對話完成最後一個 MQI 呼叫的時間。

MAXMSGL

用於此階段作業的訊息長度上限 (僅適用於 z/OS )。

MAXSHCNV

對於伺服器連線通道以外的所有通道類型，MAXSHCNV 值都是空白。對於伺服器連線通道的每個實例，MAXSHCNV 輸出提供可對該通道實例執行的對話數目的協議上限。

零值指出通道的執行方式與 IBM WebSphere MQ 7.0之前版本的執行方式相同，與下列相關:

管理者停止/靜止
活動訊號中
先讀
共用交談
用戶端非同步取用

MCASTAT

訊息通道代理程式目前是否正在執行中。它可能是「執行中」或「未執行」。請注意，通道可能處於已停止狀態，但程式可能仍在執行中。

在 z/OS上無法使用此資訊。如果指定了此參數，則會予以忽略。

您無法在 z/OS上使用 MCASTAT 作為過濾關鍵字。

MCAUSER

MCA 使用的使用者 ID。這可以是通道定義中設定的使用者 ID、用於訊息通道的預設使用者 ID、從用戶端傳送的使用者 ID（如果這是伺服器連線通道的話），或是安全結束程式所指定的使用者 ID。

此參數僅適用於伺服器連線、接收端、要求端及叢集接收端通道。

在共享對話的伺服器連線通道上，如果所有對話具有相同的 MCA 使用者 ID 值，則 MCAUSER 欄位包含使用者 ID。如果這些對話之間使用的 MCA 使用者 ID 不同，則 MCAUSER 欄位包含 * 這個值。

Multiplatforms 上的長度上限為 64 個字元。

z/OS 上的長度上限為 12 個字元。

MONCHL

通道的監視資料收集的現行層次。

當您指定 MONITOR 參數時，也會顯示此參數。

MSGS

此階段作業期間（自啟動通道以來）已傳送或接收到的訊息數（或者針對伺服器連線通道所處理的 MQI 呼叫數）。

如果是共享對話的伺服器連線通道實例，這是指對通道實例上執行的所有對話已處理的 MQI 呼叫總數。

NETTIME

向通道遠端系統傳送要求以及接收回應所花費的時間量（以微秒顯示）。此時間僅測量這類作業的網路時間。會顯示兩個值：

第一個值是基於短期內的最近活動。
第二個值是基於較長期間內的活動。

這個參數只適用於傳送端、伺服器及叢集傳送端通道。

當您指定 MONITOR 參數時，也會顯示此參數。

如果為此通道設定了 MONCHL，才會顯示此參數的值。請參閱設定監視器值。

NPMSPEED

用於此階段作業的非持續性訊息處理技術。

PORT

用於連接 AMQP 通道的埠號。 AMQP 1.0 連線的預設埠為 5672。

RAPPLTAG

遠端友機應用程式名稱。這是通道遠端系統的用戶端應用程式名稱。

對於 Managed File Transfer， RAPPLTAG 會顯示

Managed File Transfer
Agent agent name

。

此參數只適用於伺服器連線通道。

附註: 如果多個 IBM MQ 連線使用相同的通道實例，亦即，使用 SHARECNV> 1 定義通道，且同一處理程序對佇列管理程式建立多個連線，則如果連線指定不同的應用程式名稱，則 RAPPLTAG 欄位會顯示星號: RAPPLTAG(*)。

RPRODUCT

遠端友機產品 ID。這是在通道遠端執行之 IBM MQ 程式碼的產品 ID 。可能的值如表 4所示。

表 4. 產品 ID 值
產品 ID	說明
MQMM	分散式平台上的佇列管理程式
MQMV	上的佇列管理程式 z/OS
MQCC	IBM MQ C 用戶端
MQNM	IBM MQ .NET 完全受管理用戶端
MQJB	IBM MQ Java 類別
MQJF	Managed File Transfer Agent
MQJM	IBM MQ Classes for JMS (標準模式)
MQJN	IBM MQ Classes for JMS (移轉模式)
MQJU	MQI 的通用 Java 介面
MQXC	XMS 用戶端 C/C++（標準模式）
MQXD	XMS 用戶端 C/C++（移轉模式）
MQXN	XMS 用戶端 .NET (標準模式)
MQXM	XMS 用戶端 .NET (移轉模式)
MQXU	IBM MQ .NET XMS 用戶端 (未受管理 /XA)
MQNU	IBM MQ .NET 未受管理的用戶端

RQMNAME

遠端系統的佇列管理程式名稱，或佇列共用群組名稱。此參數不適用於伺服器連線通道。

RVERSION

遠端友機版本。這是在通道遠端執行的 IBM MQ 程式碼版本。

遠端版本顯示為 VVRRMMFF，其中

VV: 版本
RR: 版次
MM: 維護層次
FF: 修正層次

SECPROT

定義目前使用中的安全通訊協定。

不適用於用戶端連線通道。

根據您在 DEFINE CHANNEL中為 SSLCIPH 設定的值自動設定。

從 IBM MQ 9.2.0開始， z/OS上支援 SECPROT 。

可能的值為：

無: 沒有安全通訊協定
SSLV3: SSL 3.0; 此通訊協定已淘汰。請參閱已淘汰 CipherSpecs
TLSV1: TLS 1.0
TLSV12: TLS 1.2
TLSV13: TLS 1.3; 從 IBM MQ 9.2.0開始，產品在所有平台上都支援 TLS 1.3 安全通訊協定。在 IBM MQ for z/OS上， TLS 1.3 僅在 z/OS 2.4 或更新版本上受支援。

SHORTRTS

剩下的短時間重試等待啟動的嘗試次數。這只適用於傳送端或伺服器通道。

SSLCERTI

遠端憑證發卡機構的完整「識別名稱」。發卡機構是指發出憑證的憑證管理中心。

由於長度上限為 256 個字元，因此較長的「識別名稱」會被截斷。

SSLCERTU

與遠端憑證相關聯的本端使用者 ID。這僅適用於 z/OS 。

SSLCIPH

連線所使用的 CipherSpec 。

此參數已存在於 DEFINE CHANNEL中，由 IBM MQ 9.2.0中的 DISPLAY CHSTATUS 顯示。

如需相關資訊，請參閱 DEFINE CHANNEL 中的 SSLCIPH 內容。

此參數的值也用來設定 SECPROT的值。

SSLKEYDA

上次成功發出 TLS 秘密金鑰重設的日期。

附註: TLS 1.3 金鑰重設是 TLS 1.3的一部分，且不會與應用程式通訊。因此，在 z/OS 佇列管理程式上，對於接收端通道，當通道使用 TLS 1.3 CipherSpec進行通訊時，將不會設定此值。在分散式佇列管理程式上，當通道使用 TLS 1.3 CipherSpec進行通訊時，此值將不精確，甚至可能在通道任一端設為零。

SSLKEYTI

上次成功發出 TLS 秘密金鑰重設的時間。

SSLPEER

通道另一端的對等佇列管理程式或用戶端的「識別名稱」。

由於長度上限為 256 個字元，因此較長的「識別名稱」會被截斷。

SSLRKEYS

TLS 金鑰重設成功次數。通道實例結束時會重設 TLS 私密金鑰重設次數。

STOPREQ

是否未完成處理使用者的停止要求。這不是 YES 就是 NO。

STATCHL

通道的現行統計資料收集層次。

SUBSTATE

發出此指令時通道所執行的動作。會按照優先順序列出下列子狀態（從具有最高優先順序的子狀態開始）：

ENDBATCH: 通道正在執行批次結束處理。
傳送: 已對基礎通訊子系統發出要求來傳送一些資料。
接收: 已對基礎通訊子系統發出要求來接收一些資料。
序列化: 通道正在序列化它對佇列管理程式的存取。僅適用於 z/OS 。
重新同步化 (resynch): 通道正在與友機重新同步化。
活動訊號: 通道正在向友機發送活動訊號。
SCYEXIT: 通道正在執行安全結束程式。
RCVEXIT: 通道正在執行其中一個接收結束程式。
SENDEXIT: 通道正在執行其中一個傳送結束程式。
MSGEXIT: 通道正在執行其中一個訊息結束程式。
MREXIT: 通道正在執行訊息重試結束程式。
CHADEXIT: 通道正在透過通道自動定義結束程式執行。
NETCONNECT: 已對基礎通訊子系統發出要求來連接友機。
SSLHANDSHK: 通道正在處理 TLS 信號交換。
NameServer: 已對名稱伺服器發出要求。
MQPUT: 已對佇列管理程式發出要求，以在目的地佇列上放置訊息。
MQGET: 已對佇列管理程式發出要求，以從傳輸佇列（如果這是訊息通道）或從應用程式佇列（如果這是 MQI 通道）取得訊息。
MQICALL: 正在執行 MQ API 呼叫（非 MQPUT 和 MQGET）。
COMPRESS: 通道正在壓縮或解壓縮資料。

並非所有子狀態都對所有通道類型或通道狀態都有效。在某些情況下，任何子狀態都無效，此時會傳回空白值。

對於在多個執行緒上執行的通道，此參數會顯示具有最高優先順序的子狀態。

TPROOT

AMQP 通道的根主題。 TPROOT 的預設值是 SYSTEM.BASE.TOPIC。使用此值時，AMQP 用戶端用來發佈或訂閱的主題字串沒有字首，該用戶端可以與其他 MQ 發佈/訂閱應用程式交換訊息。為了讓 AMQP 用戶端在某個主題字首下發佈及訂閱，首先請在建立 MQ 主題物件時將主題字串設為您想要的字首，然後將 TPROOT 設為您所建立的 MQ 主題物件的名稱。

此參數僅對於通道類型 (CHLTYPE) 為 AMQP 的通道才有效

XBATCHSZ

透過通道傳輸的批次大小。會顯示兩個值：

第一個值是基於短期內的最近活動。
第二個值是基於較長期間內的活動。

此參數不適用於伺服器連線通道。

當您指定 MONITOR 參數時，也會顯示此參數。

如果為此通道設定了 MONCHL，才會顯示此參數的值。請參閱設定監視器值。

USECLTID

指定 AMQP 通道的授權檢查應該使用用戶端 ID，而不是 MCAUSER 屬性值。

XQMSGSA

排入可供通道進行 MQGET 作業的傳輸佇列中的訊息數。

此參數可顯示的最大值是 999。如果可用的訊息數超出 999，則顯示值 999。

[z/OS] 在 z/OS上，如果傳輸佇列未由 CorrelId編製索引，則此值會顯示為空白。

此參數只適用於叢集傳送端通道。

當您指定 MONITOR 參數時，也會顯示此參數。

如果為此通道設定了 MONCHL，才會顯示此參數的值。請參閱設定監視器值。

XQTIME

訊息在被擷取之前留在傳輸佇列中的時間（微秒）。此時間的測量是從訊息放入傳輸佇列中開始，一直到此訊息被擷取以在通道上傳送為止，因此，包含放置端應用程式因延遲而導致的任何間隔。

會顯示兩個值：

第一個值是基於短期內的最近活動。
第二個值是基於較長期間內的活動。

這個參數只適用於傳送端、伺服器及叢集傳送端通道。

當您指定 MONITOR 參數時，也會顯示此參數。

如果為此通道設定了 MONCHL，才會顯示此參數的值。請參閱設定監視器值。

簡短狀態

下列資訊僅適用於現行通道實例。

QMNAME: 擁有通道實例的佇列管理程式名稱。

設定監視器值

對於自動定義的叢集傳送端通道，這些是使用佇列管理程式 MONACLS 參數來控制。如需相關資訊，請參閱 ALTER QMGR (alter queue manager settings) 。您無法顯示或變更自動定義的叢集傳送端通道。不過，您可以取得其狀態，或發出 DISPLAY CLUSQMGR ，如這裡所說明: 使用自動定義的叢集傳送端通道。

對於其他通道（包括手動定義的叢集傳送端通道），這些是使用通道 MONCHL 參數來控制。如需相關資訊，請參閱 ALTER CHANNEL (alter channel settings) 。