通道內容

您可以為所有類型的通道(包括用戶端連線通道)設定內容。 某些內容特定於特定類型的通道。

下表列出您可以設定的所有內容:

某些內容並並非適用於所有類型的通道:
  • 某些內容特定於叢集通道。
  • [z/OS]部分內容特定於 z/OS® 通道。

每一個內容都有一個簡要說明,來說明您何時需要配置該內容。 這些表格也提供了 DEFINE、ALTER 及 DISPLAY CHANNEL 指令的對等 MQSC 參數。 如需 MQSC 指令的相關資訊,請參閱 使用 MQSC 指令管理

「一般」頁面

下表列出您可以在「 通道內容 」對話框的 一般 頁面上設定的內容。

內容 意義 MQSC 參數
通道名稱 唯讀。 這是通道定義的名稱。 CHANNEL
類型 唯讀。 這是通道定義的類型。 CHLTYPE
QSG 性質 唯讀。 這是通道定義的佇列共用群組處置方式。 建立之後,您就不能變更通道定義的處置方式。 Queue manager 表示物件定義只適用於管理它的佇列管理程式;Group 表示物件定義儲存在共用儲存庫中,且佇列共用群組中的每一個佇列管理程式都有定義副本;Copy 表示物件定義是共用儲存庫中的佇列管理程式定義副本。 QSGDISP
說明 輸入通道用途的有意義說明。 請參閱 內容對話框中的字串 DESCR
佇列管理程式名稱 輸入在其中定義通道的佇列管理程式名稱。 如果是用戶端連線通道,請輸入在 MQI 用戶端環境下執行的應用程式可以要求連線的佇列管理程式名稱。 QMNAME
傳輸通訊協定 從清單中選取通道會使用的傳輸類型。 TRPTYPE
連線名稱 對所有類型的通道(叢集接收端通道除外),輸入管理目標佇列管理程式的電腦名稱。 連線名稱的格式會視所選的傳輸通訊協定而定。 例如,如果您使用 TCP/IP 通訊協定,且您知道目標佇列管理程式正在使用 IBM® MQ 預設值 1414 以外的埠號進行連接,請鍵入 computer_name(port_number),其中 computer_name 是管理目標佇列管理程式之電腦的名稱或 IP 位址,port_number 是目標佇列管理程式接聽器正在使用的埠。

[AIX、Linux、Windows]對於 AIX®, Linux®, and Windows上使用 TCP/IP 傳輸通訊協定的叢集接收端通道,請勿指定此內容的值; IBM MQ 會產生一個名稱供使用,假設預設埠和系統的現行 IPv4 位址。 如果系統沒有 IPv4 位址,則會使用系統的現行 IPv6 位址。 針對其他平台上的叢集接收端通道,以及未使用 TCP/IP 傳輸通訊協定的叢集接收端通道,請輸入管理本端佇列管理程式的電腦名稱。

CONNAME
傳輸佇列 輸入對應於通道接收端之佇列管理程式的傳輸佇列名稱。 XMITQ
本端通訊位址 如果通道使用 TCP/IP,並且您想要通道使用特定的 IP 位址、埠或埠範圍來進行出埠通訊,請鍵入通道的本端通訊位址。 通道會連結到本端位址。 請使用格式ipaddress(low-port, high-port),其中 ipaddress 是以 IPv4 帶點十進位、 IPv6 十六進位或英數主機名稱格式指定的 IP 位址。 例如:192.0.2.0以任何埠指定 IPv4 位址;192.0.2.0(1000)指定 IPv4 位址及特定埠;192.0.2.0(1000,2000)指定 IPv4 位址及埠範圍;(1000)僅指定埠。

Cluster-sender channels: 如果您在手動定義之叢集傳送端通道的 Local communication address 欄位中輸入值,當與完整儲存庫佇列管理程式建立通訊時,這個值會被完整儲存庫的叢集接收端通道中的值改寫。 除了在手動定義的叢集傳送端通道中指定值外,您還必須撰寫通道自動定義結束程式,以強制 Local communication address 內容的值進入任何自動定義的叢集傳送端通道。

LOCLADDR
 

Cluster-receiver channels: 除非所有佇列管理程式都位於相同電腦上,否則請勿在叢集接收端通道的 Local communication address 欄位中放置 IP 位址。 這是因為嘗試連接至其叢集接收端通道的 Local communication address 欄位中具有 IP 位址之佇列管理程式的任何佇列管理程式,都會將這些值延伸到其自動定義的叢集傳送端通道。 不過,如果您想要叢集中的所有佇列管理程式使用特定埠或埠範圍來進行其所有出埠通訊,您可以將埠號或埠範圍放在叢集接收端通道的 Local communication address 欄位中。

 
整體通道狀態 唯讀。 這是通道的狀態。 STATUS

「延伸事項」頁面

下表列出您可以在「 通道內容 」對話框的 延伸事項 頁面上設定的內容。

