通道內容

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

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

某些屬性並不適用於所有類型的通道:
  • 某些屬性專屬於叢集通道。
  • [z/OS]某些屬性專屬於 z/OS® 通道。

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

「一般」頁面

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

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

叢集傳送端通道:如果您在手動定義之叢集傳送端通道的本端通訊位址欄位中輸入值,在以完整儲存庫佇列管理程式建立通訊時,這個值會被完整儲存庫的叢集接收端通道中的值所改寫。同時在指定手動定義之叢集傳送端通道中的值時,您必須撰寫通道自動定義結束程式,以強制本端通訊位址屬性的值送入任何自動定義的叢集傳送端通道。

叢集接收端通道:除非所有佇列管理程式都位於同一部電腦,否則請勿在叢集接收端通道的本端通訊位址 欄位中放入 IP 位址。這是因為如果任何佇列管理程式嘗試以其叢集接收端通道之本端通訊位址欄位中的 IP 位址連接到某個佇列管理程式,這些值都會傳給其自動定義的叢集傳送端通道。不過,如果您要叢集中的所有佇列管理程式都使用特定的埠或埠範圍來進行其所有的離埠通訊,您可以在叢集接收端通道的本端通訊位址欄位中放入埠號或埠範圍。

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

「延伸事項」頁面

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

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

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

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

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

如果實例數上限設定的值小於伺服器連線通道目前執行中的實例數,則必須等到足夠的現有實例停止執行之後,才會啟動新的實例。

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

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

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

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

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

實例數上限不同於每一用戶端的實例數上限實例數上限是指連線數的上限,但每一用戶端的實例數上限則是指容許每一用戶端連接伺服器的連線數上限。

MAXINSTC
保持作用中間隔 輸入保持作用中間隔的長度(0 到 99999)。如果通道使用了 TCP 或 SPX 以外的傳輸類型,則會忽略這個屬性。「佇列管理程式」內容的「通道」頁面中的TCP 保持作用中屬性必須設為。在 z/OS 佇列管理程式中,保持作用中間隔屬性會指定個別通道的保持作用中間隔。在其他平台的佇列管理程式中,只有在通道連接至 z/OS 佇列管理程式時,才會使用保持作用中間隔屬性;若要使用保持作用中間隔屬性所提供的功能,請將保持作用中間隔屬性設為自動,以使用根據協議的活動訊號間隔值所產生的值。 KAINT
序號折返 序號是透過通道傳送的訊息計數。每次透過通道傳送一則訊息時,序號就會遞增。請鍵入訊息序號達到之後就會從 1 重新開始的最高號碼(100 - 999999999;如果是使用 CICS®z/OS,則為 1 - 999999999)。此值必須足夠大,才不會造成此號碼正在被之前的訊息使用時就又重新發出此號碼。在通道啟動時,通道兩端必須有相同的序號折返值;否則,您會收到錯誤。 SEQWRAP
非持續性訊息速度

若要指定通道上的非持續訊息不會在交易內傳送,請選取快速。這表示擷取非持續訊息會比它是交易的一部分來得快很多。不過,由於非持續訊息不是交易的一部分,如果(比方說)通道在訊息傳輸時停止,訊息可能會遺失。要避免發生這個狀況,請選取正常 NPMSPEED
批次大小 輸入在取得同步點之前要傳送的訊息數上限。訊息一律會個別傳送,但會以批次確定或取消。請嘗試預設批次大小 50,只有在需要時才變更這個值。 BATCHSZ
訊息壓縮 按一下編輯,開啟「編輯訊息壓縮」對話框。請依照喜好的順序選取通道定義支援的訊息壓縮技術。系統會使用通道另一端所支援的第一個技術。表示不執行訊息壓縮;RLE 表示使用執行長度編碼來壓縮訊息資料;ZLIBFAST 表示使用 zlib 壓縮技術來壓縮訊息資料,並偏好快速壓縮;ZLIBHIGH 表示使用 zlib 壓縮技術來壓縮訊息資料,並偏好高階壓縮;ANY 表示可以使用佇列管理程式所支援的任何壓縮技術。如需相關資訊,請參閱 IBM MQ 線上產品說明文件中的分散式佇列及叢集 COMPMSG
標頭壓縮 按一下編輯,開啟「編輯標頭壓縮」對話框。請依照喜好的順序選取通道定義支援的標頭壓縮技術。系統會使用通道另一端所支援的第一個技術。表示不執行標頭壓縮;系統表示執行標頭壓縮。如需相關資訊,請參閱 IBM MQ 線上產品說明文件中的分散式佇列及叢集 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
內容控制

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

