ALTER QMGR

請使用 MQSC 指令 ALTER QMGR 來變更本端佇列管理程式的佇列管理程式參數。

使用 MQSC 指令

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

未在 ALTER QMGR 指令中指定的參數會導致那些參數的現有值保持不變。

您可以從來源 2CR 發出此指令。 如需來源符號的說明,請參閱 z/OS®上使用指令

此資訊分為三個區段:

ALTER QMGR

同義字: ALT QMGR
讀取語法圖跳過視覺化語法圖 ALTER QMGR 佇列管理程式屬性FORCECMDSCOPE(' ')CMDSCOPE(qmgr-name)1CMDSCOPE(*)12
佇列管理程式屬性
讀取語法圖跳過視覺化語法圖ACCTCONO(DISABLEDENABLED)3ACCTINT(整數)3ACCTMQI(OFFON)3ACCTQ(OFFONNONE)ACTCHL(整數)2ACTIVREC(DISABLEDMSGQUEUE)ACTVCONO(DISABLEDENABLED)3ACTVTRC(OFFON)3ADOPTCHK(ALLNETADDRNONEQMNAME)2ADOPTMCA(ALLNO)2AUTHOREV(DISABLEDENABLED3)BRIDGEEV(DISABLEDENABLED)2CCSID(整數)3CERTLABL(字串)CERTQSGL(字串)1CERTVPOL(ANYRFC5280)4CFCONLOS(TERMINATETOLERATE)2CHAD(DISABLEDENABLED)3CHADEV(DISABLEDENABLED)3CHADEXIT(字串)CHIADAPS(整數)2CHIDISPS(整數)2CHISERVP(字串)2CHLAUTH(DISABLEDENABLED)CHLEV(DISABLEDENABLEDEXCEPTION)CLWLDATA(字串)CLWLEXIT(字串)CLWLLEN(整數)CLWLMRUC(整數)CLWLUSEQ(LOCALANY)CMDEV(DISABLEDENABLEDNODISPLAY)CONFIGEV(DISABLEDENABLED)CONNAUTH(字串)CUSTOM(字串)DEADQ(字串)DEFXMITQ(字串)DEFCLXQ(SCTQCHANNEL)DESCR(字串)DNSGROUP(字串)2DNSWLM(NO)2EXPRYINT(OFF整數)GROUPUR(DISABLEDENABLED)2IGQ(DISABLEDENABLED)2IGQAUT(DEFCTXONLYIGQALTIGQ)2IGQUSER(字串)2INHIBTEV(DISABLEDENABLED)IMGINTVL(60OFF)3IMGLOGLN(OFF整數)3IMGRCOVO(YESNO)3IMGRCOVQ(YESNO)3IMGSCHED(MANUALAUTO)3IPADDRV(IPV4IPV6)LOCALEV(DISABLEDENABLED)LOGGEREV(DISABLEDENABLED)3LSTRTMR(整數)2LUGROUP(字串)2LUNAME(字串)2LU62ARM(字串)2LU62CHL(整數)2MARKINT(整數NOLIMIT)MAXCHL(整數)2MAXHANDS(整數)MAXMSGL(整數)3MAXPROPL(整數NOLIMIT)MAXUMSGS(整數)MONACLS(QMGROFFLOWMEDIUMHIGH)MONCHL(OFFNONELOWMEDIUMHIGH)MONQ(OFFNONELOWMEDIUMHIGH)OPORTMAX(整數)2OPORTMIN(整數)2PARENT(字串)PERFMEV(DISABLEDENABLED)PSCLUS(ENABLEDDISABLED)PSMODE(ENABLEDCOMPATDISABLED)PSNPMSG(DISCARDKEEP)PSNPRES(NORMALSAFEDISCARDKEEP)PSRTYCNT(integer)PSSYNCPT(YESIFPER)RCVTIME(整數)2RCVTMIN(整數)2RCVTTYPE(MULTIPLYADDEQUAL)2REMOTEEV(DISABLEDENABLED)REPOS(ClusterName)REPOSNL(nlname)REVDNS(ENABLEDDISABLED)ROUTEREC(DISABLEDMSGQUEUE)SCHINIT(QMGRMANUAL)3SCMDSERV(QMGRMANUAL)3SCYCASE(UPPERMIXED)2SQQMNAME(USEIGNORE)2SSLCRLNL(nlname)SSLCRYP(字串)4SSLEV(DISABLEDENABLED)SSLFIPS(NOYES)5SSLKEYR(字串)SSLRKEYC(整數)SSLTASKS(整數)2STATACLS(QMGROFFLOWMEDIUMHIGH)STATCHL(NONEOFFLOWMEDIUMHIGH)STATINT(整數)3STATMQI(OFFON)3STATQ(OFFONNONE)3STRSTPEV(ENABLEDDISABLED)SUITEB(NONE128_BIT192_BIT128_BIT,192_BIT)4TCPCHL(整數)2TCPKEEP(NOYES)2TCPNAME(字串)2TCPSTACK(SINGLEMULTIPLE)2TRAXSTR(YESNO)2TRAXTBL(整數)2TREELIFE(整數)TRIGINT(整數)
附註:
  • 1 只有當佇列管理程式是佇列共用群組的成員時,才適用於 z/OS
  • 2 僅適用於 z/OS
  • 3z/OS上無效。
  • 4 僅適用於 UNIX, Linux®, and Windows
  • 5IBM® i上無效。

ALTER QMGR 的參數說明

您指定的參數會置換現行值。 您未指定的屬性保持不變。
附註:
  1. 如果您未指定任何參數,則指令會順利完成,但不會變更任何佇列管理程式選項。
  2. 當佇列管理程式停止並重新啟動時,使用這個指令所做的變更會持續保存。
強制
如果下列兩個陳述式都成立,則指定此參數可強制完成指令:
  • 已指定 DEFXMITQ 參數
  • 應用程式已開啟遠端佇列,其解決方案將受到此變更的影響

如果在這些情況下未指定 FORCE ,則指令不成功。

佇列管理程式參數

這些參數是 ALTER QMGR 指令的佇列管理程式參數:
[UNIX、Linux、Windows、IBM i]ACCTCONO
指定應用程式是否可以置換 ACCTQACCTMQI 佇列管理程式參數的設定:
已停用
應用程式無法置換 ACCTQACCTMQI 參數的設定。

這是佇列管理程式的起始預設值。

ENABLED
應用程式可以使用 MQCONNX API 呼叫 MQCNO 結構的選項欄位,來置換 ACCTQACCTMQI 參數的設定。

對此參數所進行的變更,只對變更之後建立的佇列管理程式連線有效。

此參數僅適用於 Multiplatforms

[UNIX、Linux、Windows、IBM i]ACCTINT (整數)
寫入中間統計記錄的時間間隔 (秒)。

請指定 1 到 604800 範圍內的值。

對此參數所進行的變更,只對變更之後建立的佇列管理程式連線有效。

此參數僅適用於 Multiplatforms

[UNIX、Linux、Windows、IBM i]ACCTMQI
指定是否要收集 MQI 資料的帳戶資訊:
OFF
已停用 MQI 結算資料收集。

這是佇列管理程式的起始預設值。

開啟
已啟用 MQI 結算資料收集。

如果佇列管理程式屬性 ACCTCONO 設為 ENABLED,則可以使用 MQCNO 結構的選項欄位來置換此參數的值。

對此參數所進行的變更,只對變更之後建立的佇列管理程式連線有效。

此參數僅適用於 Multiplatforms

ACCTQ
指定是否要收集所有佇列的帳戶資料。

[z/OS]z/OS上,收集的資料是類別 3 結算資料 (執行緒層次及佇列層次結算)。

OFF
對於指定 QMGR 作為其 ACCTQ 參數值的所有佇列,會停用結算資料收集。
開啟
針對指定 QMGR 作為其 ACCTQ 參數值的所有佇列,啟用結算資料收集。
[z/OS]z/OS 系統上,您必須使用 START TRACE 指令來開啟類別 3 統計作業。
不論佇列的 ACCTQ 參數值為何,都會停用所有佇列的結算資料收集。

此參數的變更僅對在參數變更之後發生的佇列管理程式連線有效。

[z/OS]ACTCHL (整數)
任何時間都可以 作用中 的通道數上限,除非該值減少到低於目前作用中通道數。

請指定 1 到 9999 之間的值,且不大於 MAXCHL的值。 MAXCHL 定義可用的通道數目上限。

如果您變更此值,則還必須檢閱 MAXCHLLU62CHLTCPCHL 值,以確保值沒有衝突

如需哪些通道狀態被視為作用中的說明; 請參閱 通道狀態

起始設定通道起始程式時,如果 ACTCHL 的值減少至小於其值,通道會繼續執行,直到停止為止。 當執行中通道數低於 ACTCHL值時,可以啟動更多通道。 當起始設定通道起始程式時,將 ACTCHL 的值增加到超過其值,並不會立即生效。 ACTCHL 的較高值會在下一次通道起始程式重新啟動時生效。

共用交談不會影響此參數的總計。

此參數僅在 z/OS上有效。

ACTIVREC
指定如果在訊息中要求,是否產生活動報告:
已停用
未產生活動報告。
MSG
在造成報告的訊息中,會產生活動報告並傳送至發送端指定的回覆佇列。

這是佇列管理程式的起始預設值。

佇列
活動報告已產生並傳送至 SYSTEM.ADMIN.ACTIVITY.QUEUE
請參閱 活動記錄
[UNIX、Linux、Windows、IBM i]ACTVCONO
指定應用程式是否可以置換 ACTVTRC 佇列管理程式參數的設定:
已停用
應用程式無法置換 ACTVTRC 佇列管理程式參數的設定。

這是佇列管理程式的起始預設值。

ENABLED
應用程式可以使用 MQCONNX API 呼叫之 MQCNO 結構的選項欄位,來置換 ACTVTRC 佇列管理程式參數的設定。

對此參數所進行的變更,只對變更之後建立的佇列管理程式連線有效。

此參數僅適用於 Multiplatforms

[UNIX、Linux、Windows、IBM i]ACTVTRC
指定是否收集 MQI 應用程式活動追蹤資訊。 請參閱 設定 ACTVTRC 以控制活動追蹤資訊的收集
OFF
IBM MQ 未啟用 MQI 應用程式活動追蹤資訊收集。

這是佇列管理程式的起始預設值。

開啟
IBM MQ 已啟用 MQI 應用程式活動追蹤資訊收集。

如果佇列管理程式屬性 ACTVCONO 設為 ENABLED,則可以使用 MQCNO 結構的選項欄位來置換此參數的值。