內容 意義 MQSC 參數
訊息長度上限 輸入可在通道上傳輸的訊息長度上限:
  • 在下列平台上,該值必須大於或等於零,且小於或等於佇列管理程式的訊息長度上限:
    • [AIX]AIX
    • [IBM i]IBM i
    • [Windows]Windows
    • VSE/ESA
  • 在其他 Multiplatforms 上,該值必須大於或等於零,且小於或等於 4,194,304 個位元組。
  • [z/OS]IBM MQ for z/OS上,該值必須大於或等於零,且小於或等於 104,857,600 個位元組。
MAXMSGL
活動訊號間隔 輸入活動訊號間隔的長度,範圍可以從 0 到 999999。 零值表示未發生活動訊號。 將值設為小於 Disconnect interval 內容的值。 使用的值為在傳送端與接收端所指定的較大值。 活動訊號間隔是指當傳輸佇列中沒有訊息時,活動訊號流從傳送端 MCA 通過的時間(秒)。 活動訊號交換提供接收 MCA 停止通道的機會。 HBINT
實例數上限

此參數會用於伺服器連線通道及 AMQP 通道。 Maximum instances 指定個別伺服器連線通道或 AMQP 通道的同時實例數上限。

該值可以是範圍 0 到 999999999 之間的數字。 預設值是 999999999

0 的值表示拒絕所有用戶端存取。

如果 Maximum instances 設為小於目前執行中伺服器連線通道實例數的值,則在有足夠的現有實例停止執行之前,不會啟動新的實例。

如果用戶端在 AMQP 通道上使用已經連接的 ID 進行連接(即它執行用戶端接管),則無論連接的用戶端數是否已達到 MAXINST,接管皆會成功。

MAXINST
每一用戶端的實例數上限

這個參數會用於伺服器連線通道。 Maximum instances per client 指定可從單一用戶端啟動之個別伺服器連線通道的同時實例數上限。 在這個情況下,源自同一個遠端網址的連線會被視為來自同一個用戶端。

該值可以是範圍 0 到 999999999 之間的數字。 預設值是 999999999

0 的值表示拒絕所有用戶端存取。

Maximum instances 不同於 Maximum instances per client,因為 Maximum instances 是連線數上限,但 Maximum instances per client 是容許每一個用戶端連接至伺服器的連線數上限。

MAXINSTC
持續作用間隔 輸入保持作用中間隔的長度(0 到 99999)。 如果通道使用了 TCP 或 SPX 以外的傳輸類型,則會忽略這個內容。 在「佇列管理程式」內容的「通道」頁面上,TCP Keep alive 內容必須設為 Yes

[z/OS]z/OS 佇列管理程式上, Keep alive interval 內容指定個別通道的保持作用中間隔。

[UNIX、Linux、Windows、IBM i]在多平台上的佇列管理程式上,只有在通道連接至 z/OS 佇列管理程式時,才會使用 Keep alive interval 內容; 若要使用 Keep alive interval 內容所提供的功能,請將 Keep alive interval 內容設為 自動 ,以使用基於協議活動訊號間隔值的值。

KAINT
序號折返 序號是透過通道傳送的訊息計數。 每次透過通道傳送一則訊息時,序號就會遞增。

[z/OS]對於使用 CICS®z/OS ,請鍵入訊息序號在 1 重新啟動之前達到的範圍 1-999999999 內的最高數字。

對於所有其他平台,請鍵入範圍介於 100 - 999999999 之間的最大號碼,該訊息序號在達到最大號碼後,會從 1 重新開始。

此值必須足夠大,才不會造成此號碼正在被之前的訊息使用時就又重新發出此號碼。 在通道啟動時,通道兩端必須有相同的序號折返值;否則,您會收到錯誤。

SEQWRAP
非持續性訊息速度

若要指定通道上的非持續訊息不會在交易內傳送,請選取快速。 這表示擷取非持續訊息會比它是交易的一部分來得快很多。 不過,由於非持續訊息不是交易的一部分,如果(比方說)通道在訊息傳輸時停止,訊息可能會遺失。 要避免發生這個狀況,請選取正常 NPMSPEED
批次大小 輸入在取得同步點之前要傳送的訊息數上限。 訊息一律會個別傳送,但會以批次確定或取消。 嘗試預設批次大小50並僅在您需要時變更值。 BATCHSZ
訊息壓縮 按一下編輯,開啟「編輯訊息壓縮」對話框。 請依照喜好的順序選取通道定義支援的訊息壓縮技術。 系統會使用通道另一端所支援的第一個技術。 表示不執行訊息壓縮;RLE 表示使用執行長度編碼來壓縮訊息資料;ZLIBFAST 表示使用 zlib 壓縮技術來壓縮訊息資料,並偏好快速壓縮;ZLIBHIGH 表示使用 zlib 壓縮技術來壓縮訊息資料,並偏好高階壓縮;ANY 表示可以使用佇列管理程式所支援的任何壓縮技術。 如需相關資訊,請參閱分散式佇列和叢集 COMPMSG
標頭壓縮 按一下編輯,開啟「編輯標頭壓縮」對話框。 請依照喜好的順序選取通道定義支援的標頭壓縮技術。 系統會使用通道另一端所支援的第一個技術。 表示不執行標頭壓縮;系統表示執行標頭壓縮。 如需相關資訊,請參閱 分散式佇列及叢集 COMPHDR
批次間隔 輸入即使傳輸佇列上沒有任何訊息,通道還是會維持開啟批次的毫秒數(0 到 999999999)。 BATCHINT
批次資料限制 提供在採用同步點之前,透過通道傳送的資料量限制(0 到 999999,以 KB 為單位)。 值 0 表示不會對透過此通道的批次套用任何資料限制。 BATCHLIM
斷線間隔 輸入批次結束後,通道關閉前的秒數(0 到 999999)。 0 的值表示不會切斷通道的連線。 DISCINT
資料轉換 若要指定訊息會由接收端應用程式轉換成接收端系統所需的格式(這是一般方法),請選取;如果遠端佇列管理程式所在的平台不支援資料轉換,請選取,來指定訊息會在傳輸之前先轉換成接收端系統所需的格式。 CONVERT
放置權限 這個內容指定在對目標佇列或 MQI 呼叫執行 MQPUT 指令時,要由「訊息通道代理程式 (MCA)」執行的安全處理類型。 若要使用預設使用者 ID,請按一下預設值;若要使用來自與訊息關聯的環境定義資訊的替代使用者 ID,請按一下環境定義 PUTAUT
批次活動訊號間隔

