IBM MQ 內容

IBM® MQ 內容適用於整個 IBM MQ 安裝。

下表列出您可以為 IBM MQ設定的內容:

每一項內容都有一個簡要說明,來說明您何時需要配置該內容。 IBM MQ 內容對話框中的內容與配置檔中的段落相關。

「一般」頁面

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

內容 說明 段落索引鍵
預設路徑 若要變更用來儲存所有佇列管理程式資料之目錄的位置,請輸入新目錄的完整路徑。 DefaultPrefix
預設佇列管理程式名稱 若要指定新佇列管理程式的預設名稱,請在這個欄位中輸入該名稱。 姓名

「延伸事項」頁面

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

內容 說明 段落索引鍵
預設暫時字首 若要變更用來儲存所有暫時佇列管理程式資料之目錄的位置,請輸入新目錄的完整路徑。 DefaultEphemeralPrefix
轉換 EBCDIC 換行 EBCDIC 字碼頁包含換行 (NL) 字元,但 ASCII 字碼頁不支援該字元(雖然 ASCII 的部分 ISO 變式包含同等字)。 如果訊息從使用 EBCDIC 字碼頁的系統 (例如 z/OS® 系統) 傳送至使用 ASCII 的系統,您可以控制 EBCDIC 換行字元轉換成 ASCII 格式的方式。 預設值是 NL_TO_LF,其表示在所有 EBCDIC 至 ASCII 轉換中,EBCDIC NL 字元 (X'15') 都會轉換成 ASCII 換行字元 LF (X'0A')。 若要根據作業系統的轉換表來轉換 EBCDIC NL 字元,請按一下 TABLE。 請注意,TABLE 轉換的結果會隨平台和語言而異;即使在相同的平台上,如果您使用不同的編碼字集 ID (CCSID),結果可能也會不同。 若要使用 TABLE 方法來轉換 ISO CCSID,並對所有其他 CCSID 使用 NL_TO_LF 方法,請按一下 ISO ConvEBCDICNewline
叢集工作量模式 叢集工作量結束程式 CLWL 可讓您指定要開啟叢集中的哪一個叢集佇列,以回應 MQI 呼叫(例如,MQOPEN 或 MQPUT)。 預設值是 SAFE,表示 CLWL 結束程式會在不同於佇列管理程式的個別程序中執行,因此如果發生問題,佇列管理程式的完整性仍然得以保留。 不過,以個別的程序執行 CLWL 結束程式可能會不利於效能。 若要在佇列管理程式的相同程序中執行 CLWL 結束程式以提昇效能,請按一下 FAST。 請只有在確信 CLWL 結束程式沒有問題時,才使用 FAST 模式,因為如果在 FAST 模式下發生問題,佇列管理程式會失敗,且佇列管理程式的完整性會有風險。 使用叢集工作量模式內容,可以置換個別佇列管理程式的這個值。 如需相關資訊,請參閱 佇列管理程式內容 CLWLMode

「結束程式」頁面

下表列出您可以在「 IBM MQ 內容」對話框的 結束程式 頁面上設定的內容。 若要配置這部電腦上所有佇列管理程式共用的結束程式,請編輯結束程式頁面上的內容。