對此參數所進行的變更,只對變更之後建立的佇列管理程式連線有效。

此參數僅適用於 Multiplatforms

[z/OS]ADOPTCHK
指定要檢查哪些元素來決定是否採用 MCA。 當偵測到與作用中 MCA 同名的新入埠通道時,即會進行檢查。
ALL
請檢查佇列管理程式名稱及網址。 請執行此檢查,以防止您的通道意外或惡意關閉。

這是佇列管理程式的起始預設值。

NETADDR
請檢查網址。
不檢查。
QMNAME
請檢查佇列管理程式名稱。

此參數的變更會在下次通道嘗試採用 MCA 時生效。

此參數僅在 z/OS上有效。

[z/OS]ADOPTMCA
指定當偵測到符合 ADOPTCHK 參數的新入埠通道要求時, MCA 的孤立實例是否立即重新啟動:
ALL
採用所有通道類型。

這是佇列管理程式的起始預設值。

NO
不需要採用孤立通道。

此參數的變更會在下次通道嘗試採用 MCA 時生效。

此參數僅在 z/OS上有效。

AUTHOREV
指定是否產生授權 (未獲授權) 事件:
已停用
不會產生授權事件。

這是佇列管理程式的起始預設值。

ENABLED
會產生授權事件。

[z/OS] z/OS不支援此值。

[z/OS]BRIDGEEV
指定是否產生 IMS 橋接器事件。
已停用
不會產生 IMS 橋接器事件。

這是佇列管理程式的起始預設值。

ENABLED
會產生所有 IMS 橋接器事件。

此參數僅在 z/OS上有效。

[UNIX、Linux、Windows、IBM i]CCSID (整數)
佇列管理程式的編碼字集 ID。 CCSID 是與 API 定義的所有字串欄位一起使用的 ID。 如果訊息描述子中的 CCSID 設為值 MQCCSI_Q_MGR,則該值會套用至訊息內文中的應用程式資料。 當訊息放入佇列時,會設定此值。

請指定 1 到 65535 範圍內的值。 CCSID 指定定義在平台上使用的值,並使用適合平台的字集。

如果使用此參數來變更 CCSID,則套用變更時正在執行的應用程式,仍會繼續使用原始 CCSID。 因此,請先停止並重新啟動所有執行中的應用程式,然後再繼續包括指令伺服器及通道程式。 若要停止並重新啟動所有執行中的應用程式,請在變更參數值之後停止並重新啟動佇列管理程式。

此參數僅適用於 Multiplatforms。 如需每一個平台所支援 CCSID 的詳細資料,請參閱 字碼頁轉換

[z/OS]若要在 z/OS上執行對等作業,請使用 CSQ6SYSP 來設定系統參數。

CERTLABL
此佇列管理程式要使用的憑證標籤。 標籤可識別已選取金鑰儲存庫中的哪個個人憑證。
預設及已移轉的佇列管理程式值如下:
  • [UNIX、Linux、Windows]UNIX, Linux, and Windows上: ibmwebspheremqxxxx ,其中 xxxx 是轉換成小寫的佇列管理程式名稱。
  • [IBM i]開啟 IBM i:
    • 如果您指定 SSLKEYR (*SYSTEM) ,則值為空白。

      請注意,禁止將非空白佇列管理程式 CERTLABL 與 SSLKEYR (*SYSTEM) 搭配使用。 嘗試這樣做會導致 MQRCCF_Q_MGR_ATTR_CONFLICT 錯誤。

    • 否則, ibmwebspheremqxxxx ,其中 xxxx 是轉換成小寫的佇列管理程式名稱。
  • [z/OS]z/OS上: ibmWebSphereMQXXXX ,其中 XXXX 是佇列管理程式名稱。

    如需相關資訊,請參閱 z/OS 系統

您應該指定之前的值。 不過,系統會將 CERTLABL 保留為佇列管理程式上的空白值,以表示指定的預設值。

重要事項: 如果您對佇列管理程式上的 CERTLABL 進行任何變更,則必須執行 REFRESH SECURITY TYPE (SSL) 指令。 不過,如果您在通道上對 CERTLABL 進行任何變更,則不需要執行 REFRESH SECURITY TYPE (SSL) 指令。
[z/OS]CERTQSGL
佇列共用群組 (QSG) 憑證標籤。

如果佇列管理程式是 QSG 的成員,則此參數優先於 CERTLABL

此參數的預設值為 ibmWebSphereMQXXXX ,其中 XXXX 是佇列共用群組名稱。

此參數僅在 z/OS上有效。

如需相關資訊,請參閱 z/OS 系統

[UNIX、Linux、Windows、IBM i]CERTVPOL
指定使用哪個 TLS 憑證驗證原則來驗證從遠端夥伴系統收到的數位憑證。 此屬性可用來控制憑證鏈驗證符合業界安全標準的嚴格程度。
ANY
套用 Secure Socket Library 所支援的每一個憑證驗證原則,並接受憑證鏈 (如果有任何原則認為憑證鏈有效的話)。 此設定可用於與不符合現代憑證標準的舊數位憑證的最大舊版相容性。
RFC5280
僅套用 RFC 5280 相容憑證驗證原則。 此設定提供比 ANY 設定更嚴格的驗證,但拒絕部分較舊的數位憑證。

如需憑證驗證原則的相關資訊,請參閱 IBM MQ中的憑證驗證原則

只有在發出 REFRESH SECURITY TYPE(SSL) 指令之後,參數的變更才會生效。

此參數僅適用於 Multiplatforms

[z/OS]CFCONLOS
指定當佇列管理程式失去與管理結構或任何 CF 結構 ( CFCONLOS 設為 ASQMGR) 的連線功能時要採取的動作。
TERMINATE
佇列管理程式會在與 CF 結構的連線中斷時終止。
容許
佇列管理程式可容忍在不終止的情況下失去與 CF 結構的連線功能。

佇列共用群組中的所有佇列管理程式必須為 710 或更高的指令層次,且 OPMODE 必須設為 NEWFUNC ,才能選取 TOLERATE

此參數僅在 z/OS上有效。

[UNIX、Linux、Windows、IBM i]CHAD
指定是否可以自動定義接收端和伺服器連線通道:
已停用
不使用自動定義。

這是佇列管理程式的起始預設值。

ENABLED
使用自動定義。

不論此參數的設定為何,一律可以自動定義叢集傳送端通道。

此參數僅適用於 Multiplatforms

[UNIX、Linux、Windows、IBM i]CHADEV
指定是否產生通道自動定義事件。
已停用
不會產生自動定義事件。

這是佇列管理程式的起始預設值。

ENABLED
會產生自動定義事件。

此參數僅適用於 Multiplatforms

CHADEXIT (string)
自動定義結束程式名稱。

如果這個名稱不是空白,當收到未定義之接收端、伺服器連線或叢集傳送端通道的入埠要求時,會呼叫這個結束程式。 當啟動叢集接收端通道時,也會呼叫它。

名稱的格式和長度上限取決於環境:
  • [UNIX][Linux]UNIX and Linux上,其格式為 libraryname (functionname)。 長度上限為 128 個字元。
  • [Windows]Windows上,其格式為 dllname (functionname) ,其中指定的 dllname 沒有字尾 .DLL。 長度上限為 128 個字元。
  • [IBM i]IBM i上,它的格式如下:
    
    progname libname
    
    其中 程式名稱 會佔用前 10 個字元,而 libname 則佔用後 10 個字元 (必要的話,兩者都以空白填補右邊)。 字串的長度上限為 20 個字元。
  • [z/OS]z/OS上,它是載入模組名稱,長度上限為 8 個字元。

[z/OS]z/OS上, CHADEXIT 參數僅適用於叢集傳送端和叢集接收端通道。

[z/OS]CHIADAPS (整數)
用於處理 IBM MQ 呼叫的通道起始程式配接卡子作業數目。
請指定 0-9999 範圍內的值。 建議的設定如下:
  • 測試系統: 8
  • 正式作業系統: 30

這個參數的變更會在重新啟動通道起始程式時生效。

如需 CHIADAPSCHIDISPSMAXCHL之間關係的相關資訊,請參閱 作業 18: 自訂通道起始程式參數

此參數僅在 z/OS上有效。

[z/OS]CHIDISPS ( integer )
要在通道起始程式中使用的分派器數目。
請指定 1 到 9999 範圍內的值。 建議的設定如下:
  • 測試系統: 5
  • 正式作業系統: 20

這個參數的變更會在重新啟動通道起始程式時生效。

如需 CHIADAPSCHIDISPSMAXCHL之間關係的相關資訊,請參閱 作業 18: 自訂通道起始程式參數

此參數僅在 z/OS上有效。

[z/OS]CHISERVP
此參數僅保留給 IBM 使用; 它不適用於一般用途。

此參數僅在 z/OS上有效。

CHLAUTH
指定是否使用通道鑑別記錄所定義的規則。 不論此屬性的值為何,仍可以設定及顯示 CHLAUTH 規則。

此參數的變更會在下次入埠通道嘗試啟動時生效。 目前啟動的通道不受此參數的變更影響。

已停用
不檢查通道鑑別記錄。
ENABLED
會檢查通道鑑別記錄。
CHLEV
指定是否產生通道事件。
已停用
不會產生通道事件。 這是佇列管理程式的起始預設值。
ENABLED
會產生所有通道事件。
異常狀況
會產生所有異常狀況通道事件。
CLWLDATA (string)
叢集工作量結束程式資料。 字串的長度上限為 32 個字元。

當呼叫此字串時,會將它傳遞至叢集工作量結束程式。

CLLEXIT (string)
叢集工作量結束程式名稱。
如果此名稱不是空白,則會在將訊息放入叢集佇列時呼叫結束程式。 名稱的格式和長度上限取決於環境:
  • [UNIX][Linux]UNIXLinux上,其格式為 libraryname (functionname)。 長度上限為 128 個字元。
  • [Windows]Windows上,它的格式為 dllname (functionname),其中指定的 dllname 沒有字尾 .DLL。 長度上限為 128 個字元。
  • [z/OS]z/OS上,它是載入模組名稱。 長度上限為 8 個字元。
  • [IBM i]IBM i上,它的格式如下:
    
    progname libname
    
    其中 程式名稱 會佔用前 10 個字元,而 libname 則佔用後 10 個字元 (必要的話,兩者都以空白填補右邊)。 長度上限為 20 個字元。
CLWLLEN (integer)
傳遞至叢集工作量結束程式的訊息資料位元組數上限。
指定範圍內的值:
  • [UNIX、Linux、Windows] UNIX, Linux, and Windows上的 0-999,999,999。
  • [IBM i] IBM i上的 0-999,999,999。
  • z/OS 系統上的 [z/OS]0-100 MB。