如果傳送端通道在批次活動訊號間隔內已與接收端通道進行過通訊,則假設接收端通道仍處於作用中,否則會將「活動訊號」傳送至接收端通道以進行檢查。 傳送端通道會根據通道「活動訊號間隔 (HBINT)」內容中指定的秒數,在間隔內等待來自通道接收端的回應。

如果通道接收端不在作用中,批次可以取消而不是成為不能確定。 透過取消批次,訊息仍然可進行處理,以便能夠(比方說)重新導向至另一個通道。 輸入通道傳送端在假設通道接收端已停用之前,等待通道接收端回應的秒數(0 到 999999)。

0 的值表示不會使用批次活動訊號。 如需相關資訊,請參閱 配置通道以減少「不確定」的機會

BATCHHB
預設通道佈置方式 當您發出 START CHANNEL 指令但未指定通道處置方式關鍵字 (CHLDISP) 時,通道會使用「預設通道處置方式」(DEFCDISP) 的值來啟動。 可能的值有三個:

專用。 這是預設值。 在本端佇列管理程式上啟動為專用通道。

共用。 如果啟動接收端通道是為了回應導引至佇列共用群組的入埠傳輸,則接收端通道是共用的。 如果傳送端通道之傳輸佇列的處置方式為 SHARED,則傳送端通道是共用的。

固定共用。 如果傳送端通道之傳輸佇列的處置方式為 SHARED 且 CONNAME 不是空白,則傳送端通道是共用的。
DEFCDISP
內容控制

(只適用於「傳送端」通道、「伺服器」通道、「叢集傳送端」通道,以及「叢集接收端」通道)

這會定義要傳送至 IBM WebSphere® MQ 6.0 或更早的佇列管理程式之訊息內容的發生情況。 該值必須從相容性變更為全部,以保留將 RFH2 傳播到呼叫端的 IBM WebSphere MQ 6.0 行為。 可能值包括:

全部表示在傳送訊息至遠端佇列管理程式時,訊息的所有內容都會併入訊息中。 這些內容(訊息描述子或延伸中的除外)會放在訊息資料內的一或多個 MQRFH2 標頭中。

相容性。 這是預設值;它容許預期 JMS 相關內容位於訊息資料之 MQRFH2 標頭中的應用程式,可以不需修改繼續運作。

如果訊息包含字首為 mcd. 的內容, jms.usr., 或 mqext. 則所有選用訊息內容(其中「支援」值為 MQPD_SUPPORT_OPTIONAL),訊息描述子(或延伸)中的除外,會在將訊息傳送至遠端佇列管理程式之前,先置於訊息資料的一或多個 MQRFH2 標頭中。 否則,會先從訊息中移除所有訊息內容(訊息描述子或延伸中的除外),再將訊息傳送給遠端佇列管理程式。

如果訊息包含一個內容,其內容描述子的 Support 欄位不是設為 MQPD_SUPPORT_OPTIONAL,則該訊息會被拒絕,並依據其報告選項來處理。 如果訊息包含一或多個內容,其內容描述子的 Support 欄位設為 MQPD_SUPPORT_OPTIONAL,但內容描述子的其他欄位設為非預設值,則會先從訊息中移除這些內容,再將訊息傳送給遠端佇列管理程式。

表示會先從訊息中移除所有訊息內容(訊息描述子或延伸中的除外),再將訊息傳送給遠端佇列管理程式。 如果訊息包含一個內容,其內容描述子的 Support 欄位不是設為 MQPD_SUPPORT_OPTIONAL,則該訊息會被拒絕,並依據其報告選項來處理。

PROPCTL
共用交談

(僅限在伺服器連線通道及用戶端連線通道)

指定可以在特定 TCP/IP 用戶端通道實例 (Socket) 上共用的交談數上限。 可能值包括:
0:指定不在 TCP/IP Socket 上共用交談。 通道實例採用比 IBM WebSphere MQ 7.0 的模式更早的模式執行,請注意:
  • 管理者停止/靜止
  • 活動訊號中
  • 先讀