內容 說明 段落索引鍵
結束程式預設路徑 無果要變更用戶端結束程式、通道結束程式和伺服器資料轉換結束程式的位置,請輸入新目錄的路徑。 ExitsDefaultPath
共用 API 結束程式 若要為 IBM MQ配置新的共用 API 結束程式,請按一下 新增 ,然後在「 內容 」對話框中鍵入該結束程式的詳細資料。 若要編輯已經顯示在表格中的共用 API 結束程式,請按一下編輯;若要從表格中移除 API 結束程式,請按一下移除 ApiExitCommon
範本 API 結束程式 若要為 IBM MQ配置新的範本 API 結束程式,請按一下 新增 ,然後在「內容」對話框中鍵入結束程式的詳細資料。 若要編輯已經顯示在表格中的範本 API 結束程式,請按一下編輯;若要從表格中移除 API 結束程式,請按一下移除 ApiExitTemplate
姓名 指定 API 結束程式的說明性名稱,其會傳給 MQAXP 結構之 ExitInfoName 欄位中的 API 結束程式。 此名稱必須是唯一的,且長度限制為 48 個字元,且只能包含對 IBM MQ 物件名稱有效的字元,例如佇列名稱。 姓名
類型 指定結束程式的類型:commontemplate (不是個別的段落索引鍵。)
序列 這個內容是不帶正負號的數值,其會定義呼叫這個 API 結束程式相較於其他 API 結束程式的順序。 具有低序號的 API 結束程式,會在另一個具有較高序號的 API 結束程式之前呼叫。 如果不同的 API 結束程式有相同的序號,其呼叫順序未定義。 在定義給佇列管理程式之 API 結束程式的序號中的跳號仍然有效。 序列
模組 指定含有 API 結束程式之程式碼的模組。 如果這個欄位含有模組的完整路徑名稱,則會依其現狀使用。 如果此欄位只包含模組名稱,則會使用與通道結束程式相同的方法來尋找模組;亦即,使用佇列管理程式內容對話框結束程式頁面上 Exit default path 欄位中的值。 模組
函數 指定含有 API 結束程式的程式碼之模組內的函數進入點名稱。 這個進入點是 MQ_INIT_EXIT 函數。 這個欄位的長度限制為 MQ_EXIT_NAME_LENGTH。 函數
資料 如果指定這個內容,系統會移除前端和尾端空格,其餘字串會截斷成 32 個字元,並將結果傳遞給 MQAXP 結構之 ExitData 欄位中的結束程式。 如果沒有指定這個內容,會將預設值 32 個空格傳遞給 MQAXP 結構之 ExitData 欄位中的結束程式。 資料

預設日誌設定

下表列出您可以在「 IBM MQ 的內容」對話框的 預設日誌設定 頁面上設定的內容。 若要變更預設日誌設定,請編輯預設日誌設定頁面上的內容。 依預設,這些設定會套用到所有新的佇列管理程式。

內容 說明 段落索引鍵
日誌類型 若要讓佇列管理程式可於重新啟動時回復,請按一下循環。 如果佇列管理程式採用循環式記載,當日誌檔已滿時,檔案會從頭開始改寫。 若要讓佇列管理程式可於重新啟動時回復,並啟用媒體或正向回復,請按一下線性。 如果佇列管理程式採用線性記載,當日誌檔已滿時,會開始新的日誌檔。 LogType
日誌路徑 若要變更日誌的預設位置,請在這裡輸入完整路徑。 如果您未在這裡指定路徑,則預設值是 DefaultPrefix 中稱為 Log 的子目錄,其中 DefaultPrefix 是 IBM MQ 對話框之「內容」的 一般 頁面上 Default prefix 內容中指定的目錄。 LogPath
日誌檔頁數 輸入日誌檔中的 4KB 頁面數(32 到 4095)。 例如,如果您鍵入256,檔案大小為 1MB。 LogFilePages
日誌主要檔

AIX® 及 Linux®上,鍵入主要日誌檔的數目 (2 到 510)。 預設值為 3。 主要及次要日誌檔的總數不得超過 511,且不得小於 3。

Windows上,鍵入主要日誌檔的數目 (2 到 254)。 預設值為 3。 主要及次要日誌檔的總數不得超過 255,且不得小於 3。

LogPrimaryFiles
日誌次要檔

AIX 及 Linux上,鍵入次要日誌檔的數目 (1 到 509)。 預設值為 3。 主要及次要日誌檔的總數不得超過 511,且不得小於 3。

Windows上,鍵入次要日誌檔的數目 (1 到 253)。 預設值為 3。 主要及次要日誌檔的總數不得超過 255,且不得小於 3。

LogSecondaryFiles
日誌緩衝區頁數 輸入用於寫入的 4KB 緩衝區頁面數(0 到 512)。 如果您指定 0,則佇列管理程式會自行選取號碼。

如果您輸入 1 到 17 的數目,則會使用最小值 18。 如果您輸入 18 到 512 的數字,則會使用該頁數。 如果您變更此內容的值,請重新啟動佇列管理程式來偵測變更。

LogBufferPages
日誌寫入完整性 日誌程式用來可靠寫入日誌記錄的方法。

預設值為 TripleWrite。 請注意,可以選取 DoubleWrite,但如果您這樣做,系統會將此解譯為 TripleWrite

只有在管理 IBM MQ 回復日誌的檔案系統或裝置明確保證 4KB 寫入的原子性時,您才應該使用 SingleWrite

也就是說,如果寫入 4KB 頁面失敗,不論原因為何,僅有的兩種可能狀態為前像或後像。 不會有中間狀態。