CLWLMRUC (integer)
最近使用的出埠叢集通道數上限。

請指定 1 到 999,999,999 範圍內的值。

請參閱 CLWLMRUC 佇列管理程式屬性

CLWLUSEQ
此屬性適用於佇列屬性 CLWLUSEQ 設為 QMGR的佇列。 它指定當目標佇列具有本端實例及至少一個遠端叢集實例時, MQPUT 作業的行為。 如果 MQPUT 源自叢集通道,則不適用。
指定下列任一項:
本端
本端佇列是 MQPUT 作業的唯一目標。

這是佇列管理程式的起始預設值。

ANY
基於工作量配送的目的,佇列管理程式會將本端佇列視為叢集佇列的另一個實例。

請參閱 CLWLUSEQ 佇列管理程式屬性

CMDEV
指定是否產生指令事件:
已停用
不會產生指令事件。

這是佇列管理程式的起始預設值。

ENABLED
所有成功指令都會產生指令事件。
NoDisplay
會針對 DISPLAY 指令以外的所有成功指令產生指令事件。
[z/OS]CMDSCOPE
指定在佇列管理程式隸屬於佇列共用群組時如何執行此指令。
'
指令在輸入它的佇列管理程式上執行。
佇列管理程式-名稱
指令會在您指定的佇列管理程式上執行,前提是佇列管理程式在佇列共用群組內處於作用中。

您可以指定不同的佇列管理程式。 如果您使用佇列共用群組環境,且已啟用指令伺服器,則可以這麼做。 然後,您可以指定與輸入指令所在佇列管理程式不同的佇列管理程式。

*

指令在本端佇列管理程式上執行,也會傳遞至佇列共用群組中的每個作用中佇列管理程式。 輸入此值的效果與在佇列共用群組中的每個佇列管理程式上輸入指令相同。

此參數僅在 z/OS上有效。

CONFIGEV
指定是否產生配置事件:
ENABLED
會產生配置事件。 設定此值之後,請針對所有物件發出 REFRESH QMGR TYPE(CONFIGEV) 指令,讓佇列管理程式配置保持最新。
已停用
不會產生配置事件。

這是佇列管理程式的起始預設值。

CONNAUTH
鑑別資訊物件的名稱,用來提供使用者 ID 和密碼鑑別的位置。 如果 CONNAUTH 為空白,則佇列管理程式不會執行任何使用者 ID 及密碼檢查。 字串的長度上限為 MQ_AUTH_INFO_NAME_LENGTH
只能指定類型為 IDPWOS 或 IDPWLDAP 的鑑別資訊物件; 在下列情況下,其他類型會導致錯誤訊息:
  • [UNIX、Linux、Windows、IBM i]OAM 會讀取 Multiplatforms上的配置。
  • [z/OS]安全元件會讀取 z/OS上的配置。
對這個配置或它所參照的物件所做的變更,會在發出 REFRESH SECURITY TYPE(CONNAUTH) 指令時生效。
如果您將 CONNAUTH 保留空白,並嘗試連接至在 CHCKCLNT 欄位中設定了下列其中一個選項的通道,則連線會失敗:
  • [UNIX、Linux、Windows、IBM i]REQDADM
  • [z/OS]必要
CUSTOM (string)
新特性的自訂屬性。

在引進具名屬性之前,此屬性保留用於新特性的配置。 它可以包含零個以上屬性的值作為屬性名稱與值的配對,以至少一個空格區隔。 屬性名稱/值配對的格式為 NAME(VALUE。 使用另一個單引號來跳出單引號。

未定義 Custom的值。

DEADQ (string)
無法傳送郵件的佇列 (或無法遞送的訊息佇列) 的本端名稱,其中會放置無法遞送至其正確目的地的訊息。

指名的佇列必須是本端佇列; 請參閱 IBM MQ 物件的命名規則

DEFCLXQ
DEFCLXQ 屬性控制依預設由叢集傳送端通道選取要從中取得訊息,以將訊息傳送至叢集接收端通道的傳輸佇列。
Sctq

所有叢集傳送端通道都會從 SYSTEM.CLUSTER.TRANSMIT.QUEUE 傳送訊息。 放置在傳輸佇列上的訊息的 correlID,可識別該訊息的目的地是哪一個叢集傳送端通道。

SCTQ在定義佇列管理程式時會設定 。 在 IBM WebSphere® MQ 7.5之前的版本中,此行為是隱含的。 在舊版中,佇列管理程式屬性 DEFCLXQ 不存在。

CHANNEL
每個叢集傳送端通道會從不同的傳輸佇列傳送訊息。 每一個傳輸佇列都會從模型佇列 SYSTEM.CLUSTER.TRANSMIT.MODEL.QUEUE 建立為永久動態佇列。

如果佇列管理程式屬性 DEFCLXQ設為 CHANNEL,則預設配置會變更為與個別叢集傳輸佇列相關聯的叢集傳送端通道。 傳輸佇列是從模型佇列 SYSTEM.CLUSTER.TRANSMIT.MODEL.QUEUE建立的永久動態佇列。 每個傳輸佇列與一個叢集傳送端通道相關聯。 當一個叢集傳送端通道為某個叢集傳輸佇列提供服務時,傳輸佇列只包含一個叢集中的一個佇列管理程式的訊息。 您可以配置叢集,使某個叢集中的每個佇列管理程式都只包含一個叢集佇列。 在此情況下,從一個佇列管理程式到每個叢集佇列的訊息資料流量將與其他佇列的訊息分開傳送。

DEFXMITQ (string)
預設傳輸佇列的本端名稱,其中會放置以遠端佇列管理程式為目的地的訊息。 如果未定義其他適當的傳輸佇列,則會使用預設傳輸佇列。

叢集傳輸佇列不得用作佇列管理程式的預設傳輸佇列。

名稱為的佇列必須是本端傳輸佇列; 請參閱 IBM MQ 物件的命名規則

DESCR (string)
純文字註解。 它提供佇列管理程式的敘述性資訊。

它只包含可顯示的字元。 字串的長度上限為 64 個字元。 在 DBCS 安裝中,可以包含 DBCS 字元(但需符合 64 個位元組的長度上限)。

如果敘述性資訊中的字元是在此佇列管理程式的編碼字集 ID (CCSID) 中,則會正確地轉換它們。 當敘述性資訊傳送至另一個佇列管理程式時,會轉換它們。 如果它們不在此佇列管理程式的 CCSID 中,則它們可能翻譯不正確。

[z/OS]DNSGROUP (string)
此參數已不再使用。 請參閱 z/OS: 不再支援 WLM/DNS
[z/OS]DNSWLM
此參數已不再使用。 請參閱 z/OS: 不再支援 WLM/DNS
NO
此值是唯一接受的值。
[z/OS]EXPRYINT
指定掃描佇列以捨棄過期訊息的頻率:
OFF
未掃描佇列。 未執行內部期限處理程序。
整數
掃描佇列的大約間隔 (秒)。 每次達到到期間隔時,佇列管理程式會尋找值得掃描的候選佇列,以捨棄過期訊息。

佇列管理程式會維護每一個佇列上過期訊息的相關資訊,因此是否值得掃描過期訊息。 因此,隨時只會掃描選取的佇列。

該值必須在 1 到 99999999 的範圍內。 使用的掃描間隔下限為 5 秒,即使您指定較低的值也一樣。

對於佇列共用群組內支援此屬性的所有佇列管理程式,您必須設定相同的 EXPRYINT 值。 共用佇列只會由佇列共用群組中的一個佇列管理程式掃描。 此佇列管理程式是要重新啟動的第一個佇列管理程式,或為其設定「 EXPRYINT 」的第一個佇列管理程式。

EXPRYINT 的變更會在現行間隔到期時生效。 如果新間隔小於現行間隔的未過期部分,則變更也會生效。 在此情況下,會排定掃描,且新的間隔值會立即生效。

此參數僅在 z/OS上有效。

[z/OS]GROUPUR
此參數控制 CICS® 及 XA 用戶端應用程式是否可以建立具有 GROUP 單元回復處置的交易。
只有在佇列管理程式是佇列共用群組的成員時,才能啟用此內容。
ENABLED
CICS 和 XA 用戶端應用程式可以在連接時指定佇列共用群組名稱,以建立具有群組回復單元處置的交易。
已停用
CICS 和 XA 用戶端應用程式必須使用佇列管理程式名稱來連接。

此參數僅在 z/OS上有效。

[z/OS]IGQ
指定是否使用內部群組佇列作業。

只有在佇列管理程式是佇列共用群組的成員時, IGQ 參數才在 z/OS 上有效。

ENABLED
佇列共用群組內佇列管理程式之間的訊息傳送會使用共用傳輸佇列 SYSTEM.QSG.TRANSMIT.QUEUE
已停用
佇列共用群組內佇列管理程式之間的訊息傳送會使用非共用傳輸佇列及通道。 不屬於佇列共用群組的佇列管理程式也會使用此機制。
如果已啟用內部群組佇列作業,但已停止內部群組佇列作業代理程式,請使用下列指令來重新啟動它:
ALTER QMGR IGQ(ENABLED)

此參數僅在 z/OS上有效。

[z/OS]IGQAUT
指定權限檢查的類型,因此指定 IGQ 代理程式 (IGQA) 要使用的使用者 ID。 此參數會建立將訊息放入目的地佇列的權限。

只有在佇列管理程式是佇列共用群組的成員時, IGQAUT 參數才在 z/OS 上有效。

DEF
指出使用預設使用者 ID 來建立將訊息放入目的地佇列的權限。

對於一個使用者 ID 檢查,預設使用者 ID 是佇列共用群組內佇列管理程式的使用者 ID。 預設使用者 ID 是將訊息放置到 SYSTEM.QSG.TRANSMIT.QUEUE之佇列管理程式的使用者 ID。 此使用者 ID 稱為 QSGSEND 使用者 ID。

對於兩個使用者 ID 檢查,預設第二個使用者 ID 是 IGQ 使用者 ID。

CTX
指出使用 UserIdentifier 欄位中的使用者 ID 來建立將訊息放入目的地佇列的權限。 使用者 ID 是 SYSTEM.QSG.TRANSMIT.QUEUE上訊息的訊息描述子中的 UserIdentifier 欄位。

對於某個使用者 ID 檢查,會使用 QSGSEND 使用者 ID。

對於兩個使用者 ID 檢查,會使用 QSGSEND 使用者 ID、 IGQ 使用者 ID 及替代使用者 ID。 替代使用者 ID 是從 SYSTEM.QSG.TRANSMIT.QUEUE上訊息的訊息描述子中的 UserIdentifier 欄位取得。 替代使用者 ID 稱為 ALT

ONLYIGQ
指出僅使用 IGQ 使用者 ID 來建立將訊息放置到目的地佇列的權限。

對於所有 ID 檢查,會使用 IGQ 使用者 ID。

ALTIGQ
指出使用 IGQ 使用者 ID 和 ALT 使用者 ID 來建立將訊息放入目的地佇列的權限。

對於某個使用者 ID 檢查,會使用 IGQ 使用者 ID。

對於兩項使用者 ID 檢查,會使用 IGQ 使用者 ID 和 ALT 使用者 ID。

此參數僅在 z/OS上有效。

[z/OS]IGQUSER
提名 IGQ 代理程式 (IGQA) 要使用的使用者 ID ,以建立將訊息放入目的地佇列的權限。 使用者 ID 稱為 IGQ 使用者 ID。
只有在佇列管理程式是佇列共用群組的成員時,此參數才在 z/OS 上有效。 可能的值為:
空白
指出使用佇列共用群組內接收端佇列管理程式的使用者 ID。
特定使用者 ID
指出使用接收端佇列管理程式的 IGQUSER 參數中指定的使用者 ID。
附註:
  1. 由於接收端佇列管理程式對它可以存取的所有佇列具有權限,因此可能不會對此使用者 ID 類型執行安全檢查。
  2. 由於空白值有特殊意義,您無法使用 IGQUSER 來指定空白的實際使用者 ID。

此參數僅在 z/OS上有效。

[2017 年 3 月 9.0.2 版][UNIX、Linux、Windows、IBM i]IMGINTVL
自物件的前一個媒體映像檔以來,佇列管理程式自動寫入媒體映像檔的目標頻率 (分鐘)。
可能的值為:
1-999 999 999 999
佇列管理程式自動寫入媒體映像檔的時間 (分鐘)。

預設值為 60 分鐘。

OFF
不會根據時間間隔來寫入自動媒體映像檔。

此參數僅適用於 Multiplatforms

[2017 年 3 月 9.0.2 版][UNIX、Linux、Windows、IBM i]IMGLOGLN
自物件的前一個媒體映像檔以來,在佇列管理程式自動寫入媒體映像檔之前寫入的回復日誌目標大小 (MB)。 這會限制在回復物件時要讀取的日誌數量。
可能的值為:
1-999 999 999 999
回復日誌的目標大小 (MB)。
OFF
不會根據寫入的日誌大小來寫入自動媒體映像檔。

OFF 是預設值。

此參數僅適用於 Multiplatforms

[2017 年 3 月 9.0.2 版][UNIX、Linux、Windows、IBM i]IMGRCOVO
指定如果使用線性記載,是否可從媒體映像檔回復鑑別資訊、通道、用戶端連線、接聽器、名單、處理程序、別名佇列、遠端佇列及服務物件。
可能的值為:
NO
這些物件不允許 rcdmqimg (記錄媒體映像檔)rcrmqobj (重建物件) 指令,且如果已啟用自動媒體映像檔,則不會寫入這些物件。
YES
這些物件是可回復的。

YES 是預設值。

此參數僅適用於 Multiplatforms

[2017 年 3 月 9.0.2 版][UNIX、Linux、Windows、IBM i]IMGRCOVQ
與此參數一起使用時,指定本端及永久動態佇列物件的預設 IMGRCOVQ 屬性。
可能的值為:
NO
本端及永久動態佇列物件的 IMGRCOVQ 屬性設為 NO
YES
本端及永久動態佇列物件的 IMGRCOVQ 屬性設為 YES

YES 是預設值。

此參數僅適用於 Multiplatforms

[2017 年 3 月 9.0.2 版][UNIX、Linux、Windows、IBM i]IMGSCHED
佇列管理程式是否自動寫入媒體影像。
可能的值為:
自動
自取得物件的前一個媒體映像檔後,佇列管理程式會嘗試自動寫入物件的媒體映像檔,在經歷 IMGINTVL 分鐘之前,或已寫入 IMGLOGLN MB 回復日誌。

IMGINTVLIMGLOGLN的設定而定,先前的媒體映像檔可能已手動或自動取得。

手動
不會寫入自動媒體映像檔。

MANUAL 是預設值。

此參數僅適用於 Multiplatforms

INHIBTEV
指定是否產生禁止事件。 事件是針對「禁止取得」及「禁止放置」所產生)
ENABLED
產生禁止事件。
已停用
不產生禁止事件。