1:指定不在 TCP/IP Socket 上共用交談。 不論是否在 MQGET 呼叫中,都可以使用用戶端活動訊號和先讀,且通道靜止較可控制。

2 - 999999999:共用的交談數。 預設值是 10

如果用戶端連線 SHARECNV 值不符合伺服器連線 SHARECNV 值,則會使用最低值。
SHARECNV
擱置重設序號

這是未完成的要求的序號,指出使用者 RESET CHANNEL 指令要求未完成。 值 0 指出沒有任何未完成的 RESET CHANNEL。 值的範圍為 1 到 999999999。

如果 RESETSEQ 的值是 0,DISPLAY CHANNEL 指令會傳回 RESETSEQ(NO)。

RESETSEQ
使用無法傳送郵件的佇列

(在用戶端連線通道、伺服器連線通道或遙測通道上不使用)

指定在通道無法遞送訊息時,是否使用無法傳送郵件的佇列。 有兩個可能的值:
  • 表示將通道無法遞送的訊息視為失敗,通道會根據 非持續訊息速度設定而結束,或捨棄訊息。
  • 表示如果佇列管理程式 無法傳送郵件的佇列 內容提供「無法傳送郵件的佇列」名稱,則會使用該佇列。 否則,其行為會與相同。
USEDLQ

(僅限 AMQP 通道)

指定 AMQP 連線的埠。 AMQP 1.0 連線的預設埠為 5672。 如果您已經在使用埠 5672,則可指定不同的埠。 PORT
使用用戶端 ID

(僅限 AMQP 通道)

指定將用戶端 ID 用於 AMQP 通道上的連線。 設定為 USECLTID
AMQP 保持作用中

(僅限 AMQP 通道)

指定保持作用中時間(毫秒)。 如果 AMQP 用戶端在保持作用中間隔內未傳送任何訊框,則會以amqp:resource-limit-exceededAMQP 錯誤狀況。 AMQPKA
根主題

(僅限 AMQP 通道)

指定 AMQP 通道的根主題。 使用此內容來確保 MQ Light 應用程式在部署至佇列管理程式時,不會在其他應用程式正在使用的主題樹狀結構區域中發佈或訂閱訊息。

TPROOT 的預設值是 SYSTEM.BASE.TOPIC。 利用這個預設值,AMQP 用戶端用來發佈或訂閱的主題字串不會有字首,而用戶端可以與其他 MQ 發佈/訂閱應用程式交換訊息。

TPROOT
[MQ 9.3.0 2022 年 7 月]暫時模型佇列

(僅限 AMQP 通道)

指定建立暫時佇列時要使用的模型佇列名稱(長度上限為 48 個字元)。

預設值是 SYSTEM.DEFAULT.MODEL.QUEUE。

TMPMODEL
[MQ 9.3.0 2022 年 7 月]暫時佇列字首

(僅限 AMQP 通道)

當衍生暫時佇列名稱時,要新增至模型佇列開頭的暫時佇列名稱字首(長度上限為 32 個字元)。

預設值為 AMQP.*

TMPQPRFX
[z/OS]安全原則保護 這將從套用 AMS 保護原則方面,定義在從傳輸佇列取得訊息或將訊息放入目標佇列時「訊息通道代理程式」的行為。
這適用於類型為傳送端、伺服器、接收端及要求端的通道。 可能值包括:
透通
訊息通道代理程式為此通道傳送或接收的透通、未變更及其他任何訊息。
此值適用於通道類型為傳送端、伺服器、接收端或要求端的通道,且為預設值。
移除
從訊息通道代理程式擷取自傳輸佇列的訊息中移除任何 AMS 保護,並將訊息傳送至友機。
在 MCA 從傳輸佇列取得訊息時,如果已為傳輸佇列定義 AMS 原則,則會套用該原則,以在跨越通道傳送訊息之前從訊息中移除任何 AMS 保護。 如果沒有為傳輸佇列定義 AMS 原則,則會依現狀傳送訊息。
此值僅適用於通道類型為傳送端或伺服器的通道。
作為原則
根據為目標佇列定義的原則,將 AMS 保護套用至入埠訊息,然後再將其放入目標佇列。
在訊息通道代理程式接收入埠訊息時,如果已為目標佇列定義 AMS 原則,則會將 AMS 保護套用至訊息,然後再將訊息放入目標佇列。 如果沒有為目標佇列定義 AMS 原則,則會依現狀將訊息放入目標佇列。
此值僅適用於通道類型為接收端或要求端的通道。
SPLPROT

MCA 頁面

下表列出您可以在「 通道內容 」對話框的 MCA 頁面上設定的內容。 若要配置這個通道的「訊息通道代理程式 (MCA)」的執行方式,請編輯 MCA 頁面上的內容。

