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 物件名稱有效的字元,例如佇列名稱。 | 姓名 |
類型 | 指定結束程式的類型:common 或 template 。 |
(不是個別的段落索引鍵。) |
序列 | 這個內容是不帶正負號的數值,其會定義呼叫這個 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® and Linux® 上,鍵入主要日誌檔的號碼,從 2 到 510。 預設值為 3。 主要及次要日誌檔的總數不得超過 511,且不得小於 3。 在 Windows上,鍵入主要日誌檔的數目 (2 到 254)。 預設值為 3。 主要及次要日誌檔的總數不得超過 255,且不得小於 3。 |
LogPrimaryFiles |
日誌次要檔 | 在 AIX and 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 |
拒絕暫停 | 如果未設定 Do dialog 內容,或已設定但無法顯示對話框(例如,如果筆記型電腦已關閉其蓋子),則 Deny suspend 會控制回應。 預設值為否,表示 IBM MQ 會暫停,即使無法顯示對話框也一樣。 如果要在無法顯示對話框時防止 IBM MQ 暫停,請按一下是。 此內容可以由 Check channels running 內容所取代。 | DenySuspend |
確定通道正在執行 | 預設值為 No,表示 IBM MQ 不會檢查是否有任何通道在執行中,並依 Do dialog 和 Deny suspend 內容的指示進行回應。 若要檢查是否有任何通道在執行中,請按一下是。 如果沒有通道在執行中,IBM MQ 會忽略 Do dialog 和 Deny suspend 內容。 如果有通道在執行中,IBM MQ 會依照 Do dialog 和 Deny suspend 內容的指示來回應。 | CheckChannelsRunning |
![[Windows]](ngwin.gif)
「警示監視器」頁面
「警示監視器」只能用於 Windows。
下表列出您可以在「IBM MQ 的內容」對話框的警示監視器頁面上設定的內容。 「警示監視器」對於問題判斷非常有用。 在發生問題時,服務會發出警示;比方說,通道起始程式服務因為所需的佇列已被刪除而無法啟動。 若要配置警示監視器,請編輯警示監視器頁面上的內容。
內容 | 說明 | 段落索引鍵 |
---|---|---|
警示監視器會通知使用者 | 預設值為否,表示出現問題時 IBM MQ 不會傳送警示給使用者。 如果要配置 IBM MQ 以在發生問題時傳送警示,請按一下是。 | 啟用 |
警示監視器的使用者 | 鍵入 IBM MQ 應該向其傳送警示的電腦名稱或使用者名稱。 | 接受者 |
已將警示監視器的圖示新增至工作列 | 預設值是是,表示「警示監視器」圖示不會顯示在 Windows 系統匣。 如果要在 Windows 系統匣顯示「警示監視器」圖示,請按一下是。 | 工作列 |
「配置資訊」頁面
下表列出在「IBM MQ 的內容」對話框的配置資訊頁面上顯示的內容。 配置資訊頁面中的內容是唯讀的。
內容 | 說明 |
---|---|
安裝類型 | 唯讀。 此內容指出您是否已在此電腦上安裝「伺服器」或「用戶端」版本 IBM MQ。 |
mqjbnd05 已載入 | 唯讀。 這是連接本端佇列管理程式所需的程式庫。 |
MQ 版本 | 唯讀。 這是安裝在此電腦上的 IBM MQ 版本。 |
建置層次 | 唯讀。 這是已安裝在此電腦上的 IBM MQ 產品的建置號碼。 |
建置類型 | 唯讀。 這是已安裝在此電腦上的 IBM MQ 產品的建置類型。 |