這會定義即將傳送給第 6 版以前的佇列管理程式的訊息,其內容會如何處理。該值必須從相容性變更為全部,以保留將 RFH2 傳送給呼叫端的第 6 版行為。可能的值為:

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

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

如果訊息包含字首為 mcd.jms.usr.mqext. 的內容,則所有選用訊息內容(其 Support 值為 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
[V9.0.0.0 Jun 2016]埠號

(僅限 AMQP 通道)

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

(僅限 AMQP 通道)

[V9.0.0.0 Jun 2016]指定將用戶端 ID 用於 AMQP 通道上的連線。設定為 [V9.0.0.0 Jun 2016]USECLTID
[V9.0.0.0 Jun 2016]AMQP 保持作用中

(僅限 AMQP 通道)

[V9.0.0.0 Jun 2016]指定保持作用中時間(以秒為單位)。如果 AMQP 用戶端在保持作用中間隔內未傳送任何訊框,則會因發生 amqp:resource-limit-exceeded AMQP 錯誤狀況而關閉連線。 [V9.0.0.0 Jun 2016]AMQPKA
[V9.0.0.0 Jun 2016]根主題

(僅限 AMQP 通道)

[V9.0.0.0 Jun 2016]指定 AMQP 通道的根主題。使用這個屬性來確保部署到佇列管理程式時,MQ Light 應用程式不會從其他應用程式正使用的主題樹狀結構的區域發佈或訂閱訊息。

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

[V9.0.0.0 Jun 2016]TPROOT

MCA 頁面

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

屬性 意義 MQSC 參數
MCA 使用者 ID 訊息通道代理程式使用者 ID。如果值不是空白,則為訊息通道代理程式要用來授權存取 IBM MQ 資源的使用者 ID,包括(如果 PUTAUT 是 DEF)授權將訊息放置到接收端或要求端通道的目的地佇列。
如果此值空白,則訊息通道代理程式會使用其預設使用者 ID。預設使用者 ID 衍生自啟動接收端通道的使用者 ID。可能的值為:
  • z/OS 上,為 z/OS 啟動程序表指派給通道起始程式啟動作業的使用者 ID。
  • 若為 TCP/IP,除 z/OS 以外,為 inetd.conf 項目中的使用者 ID,或為啟動接聽器的使用者。
  • 若為 SNA,除 z/OS 以外,為 SNA 伺服器項目中的使用者 ID,或在沒有此項目時,為送入的連接要求中的使用者 ID,或為啟動接聽器的使用者。
  • 若為 NetBIOS 或 SPX,為啟動接聽器的使用者 ID。
Windows 上,字串的長度上限為 64 個字元,在其他平台上,上限為 12 個字元。在 Windows 上,您可以選擇性地以 user@domain 格式定義含有網域名稱的使用者 ID。
MCAUSER
MCA 類型 若要指定訊息通道代理程式 (MCA) 當成執行緒來執行,請選取執行緒;若要指定 MCA 當成程序來執行,請選取程序 MCATYPE
MCA 名稱 唯讀。您不能編輯這個屬性,因為 MCA 名稱是保留的,且只能設為空白。 MCANAME

「結束程式」頁面

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

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

LU6.2 頁面

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

屬性 意義 MQSC 參數
模式名稱 輸入 LU 6.2 模式名稱,其是 SNA 模式名稱;但如果一般頁面的連線名稱屬性值含有 side-object,則請將模式名稱值保留空白。長度上限為 8 個字元。 MODENAME
TP 名稱 輸入在鏈結遠端執行之 MCA 程式的名稱或通用名稱。 TPNAME
使用者 ID 輸入在嘗試以遠端 MCA 起始安全 LU 6.2 階段作業時,MCA 會使用的使用者 ID。長度上限為 12 個字元;不過只會使用前 10 個字元。 USERID
密碼 按一下變更通道密碼,然後在「變更密碼」對話框輸入在嘗試以遠端 MCA 起始安全 LU 6.2 階段作業時,MCA 所使用的密碼。長度上限為 12 個字元。 PASSWORD

「重試」頁面

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

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

「訊息重試」頁面

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

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

「叢集」頁面

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

SSL 頁面

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

屬性 意義 MQSC 參數
CertificateLabel 供此通道使用的憑證標籤。此標籤識別將金鑰儲存庫中的哪個個人憑證傳送至遠端同層級。如果此屬性是空白,則由佇列管理程式 CertificateLabel 屬性決定憑證。 CERTLABL
CipherSpec 輸入 TLS 連線之 CipherSpec 的名稱(最多 32 個字元)。IBM MQ SSL 通道定義的兩端都必須有相同的 CipherSpec 屬性值。 SSLCIPH
鑑別起始連線的雙方 若要指定通道必須接收並鑑別來自 TLS 用戶端的 TLS 憑證,請選取必要;若要指定通道不需要接收並鑑別來自 TLS 用戶端的 TLS 憑證,請選取選用;如果您選取選用,且同層級 TLS 用戶端傳送憑證,則通道會照常鑑別該憑證。 SSLCAUTH
同層級發證者名稱 憑證發證者「識別名稱」過濾器。此欄位所含「識別名稱」過濾器符合遠端同層級個人憑證的「發證者 DN」。「同層級發證者名稱」是「SSL 同層級對映」中的索引鍵欄位,亦即,用來符合入埠通道連線的通道權限記錄。 SSLCERTI
只接受識別名稱符合這些值的憑證 鍵入來自同層級佇列管理程式或 IBM MQ 通道另一端之用戶端的憑證上「識別名稱」的值。當通道啟動時,這個屬性的值會與憑證的「識別名稱」相比較。 SSLPEER
只接受識別名稱符合這些值的憑證 此通道鑑別記錄會將 TLS「識別名稱 (DN)」對映至 MCAUSER 值。SSLPEERMAP 參數必須由 SSLPEER 隨附。 SSLPEERMAP
安全通訊協定 通道上目前使用中的安全通訊協定。此值可以是 NONE、TLSV1 或 TLSV12。 SECPROT

「負載平衡」頁面

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

屬性 意義 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 來收集關於通道現行效能的連線監視資料。若要繼承佇列管理程式之通道監視屬性的值(請參閱佇列管理程式內容),請按一下佇列管理程式。如果佇列管理程式的通道監視屬性為,則會忽略佇列的通道監視屬性。如果佇列管理程式的通道監視屬性不是:若要置換佇列管理程式的設定,且不要收集這個通道的資料,請按一下關閉;若要以低速率收集資料,請按一下;若要以中速率收集資料,請按一下;若要以高速率收集資料,請按一下 MONCHL
通道統計資料 您可以配置 IBM MQ 來收集關於通道活動的統計資料。若要繼承佇列管理程式之通道統計資料屬性的值(請參閱「佇列管理程式」內容),請按一下佇列管理程式。如果佇列管理程式的通道統計資料屬性為,則會忽略佇列的通道統計資料屬性。如果佇列管理程式的通道統計資料屬性不是,若要置換佇列管理程式的設定,且不要收集這個通道的資料,請按一下關閉;若要以低速率收集資料,請按一下;若要以中速率收集資料,請按一下;若要以高速率收集資料,請按一下 STATCHL

參考 參考

反饋

「時間戳記」圖示 前次更新時間: 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_channels.htm