這是佇列管理程式的起始預設值。

IPADDRV
指定通道連線要使用的 IP 通訊協定。
IPV4
將使用 IPv4 IP 位址。

這是佇列管理程式的起始預設值。

IPV6
將使用 IPv6 IP 位址。
此參數僅在執行 IPv4IPv6的系統中使用。 當下列兩個條件之一為 true 時,它適用於僅使用 TCP 的 TRPTYPE 所定義的通道:
  • 通道的 CONNAME 參數包含同時解析為 IPv4IPv6 位址的主機名稱,且未指定 LOCLADDR 參數。
  • 通道的 CONNAMELOCLADDR 參數值是同時解析為 IPv4IPv6 位址的主機名稱。
LOCALEV
指定是否產生本端錯誤事件:
ENABLED
會產生本端錯誤事件。
已停用
不會產生本端錯誤事件。

這是佇列管理程式的起始預設值。

[UNIX、Linux、Windows、IBM i]LOGGEREV
指定是否產生回復日誌事件:
已停用
不會產生日誌程式事件。

這是佇列管理程式的起始預設值。

ENABLED
會產生日誌程式事件。
此參數僅適用於 Multiplatforms
[z/OS]LSTRTMR (整數)
在 APPC 或 TCP/IP 失敗之後, IBM MQ 嘗試重新啟動接聽器的時間間隔 (秒)。 當接聽器在 TCP/IP 上重新啟動時,會使用第一次啟動時所使用的相同埠和 IP 位址。

請指定 5 到 9999 範圍內的值。

此參數的變更會對稍後啟動的接聽器生效。 目前啟動的接聽器不受此參數的變更影響。

此參數僅在 z/OS上有效。

[z/OS]LUGROUP (string)
供 LU 6.2 接聽器使用的一般 LU 名稱,用於處理佇列共用群組的入埠傳輸。 這個參數的長度上限為 8 個字元。

如果這個名稱是空白,則無法使用接聽器。

此參數的變更會對稍後啟動的接聽器生效。 目前啟動的接聽器不受此參數的變更影響。

此參數僅在 z/OS上有效。

[z/OS]LUNAME (string)
用於出埠 LU 6.2 傳輸的 LU 名稱。 將此參數設為與接聽器用於入埠傳輸的 LU 名稱相同。 這個參數的長度上限為 8 個字元。

如果此名稱空白,則會使用 APPC/MVS 預設 LU 名稱。 此名稱是變數,因此如果您使用 LU 6.2 ,則必須一律設定 LUNAME

這個參數的變更會在重新啟動通道起始程式時生效。

此參數僅在 z/OS上有效。

[z/OS]LU62ARM (string)
SYS1.PARMLIB。 這個字尾代表這個通道起始程式的 LUADD。 當自動重新啟動管理程式 (ARM) 重新啟動通道起始程式時,會發出 z/OS 指令 SET APPC= xx

如果您未提供此參數的值,則不會發出 SET APPC= xx 指令。

此參數的長度上限為兩個字元。

這個參數的變更會在重新啟動通道起始程式時生效。

此參數僅在 z/OS上有效。

[z/OS]LU62CHL (整數)
使用 LU 6.2 傳輸通訊協定的現行或可連接的通道數上限。

指定 0-9999 的值不大於 MAXCHL的值。 MAXCHL 定義可用的通道數目上限。 如果您指定零,則不會使用 LU 6.2 傳輸通訊協定。

如果您變更此值,也請檢閱 MAXCHLLU62CHLACTCHL 值。 請確定值沒有衝突,必要的話,請提高 MAXCHLACTCHL的值。

如果此參數的值減少,則超出新限制的任何現行通道都會繼續執行,直到停止為止。

當通道起始程式啟動時,如果 LU62CHL 的值不是零,則可以動態修改此值。 當通道起始程式啟動時,如果 LU62CHL 的值為零,則稍後的 ALTER 指令不會生效。 在此情況下,您應該在通道起始程式啟動之前執行 ALTER 指令,或在發出 START CHINIT 指令之前在 CSQINP2 中執行 ALTER 指令。

此參數僅在 z/OS上有效。

MARKINT (integer)
時間間隔 (以毫秒為單位) ,在此時間間隔中,由 MQGET的呼叫標示為已瀏覽的訊息 (具有取得訊息選項 MQGMO_MARK_BROWSE_CO_OP) 預期會維持標示為已瀏覽。

如果訊息標示超過大約 MARKINT 毫秒,佇列管理程式可能會自動取消標示訊息。 它可能會取消標示針對協同作業控點集標示為已瀏覽的訊息。

此參數不會影響透過使用取得訊息選項 MQGMO_MARK_BROWSE_HANDLEMQGET 的呼叫標示為瀏覽的任何訊息的狀態。

請指定最大值 999,999,999。 預設值是 5000。
注意: 您不應減少低於預設值 5000 的值。

特殊值 NOLIMIT 指出佇列管理程式不會自動取消標示此處理程序的訊息。

[z/OS]MAXCHL (整數)
可以 現行 的通道數上限 (包括具有已連接用戶端的伺服器連線通道)。

請指定 1-9999 範圍內的值。 如果您變更此值,也請檢閱 TCPCHLLU62CHLACTCHL 值,以確保值沒有衝突。 必要的話,請增加具有 ACTCHL 值的作用中通道數目。 ACTCHLLU62CHLTCPCHL 的值不得大於通道數上限。 建議的設定如下:

  • 測試系統: 200
  • 正式作業系統: 1000

如需哪些通道狀態被視為現行通道狀態的說明; 請參閱 通道狀態

如果此參數的值減少,則超出新限制的任何現行通道都會繼續執行,直到停止為止。

起始設定通道起始程式時,如果 MAXCHL 的值減少到小於其值,通道會繼續執行,直到停止為止。 當執行中通道數低於 MAXCHL值時,可以啟動更多通道。 當起始設定通道起始程式時,將 MAXCHL 的值增加到超過其值,並不會立即生效。 MAXCHL 的較高值會在下一次通道起始程式重新啟動時生效。

共用交談不會影響此參數的總計。

如需 CHIADAPSCHIDISPSMAXCHL之間關係的相關資訊,請參閱 作業 18: 自訂通道起始程式參數