LogWriteIntegrity
日誌管理 管理日誌所使用的方法。 LogManagement 只適用於 LogType 為 LINEAR 時。

如果您變更 LogManagement 值,該變更要等到佇列管理程式重新啟動之後才會生效。

有三個選項。

手動,您可手動管理日誌範圍。 指定此選項表示佇列管理程式不會重複使用或刪除日誌範圍,即使回復不再需要日誌範圍亦是如此。

自動,由佇列管理程式自動管理日誌範圍。 指定此選項表示佇列管理程式能夠重複使用日誌範圍,或在回復不再需要日誌範圍時將其刪除。 不會考慮保存。

保存,由佇列管理程式自動管理日誌範圍,但您必須在每個日誌範圍保存完成時通知佇列管理程式。

指定此選項表示佇列管理程式可以任意重複使用或刪除日誌範圍(只要佇列管理程式收到回復不再需要的日誌範圍已保存的通知)。

預設值是手動

LogManagement

ACPI 頁面

下表列出您可以在 IBM MQ 對話框之「內容」的 ACPI 頁面上設定的內容。 ACPI (Advanced Configuration and Power ® Interface) 是一種作業系統特性,可讓電腦偵測特定活動狀態並因此進入休眠狀態,亦即將自己切換至低功率模式而不執行任何程式,並以容許快速「起動」的方式。

當 ACPI 要使電腦進入休眠狀態時,它會先傳送暫停要求給所有應用程式。 若要控制 IBM MQ 如何回應此要求,請在 ACPI 頁面上設定 執行對話 內容。

內容 說明 段落索引鍵
執行對話框 預設值為 ,表示 IBM MQ 會顯示一則訊息,詢問使用者是否要暫停執行中的佇列管理程式。 若要暫停 IBM MQ 而不顯示此訊息,請按一下 DoDialog
拒絕暫停 如果未設定「執行」對話框 內容,或是已設定但無法顯示對話框(比方說,筆記型電腦的蓋子已關上),則拒絕暫停會控制回應。 預設值為 ,表示即使無法顯示對話框, IBM MQ 也會暫停。 若要在無法顯示對話框時防止 IBM MQ 暫停,請按一下 。 這個內容可以被檢查通道是否在執行內容取代。 DenySuspend
確定通道正在執行 預設值為 ,表示 IBM MQ 不會檢查是否有任何通道在執行中,並依 「執行」對話框拒絕暫停 內容的指示進行回應。 若要檢查是否有任何通道在執行中,請按一下。 如果沒有通道在執行中, IBM MQ 會忽略 「執行」對話框拒絕暫停 內容。 如果有通道在執行中, IBM MQ 會依照 「執行」對話框拒絕暫停 內容的指示來回應。 CheckChannelsRunning
[Windows]

「警示監視器」頁面

「警示監視器」只能用於 Windows

下表列出您可以在「 IBM MQ 的內容」對話框的 警示監視器 頁面上設定的內容。 「警示監視器」對於問題判斷非常有用。 在發生問題時,服務會發出警示;比方說,通道起始程式服務因為所需的佇列已被刪除而無法啟動。 若要配置警示監視器,請編輯警示監視器頁面上的內容。

內容 說明 段落索引鍵
警示監視器會通知使用者 預設值為 ,表示 IBM MQ 不會在發生問題時傳送警示給使用者。 若要配置 IBM MQ 以在發生問題時傳送警示,請按一下 啟用
警示監視器的使用者 鍵入 IBM MQ 應該向其傳送警示的電腦名稱或使用者名稱。 接受者
已將警示監視器的圖示新增至工作列 預設值是,表示「警示監視器」圖示不會顯示在 Windows 系統匣。 如果要在 Windows 系統匣顯示「警示監視器」圖示,請按一下 工作列

「配置資訊」頁面

下表列出在「 IBM MQ 的內容」對話框的 配置資訊 頁面上顯示的內容。 配置資訊頁面中的內容是唯讀的。

內容 說明
安裝類型 唯讀。 此內容指出您是否已在此電腦上安裝 IBM MQ 的伺服器或用戶端版本。
mqjbnd05 已載入 唯讀。 這是連接本端佇列管理程式所需的程式庫。
MQ 版本 唯讀。 這是這部電腦上安裝的 IBM MQ 版本。
建置層次 唯讀。 這是這部電腦所安裝 IBM MQ 產品的建置號碼。
建置類型 唯讀。 這是這部電腦所安裝 IBM MQ 產品的建置類型。