內容 意義 MQSC 參數
MCA 使用者 ID 訊息通道代理程式使用者 ID。 如果它不是空白,則它是訊息通道代理程式要用來存取 IBM MQ 資源的使用者 ID,包括(如果 PUTAUT 是 DEF)授權將訊息放置到接收端或要求端通道的目的地佇列。
如果此值空白,則訊息通道代理程式會使用其預設使用者 ID。 預設使用者 ID 衍生自啟動接收端通道的使用者 ID。 可能值包括:
  • [z/OS]z/OS上,由 z/OS 啟動程序表格指派給通道起始程式啟動作業的使用者 ID。
  • 若為 TCP/IP ,若為 z/OS以外的平台,則是 inetd.conf 項目中的使用者 ID ,或啟動接聽器的使用者。
  • 若為 SNA ,若為 z/OS以外的平台,則為 SNA 伺服器項目中的使用者 ID ,若沒有此項目,則為送入的連接要求,或啟動接聽器的使用者。
  • 若為 NetBIOS 或 SPX,為啟動接聽器的使用者 ID。
字串的長度上限為:
  • Windows上的 [Windows]64 個字元。

    對於 CHLTYPEAMQP 的通道,在 IBM MQ 9.2.0 之前,只有長度最多為 12 個字元的使用者 ID 才支援 MCAUSER 使用者 ID 設定。 從 IBM MQ 9.2.0開始,移除 12 個字元的限制。

  • Windows以外的平台上 12 個字元。

[Windows]Windows上,您可以選擇性地使用 user@domain格式的網域名稱來限定使用者 ID。

MCAUSER
MCA 類型 若要指定訊息通道代理程式 (MCA) 當成執行緒來執行,請選取執行緒;若要指定 MCA 當成程序來執行,請選取程序 MCATYPE
MCA 名稱 唯讀。 您不能編輯這個內容,因為 MCA 名稱是保留的,且只能設為空白。 MCANAME

「結束程式」頁面

下表列出您可以在「 通道內容 」對話框的 結束程式 頁面上設定的內容。 若要配置通道來執行使用者結束程式,請編輯結束程式頁面上的內容。

內容 意義 MQSC 參數
傳送結束程式名稱 按一下編輯,開啟「編輯傳送結束程式名稱」對話框。 新增傳送結束程式的名稱:
  • [AIX][Linux]AIX and Linux上,輸入一個以上結束程式的名稱。 所有名稱加在一起的總長度上限為 999 個字元。 請使用格式libraryname(functionname),其中名稱中的字元數上限為 128。
  • [Windows]Windows上,輸入一個以上結束程式的名稱。 所有名稱加在一起的總長度上限為 999 個字元。 請使用格式dllname(functionname),其中名稱中的字元數上限為 128。
  • [IBM i]IBM i上,輸入最多 10 個結束程式的名稱。 請使用格式programname libname,其中 programname 會佔用前 10 個字元,而 libname 則佔用後 10 個字元。 請在較短的名稱結尾新增空格,使其最多達到 10 個字元。
  • [z/OS]z/OS上,輸入最多 8 個結束程式的名稱。 請使用載入模組名稱,其中名稱的字元數上限為 8。
  • 在其他平台上,您只能對每一個通道指定一個傳送結束程式的名稱。
SENDEXIT
傳送結束程式使用者資料 輸入在呼叫傳送結束程式時,要傳給通道傳送結束程式的資料(最多 32 個字元):
  • [AIX、Linux、Windows]AIX, Linux, and Windows上,鍵入一個以上結束程式的資料。 請以逗點區隔資料。 該欄位的總長度上限為 999 個字元。
  • [IBM i]IBM i上,鍵入最多 10 個資料字串,每一個字串的長度為 32 個字元。 資料的第一個字串會傳給第一個傳送結束程式,第二個字串會傳給第二個結束程式,依此類推。
  • [z/OS]z/OS上,鍵入最多 8 個資料字串,每一個字串的長度為 32 個字元。 資料的第一個字串會傳給第一個傳送結束程式,第二個字串會傳給第二個結束程式,依此類推。
  • 在其他平台上,您只能對每一個通道指定一個傳送結束程式資料字串。
SENDDATA
接收結束程式名稱 按一下編輯,開啟「編輯接收結束程式名稱」對話框。 新增接收結束程式的名稱:
  • [AIX][Linux]AIX and Linux上,輸入一個以上結束程式的名稱。 所有名稱加在一起的總字元數上限為 999 個字元。 請使用格式libraryname(functionname),其中字串中的字元數上限為 128。
  • [Windows]Windows上,輸入一個以上結束程式的名稱。 請以逗點區隔名稱。 該欄位的總長度上限為 999 個字元。 請使用格式dllname(functionname),其中字串中的字元數上限為 128。
  • [Windows]Windows上,鍵入最多 10 個結束程式的名稱。 請以逗點區隔名稱。 請使用格式programname libname,其中 programname 會佔用前 10 個字元,而 libname 則佔用後 10 個字元。 請在較短的名稱結尾新增空格,使其最多達到 10 個字元。
  • [z/OS]z/OS上,鍵入最多 8 個結束程式的名稱。 請以逗點區隔名稱。 請使用載入模組名稱,其中的字元數上限為 8。
  • 在其他平台上,您只能對每一個通道指定一個傳送結束程式的名稱。