此參數僅在 z/OS上有效。

MAXHANDS (integer)
任何一個連線可以同時擁有的開啟控點數目上限。

此值是 0-999,999,999 範圍內的值。

MAXMSGL (整數)
此佇列管理程式在佇列上容許的訊息長度上限。

此值在 32 KB 到 100 MB 的範圍內。

在決定通道的 MAXMSGL 參數值時,請確定您也考量任何訊息內容的長度。

如果您減少佇列管理程式的訊息長度上限,也必須減少 SYSTEM.DEFAULT.LOCAL.QUEUE 定義的訊息長度上限。 您也必須減少佇列管理程式上定義的所有其他佇列的訊息長度上限。 此變更可確保佇列管理程式的限制不小於與其相關聯的任何佇列的限制。 如果您不變更這些長度,且應用程式只會查詢佇列的 MAXMSGL 值,它們可能無法正確運作。

請注意,透過將數位簽章和金鑰新增至訊息, Advanced Message Security 會增加訊息的長度。

MAXPROPL ( integer )
可以與訊息相關聯的內容資料長度上限 (以位元組為單位)。

此值在 0 到 100 MB (104 857 600 位元組) 範圍內。

特殊值 NOLIMIT 指出內容的大小不受限制,但上限除外。

MAXUMSGS (integer)
同步點內未確定的訊息數目上限。

MAXUMSGS 是可在任何單一同步點內擷取的訊息數,加上可放置的訊息數的限制。 此限制不適用於在同步點之外放置或擷取的訊息。

此數目包括在相同回復單元內產生的任何觸發訊息及報告訊息。

如果現有應用程式及佇列管理程式處理程序正在同步點放置並取得大量訊息,則減少 MAXUMSGS 可能會導致問題。

[z/OS] 可能受影響的佇列管理程式處理程序範例是 z/OS上的叢集作業。

請指定 1 到 999,999,999 範圍內的值。 預設值為 10000。

MAXUMSGSMQ Telemetry沒有影響。 MQ Telemetry 會嘗試將來自多個用戶端的訂閱、取消訂閱、傳送及接收訊息的要求批次處理至交易內的工作批次。

MONACLS
控制收集自動定義叢集傳送端通道的線上監視資料:
QMGR
連線監視資料的收集繼承自佇列管理程式的 MONCHL 參數設定。

這是佇列管理程式的起始預設值。

OFF
通道的監視已停用。
除非 MONCHLNONE,否則會以低資料收集速率啟用監視,且對系統效能的影響最小。 所收集的資料可能不是最新的。
中型
除非 MONCHLNONE,否則會以中等速率的資料收集啟用監視,且對系統效能的影響會有限。
除非 MONCHLNONE,否則會以高資料收集速率啟用監視,並可能影響系統效能。 收集的資料是最新的可用資料。

此參數的變更僅在發生變更之後啟動的通道上生效。 在參數變更之前啟動的任何通道,都會以通道啟動時生效的值繼續執行。

MONCHL
控制通道線上監視資料的收集。 使用 MONCHL(QMGR) 定義的通道會受到變更 QMGR MONCHL 屬性的影響。
OFF
對於在其 MONCHL 參數中指定 QMGR 值的通道,會關閉線上監視資料收集。

這是佇列管理程式的起始預設值。

不論通道的 MONCHL 參數設定為何,都會關閉通道的線上監視資料收集。
對於在其 MONCHL 參數中指定 QMGR 值的通道,會以低資料收集比例開啟線上監視資料收集。
中型
針對在其 MONCHL 參數中指定 QMGR 值的通道,開啟具有中等資料收集比例的線上監視資料收集。
對於在其 MONCHL 參數中指定 QMGR 值的通道,會以高資料收集比例開啟線上監視資料收集。

此參數的變更僅在發生變更之後啟動的通道上生效。 在參數變更之前啟動的任何通道,都會以通道啟動時生效的值繼續執行。

MONQ
控制收集佇列的線上監視資料。
OFF
針對在其 MONQ 參數中指定 QMGR 值的佇列,關閉線上監視資料收集。

這是佇列管理程式的起始預設值。

不論佇列的 MONQ 參數設定為何,都會關閉佇列的線上監視資料收集。
針對在其 MONQ 參數中指定 QMGR 值的佇列開啟線上監視資料收集。
中型
針對在其 MONQ 參數中指定 QMGR 值的佇列開啟線上監視資料收集。
針對在其 MONQ 參數中指定 QMGR 值的佇列開啟線上監視資料收集。

MONCHL相反,值 之間沒有區別。 這些值都會開啟資料收集,但不會影響收集率。

此參數的變更僅對變更參數之後開啟的佇列有效。

[z/OS]OPORTMAX (整數)
連結送出通道時要使用的埠號範圍內的最大值。 當使用指定範圍內的所有埠號時,送出通道會連結至任何可用的埠號。

請指定 0-65535 範圍內的值。 值零表示所有送出通道都連結至任何可用的埠號。

指定 OPORTMIN 的對應值,以定義埠號的範圍。 請確定您指定給 OPORTMAX 的值大於或等於您指定給 OPORTMIN的值。

此參數的變更會對稍後啟動的通道生效。 目前啟動的通道不受此參數的變更影響。

此參數僅在 z/OS上有效。

[z/OS]OPORTMIN (integer)
連結送出通道時要使用的埠號範圍內的最小值。 當使用指定範圍內的所有埠號時,送出通道會連結至任何可用的埠號。

請指定 0-65535 範圍內的值。

指定 OPORTMAX 的對應值,以定義埠號的範圍。 請確定您指定給 OPORTMIN 的值小於或等於您指定給 OPORTMAX的值。

此參數的變更會對稍後啟動的通道生效。 目前啟動的通道不受此參數的變更影響。

此參數僅在 z/OS上有效。

母項 (parentname)
本端佇列管理程式會與其連接,以作為其在階層中的子項的母項佇列管理程式的名稱。

空白值表示佇列管理程式沒有母項佇列管理程式。

如果有現有的母項佇列管理程式,則會斷線。

IBM MQ 階層式連線需要將佇列管理程式屬性 PSMODE 設為 ENABLED

如果 PSMODE 設為 DISABLEDPARENT 的值可以設為空白值。

在佇列管理程式可以連接至佇列管理程式作為階層中的子項之前,通道必須雙向存在。 通道必須存在於母項佇列管理程式與子項佇列管理程式之間。

如果已定義母項,則 ALTER QMGR PARENT 指令會中斷與原始母項的連線,並將連線流程傳送至新的母項佇列管理程式。

順利完成指令並不表示動作已完成。 若要檢查此指令是否已完成,請參閱 檢查分散式網路的非同步指令是否已完成中的 ALTER QMGR 步驟。

PERFMEV
指定是否產生效能相關事件:
ENABLED
會產生效能相關事件。
已停用
不會產生效能相關事件。

這是佇列管理程式的起始預設值。

[z/OS]IBM MQ for z/OS上,佇列共用群組中的所有佇列管理程式都必須具有相同的設定。

PSCLUS
控制此佇列管理程式是否在其所屬的任何叢集中參與發佈訂閱活動。 從 ENABLED 修改為 DISABLED時,任何叢集中都無法存在任何叢集化主題物件。
如需 PSCLUS的相關資訊,請參閱 禁止叢集發佈/訂閱
附註: 若要變更 PSCLUS 參數狀態, CHIN 位址空間必須在執行中。
ENABLED
此佇列管理程式可以定義叢集主題物件、發佈至其他佇列管理程式上的訂閱者,以及登錄從其他佇列管理程式接收發佈的訂閱。 叢集中執行支援此選項之 IBM MQ 版本的所有佇列管理程式必須指定 PSCLUS(ENABLED) ,發佈/訂閱活動才能如預期般運作。 ENABLED 是建立佇列管理程式時的預設值。
已停用
此佇列管理程式無法定義叢集主題物件,並忽略其在叢集中任何其他佇列管理程式上的定義。
發佈不會轉遞至叢集中其他位置的訂閱者,且訂閱不會在本端佇列管理程式上登錄。
為了確保叢集中不會發生發佈/訂閱活動,所有佇列管理程式都必須指定 PSCLUS(DISABLED)。 至少在啟用或停用發佈/訂閱參與時,完整儲存庫必須一致。
PSMODE
控制發佈/訂閱引擎及排入佇列的發佈/訂閱介面是否在執行中。 它控制應用程式是否可以使用應用程式設計介面來發佈或訂閱。 它也會控制是否監視已排入佇列的發佈/訂閱介面所監視的佇列。
變更 PSMODE 屬性可以變更 PSMODE 狀態。 請使用下列其中一個指令來判斷發佈/訂閱引擎及已排入佇列的發佈/訂閱介面的現行狀態:
COMPAT
發佈/訂閱引擎正在執行中。 因此,可以使用應用程式設計介面來發佈或訂閱。

已排入佇列的發佈/訂閱介面不在執行中。 不會處理放入佇列發佈/訂閱介面所監視佇列的任何發佈/訂閱訊息。

使用此設定,以與使用此佇列管理程式的 IBM Integration Bus (舊稱為 WebSphere Message Broker) V6 或更早版本相容。

已停用
發佈/訂閱引擎及排入佇列的發佈/訂閱介面不在執行中。 因此,無法使用應用程式設計介面來發佈或訂閱。 不會處理放入佇列發佈/訂閱介面所監視佇列的任何發佈/訂閱訊息。

如果佇列管理程式位於發佈/訂閱叢集或階層中,它可能會從叢集或階層中的其他佇列管理程式接收發佈/訂閱訊息。 這類訊息的範例有發佈訊息或 Proxy 訂閱。 當 PSMODE 設為 DISABLED 時,不會處理那些訊息。 基於此原因,只有在訊息很少累積的情況下,才停用發佈/訂閱叢集或階層中的任何佇列管理程式。

ENABLED
發佈/訂閱引擎及排入佇列的發佈/訂閱介面正在執行中。 因此,可以使用應用程式設計介面及佇列發佈/訂閱介面所監視的佇列來發佈或訂閱。

這是佇列管理程式的起始預設值。

