IBM MQ 內容
IBM® MQ 內容適用於整個 IBM MQ 安裝。
下表列出您可以為 IBM MQ 設定的內容:
每一項內容都有一個簡要說明,來說明您何時需要配置該內容。IBM MQ 內容對話框中的屬性會與配置檔中的段落相關。
「一般」頁面
下表列出您可以在「IBM MQ 的內容」對話框的一般頁面上設定的內容。
內容 | 說明 | 段落索引鍵 |
---|---|---|
預設路徑 | 若要變更用來儲存所有佇列管理程式資料之目錄的位置,請輸入新目錄的完整路徑。 | DefaultPrefix |
預設佇列管理程式名稱 | 若要指定新佇列管理程式的預設名稱,請在這個欄位中輸入該名稱。 | 名稱 |
「延伸事項」頁面
下表列出您可以在「IBM MQ 的內容」對話框的延伸事項頁面上設定的內容。
內容 | 說明 | 段落索引鍵 |
---|---|---|
轉換 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 物件名稱(如佇列名稱)有效的字元。 | 名稱 |
類型 | 指定結束程式的類型:共用或範本。 | (不是個別的段落索引鍵。) |
順序 | 這個屬性是不帶正負號的數值,其會定義呼叫這個 API 結束程式相較於其他 API 結束程式的順序。具有低序號的 API 結束程式,會在另一個具有較高序號的 API 結束程式之前呼叫。如果不同的 API 結束程式有相同的序號,其呼叫順序未定義。在定義給佇列管理程式之 API 結束程式的序號中的跳號仍然有效。 | 順序 |
模組 | 指定含有 API 結束程式之程式碼的模組。如果這個欄位含有模組的完整路徑名稱,則會依其現狀使用。如果這個欄位只包含模組名稱,則會使用與通道結束程式相同的方法來找出該模組;也就是使用佇列管理程式內容對話框之結束程式頁面的結束程式預設路徑欄位中的值。 | 模組 |
函數 | 指定含有 API 結束程式的程式碼之模組內的函數進入點名稱。這個進入點是 MQ_INIT_EXIT 函數。這個欄位的長度限制為 MQ_EXIT_NAME_LENGTH。 | 函數 |
資料 | 如果指定這個屬性,系統會移除前端和尾端空白,其餘字串會截斷成 32 個字元,並將結果傳給 MQAXP 結構之 ExitData 欄位中的結束程式。如果沒有指定這個屬性的話,會將預設值 32 個空格傳給 MQAXP 結構 ExitData 欄位中的結束程式。 | 資料 |
預設日誌設定
下表列出您可以在「IBM MQ 的內容」對話框的預設日誌設定頁面上設定的內容。若要變更預設日誌設定,請編輯預設日誌設定頁面中的屬性。依預設,這些設定會套用到所有新的佇列管理程式。
內容 | 說明 | 段落索引鍵 |
---|---|---|
日誌類型 | 若要讓佇列管理程式可於重新啟動時回復,請按一下循環。如果佇列管理程式採用循環式記載,當日誌檔已滿時,檔案會從頭開始改寫。若要讓佇列管理程式可於重新啟動時回復,並啟用媒體或正向回復,請按一下線性。如果佇列管理程式採用線性記載,當日誌檔已滿時,會開始新的日誌檔。 | LogType |
日誌路徑 | 若要變更日誌的預設位置,請在這裡輸入完整路徑。如果您未在這裡指定路徑,預設值是 DefaultPrefix 中名稱為 Log 的子目錄,其中 DefaultPrefix 是「IBM MQ 的內容」對話框的一般頁面中,預設字首內容所指定的目錄。 | LogPath |
日誌檔頁數 | 輸入日誌檔中的 4KB 頁面數(32 到 4095)。比方說,如果您輸入 256,檔案大小為 1MB。 | LogFilePages |
日誌主要檔 | 在 Windows 上,請鍵入主要日誌檔的數目(2 到 254)。預設值是 3。主要和次要日誌檔的總數不可超過 255,且不可小於 3。 在 UNIX 及 Linux 上,請鍵入主要日誌檔的數目(2 到 510)。預設值是 3。主要和次要日誌檔的總數不可超過 511 且不可小於 3。 |
LogPrimaryFiles |
日誌次要檔 | 在 Windows 上,請鍵入次要日誌檔的數目(1 到 253)。預設值是 3。主要和次要日誌檔的總數不可超過 255,且不可小於 3。 在 UNIX 及 Linux 上,請鍵入次要日誌檔的數目(1 到 509)。預設值是 3。主要和次要日誌檔的總數不可超過 511 且不可小於 3。 |
LogSecondaryFiles |
日誌緩衝區頁數 | 輸入用於寫入的 4KB 緩衝區頁面數(0 到 512)。如果您指定 0,則佇列管理程式會自行選取號碼。 如果您輸入 1 到 17 的數目,則會使用最小值 18。如果您輸入 18 到 512 的數字,則會使用該頁數。如果您變更此內容的值,請重新啟動佇列管理程式來偵測變更。 |
LogBufferPages |
日誌寫入完整性 | 日誌程式用來可靠寫入日誌記錄的方法。 預設值為 TripleWrite。請注意,可以選取 DoubleWrite,但如果您這樣做,系統會將此解譯為 TripleWrite。 只有在託管 IBM MQ 回復日誌的檔案系統或裝置明確地保證最小寫入單位 4KB 時,才應該使用 SingleWrite。 也就是說,如果寫入 4KB 頁面失敗,不論原因為何,僅有的兩種可能狀態為前像或後像。不會有中間狀態。 |
LogWriteIntegrity |
![]() |
![]() 如果您變更 LogManagement 值,該變更要等到佇列管理程式重新啟動之後才會生效。 有三個選項。 手動,您可手動管理日誌範圍。指定此選項表示佇列管理程式不會重複使用或刪除日誌範圍,即使回復不再需要日誌範圍亦是如此。 自動,由佇列管理程式自動管理日誌範圍。指定此選項表示佇列管理程式能夠重複使用日誌範圍,或在回復不再需要日誌範圍時將其刪除。不會考慮保存。 保存,由佇列管理程式自動管理日誌範圍,但您必須在每個日誌範圍保存完成時通知佇列管理程式。 指定此選項表示佇列管理程式可以任意重複使用或刪除日誌範圍(只要佇列管理程式收到回復不再需要的日誌範圍已保存的通知)。 預設值是手動。 |
![]() |
ACPI 頁面
下表列出您可以在「IBM MQ 的內容」對話框的 ACPI 頁面上設定的內容。ACPI(進階配置與Power®介面)是一個作業系統特性,可讓電腦偵測某些活動狀態,從而進入休眠狀態(也就是將其本身切換至不執行任何程式的低功率模式,藉此方式來容許快速「起動」)。
當 ACPI 要使電腦進入休眠狀態時,它會先傳送暫停要求給所有應用程式。若要控制 IBM MQ 回應這個要求的方式,請設定 ACPI 頁面上的「執行」對話框內容。
內容 | 說明 | 段落索引鍵 |
---|---|---|
執行對話框 | 預設值是是,表示 IBM MQ 會顯示一則訊息詢問使用者是否要暫停執行中的佇列管理程式。若要暫停 IBM MQ 而不顯示這則訊息,請按一下否。 | DoDialog |
拒絕暫停 | 如果未設定「執行」對話框 內容,或是已設定但無法顯示對話框(比方說,筆記型電腦的蓋子已關上),則拒絕暫停會控制回應。預設值是否,表示 IBM MQ 會暫停,即使無法顯示對話框亦然。若要避免無法顯示對話框時 IBM MQ 會暫停,請按一下是。這個內容可以被檢查通道是否在執行內容取代。 | DenySuspend |
檢查通道是否在執行 | 預設值是否,表示 IBM MQ 不會檢查是否有任何通道在執行中,並依「執行」對話框和拒絕暫停內容的指示回應。若要檢查是否有任何通道在執行中,請按一下是。如果沒有通道在執行中,IBM MQ 會忽略「執行」對話框及拒絕暫停內容。如果有通道在執行中,IBM MQ 會依「執行」對話框及拒絕暫停內容的指示回應。 | 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 產品的建置類型。 |