RCVEXIT
接收結束程式使用者資料 輸入在呼叫接收結束程式時,要傳給通道接收結束程式的資料(最多 32 個字元):
  • [AIX、Linux、Windows]AIX, Linux, and Windows上,鍵入一個以上結束程式的資料。 請以逗點區隔資料。 該欄位的總長度上限為 999 個字元。
  • [IBM i]IBM i上,鍵入最多 10 個資料字串,每一個字串的長度為 32 個字元。 資料的第一個字串會傳給第一個接收結束程式,第二個字串會傳給第二個結束程式,依此類推。
  • [z/OS]z/OS上,鍵入最多 8 個資料字串,每一個字串的長度為 32 個字元。 資料的第一個字串會傳給第一個接收結束程式,第二個字串會傳給第二個結束程式,依此類推。
  • 在其他平台上,您只能對每一個通道指定一個接收結束程式資料字串。
RCVDATA
安全結束程式名稱 輸入安全結束程式的名稱:
  • [AIX、Linux、Windows]AIX, Linux, and Windows上,使用格式libraryname(functionname),其中字串中的字元數上限為 128。
  • [IBM i]IBM i上,使用格式programname libname,其中 programname 會佔用前 10 個字元,而 libname 則佔用後 10 個字元。 請在較短的名稱結尾新增空格,使其最多達到 10 個字元。
  • [z/OS]z/OS上,使用載入模組名稱,其中字元數上限為 8。
SCYEXIT
安全結束程式使用者資料 輸入在呼叫通道安全結束程式時,要傳給通道安全結束程式的資料(最多 32 個字元)。 SCYDATA
訊息結束程式名稱 按一下編輯,開啟「編輯訊息結束程式名稱」對話框。 新增訊息結束程式的名稱:
  • [AIX][Linux]AIX and Linux上,輸入一個以上結束程式的名稱。 所有名稱加在一起的總長度上限為 999 個字元。 請使用格式libraryname(functionname),其中名稱中的字元數上限為 128。
  • [Windows]Windows上,輸入一個以上結束程式的名稱。 所有名稱加在一起的總長度上限為 999 個字元。 請使用格式dllname(functionname),其中名稱中的字元數上限為 128。
  • [IBM i]IBM i上,輸入最多 10 個結束程式的名稱。 請使用格式programname libname,其中 programname 會佔用前 10 個字元,而 libname 則佔用後 10 個字元。 請在較短的名稱結尾新增空格,使其最多達到 10 個字元。
  • [z/OS]z/OS上,輸入最多 8 個結束程式的名稱。 請使用載入模組名稱,其中名稱的字元數上限為 8。
  • 在其他平台上,您只能對每一個通道指定一個訊息結束程式的名稱。
MSGEXIT
訊息結束程式使用者資料 輸入在呼叫通道訊息結束程式時,要傳給通道訊息結束程式的資料(最多 32 個字元):
  • [AIX、Linux、Windows]AIX, Linux, and Windows上,鍵入一個以上結束程式的資料。 請以逗點區隔資料。 該欄位的總長度上限為 999 個字元。
  • [IBM i]IBM i上,鍵入最多 10 個資料字串,每一個字串的長度為 32 個字元。 資料的第一個字串會傳給第一個通道訊息結束程式,第二個字串會傳給第二個結束程式,依此類推。
  • [z/OS]z/OS上,鍵入最多 8 個資料字串,每一個字串的長度為 32 個字元。 資料的第一個字串會傳給第一個通道訊息結束程式,第二個字串會傳給第二個結束程式,依此類推。
  • 在其他平台上,您只能對每一個通道指定一個訊息結束程式資料字串。
MSGDATA

LU6.2 頁面

下表列出您可以在「 通道內容 」對話框的 LU6.2 頁面上設定的內容。 如果通道使用 LU 6.2 傳輸通訊協定,請編輯 LU6.2 頁面上的內容。

內容 意義 MQSC 參數
模式名稱 鍵入 LU 6.2 模式名稱,即 SNA 模式名稱,除非一般頁面上的 Connection name 內容值包含側邊物件,在此情況下,將 Mode name 值保留空白。 長度上限為 8 個字元。 MODENAME
TP 名稱 輸入在鏈結遠端執行之 MCA 程式的名稱或通用名稱。 TPNAME
使用者 ID 輸入在嘗試以遠端 MCA 起始安全 LU 6.2 階段作業時,MCA 會使用的使用者 ID。 長度上限為 12 個字元;不過只會使用前 10 個字元。 使用者 ID
密碼 按一下變更通道密碼,然後在「變更密碼」對話框輸入在嘗試以遠端 MCA 起始安全 LU 6.2 階段作業時,MCA 所使用的密碼。 長度上限為 12 個字元。 PASSWORD

「重試」頁面

下表列出您可以在「 通道內容 」對話框的 重試 頁面上設定的內容。 若要配置當通道無法連接至遠端佇列管理程式時的通道行為方式,請編輯重試頁面上的內容。