附註: 如果佇列管理程式位於發佈/訂閱叢集或階層中,且您將 PSMODE 變更為 ENABLED,則可能必須執行指令 REFRESH QMGR TYPE(PROXY)。 此指令可確保當 PSMODE 設回 ENABLED時,叢集或階層中的不可延續訂閱是已知的。 您必須執行指令的情況如下。 如果 PSMODEENABLED 變更為 已停用 ,並變更回 ENABLED,則在所有三個階段中都存在一個以上不可延續訂閱。
PSNPMSG
如果排入佇列的發佈/訂閱介面無法處理非持續性輸入訊息,則可能會嘗試將輸入訊息寫入無法傳送郵件的佇列。 是否嘗試這樣做取決於輸入訊息的報告選項。 嘗試將輸入訊息寫入無法傳送郵件的佇列可能會失敗。 在此情況下,排入佇列的發佈/訂閱介面可能會捨棄輸入訊息。 如果在輸入訊息上指定 MQRO_DISCARD_MSG ,則會捨棄輸入訊息。 如果未設定 MQRO_DISCARD_MSG ,則將 PSNPMSG 設為 KEEP 會防止捨棄輸入訊息。 預設值是捨棄輸入訊息。
附註: 如果您對 PSSYNCPT指定 IFPER 值,則不得對 PSNPMSG指定 KEEP 值。
捨棄
如果無法處理非持續性輸入訊息,則可能會捨棄它們。
KEEP
如果無法處理非持續性輸入訊息,則不會捨棄它們。 在此狀況下,排入佇列的發佈/訂閱介面會繼續嘗試以適當的間隔再次處理此訊息,且不會繼續處理後續訊息。
PSNPRES
PSNPRES 屬性控制排入佇列的發佈/訂閱介面是否將無法遞送的回覆訊息寫入無法傳送的郵件佇列,或捨棄該訊息。 如果已排入佇列的發佈/訂閱介面無法將回覆訊息遞送至回覆目的地佇列,則需要此選項。

若為新的佇列管理程式,起始值為 NORMAL。 如果您對 PSSYNCPT指定 IFPER 值,則不得對 PSNPRES指定 KEEPSAFE 值。

[UNIX、Linux、Windows、IBM i]對於 Multiplatforms上已移轉的佇列管理程式,此值取決於 DLQNonPersistentResponseDiscardNonPersistentResponse

NORMAL
不能放在回覆佇列的非持續回應,會放在無法傳送郵件的佇列中。 如果無法將它們放置在無法傳送郵件的佇列上,則會捨棄它們。
安全
不能放在回覆佇列的非持續回應,會放在無法傳送郵件的佇列中。 如果無法傳送回應,且無法放置在無法傳送郵件的佇列上,則已排入佇列的發佈/訂閱介面會取消現行作業。 它會以適當的間隔重試,且不會繼續處理後續訊息。
捨棄
捨棄無法放置在回覆佇列上的非持續性回應
KEEP

非持續性回應不會放置在無法傳送郵件的佇列上或被捨棄。 相反地,排入佇列的發佈/訂閱介面會取消現行作業,然後以適當的間隔重試該作業,且不會繼續處理後續訊息。

PSRTYCNT
如果排入佇列的發佈/訂閱介面無法在同步點下處理指令訊息,則會取消工作單元。 在發佈/訂閱分配管理系統改為根據其報告選項來處理指令訊息之前,指令會再次嘗試處理訊息數次。 這種情況可能有多種原因。 例如,如果發佈訊息無法遞送至訂閱者,且無法將發佈放置在無法傳送的郵件佇列上。

新佇列管理程式上此參數的起始值為 5。

範圍是 0-999,999,999。

PSSYNCPT
控制排入佇列的發佈/訂閱介面是否在同步點下處理指令訊息 (發佈或刪除發佈訊息)。
YES
所有訊息都在同步點下處理。
若持續
只有持續訊息是同步點的一部分

佇列管理程式的起始值為 IFPER

[z/OS]RCVTIME ( 整數 )
在回到非作用中狀態之前, TCP/IP 通道等待從其友機接收資料 (包括活動訊號) 的大約時間長度。
當通道接收逾時是根據協議的活動訊號間隔來設定時,此參數僅適用於訊息通道,以及 SHARECNV 大於零的 MQI 伺服器連線及用戶端連線通道。 此數字可以如下所示限定:
  • 若要指定此數字是乘數,以套用至協議的 HBINT 值以判定通道等待的時間長度,請將 RCVTTYPE 設為 MULTIPLY。 指定 RCVTIME 值零或在 2 到 99 的範圍內。 如果您指定零,通道會繼續無限期地等待從其友機接收資料。
  • 若要指定 RCVTIME 是要新增至協議 HBINT 值以決定通道等待時間的秒數,請將 RCVTTYPE 設為 ADD。 請指定範圍 1 到 999999 內的 RCVTIME 值。
  • 若要指定 RCVTIME 是通道要等待的值 (以秒為單位) ,請將 RCVTTYPE 設為 EQUAL。 請指定 0-999,999 範圍內的 RCVTIME 值。 如果您指定零,通道會繼續無限期地等待從其友機接收資料。
附註: 對於使用共用交談的 MQI 通道, ReceiveTimeoutReceiveTimeMinReceiveTimeoutType 所使用的活動訊號間隔比協議的活動訊號間隔大五秒。
對於 SHARECNV 等於零的通道, RCVTMIN 不適用。

此參數的變更會對稍後啟動的通道生效。 目前啟動的通道不受此參數的變更影響。

如需相關資訊,請參閱 檢查通道另一端是否仍然可用

此參數僅在 z/OS上有效。

[z/OS]RCVTMIN (integer)
在回到非作用中狀態之前, TCP/IP 通道等待從其友機接收資料 (包括活動訊號) 的時間長度下限。
當通道接收逾時是根據協議的活動訊號間隔來設定時,此參數僅適用於訊息通道,以及 SHARECNV 大於零的 MQI 伺服器連線及用戶端連線通道。
附註: 對於使用共用交談的 MQI 通道, ReceiveTimeoutReceiveTimeMinReceiveTimeoutType 所使用的活動訊號間隔比協議的活動訊號間隔大五秒。
對於 SHARECNV 等於零的通道, RCVTMIN 不適用。

TCP/IP 通道等待時間可以配置成相對於 HBINT的協議值。 如果 RCVTTYPEMULTIPLYADD,則產生的值可能小於在 RCVTMIN中設定的值。 在此情況下, TCP/IP 通道等待時間會設為 RCVTMIN。 如果 RCVTTYPEEQUAL ,則 RCVTMIN 不適用。

指定介於零和 999999 之間的值 (以秒為單位)。

此參數的變更會對稍後啟動的通道生效。 目前啟動的通道不受此參數的變更影響。

如需相關資訊,請參閱 檢查通道另一端是否仍然可用

此參數僅在 z/OS上有效。

[z/OS]RCVTTYPE
要套用至 RCVTIME中的值的限定元。
指定 RCVTIME 是要套用至協議 HBINT 值的乘數,以決定通道等待的時間長度。
新增
指定 RCVTIME 是要新增至協議 HBINT 值的值 (以秒為單位) ,以決定通道等待的時間長度。
相同
指定 RCVTIME 是代表通道等待時間長度的值 (以秒為單位)。

此參數的變更會對稍後啟動的通道生效。 目前啟動的通道不受此參數的變更影響。

如需相關資訊,請參閱 檢查通道另一端是否仍然可用

此參數僅在 z/OS上有效。

REMOTEEV
指定是否產生遠端錯誤事件:
已停用
不會產生遠端錯誤事件。

這是佇列管理程式的起始預設值。

ENABLED
產生遠端錯誤事件。

[z/OS]如果您使用 WebSphere Application Server隨附的 IBM MQ for z/OS 精簡函數形式,則只有 DISABLED 有效。

REPOS (clustername)
此佇列管理程式為其提供儲存庫管理程式服務的叢集名稱。 符合 IBM MQ 物件命名規則的長度上限為 48 個字元。

REPOSREPOSNL 的結果值不能超過一個為非空白。

如果您使用 REPOS 參數來建立完整儲存庫佇列管理程式,請將它連接至叢集中至少一個其他完整儲存庫佇列管理程式。 請使用叢集傳送端通道來連接它。 如需搭配使用叢集傳送端通道與完整儲存庫佇列管理程式的詳細資料,請參閱 叢集的元件 中的資訊。

順利完成指令並不表示動作已完成。 若要檢查是否真正完成,請參閱 檢查分散式網路的非同步指令已完成中的 ALTER QMGR 步驟。

REPOSNL (nlname)
此佇列管理程式為其提供儲存庫管理程式服務的叢集名稱清單名稱。 符合 IBM MQ 名單物件命名規則的長度上限為 48 個字元。

如需指定 REPOSREPOSNL的相關資訊,請參閱 REPOS 的說明。

REVDNS
控制是否針對通道連線的來源 IP 位址,從「網域名稱伺服器 (DNS)」反向查閱主機名稱。 這個屬性只會影響使用 TCP 傳輸類型 (TRPTYPE) 的通道:
ENABLED
當需要此資訊時, DNS 主機名稱會反向查閱入埠通道的 IP 位址。 需要此設定才能比對包含主機名稱的 CHLAUTH 規則,以及將主機名稱併入錯誤訊息中。 IP 位址仍包含在提供連線 ID 的訊息中。

這是佇列管理程式的起始預設值。

已停用
DNS 主機名稱不會反向查閱入埠通道的 IP 位址。 使用此設定時,任何使用主機名稱的 CHLAUTH 規則都不相符。
ROUTEREC
指定如果在訊息中要求,是否記錄追蹤路徑資訊。 如果此參數未設定為 DISABLED,它會控制將產生的任何回覆傳送至 SYSTEM.ADMIN.TRACE.ROUTE.QUEUE,還是傳送至訊息本身指定的目的地。 如果 ROUTEREC 不是 DISABLED,則尚未在最終目的地的訊息可能會新增資訊。
已停用
未記錄追蹤路徑資訊。
MSG
追蹤路徑資訊會記錄並傳送至追蹤路徑記錄的訊息發送端所指定的目的地。

這是佇列管理程式的起始預設值。

佇列
追蹤路徑資訊會記錄並傳送至 SYSTEM.ADMIN.TRACE.ROUTE.QUEUE
[UNIX、Linux、Windows、IBM i]SCHINIT
指定佇列管理程式啟動時,是否自動啟動通道起始程式。
QMGR
當佇列管理程式啟動時,通道起始程式會自動啟動。
手動
通道起始程式不會自動啟動。

此參數僅適用於 Multiplatforms

[UNIX、Linux、Windows、IBM i]SCMDSERV
指定佇列管理程式啟動時,是否自動啟動指令伺服器。
QMGR
當佇列管理程式啟動時,指令伺服器會自動啟動。
手動
指令伺服器不會自動啟動。

此參數僅適用於 Multiplatforms

[z/OS]SCYCASE
指定安全設定檔是大寫還是混合大小寫。
UPPER
安全設定檔僅為大寫。 不過, MXTOPICGMXTOPIC 用於主題安全,可包含大小寫混合的設定檔。
混合
安全設定檔大小寫混合。 MQCMDSMQCONN 用於指令和連線安全,但只能包含大寫設定檔。
SCYCASE 的變更會在您執行下列指令之後生效:

REFFRESH SECURITY(*) TYPE(CLASSES)

此參數僅在 z/OS上有效。

[z/OS]SQQMNAME
SQQMNAME 屬性指定佇列共用群組中的佇列管理程式是否直接開啟相同群組中的共用佇列。 處理佇列管理程式會針對共用佇列呼叫 MQOPEN ,並為佇列設定 ObjectQmgrName 參數。 如果共用佇列位於與處理佇列管理程式相同的佇列共用群組中,則處理佇列管理程式可以直接開啟該佇列。 設定 SQQMNAME 屬性,以控制佇列是直接開啟,還是由 ObjectQmgr名稱 佇列管理程式開啟。 當開啟具有副本處置的 QALIAS 時,如果目標佇列是與處理佇列管理程式相同的佇列共用群組中的共用佇列,也會允許使用此屬性。 在此狀況下,佇列共用群組中每一個佇列管理程式上的 QALIAS 副本物件必須具有相同的目標佇列。
使用
使用 ObjectQmgr名稱 ,並開啟適當的傳輸佇列。
IGNORE
處理佇列管理程式會直接開啟共用佇列。 將參數設為此值可以減少佇列管理程式網路中的資料流量。

此參數僅在 z/OS上有效。

SSLCRLNL ( nlname )

鑑別資訊物件的名稱清單,用來提供憑證撤銷位置以容許加強 TLS 憑證檢查。

如果 SSLCRLNL 為空白,則除非使用的其中一個 TLS 憑證包含 AuthorityInfoAccessCrlDistributionPoint X.509 憑證延伸,否則不會呼叫憑證撤銷檢查。

SSLCRLNL或對先前指定名單中名稱的變更,或對先前參照的鑑別資訊物件的變更會生效,如下所示:
  • 當發出 REFRESH SECURITY TYPE(SSL) 指令時。
  • [UNIX、Linux、Windows]開啟 UNIX, Linux, and Windows:
    • 啟動新的通道處理程序時
    • 對於作為通道起始程式的執行緒執行的通道,當通道起始程式重新啟動時
    • 對於以接聽器執行緒身分執行的通道,當接聽器重新啟動時
  • [IBM i]開啟 IBM i:
    • 啟動新的通道處理程序時
    • 對於作為通道起始程式的執行緒執行的通道,當通道起始程式重新啟動時
    • 對於以接聽器執行緒身分執行的通道,當接聽器重新啟動時
    IBM i 佇列管理程式上,會忽略此參數。 不過,它用來判斷哪些鑑別資訊物件會寫入 AMQCLCHL.TAB 檔。
  • [z/OS]開啟 z/OS,當通道起始程式重新啟動時。
SSLCRLNL所參照的名單中,只接受類型為 LDAPCRLOCSP 的鑑別資訊物件。 任何其他類型都會在處理清單時產生錯誤訊息,並隨後予以忽略。
注意: 名單最多只能參照一個 OCSP 類型 AUTHINFO 物件。
SSLCRYP (string)
設定必要的參數字串名稱,以配置系統上呈現的加密硬體。
所有支援的加密硬體都支援 PKCS #11 介面。 請指定下列格式的字串:

GSK_PKCS11= the PKCS #11 driver path and file name>
; the PKCS #11 token label> ;
the PKCS #11 token password> ; symmetric cipher setting>
;
PKCS #11 驅動程式路徑是提供 PKCS #11 卡支援之共用程式庫的絕對路徑。 PKCS #11 驅動程式檔名是共用程式庫的名稱。 PKCS #11 驅動程式路徑和檔名所需的值範例為 /usr/lib/pkcs11/PKCS11_API.so
若要透過 GSKit 存取對稱密碼作業,請指定對稱密碼設定參數。 此參數的值為:
SYMMETRIC_CIPHER_OFF
不存取對稱密碼作業。
SYMMETRIC_CIPHER_ON
存取對稱密碼作業。
如果未指定對稱密碼設定參數,則其效果與指定 SYMMETRIC_CIPHER_OF F 相同。

字串的長度上限為 256 個字元。

如果您指定的字串不是所列出的格式,則會發生錯誤。

SSLCRYP 值變更時,指定的加密硬體參數會變成用於新的 TLS 連線環境的參數。 新資訊會生效:
  • 啟動新的通道處理程序時。
  • 對於作為通道起始程式之執行緒執行的通道,當通道起始程式重新啟動時。
  • 對於作為接聽器執行緒執行的通道,當重新啟動接聽器時。
  • 當發出 REFRESH SECURITY TYPE(SSL) 指令時。
SSLEV
指定是否產生 TLS 事件。
已停用
不會產生 TLS 事件。

這是佇列管理程式的起始預設值。

ENABLED
會產生所有 TLS 事件。
[UNIX、Linux、Windows][z/OS]SSLFIPS
SSLFIPS 指定在 IBM MQ而非加密硬體中執行加密法時,是否只使用 FIPS 認證的演算法。 如果已配置加密硬體,則使用的加密模組是硬體產品所提供的那些模組。 這些可能或可能未通過 FIPS 認證為特定層次。 模組是否經過 FIPS 認證取決於使用中的硬體產品。 如需 FIPS 的相關資訊,請參閱 聯邦資訊存取安全標準 (FIPS) 手冊。
NO
如果您將 SSLFIPS 設為 NO,則可以使用 FIPS 認證或非 FIPS 認證的 CipherSpecs。

如果佇列管理程式在未使用加密硬體的情況下執行,請參閱 指定 CipherSpecs中列出的 CipherSpecs 。

這是佇列管理程式的起始預設值。

YES
指定在此佇列管理程式的所有 TLS 連線上只容許在 CipherSpecs 中使用 FIPS 認證的演算法。

如需適當 FIPS 140-2 認證的 CipherSpecs清單; 請參閱 指定 CipherSpecs

SSLFIPS 的變更會生效,如下所示:
  • [UNIX、Linux、Windows、IBM i]開啟 UNIX, Linux, and Windows:
    • 當發出 REFRESH SECURITY TYPE(SSL) 指令時
    • 啟動新的通道處理程序時
    • 通道起始程式重新啟動時,針對作為通道起始程式之執行緒執行的通道
    • 對於作為接聽器的執行緒執行的通道,當接聽器重新啟動時
    • 對於作為處理程序儲存區處理程序的執行緒執行的通道,當處理程序儲存區處理程序已啟動或重新啟動且第一次執行 TLS 通道時。 如果處理程序儲存區處理程序已執行 TLS 通道,且您想要變更立即生效,請執行 MQSC 指令 REFRESH SECURITY TYPE(SSL)。 程序儲存區處理程序是 amqrmppa
  • [z/OS]開啟 z/OS,當通道起始程式重新啟動時。

此參數僅在 z/OSUNIX, Linux, and Windows上有效。

SSLKEYR (string)
Secure Sockets Layer 金鑰儲存庫的名稱。 字串的長度上限為 256 個字元。 名稱的格式視環境而定。

[z/OS]z/OS上,名稱是金鑰環的名稱。

[UNIX、Linux、Windows、IBM i]Multiplatforms上,名稱是以詞幹格式表示,這表示它包括完整路徑及不含副檔名的檔名:
  • [IBM i]IBM i上,名稱格式為 pathname/keyfile,其中 keyfile 指定時不含字尾 .kdb,並識別 GSKit 金鑰資料庫檔。
    • 如果您指定 *SYSTEMIBM MQ 會使用系統憑證儲存庫作為佇列管理程式的金鑰儲存庫。 佇列管理程式在「數位 Certificate Manager (DCM)」中登錄為伺服器應用程式。 您可以將系統儲存庫中的任何伺服器/用戶端憑證指派給佇列管理程式,因為您將它登錄為伺服器應用程式。
    • 如果您將 SSLKEYR 參數變更為 *SYSTEM以外的值, IBM MQ 會將佇列管理程式取消登錄為具有 DCM 的應用程式。
  • [UNIX][Linux]UNIXLinux上,名稱的格式為 pathname/keyfile ,其中指定 keyfile 時不含字尾 .kdb ,並識別 GSKit CMS 金鑰資料庫檔。
  • [Windows]Windows上,指定的名稱格式為 pathname\keyfile ,其中 keyfile 沒有字尾 .kdb ,並識別 GSKit CMS 金鑰資料庫檔。
Multiplatforms上,會驗證此參數的語法,以確保它包含有效且絕對的目錄路徑。

如果 SSLKEYR 為空白,則使用 TLS 的通道不會啟動。 如果 SSLKEYR 設為未對應至金鑰環或金鑰資料庫檔的值,則使用 TLS 的通道也不會啟動。

SSLKEYR 的變更會生效,如下所示:
  • 當發出 REFRESH SECURITY TYPE(SSL) 指令時。
  • [UNIX、Linux、Windows、IBM i]Multiplatforms上:
    • 啟動新的通道處理程序時。
    • 對於作為通道起始程式之執行緒執行的通道,當通道起始程式重新啟動時。
    • 對於作為接聽器執行緒執行的通道,當重新啟動接聽器時。
    • 對於作為處理程序儲存區處理程序的執行緒執行的通道,當處理程序儲存區處理程序已啟動或重新啟動且第一次執行 TLS 通道時, amqrmppa。 如果處理程序儲存區處理程序已執行 TLS 通道,且您想要變更立即生效,請執行 MQSC 指令 REFRESH SECURITY TYPE(SSL)
  • [z/OS]開啟 z/OS,當通道起始程式重新啟動時。
SSLRKEYC (integer)
在重新協議秘密金鑰之前,要在 TLS 交談內傳送及接收的位元組數。 位元組數包括控制資訊。

SSLRKEYC 僅由從佇列管理程式起始通訊的 TLS 通道使用。 例如,傳送端通道會在傳送端與接收端通道配對中起始通訊。

如果指定大於零的值,則在通道活動訊號之後傳送或接收訊息資料之前,也會重新協議秘密金鑰。 每次成功重新協議之後重設下一個秘密金鑰重新協議之前的位元組計數。

請指定 0-999,999,999 範圍內的值。 零值表示永不重新協議秘密金鑰。 如果您指定範圍 1-32767 個位元組 (32 KB) 內的 TLS 秘密金鑰重設計數,則 TLS 通道會使用 32 KB 的秘密金鑰重設計數。 較大的重設計數值可避免針對小型 TLS 秘密金鑰重設值進行過多金鑰重設的成本。