內容 意義 MQSC 參數
短重試次數 鍵入通道可以嘗試連接至遠端佇列管理程式的次數上限 (0-999999999) (若為使用 CICSz/OS ,則為 1-999999999)。 SHORTRTY
短重試間隔 輸入通道在短重試次數期間,於重試連接遠端佇列管理程式之前必須等待的大約間隔(秒)。 0 的值表示通道會立即重試。 SHORTTMR
長重試次數 輸入通道可以嘗試連接遠端佇列管理程式的次數上限(0 到 999999999)。 只有在 Short retry count 內容中指定的計數已用盡,且通道仍未順利連接遠端佇列管理程式時,才會使用此內容的值。 LONGRTY
長重試間隔 輸入通道在長重試次數期間,於重試連接遠端佇列管理程式之前必須等待的大約間隔(秒)。 0 的值表示通道會立即重試。 LONGTMR
持續作用間隔 Keep alive interval 內容的值指定通道的逾時值。 若要讓保持作用中值根據協議的活動訊號間隔值而定,請選取自動。 如果協議活動訊號間隔大於零,則 Keep alive interval 是協議活動訊號間隔加 60 秒;如果協議活動訊號間隔為零,則 Keep alive interval 也為零。 若要指定逾時值,請輸入秒數(0 到 99999)。 若要停用這個通道的「保持作用中」,請輸入 0。 KAINT

「訊息重試」頁面

下表列出您可以在「 通道內容 」對話框的 訊息重試 頁面上設定的內容。 若要配置當通道第一次嘗試將訊息放到遠端佇列失敗時的通道行為方式,請編輯訊息重試頁面上的內容。

內容 意義 MQSC 參數
訊息重試次數 輸入通道在決定無法遞送訊息至遠端佇列之前,會重試遞送訊息的次數(0 到 999999999)。 只有在 Message retry exit name 內容為空白時,此內容才會控制 MCA 的動作。 如果 Message retry exit name 內容不是空白,則會將 Message retry count 內容的值傳遞給結束程式供結束程式使用,但通道重試遞送訊息的次數是由結束程式控制,而不是由 Message retry count 內容控制。 MRRTY
訊息重試間隔 輸入在通道可以重試將訊息放到遠端佇列之前,必須等待的時間長度下限(毫秒)。 MRTMR
訊息重試結束程式名稱 輸入通道訊息重試結束程式的名稱:
  • [AIX][Linux]開啟 AIX and Linux,請使用下列格式:libraryname(functionname),其中字串中的字元數上限為 128。
  • [Windows]Windows上,使用格式dllname(functionname),其中字串中的字元數上限為 128。
  • [IBM i]IBM i上,使用格式programname libname,其中 programname 會佔用前 10 個字元,而 libname 會佔用 後 10 個字元。 請在較短的名稱結尾新增空格,使其最多達到 10 個字元。
  • [z/OS]z/OS上,使用載入模組名稱,其中字元數上限為 8。
MRDATA
訊息重試結束程式使用者資料 輸入在呼叫通道訊息重試結束程式時,傳給通道訊息重試結束程式的資料(最多 32 個字元)。 MREXIT

「叢集」頁面

下表列出您可以在「 通道內容 」對話框的 叢集 頁面上設定的內容。 若要在一或多個叢集中共用通道,請編輯叢集頁面上的內容。
附註: 指定目標佇列管理程式中叢集接收端通道上的叢集通道內容。 在相符叢集傳送端通道上指定的任何內容都可能會被忽略。 請參閱 叢集通道
內容 意義 MQSC 參數
在叢集中不共用 預設值會選取這個選項,使得通道不會在任何叢集中共用。 不適用。
在叢集中共用 若要在叢集中共用通道,請選取這個選項,然後輸入叢集的名稱。 請參閱 內容對話框中的字串 CLUSTER
在一列叢集中共用 若要在多個叢集中共用通道,請選取這個選項,然後輸入含有叢集名稱之名稱清單物件的名稱。 請參閱 內容對話框中的字串 CLUSNL
網路優先順序 這個內容的值指出網路連線的通道優先順序。 請輸入 0 到 9 的值;0 是最低優先順序。 請參閱 NETPRTY 通道內容 NETPRTY
CLWL 通道等級 輸入叢集中的通道等級(0 到 9);0 是最低等級。 請參閱 CLWLRANK 通道內容 CLWLRANK
CLWL 通道優先順序 輸入叢集中的通道優先順序(0 到 9);0 是最低優先順序。 請參閱 CLWLPRTY 通道內容 CLWLPRTY
CLWL 通道權重 輸入套用到通道的加權,以便控制透過通道傳送訊息的比率。 這個值必須是 1 到 99;1 是最低加權。 請參閱 CLWLWGHT 通道內容 CLWLWGHT

SSL 頁面

下表列出您可以在「 通道內容 」對話框的 SSL 頁面上設定的內容。 若要配置通道以使用 SSL 安全,請編輯 SSL 頁面上的內容。

內容 意義 MQSC 參數
CertificateLabel 供此通道使用的憑證標籤。 此標籤識別將金鑰儲存庫中的哪個個人憑證傳送至遠端同層級。 如果此內容空白,則由佇列管理程式 CertificateLabel 內容決定憑證。 CERTLABL
CipherSpec 輸入 TLS 連線之 CipherSpec 的名稱(最多 32 個字元)。 IBM MQ SSL 通道定義的兩端必須在 CipherSpec 內容中具有相同的值。 如需相關資訊,請參閱 DEFINE CHANNEL 中的 SSLCIPH 內容

此參數的值也用來設定「安全通訊協定」內容的值,該內容是 通道狀態屬性 頁面上的輸出欄位。

SSLCIPH
鑑別起始連線的雙方 若要指定通道必須接收並鑑別來自 TLS 用戶端的 TLS 憑證,請選取必要;若要指定通道不需要接收並鑑別來自 TLS 用戶端的 TLS 憑證,請選取選用;如果您選取選用,且同層級 TLS 用戶端傳送憑證,則通道會照常鑑別該憑證。 SSLCAUTH
同層級發證者名稱 憑證發證者「識別名稱」過濾器。 此欄位所含「識別名稱」過濾器符合遠端同層級個人憑證的「發證者 DN」。 「同層級發證者名稱」是「SSL 同層級對映」中的索引鍵欄位,亦即,用來符合入埠通道連線的通道權限記錄。 SSLCERTI
只接受識別名稱符合這些值的憑證 輸入來自 IBM MQ 通道另一端同層級佇列管理程式或用戶端的憑證上的「識別名稱」值。 當通道啟動時,此內容的值會與憑證的「識別名稱」進行比較。 SSLPEER
只接受識別名稱符合這些值的憑證 此通道鑑別記錄會將 TLS「識別名稱 (DN)」對映至 MCAUSER 值。 SSLPEERMAP 參數必須由 SSLPEER 隨附。 SSLPEERMAP

「負載平衡」頁面

下表列出您可以在「 通道內容 」對話框的 負載平衡 頁面上設定的內容。

內容 意義 MQSC 參數
權重 用戶端通道加權內容用來指定影響要使用哪一個用戶端連線通道定義的加權。 用戶端通道加權內容是用來當有多個合適的定義可供使用時,可以根據其加權隨機選取用戶端通道定義。

當用戶端發出 MQCONN,並指定以星號開頭的佇列管理程式名稱以要求連線至佇列管理程式群組時,如果用戶端通道定義表 (CCDT) 中有多個合適的通道定義可供使用,則會根據加權隨機選取要使用的定義,其中任何適用的 CLNTWGHT(0) 定義會先選取,並按字母順序排列。 請指定範圍在 0 - 99 的值。 預設值是 0。 0 的值指出未執行負載平衡,並按字母順序選取適用的定義。 若要啟用負載平衡,請選擇範圍在 1 - 99 的值,其中 1 是最低加權,而 99 是最高加權。 在兩個以上具有非零加權的通道之間的訊息分佈,大約與這些加權的比率成比例。

CLNTWGHT
親緣性 通道親緣性內容是用來讓利用同一個佇列管理程式名稱連接多次的用戶端應用程式,可以選擇是否要對每一個連線使用相同的用戶端通道定義。 當有多個適用的通道定義可供使用時,請使用這個內容。 可能值包括:

偏好。 這是預設值。 在程序中讀取用戶端通道定義表 (CCDT) 的第一個連線,會根據用戶端通道加權來建立適用定義的清單,其中加權為 0 的任何定義放在最前面,並按字母順序排列。 程序中的每一個連線都會嘗試使用清單中的第一個定義來連接。 如果連線不成功,則會使用下一個定義。 用戶端通道加權值不是 0 的不成功定義會移至清單的尾端。 用戶端通道加權為 0 的定義會留在清單的開頭,每次連線時都會優先選取。 具有相同主機名稱的每一個用戶端程序都會建立相同的清單。

。 在程序中讀取 CCDT 的第一個連線,會建立適用定義的清單。 程序中的所有連線都會根據用戶端通道加權來選取適用的定義,其中加權為 0 的任何定義會先選取,並按字母順序排列。

AFFINITY

「統計資料」頁面

下表列出您可以在「 通道內容 」對話框的 統計資料 頁面上設定的內容。 若要配置通道來收集監視或統計資料,請編輯統計資料頁面上的內容。

內容 意義 MQSC 參數
變更日期 唯讀。 這是前次變更佇列內容的日期。 ALTDATE
變更時間 唯讀。 這是前次變更佇列內容的時間。 ALTTIME
監視通道 您可以配置 IBM MQ ,以收集通道現行效能的相關線上監視資料。 若要繼承佇列管理程式之 Channel monitoring 內容的值 (請參閱 佇列管理程式內容) ,請按一下 佇列管理程式。 如果佇列管理程式的 Channel monitoring 內容是 None,則會忽略佇列的 Channel monitoring 內容。 如果佇列管理程式的 Channel monitoring 內容不是 None:若要置換佇列管理程式設定並防止收集此通道的資料,請按一下關閉;若要以低速率收集資料,請按一下;若要以中等速率收集資料,請按一下;若要以高速率收集資料,請按一下 MONCHL
通道統計資料 您可以配置 IBM MQ 來收集通道活動的相關統計資料。 若要繼承佇列管理程式之 Channel statistics 內容的值(請參閱佇列管理程式內容),請按一下佇列管理程式。 如果佇列管理程式的 Channel statistics 內容是 None,則會忽略佇列的 Channel statistics 內容。 如果佇列管理程式的 Channel statistics 內容不是 None:若要置換佇列管理程式設定並防止收集此通道的資料,請按一下關閉;若要以低速率收集資料,請按一下;若要以中等速率收集資料,請按一下;若要以高速率收集資料,請按一下 STATCHL