注意: 如果您的企業已套用 APAR PH30305,則下列陳述不再適用:
  • 小於 4096 (4 KB) 的非零值可能會導致通道無法啟動,或可能導致 SSLKEYDASSLKEYTISSLRKEYS的值不一致。
[z/OS]SSLTASKS (integer)
用於處理 TLS 呼叫的伺服器子作業數。 若要使用 TLS 通道,您必須至少有兩項作業在執行中。

此值在 0-9999 範圍內。 若要避免儲存體配置發生問題,請不要將 SSLTASKS 參數設為大於 50 的值。

此參數的變更會在通道起始程式重新啟動時生效。

此參數僅在 z/OS上有效。

STATACLS
指定是否要收集自動定義叢集傳送端通道的統計資料:
QMGR
統計資料的收集繼承自佇列管理程式的 STATCHL 參數設定。

這是佇列管理程式的起始預設值。

OFF
通道的統計資料收集已停用。
除非 STATCHLNONE,否則會以低資料收集比例開啟統計資料收集,而對系統效能的影響最小。
中型
除非 STATCHLNONE,否則會以中等比例的資料收集來開啟統計資料收集。
除非 STATCHLNONE,否則會以高資料收集比例開啟統計資料收集。

此參數的變更僅在發生變更之後啟動的通道上生效。 在參數變更之前啟動的任何通道,都會以通道啟動時生效的值繼續執行。

[z/OS]z/OS 系統上,不論您選取的值為何,啟用此參數只會開啟統計資料收集。 指定 LOWMEDIUMHIGH 對您的結果不會造成任何差別。 必須啟用此參數,才能收集通道統計記錄。

STATCHL
指定是否要收集通道的統計資料:
不論通道的 STATCHL 參數設定為何,都會關閉通道的統計資料收集。
OFF
針對在其 STATCHL 參數中指定 QMGR 值的通道,關閉統計資料收集。

這是佇列管理程式的起始預設值。

針對在其 STATCHL 參數中指定 QMGR 值的通道,開啟具有低資料收集比例的統計資料收集。
中型
針對在其 STATCHL 參數中指定 QMGR 值的通道,開啟具有中等資料收集比例的統計資料收集。
針對在其 STATCHL 參數中指定 QMGR 值的通道,開啟具有高資料收集比例的統計資料資料收集。

此參數的變更僅在發生變更之後啟動的通道上生效。 在參數變更之前啟動的任何通道,都會以通道啟動時生效的值繼續執行。

[z/OS]z/OS 系統上,不論您選取的值為何,啟用此參數只會開啟統計資料收集。 指定 LOWMEDIUMHIGH 對您的結果不會造成任何差別。 必須啟用此參數,才能收集通道統計記錄。

[UNIX、Linux、Windows、IBM i]STATINT (整數)
統計資料監視資料寫入監視佇列的時間間隔 (秒)。

請指定 1 到 604800 範圍內的值。

此參數的變更會對監視及統計資料的收集立即生效。

此參數僅在 Multiplatforms 上有效。

[UNIX、Linux、Windows、IBM i]STATMQI
指定是否要收集佇列管理程式的統計資料監視資料:
OFF
已停用 MQI 統計資料的資料收集。

這是佇列管理程式的起始預設值。

開啟
已啟用 MQI 統計資料的資料收集。

此參數的變更會對監視及統計資料的收集立即生效。

此參數僅適用於 Multiplatforms

[UNIX、Linux、Windows、IBM i]STATQ
指定是否要收集佇列的統計資料:
不論佇列的 STATQ 參數設定為何,都會關閉佇列的統計資料收集。
OFF
對於在其 STATQ 參數中指定 QMGROFF 值的佇列,會關閉統計資料收集。 OFF 是預設值。
開啟
針對在其 STATQ 參數中指定 QMGRON 值的佇列,開啟統計資料收集。

只有在啟用統計資料收集之後開啟的佇列才會產生統計資料訊息。 您不需要重新啟動佇列管理程式,新的 STATQ 值就會生效。

此參數僅在 Multiplatforms 上有效。

STRSTPEV
指定是否產生啟動和停止事件:
ENABLED
會產生啟動和停止事件。

這是佇列管理程式的起始預設值。

已停用
不會產生啟動和停止事件。
SUITEB
指定是否使用 Suite B 相容加密法,以及需要何種強度。
未使用套組 B。 NONE 是預設值
128_BIT
使用套組 B 128 位元層次安全。
192_BIT
使用套組 B 192 位元層次安全
128_BIT,192_BIT
同時使用套組 B 128 位元及 192 位元層次安全
[z/OS]TCPCHL (整數)
使用 TCP/IP 傳輸通訊協定的現行或可連接的用戶端通道數上限。

使用的 Socket 數目上限是 TCPCHLCHIDISPS中的值總和。 z/OS UNIX 系統服務 MAXFILEPROC 參數 (在 SYS1.PARMLIBBPXPRMxx 成員中指定) 控制容許每個作業的 Socket 數目,從而控制容許每個分派器的通道數目。 在此情況下,使用 TCP/IP 的通道數會限制為 MAXFILEPROC 的值乘以 CHIDISPS的值。

請指定 0-9999 的值。 該值不得大於 MAXCHL的值。 MAXCHL 定義可用的通道數目上限。 TCP/IP 可能不支援最多 9999 個通道。 若是如此,您可以指定的值會受限於 TCP/IP 可支援的通道數。 如果您指定零,則不會使用 TCP/IP 傳輸通訊協定。

如果您變更此值,也請檢閱 MAXCHLLU62CHLACTCHL 值,以確保值沒有衝突。 必要的話,請提高 MAXCHLACTCHL的值。

如果此參數的值減少,則超出新限制的任何現行通道都會繼續執行,直到停止為止。

共用交談不會影響此參數的總計。

當通道起始程式啟動時,如果 TCPCHL 的值不是零,則可以動態修改此值。 當通道起始程式啟動時,如果 TCPCHL 的值為零,則稍後的 ALTER 指令不會生效。 在此情況下,您應該在通道起始程式啟動之前或在 CSQINP2 中執行 ALTER 指令,然後再發出 START CHINIT 指令。

此參數僅在 z/OS上有效。

[z/OS]TCPKEEP
指定是否要使用 KEEPALIVE 機能來檢查連線的另一端是否仍然可用。 如果無法使用,則會關閉通道。
NO
不使用 TCP KEEPALIVE 機能。

這是佇列管理程式的起始預設值。

YES
TCP KEEPALIVE 機能將依照 TCP 設定檔配置資料集中的指定來使用。 間隔指定在 KAINT 通道屬性中。

此參數的變更會對稍後啟動的通道生效。 目前啟動的通道不受此參數的變更影響。

此參數僅在 z/OS上有效。

「現代」佇列管理程式不再需要使用 TCPKEEP 參數。 取代項目是下列項目的組合:
  • using 'modern' client channels (SHARECNV <> 0)
  • 使用訊息通道 RCVTIME的接收逾時。

如需相關資訊,請參閱 Technote Setting the TCP/IP KeepAlive interval to be used by IBM MQ,網址為: https://www.ibm.com/support/docview.wss?uid=swg21216834

[z/OS]TCPNAME (string)
要使用的唯一或偏好 TCP/IP 堆疊名稱,視 TCPSTACK的值而定。 此名稱是 TCP/IP 的「 z/OS UNIX 系統服務」堆疊名稱,如 SYS1.PARMLIBBPXPRMxx 成員中的 SUBFILESYSTYPE NAME 參數所指定。 TCPNAME 僅適用於 CINET 多重堆疊環境。 佇列管理程式的起始預設值為 TCPIP。

在 INET 單一堆疊環境中,通道起始程式會使用唯一可用的 TCP/IP 堆疊。

這個參數的長度上限為 8 個字元。

這個參數的變更會在重新啟動通道起始程式時生效。

此參數僅在 z/OS上有效。

[z/OS]TCPSTACK
指定通道起始程式是否只能使用 TCPNAME中指定的 TCP/IP 堆疊,或選擇性地連結至任何選取的 TCP/IP 堆疊。 此參數僅適用於 CINET 多重堆疊環境。
SINGLE
通道起始程式只能使用 TCPNAME中指定的 TCP/IP 位址空間。
多行
通道起始程式可以使用任何可用的 TCP/IP 位址空間。

這個參數的變更會在重新啟動通道起始程式時生效。

此參數僅在 z/OS上有效。

[z/OS]TRAXSTR
指定通道起始程式追蹤是否自動啟動:
YES
通道起始程式追蹤會自動啟動。
NO
通道起始程式追蹤不會自動啟動。

這個參數的變更會在重新啟動通道起始程式時生效。 如果您要啟動或停止通道起始程式追蹤,而不重新啟動通道起始程式,請在啟動通道起始程式之後使用 START TRACESTOP TRACE 指令。

此參數僅在 z/OS上有效。

[z/OS]TRAXTBL (整數)
通道起始程式的追蹤資料空間大小 (MB)。

請指定 2 到 2048 範圍內的值。

附註:
  1. 此參數的變更會立即生效; 任何現有的追蹤表格內容都會遺失。
  2. CHINIT 追蹤儲存在稱為 qmidCHIN.CSQXTRDS的資料空間中。 當您使用大型 z/OS 資料空間時,請確定系統上有足夠的輔助儲存體可支援任何相關的 z/OS 分頁活動。 您也可能需要增加 SYS1.DUMP 資料集的大小。

此參數僅在 z/OS上有效。

TREELIFE ( integer )
非管理主題的有效期限(秒)。

非管理主題是指當應用程式發佈至或訂閱不存在作為管理節點的主題字串時所建立的主題。 當此非管理節點不再具有任何作用中訂閱時,此參數會決定在移除該節點之前佇列管理程式等待的時間。 在佇列管理程式回收之後,只會保留由可延續訂閱使用中的非管理主題。

請指定範圍 0 到 604000 的值。 0 的值表示佇列管理程式不會移除非管理主題。

TRIGINT (integer)
以毫秒表示的時間間隔。

僅當觸發類型 (TRIGTYPE) 設定為 FIRST 時, TRIGINT 參數才相關 (如需詳細資料,請參閱 DEFINE QLOCAL )。 在此情況下,通常只有在適當的訊息到達佇列且佇列先前是空的時,才會產生觸發訊息。 不過,在某些情況下,即使佇列不是空的,也可以使用 FIRST 觸發來產生其他觸發訊息。 這些額外的觸發訊息不會比每 TRIGINT 毫秒產生一次更頻繁; 請參閱 觸發類型 FIRST 的特殊案例

請指定 0-999,999,999 範圍內的值。